feat(cache): support customKey, cache statistics and unstable_shouldDisable for the cache function

[yimingjfe]

Summary

1. Add a customKey property to the cache function, which can be used to save the cache when the function reference changes.
2. Add a onCache property to the cache function, which can be used to supports cache hit rate statistics.
3. Supports unstable_shouldDisable, which can be used to custom forced cache invalidation way, such as based on request query.

Related Links

Checklist

• I have added changeset via pnpm run change.
• I have updated the documentation.
• I have added tests to cover my changes.

[changeset-bot]

🦋 Changeset detected

Latest commit: 868ce29

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 291 packages

Name	Type
@modern-js/runtime-utils	Patch
@modern-js/plugin-data-loader	Patch
@modern-js/plugin-tailwindcss	Patch
@modern-js/plugin-garfish	Patch
@modern-js/plugin-router-v5	Patch
@modern-js/runtime	Patch
@modern-js/plugin-state	Patch
@modern-js/server-core	Patch
@modern-js/create-request	Patch
@modern-js/plugin-server	Patch
@modern-js/prod-server	Patch
@modern-js/server	Patch
@modern-js/plugin-v2	Patch
app-entry-server	Patch
@modern-js/app-tools	Patch
integration-tailwindcss-v2	Patch
integration-tailwindcss-v3-js-config-with-postcss-config	Patch
integration-tailwindcss-v3-js-config	Patch
integration-tailwindcss-v3-merge-config	Patch
integration-tailwindcss-v3-ts-config	Patch
integration-tailwindcss-v3	Patch
twin-macro-v2	Patch
twin-macro-v3	Patch
app-garfish-dashboard	Patch
app-garfish-master	Patch
app-garfish-table	Patch
@e2e/garfish-dashboard-router-v6	Patch
@e2e/garfish-dashboard	Patch
@e2e/garfish-main-router-v6	Patch
@e2e/garfish-main	Patch
@e2e/garfish-table	Patch
app-document	Patch
file-based-router	Patch
@modern-js/plugin-bff	Patch
@modern-js/devtools-client	Patch
@modern-js/plugin-devtools	Patch
@modern-js/plugin-testing	Patch
@modern-js/storybook-builder	Patch
@integration-test/alias-set	Patch
api-service-koa	Patch
async-entry-test	Patch
tmp	Patch
bff-api-app	Patch
bff-client-app	Patch
bff-indep-client-app	Patch
bff-express	Patch
bff-koa	Patch
integration-clean-dist-path	Patch
integration-compatibility	Patch
integration-custom-dist-path	Patch
custom-file-system-entry	Patch
integration-custom-render	Patch
integration-custom-template	Patch
deploy	Patch
deploy-server	Patch
dev-server	Patch
@integration-test/devtools	Patch
integration-disable-html	Patch
app-custom-bootstrap	Patch
app-custom-routes-runtime	Patch
app-custom	Patch
app-entry	Patch
app-route	Patch
esbuild-transform-and-minify	Patch
@integration-test/image-component	Patch
main-entry-name	Patch
nonce	Patch
pure-esm-project	Patch
routes-match	Patch
routes	Patch
app-rsbuild-hooks	Patch
rsc-csr-app	Patch
rsc-ssr-app	Patch
runtime-custom-plugin	Patch
runtime-custom-config-plugin	Patch
use-loader	Patch
select-mul-entry-test	Patch
select-one-entry-test	Patch
server-config-v2	Patch
server-config	Patch
server-middleware	Patch
server-new-middleware	Patch
server-hook-reqeust	Patch
server-hook-response	Patch
server-hook-router	Patch
@integration-test/server-hook-reqeust	Patch
server-json-script	Patch
server-monitors	Patch
server-prod	Patch
server-routes	Patch
@source-code-build/app-ts-loader	Patch
@source-code-build/app	Patch
ssg-fixtures-mega-list-routes	Patch
ssg-fixtures-nested-routes	Patch
ssg-fixtures-simple	Patch
ssg-fixtures-web-server	Patch
ssr-base-async-entry-test	Patch
ssr-base-json-test	Patch
ssr-base-test	Patch
ssr-base-fallback-test	Patch
init	Patch
ssr-inline	Patch
ssr-partial-test	Patch
ssr-script-loading	Patch
ssr-streaming-inline-test	Patch
ssr-streaming-test	Patch
swc-config-function	Patch
swc-minify-css	Patch
swc-minify-js	Patch
transform-fail	Patch
integration-tailwindcss-without-plugin	Patch
tmp-dir	Patch
transform-import-type-test	Patch
transform-import-type-lodash	Patch
write-to-dist	Patch
@modern-js/render	Patch
@modern-js/plugin-express	Patch
@modern-js/plugin-koa	Patch
@modern-js/plugin-polyfill	Patch
@modern-js/server-utils	Patch
@modern-js/plugin-ssg	Patch
@modern-js/plugin-worker	Patch
@modern-js/plugin-swc	Patch
@modern-js/devtools-kit	Patch
@modern-js/image	Patch
tests	Patch
integration-asset-prefix	Patch
integration-builder-plugins	Patch
integration-copy-assets	Patch
entries-app-builder-index	Patch
entries-app-builder	Patch
integration-config-async-config-test	Patch
integration-basic-local-config	Patch
integration-config-function-params	Patch
integration-local-config-function	Patch
swc-test-decorator-legacy	Patch
swc-test-decorator	Patch
@modern-js/storybook	Patch
integration-tests-storybook	Patch
@modern-js/tsconfig	Patch
@modern-js/babel-preset	Patch
@modern-js/core	Patch
@modern-js/flight-server-transform-plugin	Patch
@modern-js/plugin-changeset	Patch
@modern-js/plugin-i18n	Patch
@modern-js/plugin-proxy	Patch
@modern-js/rsbuild-plugin-esbuild	Patch
@modern-js/uni-builder	Patch
@modern-js/main-doc	Patch
@modern-js/module-tools-docs	Patch
@modern-js/new-action	Patch
@modern-js/sandpack-react	Patch
@modern-js/babel-plugin-module-resolver	Patch
@modern-js/bff-core	Patch
@modern-js/bff-runtime	Patch
@modern-js/plugin-module-babel	Patch
@modern-js/plugin-module-banner	Patch
@modern-js/plugin-module-import	Patch
@modern-js/plugin-module-node-polyfill	Patch
@modern-js/plugin-module-polyfill	Patch
@modern-js/plugin-module-vue	Patch
@modern-js/module-tools	Patch
@modern-js/monorepo-tools	Patch
@modern-js/create	Patch
@modern-js/e2e	Patch
@modern-js/node-bundle-require	Patch
@modern-js/plugin	Patch
@modern-js/types	Patch
@modern-js/upgrade	Patch
@modern-js/utils	Patch
@modern-js/babel-compiler	Patch
@scripts/build	Patch
@scripts/check-changeset	Patch
@scripts/jest-config	Patch
@scripts/lint-package-json	Patch
@scripts/prebundle	Patch
@scripts/release-versin	Patch
@scripts/update-codesmith	Patch
@scripts/vitest-config	Patch
entries-integration	Patch
esbuild-integration	Patch
integration-load-config	Patch
alias-js-test	Patch
alias-module-id-test	Patch
alias-ts-test	Patch
asset-limit-test	Patch
asset-name-test	Patch
asset-path-test	Patch
asset-publicPath-test	Patch
svgr-test	Patch
auto-extension-commonjs-test	Patch
auto-extension-type-module-test	Patch
auto-external-test	Patch
banner-footer-test	Patch
build-type-test	Patch
copy-test	Patch
decorator-test	Patch
global-vars-js-test	Patch
global-vars-ts-test	Patch
dts-composite	Patch
dts-test	Patch
esbuild-options-test	Patch
external-test	Patch
format-cjs-test	Patch
format-esm-test	Patch
format-iife-test	Patch
format-umd-test	Patch
hook-test	Patch
entry-test	Patch
jsx-test	Patch
loader-esbuild-test	Patch
loader-swc-test	Patch
metafile-test	Patch
minify-test	Patch
platform-test	Patch
redirect-test	Patch
resolve-alias-error	Patch
resolve-alias-test	Patch
data-url-test	Patch
browser-false	Patch
resolve-false	Patch
ndoe-protocol-test	Patch
lib1	Patch
lib2	Patch
lib3	Patch
condition-exports-test	Patch
js-extensions-test	Patch
main-fields-test	Patch
shims-test	Patch
module-tools-side-effects-test	Patch
source-dir-test	Patch
sourcemap-test	Patch
splitting-test	Patch
css-test	Patch
less-test	Patch
style-test	Patch
postcss-test	Patch
sass-test	Patch
scss-test	Patch
tailwindcss-test	Patch
target-test	Patch
transform-import	Patch
transform-lodash	Patch
tsconfig-test	Patch
tsconfig-extends-test	Patch
umdGlobals-test	Patch
get-module-id-test	Patch
dev-test	Patch
build-platform-test	Patch
build-preset-error-test	Patch
build-preset-function-test	Patch
build-preset-test	Patch
build-preset-string-test	Patch
integration-module-tools	Patch
plugin-babel	Patch
module-hooks-test	Patch
plugin-node-polyfill	Patch
plugin-polyfill	Patch
plugin-vue	Patch
runtime	Patch
entry	Patch
@source-code-build/common	Patch
@source-code-build/components	Patch
@source-code-build/utils	Patch
ssg	Patch
ssr	Patch
swc-integration	Patch
tailwindcss-integration-test	Patch
@e2e/webpack-builder-import-antd-v4	Patch
@e2e/webpack-builder-import-antd-v5	Patch
@e2e/webpack-builder-import-arco	Patch
@e2e/webpack-builder-test-moment	Patch
@e2e/builder-remove-prop-types	Patch
@e2e/webpack-builder-source-map	Patch
@e2e/builder	Patch
@e2e/garfish	Patch
@modern-js/generator-common	Patch
@modern-js/generator-utils	Patch
@modern-js/bff-generator	Patch
@modern-js/dependence-generator	Patch
@modern-js/entry-generator	Patch
@modern-js/mwa-generator	Patch
@modern-js/router-v5-generator	Patch
@modern-js/ssg-generator	Patch
@modern-js/storybook-next-generator	Patch
@modern-js/upgrade-generator	Patch
@modern-js/generator-cases	Patch
@modern-js/base-generator	Patch
@modern-js/packages-generator	Patch
@modern-js/server-generator	Patch
@modern-js/tailwindcss-generator	Patch

Not sure what this means? Click here to learn what changesets are.

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

[netlify]

✅ Deploy Preview for modernjs-byted ready!

Name	Link
🔨 Latest commit	868ce29
🔍 Latest deploy log	https://app.netlify.com/sites/modernjs-byted/deploys/680dcda7f886d40008c62231
😎 Deploy Preview	https://deploy-preview-7058--modernjs-byted.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 77 (🔴 down 1 from production) Accessibility: 90 (no change from production) Best Practices: 100 (no change from production) SEO: 91 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify site configuration.