@ztothez/design-engineering 2.0.0

package/dist/src/design-plan/schema.d.ts

@@ -0,0 +1,202 @@
+import { z } from "zod";
+export declare const designPlanTraceSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        standard: "standard";
+        assumption: "assumption";
+        brief: "brief";
+    }>;
+    reference: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+export declare const downstreamContractResultSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "information-design": "information-design";
+        "product-task": "product-task";
+        "interface-trust": "interface-trust";
+        "design-deliverable": "design-deliverable";
+    }>;
+    declaration: z.ZodEnum<{
+        "not-applicable": "not-applicable";
+        planned: "planned";
+        exists: "exists";
+    }>;
+    validation: z.ZodEnum<{
+        "not-applicable": "not-applicable";
+        invalid: "invalid";
+        validated: "validated";
+        planned: "planned";
+    }>;
+    source: z.ZodOptional<z.ZodString>;
+    passed: z.ZodBoolean;
+    findings: z.ZodNumber;
+    reason: z.ZodString;
+    traceRefs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const designPlanSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    compilerVersion: z.ZodString;
+    id: z.ZodString;
+    product: z.ZodString;
+    sourceBrief: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+        file: z.ZodString;
+        digest: z.ZodString;
+        generationReady: z.ZodBoolean;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        ready: "ready";
+        blocked: "blocked";
+        provisional: "provisional";
+    }>;
+    planningReady: z.ZodBoolean;
+    implementationReady: z.ZodBoolean;
+    traces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            standard: "standard";
+            assumption: "assumption";
+            brief: "brief";
+        }>;
+        reference: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>;
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            confirmed: "confirmed";
+            provisional: "provisional";
+        }>;
+        statement: z.ZodString;
+        rationale: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    informationArchitecture: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        order: z.ZodNumber;
+        label: z.ZodString;
+        purpose: z.ZodString;
+        contentRefs: z.ZodArray<z.ZodString>;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    routes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        taskRef: z.ZodString;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            confirmed: "confirmed";
+            provisional: "provisional";
+        }>;
+        purpose: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    components: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        taskRef: z.ZodString;
+        boundary: z.ZodString;
+        responsibility: z.ZodString;
+        ownsState: z.ZodArray<z.ZodString>;
+        inputs: z.ZodArray<z.ZodString>;
+        outputs: z.ZodArray<z.ZodString>;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    stateOwnership: z.ZodArray<z.ZodObject<{
+        state: z.ZodString;
+        taskRefs: z.ZodArray<z.ZodString>;
+        ownerComponentRef: z.ZodString;
+        behavior: z.ZodString;
+        recovery: z.ZodString;
+        disclosure: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    contracts: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "information-design": "information-design";
+            "product-task": "product-task";
+            "interface-trust": "interface-trust";
+            "design-deliverable": "design-deliverable";
+        }>;
+        declaration: z.ZodEnum<{
+            "not-applicable": "not-applicable";
+            planned: "planned";
+            exists: "exists";
+        }>;
+        validation: z.ZodEnum<{
+            "not-applicable": "not-applicable";
+            invalid: "invalid";
+            validated: "validated";
+            planned: "planned";
+        }>;
+        source: z.ZodOptional<z.ZodString>;
+        passed: z.ZodBoolean;
+        findings: z.ZodNumber;
+        reason: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    tokenRequirements: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            color: "color";
+            shape: "shape";
+            typography: "typography";
+            motion: "motion";
+            spacing: "spacing";
+            "data-visualization": "data-visualization";
+        }>;
+        roles: z.ZodArray<z.ZodString>;
+        rule: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    responsiveBehavior: z.ZodArray<z.ZodObject<{
+        platformRef: z.ZodString;
+        viewports: z.ZodArray<z.ZodNumber>;
+        inputModes: z.ZodArray<z.ZodString>;
+        rules: z.ZodArray<z.ZodString>;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    assets: z.ZodObject<{
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            confirmed: "confirmed";
+            provisional: "provisional";
+        }>;
+        requirements: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            purpose: z.ZodString;
+            rightsRequired: z.ZodBoolean;
+            alternativesRequired: z.ZodBoolean;
+            traceRefs: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        rule: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    implementationStages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        order: z.ZodNumber;
+        name: z.ZodString;
+        exitCondition: z.ZodString;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            confirmed: "confirmed";
+            provisional: "provisional";
+        }>;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    verificationObligations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        acceptanceCriterionRef: z.ZodString;
+        taskRefs: z.ZodArray<z.ZodString>;
+        method: z.ZodString;
+        blocking: z.ZodBoolean;
+        expectedEvidence: z.ZodString;
+        traceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    blockers: z.ZodArray<z.ZodString>;
+    limitations: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type DesignPlan = z.infer<typeof designPlanSchema>;
+export type DesignPlanTrace = z.infer<typeof designPlanTraceSchema>;
+export type DownstreamContractResult = z.infer<typeof downstreamContractResultSchema>;

