/** * Compatibility matrix for the Widgets module. * * This module declares the validated combination of external dependencies * that each release of the Widgets module is known to work with: * * - Dynamic UI (consumed as api.json from the CDN) * - Template canonical (consumed via `git clone` by the * widgets-scaffold Tool, invoked from the widgets-init-project prompt) * - Validator (consumed as the @modyo/widget-validator npm package, * pinned in package.json dependencies — this file documents the * expected version for cross-check) * * Bumping any entry here is a deliberate act: * * 1. Run audits against the new version of the affected dependency. * 2. Update docs/widgets/ if the bump introduces deprecations or new APIs. * 3. Update tests as needed. * 4. Verify the integration tests against the new pinned tuple pass. * 5. Bump this matrix in a single commit, with rationale in the commit * message. * * The MCP NEVER follows upstream automatically. Operators do not override * these versions at runtime — there is no env var for this. If an operator * needs a different version, they install a different release of the MCP. * * Industry references for this pattern: Spring Boot dependency BOMs, * shadcn/ui CLI registry pinning, AMD ROCm compatibility matrix. */ /** * Canonical template repository. Cloned by the widgets-scaffold Tool at * the tag pinned in WIDGETS_COMPAT.template. Single source for the URL — * do not duplicate it in prompt text or tool code. */ export declare const WIDGETS_TEMPLATE_REPO_URL = "https://github.com/dynamic-framework/dynamic-react-vite-base-template.git"; export declare const WIDGETS_COMPAT: { /** * Dynamic UI version consumed from the CDN. Drives: * * - api.json fetched from * cdn.dynamicframework.dev/assets/{dynamicUi}/ui-react/api.json * (URL resolved via manifest.json discovery; must exist in * manifest.json versions[]). * - Storybook manifests fetched from * cdn.dynamicframework.dev/assets/{dynamicUi}/ui-react/manifests/ * {components.json, docs.json} (direct versioned path — no separate * registry). * - Stack alignment check in the widgets-validate Tool wrapper (SC20): * widget's package.json @dynamic-framework/ui-react pin must * satisfy this value before the validator runs. * * Bumping is a deliberate act — audit docs, refresh tests, commit with * rationale. */ readonly dynamicUi: "2.8.0"; /** * Template canonical git tag. * Cloned by the widgets-scaffold Tool via `git clone --branch`. * Must exist in the dynamic-framework/dynamic-react-vite-base-template * repository's tags. */ readonly template: "v1.2.0"; /** * Validator package version. The actual pinning lives in package.json * dependencies (exact, no caret). This constant exists for cross-check — * see the alignment test in tests/tools/widgets/_compatibility.test.ts. */ readonly validator: "0.2.0"; }; export type WidgetsCompat = typeof WIDGETS_COMPAT; //# sourceMappingURL=_compatibility.d.ts.map