@baseplate-dev/project-builder-lib 0.5.3 → 0.6.1

package/dist/parser/definition-issue-utils.js

@@ -0,0 +1,33 @@
+/**
+ * Resolves a definition issue's path to an absolute path in the definition.
+ *
+ * If the issue is scoped to an entity, combines the entity's path with the
+ * issue's relative path. If no entity, returns the path as-is.
+ */
+export function resolveIssuePath(issue, container) {
+    if (!issue.entityId)
+        return issue.path;
+    const entity = container.entityFromId(issue.entityId);
+    if (!entity)
+        return issue.path;
+    return [...entity.path, ...issue.path];
+}
+/**
+ * Creates a definition issue scoped to a specific entity.
+ *
+ * Validates that the entity exists in the container and returns an issue
+ * with the entity ID and a relative path from the entity root.
+ *
+ * @param container - The project definition container
+ * @param entityId - The entity ID to scope the issue to
+ * @param relativePath - Path relative to the entity
+ * @param issue - The issue message, severity, and optional fix
+ */
+export function createEntityIssue(container, entityId, relativePath, issue) {
+    const entity = container.entityFromId(entityId);
+    if (!entity) {
+        throw new Error(`Entity not found: ${entityId}`);
+    }
+    return { ...issue, entityId, path: relativePath };
+}
+//# sourceMappingURL=definition-issue-utils.js.map

package/dist/parser/definition-issue-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-issue-utils.js","sourceRoot":"","sources":["../../src/parser/definition-issue-utils.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,SAAqC;IAErC,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC/B,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAqC,EACrC,QAAgB,EAChB,YAA2B,EAC3B,KAA4D;IAE5D,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC"}

package/dist/parser/index.d.ts

@@ -1,3 +1,12 @@
+export { applyDefinitionFixes } from './apply-definition-fixes.js';
+export { cleanDefaultValues } from './clean-default-values.js';
+export { collectDefinitionIssues, collectFieldIssues, partitionIssuesBySeverity, } from './collect-definition-issues.js';
+export type { PartitionedIssues } from './collect-definition-issues.js';
+export { collectExpressionIssues } from './collect-expression-issues.js';
+export { createEntityIssue, resolveIssuePath, } from './definition-issue-utils.js';
 export * from './parser.js';
+export { findDiscriminatedUnionMatch } from './schema-structure.js';
+export { transformDataWithSchema } from './transform-data-with-schema.js';
 export type * from './types.js';
+export { walkDataWithSchema } from './walk-data-with-schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/parser/index.js

@@ -1,2 +1,10 @@
+export { applyDefinitionFixes } from './apply-definition-fixes.js';
+export { cleanDefaultValues } from './clean-default-values.js';
+export { collectDefinitionIssues, collectFieldIssues, partitionIssuesBySeverity, } from './collect-definition-issues.js';
+export { collectExpressionIssues } from './collect-expression-issues.js';
+export { createEntityIssue, resolveIssuePath, } from './definition-issue-utils.js';
 export * from './parser.js';
+export { findDiscriminatedUnionMatch } from './schema-structure.js';
+export { transformDataWithSchema } from './transform-data-with-schema.js';
+export { walkDataWithSchema } from './walk-data-with-schema.js';
 //# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/parser/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAW3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,OAAO,GACzB,eAAe,CAwBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,EAAE,EAClC,iBAAiB,EAAE,iBAAiB,GACnC,eAAe,CAsBjB;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,uBAAuB,CAOzB;AAED,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,iBAAiB,CAMnB;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B;IACD,UAAU,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IACrD,WAAW,EAAE,eAAe,CAAC;CAC9B,CASA"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAW3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,OAAO,GACzB,eAAe,CAyBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,uBAAuB,EAAE,EAClC,iBAAiB,EAAE,iBAAiB,GACnC,eAAe,CAsBjB;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,uBAAuB,CAOzB;AAED,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,iBAAiB,CAMnB;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,mBAAmB,GAC3B;IACD,UAAU,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IACrD,WAAW,EAAE,eAAe,CAAC;CAC9B,CAYA"}

