@ykdz/template 0.0.42 → 0.1.0-experimental.1

package/node_modules/@ykdz/template-generator/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ykdz/template-generator",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./content-source": {
+      "source": "./src/content-source.ts",
+      "types": "./dist/content-source.d.ts",
+      "default": "./dist/content-source.js"
+    }
+  },
+  "dependencies": {
+    "@ykdz/template-core": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "oxfmt": "^0.71.0",
+    "oxlint": "^1.77.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "typescript-7": "npm:typescript@^7.0.2"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "format:check": "oxfmt --list-different .",
+    "format:write": "oxfmt --write .",
+    "lint": "oxlint --quiet --format=unix --ignore-pattern dist .",
+    "lint:fix": "oxlint --format=unix --ignore-pattern dist . --fix",
+    "test": "node --conditions=source --experimental-strip-types --test --test-concurrency=2 --test-timeout=60000 'test/**/*.light.test.ts'",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false",
+    "test:integration": "node --test --test-concurrency=1 --test-timeout=300000 'test/**/*.integration.test.ts'"
+  }
+}

package/node_modules/@ykdz/template-workspace/assets/environment/devcontainer/workspace-template.json

@@ -0,0 +1,16 @@
+{
+  "name": "Template workspace",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "args": {}
+  },
+  "features": {
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": ["oxc.oxc-vscode"]
+    }
+  },
+  "mounts": []
+}

package/node_modules/@ykdz/template-workspace/assets/github/check.yml

@@ -0,0 +1,83 @@
+name: Check
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    name: Full Check
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+          fetch-depth: 1
+      - name: Set up Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version-file: package.json
+      - name: Set up pnpm
+        uses: pnpm/action-setup@d9184bf108216479bc5a137cc391f4d7b14c870b # v6.1.0
+        with:
+          cache: true
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Run Light Check
+        run: node --conditions=source scripts/task-gates.ts check
+      - name: Run Heavy Check
+        id: run-heavy-check
+        run: node --conditions=source scripts/task-gates.ts check:heavy
+      - name: Stage Check diagnostics
+        id: stage-diagnostics
+        if: failure()
+        env:
+          PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS: |-
+            apps/web
+          VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS: |-
+            apps/web
+        run: |
+          rm -rf .template-ci-diagnostics
+          mkdir -p .template-ci-diagnostics
+          printf '%s\n' "$PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
+            for diagnostic_directory in test-results playwright-report; do
+              source_path="$owner_path/$diagnostic_directory"
+              destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
+              if [ -d "$source_path" ]; then
+                mkdir -p "$(dirname "$destination_path")"
+                cp -R "$source_path" "$destination_path"
+              fi
+            done
+          done
+          printf '%s\n' "$VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
+            diagnostic_directory=".vitest/attachments/failure-screenshots"
+            source_path="$owner_path/$diagnostic_directory"
+            destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
+            if [ -d "$source_path" ]; then
+              mkdir -p "$(dirname "$destination_path")"
+              cp -R "$source_path" "$destination_path"
+            fi
+          done
+      - name: Upload Check diagnostics
+        id: upload-diagnostics
+        if: failure()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: check-diagnostics
+          path: .template-ci-diagnostics
+          include-hidden-files: true
+          if-no-files-found: ignore
+          retention-days: 7

package/node_modules/@ykdz/template-workspace/assets/github/dependabot.yml

@@ -0,0 +1,49 @@
+version: 2
+
+updates:
+  - package-ecosystem: devcontainers
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      drizzle:
+        patterns:
+          - "drizzle-*"
+          - "drizzle-orm"
+    ignore:
+      - dependency-name: "@types/node"
+        update-types:
+          - version-update:semver-major
+      - dependency-name: "pnpm"
+        update-types:
+          - version-update:semver-major
+          - version-update:semver-minor
+          - version-update:semver-patch
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: docker
+    directory: /.devcontainer
+    schedule:
+      interval: weekly
+    ignore:
+      - dependency-name: mcr.microsoft.com/devcontainers/typescript-node
+        update-types:
+          - version-update:semver-major
+  - package-ecosystem: cargo
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: rust-toolchain
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: docker
+    directory: /
+    schedule:
+      interval: weekly