package/dist/src/design-plan/schema.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+const idSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,127}$/);
+const text = z.string().trim().min(1).max(2_048);
+const traceRefs = z.array(idSchema).min(1).max(100);
+const decisionStatusSchema = z.enum(["confirmed", "provisional", "blocked"]);
+export const designPlanTraceSchema = z
+    .object({
+    id: idSchema,
+    kind: z.enum(["brief", "standard", "assumption"]),
+    reference: text,
+    description: text,
+})
+    .strict();
+const tracedDecisionSchema = z
+    .object({
+    id: idSchema,
+    status: decisionStatusSchema,
+    statement: text,
+    rationale: text,
+    traceRefs,
+})
+    .strict();
+export const downstreamContractResultSchema = z
+    .object({
+    kind: z.enum(["product-task", "interface-trust", "information-design", "design-deliverable"]),
+    declaration: z.enum(["planned", "exists", "not-applicable"]),
+    validation: z.enum(["planned", "validated", "invalid", "not-applicable"]),
+    source: z.string().max(1_024).optional(),
+    passed: z.boolean(),
+    findings: z.number().int().nonnegative(),
+    reason: text,
+    traceRefs,
+})
+    .strict();
+export const designPlanSchema = z
+    .object({
+    version: z.literal("1.0"),
+    compilerVersion: z.string().regex(/^\d+\.\d+\.\d+$/),
+    id: idSchema,
+    product: text,
+    sourceBrief: z
+        .object({
+        id: idSchema,
+        version: z.literal("1.0"),
+        file: text,
+        digest: z.string().regex(/^[a-f0-9]{64}$/),
+        generationReady: z.boolean(),
+    })
+        .strict(),
+    status: z.enum(["blocked", "provisional", "ready"]),
+    planningReady: z.boolean(),
+    implementationReady: z.boolean(),
+    traces: z.array(designPlanTraceSchema).min(1).max(10_000),
+    decisions: z.array(tracedDecisionSchema).min(1).max(10_000),
+    informationArchitecture: z.array(z.object({ id: idSchema, order: z.number().int().min(1), label: text, purpose: text, contentRefs: z.array(text).min(1), traceRefs }).strict()).min(1),
+    routes: z.array(z.object({ id: idSchema, path: z.string().regex(/^\/[a-z0-9/-]*$/), taskRef: idSchema, status: decisionStatusSchema, purpose: text, traceRefs }).strict()).min(1),
+    components: z.array(z.object({ id: idSchema, taskRef: idSchema, boundary: text, responsibility: text, ownsState: z.array(z.string()).max(20), inputs: z.array(text).max(30), outputs: z.array(text).max(30), traceRefs }).strict()).min(1),
+    stateOwnership: z.array(z.object({ state: z.string(), taskRefs: z.array(idSchema).min(1), ownerComponentRef: idSchema, behavior: text, recovery: text, disclosure: text, traceRefs }).strict()).min(1),
+    contracts: z.array(downstreamContractResultSchema).length(4),
+    tokenRequirements: z.array(z.object({ id: idSchema, category: z.enum(["color", "typography", "spacing", "shape", "motion", "data-visualization"]), roles: z.array(text).min(1), rule: text, traceRefs }).strict()).min(1),
+    responsiveBehavior: z.array(z.object({ platformRef: idSchema, viewports: z.array(z.number().int().min(240)).min(1), inputModes: z.array(z.string()).min(1), rules: z.array(text).min(1), traceRefs }).strict()).min(1),
+    assets: z
+        .object({
+        status: decisionStatusSchema,
+        requirements: z.array(z.object({ id: idSchema, purpose: text, rightsRequired: z.boolean(), alternativesRequired: z.boolean(), traceRefs }).strict()),
+        rule: text,
+        traceRefs,
+    })
+        .strict(),
+    implementationStages: z.array(z.object({ id: idSchema, order: z.number().int().min(1), name: text, exitCondition: text, status: decisionStatusSchema, traceRefs }).strict()).min(1),
+    verificationObligations: z.array(z.object({ id: idSchema, acceptanceCriterionRef: idSchema, taskRefs: z.array(idSchema).min(1), method: z.string(), blocking: z.boolean(), expectedEvidence: text, traceRefs }).strict()).min(1),
+    blockers: z.array(text),
+    limitations: z.array(text).min(1),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/src/design-plan/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/design-plan/schema.ts"],"names":[],"mappings":"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"}

package/dist/src/generation/loader.d.ts

@@ -0,0 +1,2 @@
+import { type DesignPlan } from "../design-plan/schema.js";
+export declare function loadDesignPlan(path: string): Promise<DesignPlan>;

package/dist/src/generation/loader.js

@@ -0,0 +1,21 @@
+import { readFile, stat } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { parse } from "yaml";
+import { designPlanSchema } from "../design-plan/schema.js";
+const MAX_PLAN_BYTES = 8 * 1024 * 1024;
+export async function loadDesignPlan(path) {
+    const resolvedPath = resolve(path);
+    if (!/^\.(?:json|ya?ml)$/i.test(extname(resolvedPath))) {
+        throw new Error("Design plans must end in .json, .yaml, or .yml");
+    }
+    const fileStats = await stat(resolvedPath);
+    if (!fileStats.isFile())
+        throw new Error("Design plan path is not a regular file");
+    if (fileStats.size > MAX_PLAN_BYTES) {
+        throw new Error(`Design plan exceeds ${MAX_PLAN_BYTES} bytes`);
+    }
+    const content = await readFile(resolvedPath, "utf8");
+    const parsed = extname(resolvedPath).toLowerCase() === ".json" ? JSON.parse(content) : parse(content);
+    return designPlanSchema.parse(parsed);
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/generation/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/generation/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAE7E,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACnF,IAAI,SAAS,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uBAAuB,cAAc,QAAQ,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,MAAM,GAAY,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/G,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/generation/policy.d.ts

@@ -0,0 +1,12 @@
+export type GenerationTargetOptions = {
+    generationRoot: string;
+    outputDirectory: string;
+    portfolioRegistryPath: string;
+};
+export type AuthorizedGenerationTarget = {
+    generationRoot: string;
+    outputDirectory: string;
+    outputParent: string;
+    portableTarget: string;
+};
+export declare function authorizeGenerationTarget(options: GenerationTargetOptions): Promise<AuthorizedGenerationTarget>;

package/dist/src/generation/policy.js

@@ -0,0 +1,62 @@
+import { lstat, realpath, stat } from "node:fs/promises";
+import { basename, dirname, isAbsolute, relative, resolve } from "node:path";
+import { isContained, portablePath } from "../portfolio/files.js";
+import { inspectPortfolioRegistry } from "../portfolio/registry.js";
+function pathsOverlap(left, right) {
+    return isContained(left, right) || isContained(right, left);
+}
+async function requireRealDirectory(path, label) {
+    const lexical = resolve(path);
+    const lexicalStats = await lstat(lexical);
+    if (lexicalStats.isSymbolicLink())
+        throw new Error(`${label} cannot be a symbolic link`);
+    const canonical = await realpath(lexical);
+    if (!(await stat(canonical)).isDirectory())
+        throw new Error(`${label} must be a directory`);
+    return canonical;
+}
+export async function authorizeGenerationTarget(options) {
+    if (!options.portfolioRegistryPath.trim()) {
+        throw new Error("A portfolio registry is required before generation");
+    }
+    const generationRoot = await requireRealDirectory(options.generationRoot, "Generation root");
+    const requestedOutput = resolve(options.outputDirectory);
+    if (requestedOutput === generationRoot || !isContained(generationRoot, requestedOutput)) {
+        throw new Error("Output must be a child of the authorized generation root");
+    }
+    try {
+        await lstat(requestedOutput);
+        throw new Error("Output must not already exist; this adapter creates new fixtures only");
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+            throw error;
+    }
+    const outputParent = await requireRealDirectory(dirname(requestedOutput), "Output parent");
+    if (!isContained(generationRoot, outputParent)) {
+        throw new Error("Output parent resolves outside the authorized generation root");
+    }
+    const outputDirectory = resolve(outputParent, basename(requestedOutput));
+    if (!isContained(generationRoot, outputDirectory)) {
+        throw new Error("Output resolves outside the authorized generation root");
+    }
+    const registryPath = resolve(options.portfolioRegistryPath);
+    if (!isAbsolute(registryPath))
+        throw new Error("Portfolio registry resolution failed");
+    const inspection = await inspectPortfolioRegistry(registryPath);
+    if (!inspection.registry || !inspection.report.passed) {
+        throw new Error("Portfolio registry must pass validation before generation");
+    }
+    for (const root of inspection.roots) {
+        if (pathsOverlap(root.canonicalPath, generationRoot) || pathsOverlap(root.canonicalPath, outputDirectory)) {
+            throw new Error(`Generation target overlaps read-only portfolio root ${root.declaration.id}`);
+        }
+    }
+    return {
+        generationRoot,
+        outputDirectory,
+        outputParent,
+        portableTarget: portablePath(relative(generationRoot, outputDirectory)),
+    };
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/generation/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/generation/policy.ts"],"names":[],"mappings":"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"}

package/dist/src/generation/react-typescript.d.ts

@@ -0,0 +1,6 @@
+import type { DesignPlan } from "../design-plan/schema.js";
+import { type GenerationTargetOptions } from "./policy.js";
+import { type GenerationReport } from "./schema.js";
+export declare const REACT_TYPESCRIPT_ADAPTER_VERSION = "1.2.1";
+export type GenerateReactTypescriptOptions = GenerationTargetOptions;
+export declare function generateReactTypescriptFixture(plan: DesignPlan, options: GenerateReactTypescriptOptions): Promise<GenerationReport>;