package/dist/parser/parser.js

@@ -32,7 +32,8 @@ export function createPluginSpecStore(pluginStore, projectDefinition) {
             module: m.module,
         }));
     });
-    return initializePlugins([...modulesWithKey, ...coreModules]);
+    const pluginKeys = plugins.map((p) => pluginEntityType.keyFromId(p.id));
+    return initializePlugins([...modulesWithKey, ...coreModules], pluginKeys);
 }
 /**
  * Creates a plugin implementation store with the given plugins added to the project definition.
@@ -89,7 +90,11 @@ export function parseProjectDefinitionWithContext(projectDefinition, context) {
 export function parseProjectDefinitionWithReferences(projectDefinition, context) {
     const { pluginStore } = context;
     const pluginSpecStore = createPluginSpecStore(pluginStore, projectDefinition);
-    const definition = parseSchemaWithTransformedReferences(createProjectDefinitionSchema, projectDefinition, { plugins: pluginSpecStore });
+    const definitionContext = createDefinitionSchemaParserContext({
+        plugins: pluginSpecStore,
+    });
+    const schema = createProjectDefinitionSchema(definitionContext);
+    const definition = parseSchemaWithTransformedReferences(schema, projectDefinition);
     return { definition, pluginStore: pluginSpecStore };
 }
 //# sourceMappingURL=parser.js.map

package/dist/parser/parser.js.map

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

package/dist/parser/schema-structure.d.ts

@@ -0,0 +1,53 @@
+import type { z } from 'zod';
+import type { ReferencePath } from '#src/references/types.js';
+export type SchemaChildren = {
+    readonly kind: 'leaf';
+} | {
+    readonly kind: 'leaf-union';
+} | {
+    readonly kind: 'wrapper';
+    readonly innerSchema: z.ZodType;
+    readonly skipIfNullish: boolean;
+} | {
+    readonly kind: 'object';
+    readonly entries: readonly (readonly [string, z.ZodType])[];
+} | {
+    readonly kind: 'array';
+    readonly elementSchema: z.ZodType;
+} | {
+    readonly kind: 'tuple';
+    readonly items: readonly z.ZodType[];
+    readonly rest: z.ZodType | null;
+} | {
+    readonly kind: 'record';
+    readonly valueSchema: z.ZodType;
+} | {
+    readonly kind: 'intersection';
+    readonly left: z.ZodType;
+    readonly right: z.ZodType;
+} | {
+    readonly kind: 'discriminated-union';
+    readonly match: z.ZodType | undefined;
+};
+/**
+ * Given a list of discriminated union options, finds the branch whose
+ * discriminator literal includes the value found at `data[discriminator]`.
+ *
+ * Returns `undefined` if:
+ * - `data` is not a plain object or doesn't contain the discriminator key
+ * - no option matches the discriminator value in the data
+ *
+ * Throws if any option is not a ZodObject or its discriminator field is not a literal schema.
+ */
+export declare function findDiscriminatedUnionMatch(options: z.ZodType[], discriminator: string, data: unknown): z.ZodType | undefined;
+/**
+ * Classifies a Zod schema node and returns a descriptor of its child schemas.
+ *
+ * This is the single source of truth for schema structure traversal.
+ * Both `walkDataWithSchema` and `transformDataWithSchema` delegate here
+ * instead of duplicating the exhaustive type switch.
+ *
+ * Throws for unsupported schema types (transform, pipe, custom, etc.).
+ */
+export declare function getSchemaChildren(schema: z.ZodType, data: unknown, path: ReferencePath): SchemaChildren;
+//# sourceMappingURL=schema-structure.d.ts.map