package/node_modules/@ykdz/template-workspace/assets/next-steps.md

@@ -0,0 +1,3 @@
+# 后续操作
+
+在仓库根目录运行以下命令：

package/node_modules/@ykdz/template-workspace/assets/tsconfig.config.json

@@ -0,0 +1,6 @@
+{
+  "extends": "@ykdz/reference-tooling-config/node.json",
+  "compilerOptions": {
+    "types": ["node"]
+  }
+}

package/node_modules/@ykdz/template-workspace/assets/turbo.json

@@ -0,0 +1,64 @@
+{
+  "boundaries": {
+    "tags": {
+      "app": {
+        "dependencies": {
+          "allow": ["app", "library"]
+        }
+      },
+      "library": {
+        "dependencies": {
+          "allow": ["library"]
+        }
+      }
+    }
+  },
+  "globalPassThroughEnv": ["CARGO_HOME", "RUSTUP_HOME", "RUSTUP_TOOLCHAIN"],
+  "globalDependencies": ["oxfmt.config.ts", "oxlint.config.ts"],
+  "tasks": {
+    "//#boundaries": {
+      "tags": ["quality:light"]
+    },
+    "//#check": {
+      "tags": ["quality:entry"]
+    },
+    "//#check:full": {
+      "tags": ["quality:entry"]
+    },
+    "//#check:heavy": {
+      "tags": ["quality:entry"]
+    },
+    "//#dev": {
+      "tags": ["work:development"]
+    },
+    "//#fix": {
+      "tags": ["work:repair"]
+    },
+    "//#format:check": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "//#format:write": {
+      "cache": false,
+      "dependsOn": ["//#lint:fix"],
+      "tags": ["work:repair"]
+    },
+    "//#lint": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "//#lint:fix": {
+      "cache": false,
+      "tags": ["work:repair"]
+    },
+
+    "//#toolchain:prepare": {
+      "cache": false,
+      "tags": ["work:preparation"]
+    },
+    "//#typecheck": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    }
+  }
+}

package/node_modules/@ykdz/template-workspace/dist/application-requirements.d.ts

@@ -0,0 +1,14 @@
+import type { DependencyMaintenancePolicy } from "./project-requirements.ts";
+import type { SharedRootContribution } from "./shared-root-files.ts";
+type DependencyMaintenanceContribution = {
+    readonly foundation: {
+        readonly dependencyMaintenance: DependencyMaintenancePolicy;
+    };
+};
+type RootDependencyMaintenanceContribution = Pick<SharedRootContribution, "dependencyMaintenance">;
+export type { DependencyMaintenancePolicy };
+/** 合并包及根文件拥有者的依赖维护声明。 */
+export declare function projectDependencyMaintenancePolicy(options: {
+    readonly contributions: readonly DependencyMaintenanceContribution[];
+    readonly rootContributions: readonly RootDependencyMaintenanceContribution[];
+}): DependencyMaintenancePolicy;

package/node_modules/@ykdz/template-workspace/dist/application-requirements.js

@@ -0,0 +1,42 @@
+/** 合并包及根文件拥有者的依赖维护声明。 */
+export function projectDependencyMaintenancePolicy(options) {
+    const policies = [
+        ...options.contributions.map((contribution) => contribution.foundation.dependencyMaintenance),
+        ...options.rootContributions.flatMap((contribution) => contribution.dependencyMaintenance === undefined
+            ? []
+            : [contribution.dependencyMaintenance]),
+    ];
+    const ecosystems = [
+        ...new Set([
+            "devcontainers",
+            ...policies.flatMap((policy) => policy.ecosystems),
+        ]),
+    ];
+    const directories = {};
+    const extraDirectories = {};
+    for (const ecosystem of ecosystems) {
+        const candidates = [
+            ...new Set([
+                ...(ecosystem === "docker" ? ["/.devcontainer"] : []),
+                ...policies.flatMap((policy) => {
+                    const primary = policy.directories?.[ecosystem];
+                    return [
+                        ...(primary === undefined ? [] : [primary]),
+                        ...(policy.extraDirectories?.[ecosystem] ?? []),
+                    ];
+                }),
+            ]),
+        ];
+        const [primary, ...extra] = candidates;
+        if (primary !== undefined)
+            directories[ecosystem] = primary;
+        if (extra.length > 0)
+            extraDirectories[ecosystem] = extra;
+    }
+    return {
+        ecosystems,
+        ...(Object.keys(directories).length === 0 ? {} : { directories }),
+        ...(Object.keys(extraDirectories).length === 0 ? {} : { extraDirectories }),
+        interval: "weekly",
+    };
+}

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

