@ykdz/template 0.0.36 → 0.0.38

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/web/turbo.json

@@ -4,14 +4,6 @@
   "tasks": {
     "build": {
       "outputs": ["dist/**"]
-    },
-    "deployment": {
-      "dependsOn": ["build"],
-      "cache": false
-    },
-    "test:e2e": {
-      "dependsOn": ["build"],
-      "cache": false
     }
   }
 }

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/web/vite.config.ts

@@ -1,50 +1,14 @@
-import { execFileSync } from "node:child_process";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
 import tailwindcss from "@tailwindcss/vite";
 import vue from "@vitejs/plugin-vue";
 import telefunc from "telefunc/vite";
 import vike from "vike/plugin";
 import { defineConfig, type PluginOption } from "vite";
 
-const webRoot = path.dirname(fileURLToPath(import.meta.url));
-const migrationsRoot = path.resolve(webRoot, "../../packages/db-migrations");
-const databaseRoot = path.resolve(webRoot, "../../packages/db");
-const databaseFile = path.join(webRoot, "data/app.sqlite");
-
 // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- telefunc/vite currently types its plugin factory as any.
 const telefuncPlugin = telefunc() as PluginOption;
 
-async function prepareDatabase(): Promise<void> {
-  const env = { ...process.env, DATABASE_FILE: databaseFile };
-  process.env.DATABASE_FILE = databaseFile;
-  execFileSync("pnpm", ["run", "db:push"], {
-    cwd: migrationsRoot,
-    env,
-    stdio: "inherit",
-  });
-  execFileSync("pnpm", ["run", "db:seed:example"], {
-    cwd: databaseRoot,
-    env,
-    stdio: "inherit",
-  });
-}
-
-function databasePreparationPlugin(): PluginOption {
-  return {
-    name: "database-preparation",
-    configureServer: () => prepareDatabase(),
-    configurePreviewServer: () => prepareDatabase(),
-  };
-}
-
 export default defineConfig({
-  plugins: [
-    vike(),
-    telefuncPlugin,
-    vue(),
-    tailwindcss(),
-    databasePreparationPlugin(),
-  ],
+  plugins: [vike(), telefuncPlugin, vue(), tailwindcss()],
+  resolve: { conditions: ["source"] },
+  ssr: { external: ["{{DB_PACKAGE_NAME}}"] },
 });

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/api/tsconfig.json

@@ -9,8 +9,13 @@
     "module": "nodenext",
     "moduleResolution": "nodenext",
     "rewriteRelativeImportExtensions": true,
-    "target": "es2023",
+    "target": "es2024",
     "types": ["node", "vitest/globals"]
   },
-  "include": ["src/**/*.ts", "test/**/*.ts", "vitest.config.ts"]
+  "include": [
+    "src/**/*.ts",
+    "test/**/*.ts",
+    "scripts/**/*.ts",
+    "vitest.config.ts"
+  ]
 }

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/root/playwright.config.ts

@@ -0,0 +1,34 @@
+import { defineConfig, devices } from "@playwright/test";
+
+const apiPort = process.env.PLAYWRIGHT_API_PORT ?? "0";
+const webPort = process.env.PLAYWRIGHT_WEB_PORT ?? "0";
+
+export default defineConfig({
+  testDir: "./test/e2e",
+  reporter: [["list"], ["html"]],
+  use: {
+    trace: "retain-on-failure",
+    ...devices["Desktop Chrome"],
+  },
+  webServer: [
+    {
+      // oxfmt-ignore
+      command: "pnpm --filter {{API_PACKAGE_NAME}} --fail-if-no-match run start",
+      env: { PORT: apiPort },
+      wait: {
+        stdout:
+          /Hono API listening on (?<VITE_API_BASE_URL>http:\/\/localhost:\d+)/,
+      },
+      reuseExistingServer: false,
+    },
+    {
+      // oxfmt-ignore
+      command: "pnpm --filter {{WEB_PACKAGE_NAME}} --fail-if-no-match run preview --host 127.0.0.1 --strictPort",
+      env: { PLAYWRIGHT_WEB_PORT: webPort },
+      wait: {
+        stdout: /Local:\s+(?<PLAYWRIGHT_WEB_URL>http:\/\/127\.0\.0\.1:\d+)/,
+      },
+      reuseExistingServer: false,
+    },
+  ],
+});

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/{web → root}/test/e2e/app.spec.ts

@@ -1,7 +1,7 @@
-import { expect, test } from "@playwright/test";
+import { expect, test } from "./fixtures.ts";
 
