feat(router): add support for custom resource routes (#6864)

[satyajeetch1991]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://refine.dev/docs/guides-concepts/contributing/#commit-convention

Bugs / Features

• Related issue(s) linked ([FEAT] Custom resource routes #6864)
• Tests for the changes have been added
• Docs have been added / updated
• Changesets have been added https://refine.dev/docs/guides-concepts/contributing/#creating-a-changeset

What is the current behavior?

Currently, refine only supports CRUD routes (list, show, create, edit) for each resource.
There is no built-in way to define additional custom routes associated with a resource.

What is the new behavior?

This PR introduces support for custom resource routes.
A new custom property is added to ResourceProps allowing developers to define additional routes alongside the default CRUD ones.

✅ Example Usage

<Refine
  resources={[
    {
      name: "posts",
      list: PostList,
      custom: [
        { path: "dashboard", component: DashboardPage },
      ],
    },
  ]}
/>

[changeset-bot]

⚠️ No Changeset found

Latest commit: f44745b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify]

❌ Deploy Preview for refine-doc-live-previews failed.

Built without sensitive environment variables

Name	Link
🔨 Latest commit	f44745b
🔍 Latest deploy log	https://app.netlify.com/projects/refine-doc-live-previews/deploys/688c71d20acd6c0009488330

[pcfreak30]

@satyajeetch1991 restore the jsdoc comments in the diff and remove the emoji comments the LLM you used added.

TL;DR review the PR again.

[alicanerdurmaz]

I'm closing this PR because it's missing a lot of things:

1. examples/custom-test/ is not working.
2. Next.js and Remix router implementations are missing.
3. There's no need to canList?: boolean;.
4. Many internal Refine hooks do not support the new implementation.

...and the list goes on.