@@ -0,0 +1,17 @@
+import type { ComponentOwner } from "./environment-needs.ts";
+/** 包贡献可在 CI 中保留的封闭式、按所有者限定的原生诊断制品。 */
+export type CiDiagnosticArtifactDeclaration = {
+    readonly kind: "playwright" | "vitest-browser";
+    readonly owner: ComponentOwner;
+};
+/**
+ * 校验封闭式诊断声明。声明不接收路径，原生路径只能在确定所有者后派生。
+ */
+export declare function assertCiDiagnosticArtifactDeclaration(value: unknown): CiDiagnosticArtifactDeclaration;
+/**
+ * 独立于预设与环境准备来合成封闭式原生诊断。同一声明按所有者稳定排序后合并。
+ */
+export declare function composeCiDiagnosticArtifacts(options: {
+    readonly packagePaths: readonly string[];
+    readonly declarations: readonly unknown[];
+}): readonly CiDiagnosticArtifactDeclaration[];

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

@@ -0,0 +1,74 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExactKeys(value, keys) {
+    const actual = Object.keys(value).toSorted();
+    const expected = [...keys].toSorted();
+    return (actual.length === expected.length &&
+        actual.every((key, index) => key === expected[index]));
+}
+const reservedWorkspaceCollections = new Set([
+    ".git",
+    ".github",
+    ".devcontainer",
+    ".template",
+    "node_modules",
+    "dist",
+    "target",
+]);
+function isSafePackagePath(value) {
+    return (/^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/u.test(value) &&
+        !reservedWorkspaceCollections.has(value.split("/", 1)[0]));
+}
+/**
+ * 校验封闭式诊断声明。声明不接收路径，原生路径只能在确定所有者后派生。
+ */
+export function assertCiDiagnosticArtifactDeclaration(value) {
+    if (!isRecord(value) || !hasExactKeys(value, ["kind", "owner"])) {
+        throw new Error("CI 诊断制品声明只能包含 kind 和 owner");
+    }
+    if (value.kind !== "playwright" && value.kind !== "vitest-browser") {
+        throw new Error("不支持的 CI 诊断制品 kind");
+    }
+    if (!isRecord(value.owner) || !hasExactKeys(value.owner, ["kind", "path"])) {
+        throw new Error("CI 诊断制品必须声明包边界所有者");
+    }
+    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 诊断制品所有者的包边界路径不安全");
+    }
+    return {
+        kind: value.kind,
+        owner: value.owner.kind === "workspace-orchestration"
+            ? { kind: "workspace-orchestration", path: "." }
+            : { kind: "package-boundary", path: value.owner.path },
+    };
+}
+/**
+ * 独立于预设与环境准备来合成封闭式原生诊断。同一声明按所有者稳定排序后合并。
+ */
+export function composeCiDiagnosticArtifacts(options) {
+    for (const packagePath of options.packagePaths) {
+        if (!isSafePackagePath(packagePath)) {
+            throw new Error(`CI 诊断制品包边界路径不安全：${packagePath}`);
+        }
+    }
+    const owners = new Set(options.packagePaths);
+    const artifacts = new Map();
+    for (const value of options.declarations) {
+        const declaration = assertCiDiagnosticArtifactDeclaration(value);
+        if (declaration.owner.kind === "package-boundary" &&
+            !owners.has(declaration.owner.path)) {
+            throw new Error(`CI 诊断制品所有者不是已声明的包边界：${declaration.owner.path}`);
+        }
+        const key = `${declaration.kind}:${declaration.owner.path}`;
+        artifacts.set(key, declaration);
+    }
+    return [...artifacts.values()].toSorted((left, right) => {
+        const ownerOrder = left.owner.path.localeCompare(right.owner.path);
+        return ownerOrder === 0 ? left.kind.localeCompare(right.kind) : ownerOrder;
+    });
+}