package/dist/parser/schema-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-structure.d.ts","sourceRoot":"","sources":["../../src/parser/schema-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,CAAC,EAaF,MAAM,KAAK,CAAC;AAEb,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM9D,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;CAC7D,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAA;CAAE,GAC7D;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;CACjC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAA;CAAE,GAC5D;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;CACvC,CAAC;AAiBN;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EACpB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,OAAO,GACZ,CAAC,CAAC,OAAO,GAAG,SAAS,CA8BvB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,aAAa,GAClB,cAAc,CAuHhB"}

package/dist/parser/schema-structure.js

@@ -0,0 +1,171 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Leaf types that are allowed in a plain `z.union()` without a discriminator. */
+const LEAF_UNION_TYPES = new Set(['string', 'enum', 'literal']);
+/**
+ * Returns `true` if every option in the union is a leaf type
+ * (string, enum, or literal), meaning no structural descent is needed.
+ */
+function isLeafUnion(options) {
+    return options.every((opt) => LEAF_UNION_TYPES.has(opt._zod.def.type));
+}
+/**
+ * Given a list of discriminated union options, finds the branch whose
+ * discriminator literal includes the value found at `data[discriminator]`.
+ *
+ * Returns `undefined` if:
+ * - `data` is not a plain object or doesn't contain the discriminator key
+ * - no option matches the discriminator value in the data
+ *
+ * Throws if any option is not a ZodObject or its discriminator field is not a literal schema.
+ */
+export function findDiscriminatedUnionMatch(options, discriminator, data) {
+    if (data === null ||
+        data === undefined ||
+        typeof data !== 'object' ||
+        !(discriminator in data)) {
+        return undefined;
+    }
+    const discValue = data[discriminator];
+    for (const option of options) {
+        if (option._zod.def.type !== 'object') {
+            throw new Error(`findDiscriminatedUnionMatch: discriminated union option must be an object schema (got type: "${option._zod.def.type}")`);
+        }
+        const { shape } = option;
+        const discField = shape[discriminator];
+        if (discField?._zod.def.type !== 'literal') {
+            throw new Error(`findDiscriminatedUnionMatch: discriminator field "${discriminator}" must be a literal schema on each union option`);
+        }
+        const { values } = discField._zod.def;
+        if (values.includes(discValue)) {
+            return option;
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// getSchemaChildren — single exhaustive type switch
+// ---------------------------------------------------------------------------
+/**
+ * Classifies a Zod schema node and returns a descriptor of its child schemas.
+ *
+ * This is the single source of truth for schema structure traversal.
+ * Both `walkDataWithSchema` and `transformDataWithSchema` delegate here
+ * instead of duplicating the exhaustive type switch.
+ *
+ * Throws for unsupported schema types (transform, pipe, custom, etc.).
+ */
+export function getSchemaChildren(schema, data, path) {
+    const { type } = schema._zod.def;
+    switch (type) {
+        case 'object': {
+            const typed = schema;
+            return {
+                kind: 'object',
+                entries: Object.entries(typed.shape),
+            };
+        }
+        case 'array': {
+            const typed = schema;
+            return {
+                kind: 'array',
+                elementSchema: typed.element,
+            };
+        }
+        case 'optional':
+        case 'nullable':
+        case 'nonoptional':
+        case 'readonly': {
+            const innerSchema = schema.unwrap();
+            return { kind: 'wrapper', innerSchema, skipIfNullish: true };
+        }
+        case 'default':
+        case 'prefault': {
+            // Default/prefault wrappers always descend regardless of data value.
+            // Both support `.unwrap()` to access the inner schema.
+            const innerSchema = schema.unwrap();
+            return { kind: 'wrapper', innerSchema, skipIfNullish: false };
+        }
+        case 'union': {
+            const typed = schema;
+            const options = typed.options;
+            // discriminator has no public API — must use internal access
+            const { discriminator } = typed._zod.def;
+            if (discriminator) {
+                const match = findDiscriminatedUnionMatch(options, discriminator, data);
+                return { kind: 'discriminated-union', match };
+            }
+            if (isLeafUnion(options)) {
+                return { kind: 'leaf-union' };
+            }
+            throw new Error(`Plain z.union() is not supported unless all options are string/enum/literal (path: ${path.join('.')})`);
+        }
+        case 'tuple': {
+            // items/rest have no public API on ZodTuple — must use internal access
+            const typed = schema;
+            return {
+                kind: 'tuple',
+                items: typed._zod.def.items,
+                rest: typed._zod.def.rest ?? null,
+            };
+        }
+        case 'record': {
+            const typed = schema;
+            return {
+                kind: 'record',
+                valueSchema: typed.valueType,
+            };
+        }
+        case 'intersection': {
+            // left/right have no public API on ZodIntersection — must use internal access
+            const typed = schema;
+            return {
+                kind: 'intersection',
+                left: typed._zod.def.left,
+                right: typed._zod.def.right,
+            };
+        }
+        // Opaque / non-structural types are not supported in definition schemas.
+        case 'transform':
+        case 'pipe':
+        case 'custom':
+        case 'file':
+        case 'symbol':
+        case 'promise':
+        case 'function':
+        case 'bigint':
+        case 'void':
+        case 'nan':
+        case 'lazy':
+        case 'catch':
+        case 'map':
+        case 'set':
+        case 'success':
+        case 'template_literal': {
+            throw new Error(`Schema type "${type}" is not supported in definition schemas (path: ${path.join('.')})`);
+        }
+        // Serializable leaf types — no structural descent needed.
+        case 'string':
+        case 'number':
+        case 'int':
+        case 'boolean':
+        case 'null':
+        case 'undefined':
+        case 'never':
+        case 'any':
+        case 'unknown':
+        case 'date':
+        case 'enum':
+        case 'literal': {
+            return { kind: 'leaf' };
+        }
+        default: {
+            // Exhaustive guard: if Zod adds a new type, this will fail to compile.
+            const _exhaustiveCheck = type;
+            void _exhaustiveCheck;
+            return { kind: 'leaf' };
+        }
+    }
+}
+//# sourceMappingURL=schema-structure.js.map

package/dist/parser/schema-structure.js.map

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

package/dist/parser/transform-data-with-schema.d.ts

@@ -0,0 +1,35 @@
+import type { z } from 'zod';
+import type { ReferencePath } from '#src/references/types.js';
+/**
+ * Context passed to the transform callback at each schema node.
+ */
+interface SchemaTransformContext {
+    /** The absolute path to the current node in the data. */
+    readonly path: ReferencePath;
+    /** The Zod schema at this node. */
+    readonly schema: z.ZodType;
+}
+/**
+ * A transform function called at each schema node after children have
+ * already been transformed. Returns the (possibly new) value for this node.
+ * Return the input value unchanged to signal "no change".
+ *
+ * Returning `undefined` signals that the value should be removed (for object
+ * keys) or kept in place (for array elements).
+ */
+export type SchemaTransformFn = (value: unknown, ctx: SchemaTransformContext) => unknown;
+/**
+ * Walks a Zod schema in parallel with data, applying a transform function
+ * bottom-up. Children are transformed first, then the parent transform
+ * sees the already-transformed children.
+ *
+ * Returns a new data tree with transformations applied. Preserves object
+ * references when no changes occur in a subtree (structural sharing).
+ *
+ * Transform semantics for `undefined` returns:
+ * - Object keys: the key is omitted from the result
+ * - Array elements: `undefined` is kept in place (indices must be preserved)
+ */
+export declare function transformDataWithSchema<T>(schema: z.ZodType, data: T, transform: SchemaTransformFn): T;
+export {};
+//# sourceMappingURL=transform-data-with-schema.d.ts.map

package/dist/parser/transform-data-with-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-data-with-schema.d.ts","sourceRoot":"","sources":["../../src/parser/transform-data-with-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D;;GAEG;AACH,UAAU,sBAAsB;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,sBAAsB,KACxB,OAAO,CAAC;AAEb;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,iBAAiB,GAC3B,CAAC,CAEH"}

package/dist/parser/transform-data-with-schema.js

@@ -0,0 +1,140 @@
+import { getSchemaChildren } from './schema-structure.js';
+/**
+ * Walks a Zod schema in parallel with data, applying a transform function
+ * bottom-up. Children are transformed first, then the parent transform
+ * sees the already-transformed children.
+ *
+ * Returns a new data tree with transformations applied. Preserves object
+ * references when no changes occur in a subtree (structural sharing).
+ *
+ * Transform semantics for `undefined` returns:
+ * - Object keys: the key is omitted from the result
+ * - Array elements: `undefined` is kept in place (indices must be preserved)
+ */
+export function transformDataWithSchema(schema, data, transform) {
+    return transformNode(schema, data, [], transform);
+}
+function transformNode(schema, data, path, transform) {
+    // Step 1: Structural descent — recurse into children first (bottom-up).
+    let childResult = data;
+    const children = getSchemaChildren(schema, data, path);
+    switch (children.kind) {
+        case 'leaf': {
+            break;
+        }
+        case 'leaf-union': {
+            break;
+        }
+        case 'wrapper': {
+            if (children.skipIfNullish && (data === undefined || data === null))
+                break;
+            childResult = transformNode(children.innerSchema, data, path, transform);
+            break;
+        }
+        case 'object': {
+            if (data === null || data === undefined || typeof data !== 'object')
+                break;
+            const obj = data;
+            let changed = false;
+            const entries = [];
+            for (const [key, fieldSchema] of children.entries) {
+                const original = obj[key];
+                const transformed = transformNode(fieldSchema, original, [...path, key], transform);
+                if (transformed !== original)
+                    changed = true;
+                entries.push([key, transformed]);
+            }
+            if (changed) {
+                // Spread original first to preserve keys not in schema shape,
+                // then overlay transformed entries.
+                const result = { ...obj };
+                for (const [key, value] of entries) {
+                    if (value === undefined) {
+                        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+                        delete result[key];
+                    }
+                    else {
+                        result[key] = value;
+                    }
+                }
+                childResult = result;
+            }
+            break;
+        }
+        case 'array': {
+            if (!Array.isArray(data))
+                break;
+            let changed = false;
+            const items = [];
+            for (const [i, datum] of data.entries()) {
+                const transformed = transformNode(children.elementSchema, datum, [...path, i], transform);
+                if (transformed !== datum)
+                    changed = true;
+                items.push(transformed);
+            }
+            if (changed) {
+                childResult = items;
+            }
+            break;
+        }
+        case 'tuple': {
+            if (!Array.isArray(data))
+                break;
+            let changed = false;
+            const resultItems = [];
+            for (const [i, itemSchema] of children.items.entries()) {
+                if (i < data.length) {
+                    const transformed = transformNode(itemSchema, data[i], [...path, i], transform);
+                    if (transformed !== data[i])
+                        changed = true;
+                    resultItems.push(transformed);
+                }
+            }
+            // Transform rest elements if the tuple has a rest schema
+            if (children.rest) {
+                for (let i = children.items.length; i < data.length; i++) {
+                    const transformed = transformNode(children.rest, data[i], [...path, i], transform);
+                    if (transformed !== data[i])
+                        changed = true;
+                    resultItems.push(transformed);
+                }
+            }
+            if (changed) {
+                childResult = resultItems;
+            }
+            break;
+        }
+        case 'record': {
+            if (data === null || data === undefined || typeof data !== 'object')
+                break;
+            const obj = data;
+            let changed = false;
+            const entries = [];
+            for (const [key, value] of Object.entries(obj)) {
+                const transformed = transformNode(children.valueSchema, value, [...path, key], transform);
+                if (transformed !== value)
+                    changed = true;
+                entries.push([key, transformed]);
+            }
+            if (changed) {
+                childResult = Object.fromEntries(entries.filter(([, v]) => v !== undefined));
+            }
+            break;
+        }
+        case 'discriminated-union': {
+            if (children.match) {
+                childResult = transformNode(children.match, data, path, transform);
+            }
+            break;
+        }
+        case 'intersection': {
+            // Transform left first, then transform the result via right
+            const leftResult = transformNode(children.left, data, path, transform);
+            childResult = transformNode(children.right, leftResult, path, transform);
+            break;
+        }
+    }
+    // Step 2: Apply transform to the (already-transformed) child result.
+    return transform(childResult, { path, schema });
+}
+//# sourceMappingURL=transform-data-with-schema.js.map

package/dist/parser/transform-data-with-schema.js.map

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

package/dist/parser/types.d.ts

@@ -1,13 +1,16 @@
 import type { PluginStore } from '#src/plugins/imports/types.js';
+export type ProjectType = 'user' | 'example' | 'test';
 export interface ProjectInfo {
     /** A deterministic ID for the project based off the directory. */
     id: string;
     /** The name of the project. */
     name: string;
-    /** The directory of the project. */
+    /** The directory of the project output. */
     directory: string;
-    /** Whether the project is an internal example project. */
-    isInternalExample: boolean;
+    /** The type of the project. */
+    type: ProjectType;
+    /** The baseplate directory containing project-definition.json and snapshots. */
+    baseplateDirectory: string;
 }
 /**
  * The context available to the schema parser, including the plugin store.

package/dist/parser/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/parser/walk-data-with-schema.d.ts

@@ -0,0 +1,46 @@
+import type { z } from 'zod';
+import type { ReferencePath } from '#src/references/types.js';
+/**
+ * The context passed to visitors during a schema walk.
+ * Carries the current path and entity context.
+ */
+export interface SchemaWalkContext {
+    /** The absolute path to the current node in the data. */
+    readonly path: ReferencePath;
+    /** The entity ID of the closest ancestor entity (undefined at root level). */
+    readonly entityId: string | undefined;
+    /** Path relative to the closest ancestor entity (or absolute if at root). */
+    readonly entityRelativePath: ReferencePath;
+}
+/**
+ * A visitor that plugs into `walkDataWithSchema`.
+ *
+ * Called for every node in the schema tree. The visitor receives the schema
+ * instance and can call its own registry internally. If the visitor returns a
+ * cleanup function, it will be called after all children have been visited —
+ * similar to the React `useEffect` cleanup pattern.
+ */
+export interface SchemaNodeVisitor {
+    visit(schema: z.ZodType, data: unknown, ctx: SchemaWalkContext): (() => void) | undefined;
+}
+/**
+ * Walks a Zod schema structure in parallel with parsed data, invoking
+ * registered visitors whenever schema nodes are encountered.
+ *
+ * Each visitor's `visit()` is called for every node. If it returns a cleanup
+ * function, that function is called after all children have been visited —
+ * similar to the React `useEffect` cleanup pattern.
+ *
+ * The walker is entity-aware: it detects entity boundaries via
+ * `definitionRefRegistry` annotations and tracks the current entity ID and
+ * relative path, exposing them through `SchemaWalkContext`.
+ *
+ * Only serializable, structurally-traversable schema types are supported.
+ * Non-serializable types (transform, custom, file, symbol, promise, function,
+ * lazy, etc.) will throw at walk time.
+ *
+ * Discriminated unions are fully supported. Plain `z.union()` is allowed only
+ * when every option is a leaf type (string, enum, or literal); otherwise it throws.
+ */
+export declare function walkDataWithSchema(schema: z.ZodType, data: unknown, visitors: readonly SchemaNodeVisitor[]): void;
+//# sourceMappingURL=walk-data-with-schema.d.ts.map

package/dist/parser/walk-data-with-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-data-with-schema.d.ts","sourceRoot":"","sources":["../../src/parser/walk-data-with-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CACH,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,iBAAiB,GACrB,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7B;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GACrC,IAAI,CAMN"}