-test("renders the web app and calls the API", async ({ page }) => {
-  await page.goto("/");
+test("renders the web app and calls the API", async ({ page, webUrl }) => {
+  await page.goto(webUrl);
 
   await expect(
     page.getByRole("heading", { name: "Vue 和 Hono 工作区" }),

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/root/test/e2e/fixtures.ts

@@ -0,0 +1,15 @@
+import { test as base } from "@playwright/test";
+
+export const test = base.extend<{ readonly webUrl: string }>({
+  webUrl: async ({ browserName: _browserName }, use) => {
+    const webUrl = process.env.PLAYWRIGHT_WEB_URL;
+    if (webUrl === undefined) {
+      throw new Error(
+        "PLAYWRIGHT_WEB_URL was not captured from the web server",
+      );
+    }
+    await use(webUrl);
+  },
+});
+
+export { expect } from "@playwright/test";

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/root/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "include": ["*.config.ts", "scripts/**/*.ts", "test/**/*.ts"]
+}

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/web/src/api.ts

@@ -1,7 +1,5 @@
-const apiBaseUrl = import.meta.env.VITE_API_BASE_URL ?? "/";
-
 export async function getHealth(): Promise<{ status: "ok" }> {
-  const response = await fetch(`${apiBaseUrl.replace(/\/$/, "")}/api/health`);
+  const response = await fetch("/api/health");
 
   if (!response.ok) {
     throw new Error(`Health check failed with ${response.status}`);

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/web/turbo.json

@@ -4,10 +4,6 @@
   "tasks": {
     "build": {
       "outputs": ["dist/**"]
-    },
-    "test:e2e": {
-      "dependsOn": ["build"],
-      "cache": false
     }
   }
 }

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/web/vite.config.ts

@@ -8,6 +8,7 @@ export default defineConfig(({ mode }) => {
     process.env.VITE_API_BASE_URL ??
     env.VITE_API_BASE_URL ??
     "http://localhost:3000";
+  const previewPort = process.env.PLAYWRIGHT_WEB_PORT;
 
   return {
     plugins: [vue(), tailwindcss()],
@@ -17,6 +18,7 @@ export default defineConfig(({ mode }) => {
       },
     },
     preview: {
+      ...(previewPort === undefined ? {} : { port: Number(previewPort) }),
       proxy: {
         "/api": apiBaseUrl,
       },

package/node_modules/@ykdz/template-core/dist/ci-diagnostic-artifact.d.ts

@@ -1,8 +1,8 @@
-import type { PackageBoundaryOwner } from "./module-graph.ts";
+import type { ComponentOwner } from "./module-graph.ts";
 /** Closed, owner-scoped native evidence a Package Contribution may retain in CI. */
 export type CiDiagnosticArtifactDeclaration = {
     readonly kind: "playwright";
-    readonly owner: PackageBoundaryOwner;
+    readonly owner: ComponentOwner;
 };
 /**
  * Validates the intentionally closed diagnostic declaration surface.  It does

package/node_modules/@ykdz/template-core/dist/ci-diagnostic-artifact.js

@@ -34,14 +34,18 @@ export function assertCiDiagnosticArtifactDeclaration(value) {
     if (!isRecord(value.owner) || !hasExactKeys(value.owner, ["kind", "path"])) {
         throw new Error("CI Diagnostic Artifact requires a Package Boundary owner");
     }
-    if (value.owner.kind !== "package-boundary" ||
-        typeof value.owner.path !== "string" ||
-        !isSafePackagePath(value.owner.path)) {
+    if ((value.owner.kind !== "workspace-orchestration" ||
+        value.owner.path !== ".") &&
+        (value.owner.kind !== "package-boundary" ||
+            typeof value.owner.path !== "string" ||
+            !isSafePackagePath(value.owner.path))) {
         throw new Error("CI Diagnostic Artifact owner has an unsafe Package Boundary path");
     }
     return {
         kind: "playwright",
-        owner: { kind: "package-boundary", path: value.owner.path },
+        owner: value.owner.kind === "workspace-orchestration"
+            ? { kind: "workspace-orchestration", path: "." }
+            : { kind: "package-boundary", path: value.owner.path },
     };
 }
 /**
@@ -58,7 +62,8 @@ export function composeCiDiagnosticArtifacts(options) {
     const artifacts = new Map();
     for (const value of options.declarations) {
         const declaration = assertCiDiagnosticArtifactDeclaration(value);
-        if (!owners.has(declaration.owner.path)) {
+        if (declaration.owner.kind === "package-boundary" &&
+            !owners.has(declaration.owner.path)) {
             throw new Error(`CI Diagnostic Artifact owner is not a declared Package Boundary: ${declaration.owner.path}`);
         }
         const key = `${declaration.kind}:${declaration.owner.path}`;

package/node_modules/@ykdz/template-core/dist/module-graph.d.ts

@@ -46,7 +46,7 @@ export declare function normalizeEnvironmentNeeds(options: {
 export declare function parseEnvironmentNeedsMetadata(value: unknown): EnvironmentNeedsMetadata;
 export declare function rustToolchainEnvironmentNeed(owner: ComponentOwner): RustToolchainEnvironmentNeed;
 export declare function dockerEngineEnvironmentNeed(): DockerEngineEnvironmentNeed;
-export declare const qualityTaskVocabulary: readonly ["boundaries", "format:check", "lint", "typecheck", "build", "test", "test:e2e"];
+export declare const qualityTaskVocabulary: readonly ["format:check", "lint", "typecheck", "build", "test", "test:e2e"];
 export declare function renderTurboRunCommand(taskNames: readonly string[], args?: readonly string[], options?: {
     readonly outputLogs?: "errors-only" | "full";
     readonly continueAfterFailure?: boolean;

package/node_modules/@ykdz/template-core/dist/module-graph.js

@@ -153,7 +153,6 @@ export function dockerEngineEnvironmentNeed() {
     return { kind: "docker-engine" };
 }
 export const qualityTaskVocabulary = [
-    "boundaries",
     "format:check",
     "lint",
     "typecheck",
@@ -175,10 +174,13 @@ export function renderTurboRunCommand(taskNames, args = [], options = {}) {
     ].join(" ");
 }
 export function renderRootCheckCommand(additionalTasks = []) {
-    return renderTurboRunCommand([...qualityTaskVocabulary, ...additionalTasks], [], {
-        continueAfterFailure: true,
-        taskPrefix: true,
-    });
+    return [
+        "pnpm run boundaries",
+        renderTurboRunCommand([...qualityTaskVocabulary, ...additionalTasks], [], {
+            continueAfterFailure: true,
+            taskPrefix: true,
+        }),
+    ].join(" && ");
 }
 export function renderDeploymentCheckCommand() {
     return renderTurboRunCommand(["deployment"], [], { taskPrefix: true });

package/node_modules/@ykdz/template-core/dist/package-contribution.d.ts

@@ -6,6 +6,34 @@ import type { PackageDefinition } from "./project-blueprint.ts";
 import type { DependencyMaintenancePolicy } from "./project-github.ts";
 import type { RenderOperation, TemplateSourceHandle } from "./renderer.ts";
 export type FoundationContribution = {
+    /** Closed root-owned Vue-Hono page/API browser acceptance capability. */
+    readonly vueHonoJointE2e?: {
+        readonly kind: "vue-hono-joint-e2e";
+        readonly apiPackageName: string;
+    };
+    readonly databasePreparation?: {
+        readonly kind: "sqlite-database-preparation";
+        readonly migrationPackageName: string;
+        readonly consumers: readonly {
+            readonly kind: "application-dev" | "database-test" | "application-e2e";
+            readonly packageName: string;
+        }[];
+    };
+    /** A closed repository-context deployment capability projected by Foundation. */
+    readonly deploymentCheck?: {
+        readonly kind: "application-container-with-database-migrations";
+        readonly applicationPackageName: string;
+        readonly databasePackageName: string;
+        readonly migrationPackageName: string;
+        readonly environmentNeeds: readonly DeploymentEnvironmentNeed[];
+        readonly sources: {
+            readonly checker: FoundationTemplateAssetSource;
+            readonly controlScript: FoundationTemplateAssetSource;
+            readonly dockerfile: FoundationTemplateAssetSource;
+            readonly dockerIgnore: FoundationTemplateAssetSource;
+            readonly shellCheckDockerfile: FoundationTemplateAssetSource;
+        };
+    };
     /** Closed publication capability consumed only by coordinated root policy. */
     readonly npmPublication?: {
         readonly kind: "public-cli-candidate";
@@ -15,6 +43,7 @@ export type FoundationContribution = {
         readonly rust?: {
             readonly toolchain: string;
             readonly components: readonly ("rustfmt" | "clippy")[];
+            readonly configurationSource: FoundationTemplateAssetSource;
         };
     };
     /** Editor capabilities the Foundation must project into its coordinated editor files. */
@@ -31,14 +60,10 @@ export type FoundationContribution = {
     readonly dependencyCatalog?: Readonly<Record<string, string>>;
     /** Source-backed Development Container capabilities coordinated by Foundation. */
     readonly developmentContainerToolLayers?: readonly DevelopmentContainerToolLayer[] | undefined;
-    /** Source-backed coordinated files projected by Foundation. */
-    readonly templateFiles?: readonly {
-        readonly identity: string;
-        readonly source: TemplateSourceHandle;
-        readonly from: string;
-        readonly to: string;
-        readonly replacements?: Readonly<Record<string, string>> | undefined;
-    }[] | undefined;
+};
+export type FoundationTemplateAssetSource = {
+    readonly source: TemplateSourceHandle;
+    readonly from: string;
 };
 /** A preset-agnostic package-sized part of a Generated Repository Plan. */
 export type PackageContribution = {
@@ -54,8 +79,6 @@ export type PackageContribution = {
     readonly environmentNeeds: readonly CheckEnvironmentNeed[];
     /** Closed native CI evidence owned by this Package Boundary. */
     readonly ciDiagnosticArtifacts?: readonly CiDiagnosticArtifactDeclaration[];
-    /** Requirements prepared only by a focused deployment entrypoint. */
-    readonly deploymentEnvironmentNeeds?: readonly DeploymentEnvironmentNeed[];
 };
 /** Validates the portable executable name promised by a CLI Package Boundary. */
 export declare function validateCliCommandName(commandName: string, occupiedCommandNames?: readonly string[]): string;

package/node_modules/@ykdz/template-core/dist/package-contribution.js

@@ -89,7 +89,7 @@ export function assertPackageContributionCommandNames(contributions) {
             }
             catch (error) {
                 if (existingOwner !== undefined) {
-                    throw new Error(`CLI command name ${JSON.stringify(commandName)} from ${contribution.definition.name} is already used by ${existingOwner}`);
+                    throw new Error(`CLI command name ${JSON.stringify(commandName)} from ${contribution.definition.name} is already used by ${existingOwner}`, { cause: error });
                 }
                 throw error;
             }

package/node_modules/@ykdz/template-core/dist/pnpm-workspace.yaml

@@ -5,7 +5,7 @@ nodeLinker: isolated
 
 autoInstallPeers: false
 
-injectWorkspacePackages: true
+injectWorkspacePackages: false
 
 dedupeInjectedDeps: false
 
@@ -21,7 +21,7 @@ overrides:
   "vue>typescript": "-"
 
 catalog:
-  "@devcontainers/cli": 0.88.0
+  "@devcontainers/cli": 0.89.0
   "@hono/node-server": ^2.0.12
   "@playwright/test": ^1.62.1
   "@tailwindcss/vite": ^4.3.3
@@ -32,32 +32,33 @@ catalog:
   "@vue/devtools-api": ^8.1.5
   "@vue/tsconfig": ^0.9.1
   commander: ^15.0.0
-  drizzle-kit: 1.0.0-rc.4
-  drizzle-orm: 1.0.0-rc.4
+  drizzle-kit: 1.0.0-rc.5-ab785fc
+  drizzle-orm: 1.0.0-rc.5-ab785fc
   execa: ^10.0.1
   hono: ^4.13.3
   node-diff3: ^3.2.1
-  npm: 11.19.1
-  oxfmt: ^0.58.0
+  npm: 12.2.0
+  oxfmt: ^0.71.0
   oxlint: ^1.77.0
   oxlint-tsgolint: ^7.0.2001
   semver: ^7.8.5
   "@types/semver": ^7.7.1
+  smol-toml: ^1.8.0
   spdx-expression-parse: ^5.0.0
   "@types/spdx-expression-parse": ^4.0.0
   pinia: ^4.0.2
-  srvx: ^0.12.5
+  srvx: ^1.0.0
   tailwindcss: ^4.3.3
   tar: ^7.5.22
   telefunc: ^0.2.22
-  turbo: 2.10.11
+  turbo: 2.11.7
   typescript: npm:@typescript/typescript6@^6.0.2
   typescript-7: npm:typescript@^7.0.2
   valibot: ^1.4.2
   vite: ^8.2.0
   vike: ^0.4.260
   vike-vue: ^0.9.12
-  vitest: ^4.1.10
+  vitest: ^5.0.0
   vue: ^3.5.40
   vue-tsc: ^3.3.9
   yaml: ^2.9.0

package/node_modules/@ykdz/template-core/dist/preset-definition.d.ts

@@ -14,6 +14,17 @@ export type GenerationContext = {
     readonly toolchain: {
         readonly nodeLtsMajor: string;
         readonly packageManagerPin: string;
+        /**
+         * 只有确实已知的精确三段 Node 版本才写入：初始化取自 CLI 发版快照，加包取自目标根现行精确声明。
+         * 纯大版本根保持缺省，不从 nodeLtsMajor 伪造 patch；该字段也不是任何版本回退的来源。
+         */
+        readonly nodeVersion?: string;
+        /**
+         * 只有确实已知的 Rust channel 才写入：初始化取自 CLI 发版快照的精确版本，已有 Rust 能力的
+         * 目标仓库在加包时取自其根 rust-toolchain.toml 的现行声明。该字段同样不是版本回退的来源，
+         * 也不进入 Environment Needs 或 Generation Record。
+         */
+        readonly rustVersion?: string;
     };
 };
 /** An in-memory plan tagged with the stable adapter that can replay it. */

package/node_modules/@ykdz/template-core/dist/project-github.d.ts

@@ -47,7 +47,7 @@ export type ProjectCheckWorkflowPlan = {
     readonly packagePaths: readonly string[];
     readonly diagnosticArtifacts: readonly CiDiagnosticArtifactDeclaration[];
 };
-export type DependencyEcosystem = "npm" | "cargo" | "github-actions" | "docker" | "rust-toolchain";
+export type DependencyEcosystem = "npm" | "cargo" | "github-actions" | "docker" | "devcontainers" | "rust-toolchain";
 export type DependabotDirectory = `/${string}`;
 export type DependencyMaintenancePolicy = {
     readonly ecosystems: DependencyEcosystem[];
@@ -61,8 +61,9 @@ export type ProjectCheckWorkflowDiagnosticOptions = {
     readonly diagnosticArtifacts?: readonly unknown[] | undefined;
 };
 type ProjectCheckWorkflowOptions = ProjectCheckWorkflowDiagnosticOptions & {
-    readonly deploymentEnvironmentNeeds?: readonly DeploymentEnvironmentNeed[];
-    readonly hasDeploymentTask?: boolean | undefined;
+    readonly deploymentCheck?: {
+        readonly environmentNeeds: readonly DeploymentEnvironmentNeed[];
+    } | undefined;
     readonly capability?: CiCapability | undefined;
     readonly environmentPreparation?: Partial<CiEnvironmentPreparation> | undefined;
     readonly taskLayer?: PnpmTaskLayer | undefined;
@@ -71,8 +72,9 @@ type ProjectCheckWorkflowOptions = ProjectCheckWorkflowDiagnosticOptions & {
 export declare function projectCheckWorkflowPlan(options: ProjectCheckWorkflowOptions): ProjectCheckWorkflowPlan;
 /** Selects a complete Foundation-owned workflow Template Source. */
 export declare function projectCheckWorkflowTemplateSource(options: ProjectCheckWorkflowDiagnosticOptions & {
-    readonly deploymentEnvironmentNeeds?: readonly DeploymentEnvironmentNeed[];
-    readonly hasDeploymentTask?: boolean | undefined;
+    readonly deploymentCheck?: {
+        readonly environmentNeeds: readonly DeploymentEnvironmentNeed[];
+    } | undefined;
 }): ".github/workflows/check.yml" | ".github/workflows/check-diagnostics.yml" | ".github/workflows/check-deployment.yml" | ".github/workflows/check-deployment-diagnostics.yml";
 /** Limited, validated facts for static Foundation diagnostic staging. */
 export declare function projectCheckWorkflowTemplateReplacements(options: ProjectCheckWorkflowDiagnosticOptions): Record<string, string>;

package/node_modules/@ykdz/template-core/dist/project-github.js

@@ -26,8 +26,8 @@ export function projectCheckWorkflowPlan(options) {
         ...options.environmentPreparation,
     };
     const taskLayer = options.taskLayer ?? pnpmTaskLayer;
-    const hasDeploymentTask = options.hasDeploymentTask === true;
-    const needsDocker = (options.deploymentEnvironmentNeeds ?? []).some((need) => need.kind === "docker-engine");
+    const hasDeploymentTask = options.deploymentCheck !== undefined;
+    const needsDocker = (options.deploymentCheck?.environmentNeeds ?? []).some((need) => need.kind === "docker-engine");
     if (hasDeploymentTask && !needsDocker) {
         throw new Error("Deployment Check requires a Docker environment need");
     }
@@ -74,8 +74,8 @@ export function projectCheckWorkflowPlan(options) {
 }
 /** Selects a complete Foundation-owned workflow Template Source. */
 export function projectCheckWorkflowTemplateSource(options) {
-    const hasDeploymentTask = options.hasDeploymentTask === true;
-    const needsDocker = (options.deploymentEnvironmentNeeds ?? []).some((need) => need.kind === "docker-engine");
+    const hasDeploymentTask = options.deploymentCheck !== undefined;
+    const needsDocker = (options.deploymentCheck?.environmentNeeds ?? []).some((need) => need.kind === "docker-engine");
     if (hasDeploymentTask && !needsDocker) {
         throw new Error("Deployment Check requires a Docker environment need");
     }

package/node_modules/@ykdz/template-core/dist/project-linking-v2.d.ts

@@ -4,8 +4,8 @@ type PackageManifest = Readonly<Record<string, unknown>>;
 export type ExplicitProjectLinkPlan = {
     readonly manifestPatchesByPackagePath: ReadonlyMap<string, {
         readonly dependencies: Readonly<Record<string, "workspace:*">>;
-        readonly dependenciesMeta: Readonly<Record<string, {
-            readonly injected: boolean;
+        readonly dependenciesMeta?: Readonly<Record<string, {
+            readonly injected: true;
         }>>;
     }>;
     /**

package/node_modules/@ykdz/template-core/dist/project-linking-v2.js

@@ -118,16 +118,22 @@ export function planExplicitProjectLinks(options) {
         if (consumerPatch === undefined) {
             manifestPatches.set(intent.consumerPackagePath, {
                 dependencies: { [provider.definition.name]: "workspace:*" },
-                dependenciesMeta: {
-                    [provider.definition.name]: { injected },
-                },
+                ...(injected
+                    ? {
+                        dependenciesMeta: {
+                            [provider.definition.name]: { injected: true },
+                        },
+                    }
+                    : {}),
             });
         }
         else {
             consumerPatch.dependencies[provider.definition.name] = "workspace:*";
-            consumerPatch.dependenciesMeta[provider.definition.name] = {
-                injected,
-            };
+            if (injected) {
+                (consumerPatch.dependenciesMeta ??= {})[provider.definition.name] = {
+                    injected: true,
+                };
+            }
         }
     }
     return {

package/node_modules/@ykdz/template-core/dist/project-projection.d.ts

@@ -28,13 +28,27 @@ export type StructuredIdentitySetPolicy = {
         };
     };
 };
+export type ProjectProjectionMirrorSlotLocation = {
+    readonly kind: "json-pointer";
+    readonly pointer: string;
+} | {
+    readonly kind: "text-anchor";
+    readonly name: string;
+};
+export type ProjectProjectionMirrorSlot = {
+    readonly id: string;
+    readonly location: ProjectProjectionMirrorSlotLocation;
+};
 export type ProjectProjectionReconciliation = {
     readonly path: string;
     readonly driver: "structured";
     readonly identitySets?: readonly StructuredIdentitySetPolicy[];
+    /** planner 拥有的根声明位置，在三向合并之前归一。 */
+    readonly mirrorSlots?: readonly ProjectProjectionMirrorSlot[];
 } | {
     readonly path: string;
     readonly driver: "text";
+    readonly mirrorSlots?: readonly ProjectProjectionMirrorSlot[];
 } | {
     readonly path: string;
     readonly driver: "canonical";
@@ -91,6 +105,19 @@ export type MaterializeProjectProjectionOptions = {
 };
 /** Pure structural preflight for a renderer-facing Project Projection plan. */
 export declare function validateProjectProjectionPlan(options: MaterializeProjectProjectionOptions): readonly string[];
+export type ProjectedMirrorSlotScalar = {
+    readonly ok: true;
+    readonly scalar: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * 有限的槽位读取：把一个 plan 声明的镜像位置在真实投影里解析成恰好一条标量字符串。
+ * Core 只认识通用位置与值形态（合法 JSON、位置存在、值为字符串、锚点区域恰一行），
+ * 不认识具体生成路径、Node/Rust 语义或 ARG 写法；承载行的解释留给 Checks 层。
+ */
+export declare function readProjectedMirrorSlotScalar(entry: ProjectProjectionEntry, location: ProjectProjectionMirrorSlotLocation): ProjectedMirrorSlotScalar;
 export declare function reconcileProjectProjections(options: {
     readonly before: ProjectProjection;
     readonly after: ProjectProjection;