package/node_modules/@ykdz/template-workspace/dist/default-environment-sources.d.ts

@@ -0,0 +1,5 @@
+export declare const environmentSources: {
+    base: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    devcontainer: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    editorCustomization: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+};

package/node_modules/@ykdz/template-workspace/dist/default-environment-sources.js

@@ -0,0 +1,8 @@
+import { fileURLToPath } from "node:url";
+import { createTemplateSourceHandle } from "@ykdz/template-core/renderer";
+const source = (name) => createTemplateSourceHandle(fileURLToPath(new URL(name === "." ? "../assets/" : `../assets/${name}`, import.meta.url)));
+export const environmentSources = {
+    base: source("environment"),
+    devcontainer: source("environment/devcontainer"),
+    editorCustomization: source("environment/editor-customization"),
+};

package/node_modules/@ykdz/template-workspace/dist/default-environment.d.ts

@@ -0,0 +1,9 @@
+export { assertCiDiagnosticArtifactDeclaration, composeCiDiagnosticArtifacts, } from "./ci-diagnostic-artifact.ts";
+export type { CiDiagnosticArtifactDeclaration } from "./ci-diagnostic-artifact.ts";
+export { browserTestDevelopmentContainerToolLayer } from "./development-container.ts";
+export { githubCliDevelopmentContainerToolLayer, prepareBuiltInDevelopmentContainerResources, prepareBuiltInEditorCustomizationDeclarations, projectBuiltInDevelopmentContainer, projectBuiltInEditorCustomization, rustDevelopmentContainerToolLayer, shellCheckDevelopmentContainerToolLayer, } from "./development-environment.ts";
+export type { PreparedBuiltInDevelopmentContainerResources } from "./development-environment.ts";
+export { editorCustomizationForCapabilities, loadEditorCustomizationDeclarations, } from "./editor-customization.ts";
+export type { EditorCustomization, EditorCustomizationCapability, EditorCustomizationDeclarations, } from "./editor-customization.ts";
+export { dockerEngineEnvironmentNeed, normalizeEnvironmentNeeds, parseEnvironmentNeedsMetadata, playwrightBrowserAssetsEnvironmentNeed, rustToolchainEnvironmentNeed, shellCheckEnvironmentNeed, } from "./environment-needs.ts";
+export type { CheckEnvironmentNeed, ComponentOwner, DeploymentEnvironmentNeed, EnvironmentNeedsMetadata, PackageBoundaryOwner, PlaywrightBrowserAssetsEnvironmentNeed, RustToolchainEnvironmentNeed, ShellCheckEnvironmentNeed, WorkspaceOrchestrationOwner, } from "./environment-needs.ts";

package/node_modules/@ykdz/template-workspace/dist/default-environment.js

@@ -0,0 +1,5 @@
+export { assertCiDiagnosticArtifactDeclaration, composeCiDiagnosticArtifacts, } from "./ci-diagnostic-artifact.js";
+export { browserTestDevelopmentContainerToolLayer } from "./development-container.js";
+export { githubCliDevelopmentContainerToolLayer, prepareBuiltInDevelopmentContainerResources, prepareBuiltInEditorCustomizationDeclarations, projectBuiltInDevelopmentContainer, projectBuiltInEditorCustomization, rustDevelopmentContainerToolLayer, shellCheckDevelopmentContainerToolLayer, } from "./development-environment.js";
+export { editorCustomizationForCapabilities, loadEditorCustomizationDeclarations, } from "./editor-customization.js";
+export { dockerEngineEnvironmentNeed, normalizeEnvironmentNeeds, parseEnvironmentNeedsMetadata, playwrightBrowserAssetsEnvironmentNeed, rustToolchainEnvironmentNeed, shellCheckEnvironmentNeed, } from "./environment-needs.js";

