@ykdz/template 0.0.41 → 0.1.0-experimental.0

package/node_modules/@ykdz/template-core/dist/editor-customization.js

@@ -1,73 +0,0 @@
-import { readFileSync } from "node:fs";
-import * as v from "valibot";
-const capabilityProjectionSchema = v.object({
-    extensions: v.array(v.string()),
-    settings: v.record(v.string(), v.unknown()),
-});
-const editorCustomizationDeclarationsSchema = v.object({
-    capabilityOrder: v.array(v.string()),
-    capabilities: v.record(v.string(), capabilityProjectionSchema),
-});
-function editorCustomizationDeclarationIssuePath(issue) {
-    const segments = issue.path?.flatMap((item) => typeof item.key === "string" || typeof item.key === "number"
-        ? [String(item.key)]
-        : []) ?? [];
-    return segments.length === 0 ? "$" : `$.${segments.join(".")}`;
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function editorCustomizationSharedResourceLabel(resourcePath) {
-    return `Editor Customization Shared Resource ${resourcePath}`;
-}
-export function loadEditorCustomizationDeclarations(resourcePath) {
-    const resourceLabel = editorCustomizationSharedResourceLabel(resourcePath);
-    let resourceText;
-    try {
-        resourceText = readFileSync(resourcePath, "utf8");
-    }
-    catch (error) {
-        throw new Error(`${resourceLabel} is unreadable: ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    let source;
-    try {
-        source = JSON.parse(resourceText);
-    }
-    catch (error) {
-        throw new Error(`${resourceLabel} is invalid: invalid JSON: ${errorMessage(error)}`, { cause: error });
-    }
-    const result = v.safeParse(editorCustomizationDeclarationsSchema, source);
-    if (!result.success) {
-        throw new Error(`${resourceLabel} is invalid: ${result.issues
-            .map((issue) => `${editorCustomizationDeclarationIssuePath(issue)}: ${issue.message}`)
-            .join("; ")}`);
-    }
-    return result.output;
-}
-function mergeSettings(base, patch) {
-    return { ...base, ...patch };
-}
-export function editorCustomizationForCapabilities(capabilities, declarations) {
-    const selected = new Set(capabilities);
-    const extensions = new Set();
-    let settings = {};
-    for (const capability of declarations.capabilityOrder) {
-        if (!selected.has(capability)) {
-            continue;
-        }
-        const projection = declarations.capabilities[capability];
-        if (projection === undefined) {
-            throw new Error(`Editor customization policy orders undeclared capability ${capability}`);
-        }
-        for (const extension of projection.extensions) {
-            extensions.add(extension);
-        }
-        settings = mergeSettings(settings, projection.settings);
-    }
-    return {
-        extensions: [...extensions],
-        settings,
-    };
-}

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

@@ -1,62 +0,0 @@
-export type PackageBoundaryOwner = {
-    readonly kind: "package-boundary";
-    readonly path: string;
-};
-export type WorkspaceOrchestrationOwner = {
-    readonly kind: "workspace-orchestration";
-    readonly path: ".";
-};
-export type ComponentOwner = PackageBoundaryOwner | WorkspaceOrchestrationOwner;
-export type PlaywrightBrowserAssetsEnvironmentNeed = {
-    readonly kind: "playwright-browser-assets";
-    readonly browser: "chromium";
-    readonly owner: ComponentOwner;
-};
-export type ShellCheckEnvironmentNeed = {
-    readonly kind: "shellcheck-command";
-    readonly owner: ComponentOwner;
-};
-/** Rust task leaves require the maintained toolchain in local and CI plans. */
-export type RustToolchainEnvironmentNeed = {
-    readonly kind: "rust-toolchain";
-    readonly owner: ComponentOwner;
-    readonly toolchain: "stable";
-};
-/**
- * Docker is needed only by the focused deployment mode. It is deliberately
- * outside ordinary Check Environment Needs, which apply to every
- * generated-check scenario.
- */
-export type DockerEngineEnvironmentNeed = {
-    readonly kind: "docker-engine";
-};
-export type CheckEnvironmentNeed = PlaywrightBrowserAssetsEnvironmentNeed | ShellCheckEnvironmentNeed | RustToolchainEnvironmentNeed;
-export type DeploymentEnvironmentNeed = DockerEngineEnvironmentNeed;
-export type EnvironmentNeedsMetadata = {
-    readonly schemaVersion: 1;
-    readonly check: readonly CheckEnvironmentNeed[];
-    readonly deployment: readonly DeploymentEnvironmentNeed[];
-};
-/** Validates, deduplicates, and canonically orders durable Environment Needs. */
-export declare function normalizeEnvironmentNeeds(options: {
-    readonly check: readonly CheckEnvironmentNeed[];
-    readonly deployment: readonly DeploymentEnvironmentNeed[];
-}): EnvironmentNeedsMetadata;
-/** Strict codec for Local Template Metadata consumed by Package Addition. */
-export declare function parseEnvironmentNeedsMetadata(value: unknown): EnvironmentNeedsMetadata;
-export declare function rustToolchainEnvironmentNeed(owner: ComponentOwner): RustToolchainEnvironmentNeed;
-export declare function dockerEngineEnvironmentNeed(): DockerEngineEnvironmentNeed;
-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;
-    readonly taskPrefix?: boolean;
-}): string;
-export declare function renderRootCheckCommand(additionalTasks?: readonly string[]): string;
-export declare function renderDeploymentCheckCommand(): string;
-export declare function renderFixCommand(): string;
-export declare function playwrightBrowserAssetsEnvironmentNeed(options: {
-    readonly browser: "chromium";
-    readonly owner: ComponentOwner;
-}): PlaywrightBrowserAssetsEnvironmentNeed;
-export declare function shellCheckEnvironmentNeed(owner: ComponentOwner): ShellCheckEnvironmentNeed;

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

@@ -1,207 +0,0 @@
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function assertExactKeys(value, allowedKeys, context) {
-    for (const key of Object.keys(value)) {
-        if (!allowedKeys.includes(key)) {
-            throw new Error(`${context} contains unknown field: ${key}`);
-        }
-    }
-}
-function parseComponentOwner(value, context) {
-    if (!isRecord(value)) {
-        throw new Error(`${context} must be a Component Owner`);
-    }
-    assertExactKeys(value, ["kind", "path"], context);
-    if (value.kind === "workspace-orchestration" && value.path === ".") {
-        return { kind: value.kind, path: value.path };
-    }
-    if (value.kind === "package-boundary" &&
-        typeof value.path === "string" &&
-        value.path.length > 0) {
-        return { kind: value.kind, path: value.path };
-    }
-    throw new Error(`${context} is not a supported Component Owner`);
-}
-function parseCheckEnvironmentNeed(value, context) {
-    if (!isRecord(value)) {
-        throw new Error(`${context} must be a Check Environment Need`);
-    }
-    switch (value.kind) {
-        case "playwright-browser-assets": {
-            assertExactKeys(value, ["kind", "browser", "owner"], context);
-            if (value.browser !== "chromium") {
-                throw new Error(`${context}.browser must be chromium`);
-            }
-            return {
-                kind: value.kind,
-                browser: value.browser,
-                owner: parseComponentOwner(value.owner, `${context}.owner`),
-            };
-        }
-        case "shellcheck-command":
-            assertExactKeys(value, ["kind", "owner"], context);
-            return {
-                kind: value.kind,
-                owner: parseComponentOwner(value.owner, `${context}.owner`),
-            };
-        case "rust-toolchain": {
-            assertExactKeys(value, ["kind", "owner", "toolchain"], context);
-            if (value.toolchain !== "stable") {
-                throw new Error(`${context}.toolchain must be stable`);
-            }
-            return {
-                kind: value.kind,
-                owner: parseComponentOwner(value.owner, `${context}.owner`),
-                toolchain: value.toolchain,
-            };
-        }
-        default:
-            throw new Error(`${context} has unsupported kind: ${String(value.kind)}`);
-    }
-}
-function parseDeploymentEnvironmentNeed(value, context) {
-    if (!isRecord(value)) {
-        throw new Error(`${context} must be a Deployment Environment Need`);
-    }
-    assertExactKeys(value, ["kind"], context);
-    if (value.kind !== "docker-engine") {
-        throw new Error(`${context} has unsupported kind: ${String(value.kind)}`);
-    }
-    return { kind: value.kind };
-}
-function componentOwnerIdentity(owner) {
-    return `${owner.kind}:${owner.path}`;
-}
-function checkEnvironmentNeedConflictKey(need) {
-    return `${need.kind}:${componentOwnerIdentity(need.owner)}`;
-}
-function checkEnvironmentNeedIdentity(need) {
-    switch (need.kind) {
-        case "playwright-browser-assets":
-            return `${checkEnvironmentNeedConflictKey(need)}:browser=${need.browser}`;
-        case "shellcheck-command":
-            return checkEnvironmentNeedConflictKey(need);
-        case "rust-toolchain":
-            return `${checkEnvironmentNeedConflictKey(need)}:toolchain=${need.toolchain}`;
-    }
-}
-function normalizeCheckEnvironmentNeeds(needs) {
-    const byIdentity = new Map();
-    const identityByConflictKey = new Map();
-    for (const [index, input] of needs.entries()) {
-        const need = parseCheckEnvironmentNeed(input, `check[${index}]`);
-        const identity = checkEnvironmentNeedIdentity(need);
-        const conflictKey = checkEnvironmentNeedConflictKey(need);
-        const previousIdentity = identityByConflictKey.get(conflictKey);
-        if (previousIdentity !== undefined && previousIdentity !== identity) {
-            throw new Error(`Check Environment Need ${conflictKey} has conflicting semantic parameters`);
-        }
-        identityByConflictKey.set(conflictKey, identity);
-        byIdentity.set(identity, need);
-    }
-    return [...byIdentity]
-        .toSorted(([left], [right]) => left.localeCompare(right))
-        .map(([, need]) => need);
-}
-function normalizeDeploymentEnvironmentNeeds(needs) {
-    const byIdentity = new Map();
-    for (const [index, input] of needs.entries()) {
-        const need = parseDeploymentEnvironmentNeed(input, `deployment[${index}]`);
-        byIdentity.set(need.kind, need);
-    }
-    return [...byIdentity]
-        .toSorted(([left], [right]) => left.localeCompare(right))
-        .map(([, need]) => need);
-}
-/** Validates, deduplicates, and canonically orders durable Environment Needs. */
-export function normalizeEnvironmentNeeds(options) {
-    return {
-        schemaVersion: 1,
-        check: normalizeCheckEnvironmentNeeds(options.check),
-        deployment: normalizeDeploymentEnvironmentNeeds(options.deployment),
-    };
-}
-/** Strict codec for Local Template Metadata consumed by Package Addition. */
-export function parseEnvironmentNeedsMetadata(value) {
-    if (!isRecord(value)) {
-        throw new Error("Environment Need metadata must be an object");
-    }
-    assertExactKeys(value, ["schemaVersion", "check", "deployment"], "$");
-    if (value.schemaVersion !== 1) {
-        throw new Error(`Unsupported Environment Need metadata schema version ${String(value.schemaVersion)}; expected 1`);
-    }
-    if (!Array.isArray(value.check)) {
-        throw new Error("$.check must be an array");
-    }
-    if (!Array.isArray(value.deployment)) {
-        throw new Error("$.deployment must be an array");
-    }
-    return normalizeEnvironmentNeeds({
-        check: value.check,
-        deployment: value.deployment,
-    });
-}
-export function rustToolchainEnvironmentNeed(owner) {
-    return {
-        kind: "rust-toolchain",
-        owner,
-        toolchain: "stable",
-    };
-}
-export function dockerEngineEnvironmentNeed() {
-    return { kind: "docker-engine" };
-}
-export const qualityTaskVocabulary = [
-    "format:check",
-    "lint",
-    "typecheck",
-    "build",
-    "test",
-    "test:e2e",
-];
-export function renderTurboRunCommand(taskNames, args = [], options = {}) {
-    return [
-        "turbo run",
-        ...taskNames,
-        ...args,
-        ...(options.continueAfterFailure
-            ? ["--continue=dependencies-successful"]
-            : []),
-        `--output-logs=${options.outputLogs ?? "errors-only"}`,
-        "--log-order=grouped",
-        ...(options.taskPrefix ? ["--log-prefix=task"] : []),
-    ].join(" ");
-}
-export function renderRootCheckCommand(additionalTasks = []) {
-    return [
-        "pnpm run boundaries",
-        renderTurboRunCommand([...qualityTaskVocabulary, ...additionalTasks], [], {
-            continueAfterFailure: true,
-            taskPrefix: true,
-        }),
-    ].join(" && ");
-}
-export function renderDeploymentCheckCommand() {
-    return renderTurboRunCommand(["deployment"], [], { taskPrefix: true });
-}
-export function renderFixCommand() {
-    return renderTurboRunCommand(["lint:fix", "format:write"], [], {
-        continueAfterFailure: true,
-        outputLogs: "full",
-        taskPrefix: true,
-    });
-}
-export function playwrightBrowserAssetsEnvironmentNeed(options) {
-    return {
-        kind: "playwright-browser-assets",
-        browser: options.browser,
-        owner: options.owner,
-    };
-}
-export function shellCheckEnvironmentNeed(owner) {
-    return {
-        kind: "shellcheck-command",
-        owner,
-    };
-}

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

@@ -1,72 +0,0 @@
-packages:
-  - packages/*
-
-nodeLinker: isolated
-
-autoInstallPeers: false
-
-injectWorkspacePackages: false
-
-dedupeInjectedDeps: false
-
-syncInjectedDepsAfterScripts:
-  - build
-
-minimumReleaseAge: 1440
-
-minimumReleaseAgeStrict: true
-
-overrides:
-  "pinia>typescript": "-"
-  "vue>typescript": "-"
-
-catalog:
-  "@ykdz/cli-contract": 0.2.1
-  "@valibot/to-json-schema": ^1.8.0
-  "@devcontainers/cli": 0.89.0
-  "@hono/node-server": ^2.0.12
-  "@playwright/test": 1.64.0
-  "@tailwindcss/vite": ^4.3.3
-  "@types/node": ^24.13.3
-  "@types/web-bluetooth": ^0.0.21
-  "@vitejs/plugin-vue": ^6.0.8
-  "@vikejs/hono": ^0.2.1
-  "@vue/devtools-api": ^8.1.5
-  "@vue/tsconfig": ^0.9.1
-  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: 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: ^1.0.0
-  tailwindcss: ^4.3.3
-  tar: ^7.5.22
-  telefunc: ^0.2.22
-  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: ^5.0.0
-  vue: ^3.5.40
-  vue-tsc: ^3.3.9
-  yaml: ^2.9.0
-
-catalogs:
-  public-cli-runtime:
-    typescript: npm:typescript@^6.0.3
-
-allowBuilds:
-  esbuild: true

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

@@ -1,25 +0,0 @@
-import type { DeploymentEnvironmentNeed } from "./module-graph.ts";
-export type DependencyEcosystem = "npm" | "cargo" | "github-actions" | "docker" | "devcontainers" | "rust-toolchain";
-export type DependabotDirectory = `/${string}`;
-export type DependencyMaintenancePolicy = {
-    readonly ecosystems: DependencyEcosystem[];
-    readonly directories?: Partial<Record<DependencyEcosystem, DependabotDirectory>>;
-    readonly extraDirectories?: Partial<Record<DependencyEcosystem, readonly DependabotDirectory[]>>;
-    readonly interval: "weekly";
-};
-export type ProjectCheckWorkflowDiagnosticOptions = {
-    /** Package Paths from the real Project Blueprint or Package Contributions. */
-    readonly packagePaths: readonly string[];
-    readonly diagnosticArtifacts?: readonly unknown[] | undefined;
-};
-/** Selects a complete Foundation-owned workflow Template Source. */
-export declare function projectCheckWorkflowTemplateSource(options: ProjectCheckWorkflowDiagnosticOptions & {
-    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>;
-export declare function projectDependabotConfig(policy: DependencyMaintenancePolicy): string;
-/** Limited substitution for the Foundation-owned Dependabot Template Source. */
-export declare function projectDependabotTemplateReplacements(policy: DependencyMaintenancePolicy): Record<string, string>;

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

@@ -1,84 +0,0 @@
-import { composeCiDiagnosticArtifacts, } from "./ci-diagnostic-artifact.js";
-function validatedDiagnosticArtifacts(options) {
-    return composeCiDiagnosticArtifacts({
-        packagePaths: options.packagePaths,
-        declarations: options.artifacts,
-    });
-}
-/** Selects a complete Foundation-owned workflow Template Source. */
-export function projectCheckWorkflowTemplateSource(options) {
-    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");
-    }
-    const hasDiagnostics = validatedDiagnosticArtifacts({
-        packagePaths: options.packagePaths,
-        artifacts: options.diagnosticArtifacts ?? [],
-    }).length > 0;
-    if (hasDeploymentTask) {
-        return hasDiagnostics
-            ? ".github/workflows/check-deployment-diagnostics.yml"
-            : ".github/workflows/check-deployment.yml";
-    }
-    return hasDiagnostics
-        ? ".github/workflows/check-diagnostics.yml"
-        : ".github/workflows/check.yml";
-}
-/** Limited, validated facts for static Foundation diagnostic staging. */
-export function projectCheckWorkflowTemplateReplacements(options) {
-    const declarations = validatedDiagnosticArtifacts({
-        packagePaths: options.packagePaths,
-        artifacts: options.diagnosticArtifacts ?? [],
-    });
-    if (declarations.length === 0)
-        return {};
-    return {
-        DIAGNOSTIC_OWNER_PATHS: declarations
-            .map((declaration) => declaration.owner.path)
-            .join("\n            "),
-    };
-}
-export function projectDependabotConfig(policy) {
-    return [
-        "version: 2",
-        "",
-        "updates:",
-        ...policy.ecosystems.flatMap((ecosystem) => [
-            policy.directories?.[ecosystem] ??
-                defaultDependabotDirectory(ecosystem),
-            ...(policy.extraDirectories?.[ecosystem] ?? []),
-        ].flatMap((directory) => renderDependabotUpdate(ecosystem, directory, policy.interval))),
-        "",
-    ].join("\n");
-}
-/** Limited substitution for the Foundation-owned Dependabot Template Source. */
-export function projectDependabotTemplateReplacements(policy) {
-    const header = "version: 2\n\nupdates:\n";
-    const configuration = projectDependabotConfig(policy);
-    if (!configuration.startsWith(header)) {
-        throw new Error("Dependabot configuration must retain its Template Source header");
-    }
-    return { DEPENDABOT_UPDATES: configuration.slice(header.length).trimEnd() };
-}
-function renderDependabotUpdate(ecosystem, directory, interval) {
-    const lines = [
-        `  - package-ecosystem: ${ecosystem}`,
-        `    directory: ${renderDependabotDirectory(ecosystem, directory)}`,
-        "    schedule:",
-        `      interval: ${interval}`,
-    ];
-    if (ecosystem === "npm") {
-        lines.push("    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");
-    }
-    if (ecosystem === "docker" && directory === "/.devcontainer") {
-        lines.push("    ignore:", "      - dependency-name: mcr.microsoft.com/devcontainers/typescript-node", "        update-types:", "          - version-update:semver-major");
-    }
-    return lines;
-}
-function renderDependabotDirectory(ecosystem, directory) {
-    return ecosystem === "cargo" ? JSON.stringify(directory) : directory;
-}
-function defaultDependabotDirectory(ecosystem) {
-    return ecosystem === "docker" ? "/.devcontainer" : "/";
-}

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

@@ -1,31 +0,0 @@
-import type { PackageContribution } from "./package-contribution.ts";
-import { type PackageRole, type ProjectBlueprint } from "./project-blueprint.ts";
-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: true;
-        }>>;
-    }>;
-    /**
-     * Build ordering follows the same explicit package relationships as manifest
-     * dependencies. Turbo resolves ^build through the derived workspace
-     * dependency rather than through Preset or framework vocabulary.
-     */
-    readonly hasBuildOrdering: boolean;
-};
-export declare function canConsumeNodePackageNameImport(contribution: PackageContribution, manifest?: PackageManifest): boolean;
-export declare function canLinkNodePackageRoles(consumerRole: PackageRole, providerRole: PackageRole): boolean;
-export declare function canProvideSourceConditionPackageNameImport(contribution: PackageContribution, manifest?: PackageManifest): boolean;
-/**
- * Resolves durable Link Intents from Package Contributions, optionally using
- * Current Manifest Truth for a follow-up decision. No Preset identity or
- * string resource protocol is involved.
- */
-export declare function planExplicitProjectLinks(options: {
-    readonly blueprint: ProjectBlueprint;
-    readonly contributions: readonly PackageContribution[];
-    readonly manifestTruthByPackagePath?: ReadonlyMap<string, PackageManifest>;
-}): ExplicitProjectLinkPlan;
-export {};