package/node_modules/@ykdz/template-workspace/dist/default-package-identity.d.ts

@@ -0,0 +1,19 @@
+import { type BlueprintValidationResult, type PackageDefinition, type ProjectBlueprint, type ProjectBlueprintDraft } from "@ykdz/template-core/project-blueprint";
+export type DefaultPackagePathValidation = {
+    readonly hasValidShape: boolean;
+    readonly reservedWorkspaceCollection?: string;
+};
+/** 默认策略用来校验新 npm 包名的事实。 */
+export declare function isValidDefaultNpmPackageName(value: string): boolean;
+/** 默认工作区 scope 的 npm 身份片段规则。 */
+export declare function isValidDefaultPackageScope(value: string): boolean;
+/** 默认工作区包采用两段目录，并保留工作区工具目录。 */
+export declare function validateDefaultPackagePath(value: string): DefaultPackagePathValidation;
+/** 验证默认策略持久化蓝图的 npm 命名、角色与目录合同。 */
+export declare function validateDefaultProjectBlueprint(value: unknown): BlueprintValidationResult;
+/** 验证默认策略在分配持久化实例标识前的包拓扑。 */
+export declare function assertDefaultProjectBlueprintDraft(value: ProjectBlueprintDraft): ProjectBlueprintDraft;
+/** 验证默认策略已经持久化的蓝图。 */
+export declare function assertDefaultProjectBlueprint(value: unknown): ProjectBlueprint;
+/** 在默认策略创建实例时校验其角色、npm 名称和目录。 */
+export declare function assertDefaultPackageDefinition(definition: PackageDefinition): PackageDefinition;

package/node_modules/@ykdz/template-workspace/dist/default-package-identity.js

@@ -0,0 +1,128 @@
+import { isBuiltin } from "node:module";
+import { assertProjectBlueprintDraft, validateProjectBlueprint, } from "@ykdz/template-core/project-blueprint";
+import { defaultPackageRoles, isDefaultPackageRole, } from "./default-package-role.js";
+const defaultPackagePath = /^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/u;
+const reservedWorkspaceCollections = new Set([
+    ".git",
+    ".github",
+    ".devcontainer",
+    ".template",
+    "node_modules",
+    "dist",
+    "target",
+]);
+const reservedPackageNames = new Set(["node_modules", "favicon.ico"]);
+const defaultPackageScope = /^[a-z0-9][a-z0-9._-]*$/u;
+/** 默认策略用来校验新 npm 包名的事实。 */
+export function isValidDefaultNpmPackageName(value) {
+    if (value.length === 0 ||
+        value.length > 214 ||
+        value !== value.trim() ||
+        value !== value.toLowerCase() ||
+        value === "." ||
+        value === ".." ||
+        reservedPackageNames.has(value) ||
+        isBuiltin(value)) {
+        return false;
+    }
+    const scopedMatch = /^@([^/]+)\/([^/]+)$/.exec(value);
+    if (value.startsWith("@") && scopedMatch === null)
+        return false;
+    const scope = scopedMatch?.[1];
+    const leaf = scopedMatch?.[2] ?? value;
+    if (scope === undefined && /^[._-]/.test(leaf)) {
+        return false;
+    }
+    if (scope !== undefined && leaf.startsWith(".")) {
+        return false;
+    }
+    if (/[~'!()*]/.test(leaf))
+        return false;
+    return (encodeURIComponent(leaf) === leaf &&
+        (scope === undefined || encodeURIComponent(scope) === scope));
+}
+/** 默认工作区 scope 的 npm 身份片段规则。 */
+export function isValidDefaultPackageScope(value) {
+    return defaultPackageScope.test(value);
+}
+/** 默认工作区包采用两段目录，并保留工作区工具目录。 */
+export function validateDefaultPackagePath(value) {
+    const workspaceCollection = value.split("/", 1)[0];
+    return {
+        hasValidShape: defaultPackagePath.test(value),
+        ...(reservedWorkspaceCollections.has(workspaceCollection)
+            ? { reservedWorkspaceCollection: workspaceCollection }
+            : {}),
+    };
+}
+function defaultPackageIssues(definition, index) {
+    const itemPath = `.packages[${index}]`;
+    const issues = [];
+    if (!isDefaultPackageRole(definition.role)) {
+        const supportedRoles = `${defaultPackageRoles
+            .slice(0, -1)
+            .join(", ")}, or ${defaultPackageRoles.at(-1)}`;
+        issues.push({
+            path: `${itemPath}.role`,
+            message: `Package Role must be ${supportedRoles}`,
+        });
+    }
+    if (!isValidDefaultNpmPackageName(definition.name)) {
+        issues.push({
+            path: `${itemPath}.name`,
+            message: "Package name must be a valid npm package name for new packages",
+        });
+    }
+    const pathValidation = validateDefaultPackagePath(definition.path);
+    if (pathValidation.reservedWorkspaceCollection !== undefined) {
+        issues.push({
+            path: `${itemPath}.path`,
+            message: `Package Path ${definition.path} uses reserved workspace collection ${pathValidation.reservedWorkspaceCollection}`,
+        });
+    }
+    else if (!pathValidation.hasValidShape) {
+        issues.push({
+            path: `${itemPath}.path`,
+            message: "Package Path must be exactly two safe path segments",
+        });
+    }
+    return issues;
+}
+function defaultBlueprintIssues(blueprint) {
+    return blueprint.packages.flatMap(defaultPackageIssues);
+}
+/** 验证默认策略持久化蓝图的 npm 命名、角色与目录合同。 */
+export function validateDefaultProjectBlueprint(value) {
+    const result = validateProjectBlueprint(value);
+    if (!result.ok)
+        return result;
+    const issues = defaultBlueprintIssues(result.value);
+    return issues.length === 0 ? result : { ok: false, issues };
+}
+/** 验证默认策略在分配持久化实例标识前的包拓扑。 */
+export function assertDefaultProjectBlueprintDraft(value) {
+    const blueprint = assertProjectBlueprintDraft(value);
+    const issues = defaultBlueprintIssues(blueprint);
+    if (issues.length > 0) {
+        throw new Error(issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n"));
+    }
+    return blueprint;
+}
+/** 验证默认策略已经持久化的蓝图。 */
+export function assertDefaultProjectBlueprint(value) {
+    const result = validateDefaultProjectBlueprint(value);
+    if (!result.ok) {
+        throw new Error(result.issues
+            .map((issue) => `${issue.path}: ${issue.message}`)
+            .join("\n"));
+    }
+    return result.value;
+}
+/** 在默认策略创建实例时校验其角色、npm 名称和目录。 */
+export function assertDefaultPackageDefinition(definition) {
+    const issues = defaultPackageIssues(definition, 0);
+    if (issues.length > 0) {
+        throw new Error(issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n"));
+    }
+    return definition;
+}

package/node_modules/@ykdz/template-workspace/dist/default-package-role.d.ts

@@ -0,0 +1,4 @@
+export declare const defaultPackageRoles: readonly ["cli-tool", "runtime-service", "shared-library", "native-package"];
+/** 默认 Node/Rust 工作区策略公开给参考包作者的角色合同。 */
+export type DefaultPackageRole = (typeof defaultPackageRoles)[number];
+export declare function isDefaultPackageRole(value: string): value is DefaultPackageRole;

package/node_modules/@ykdz/template-workspace/dist/default-package-role.js

@@ -0,0 +1,9 @@
+export const defaultPackageRoles = [
+    "cli-tool",
+    "runtime-service",
+    "shared-library",
+    "native-package",
+];
+export function isDefaultPackageRole(value) {
+    return defaultPackageRoles.includes(value);
+}