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

package/dist/schema/creator/definition-issue-registry.d.ts

@@ -0,0 +1,54 @@
+import type { z } from 'zod';
+import type { DefinitionIssue } from './definition-issue-types.js';
+/**
+ * A field-level issue checker result.
+ *
+ * The `path` is relative to the schema node the checker is registered on.
+ * The infrastructure (`collectFieldIssues`) handles scoping to the correct
+ * entity and prepending the entity-relative path.
+ */
+export type FieldIssueResult = Pick<DefinitionIssue, 'message' | 'path' | 'severity' | 'fix'>;
+/**
+ * A field-level issue checker registered on a schema node.
+ * Invoked during `collectFieldIssues()` to find problems in the local value.
+ *
+ * Returns issues with paths relative to the current schema node.
+ * The infrastructure handles entity scoping automatically.
+ */
+export type DefinitionFieldIssueChecker<T = unknown> = (value: T) => FieldIssueResult[];
+/**
+ * Metadata stored on a schema node annotated by `withIssueChecker`.
+ * Exposed as readonly; the registry manages mutation internally.
+ */
+export interface FieldIssueCheckerSchemaMeta {
+    readonly checkers: readonly DefinitionFieldIssueChecker[];
+}
+/**
+ * Registry that stores field-level issue checker metadata on Zod schema instances.
+ *
+ * Uses a WeakMap to avoid interfering with Zod's type system.
+ * Annotated by `withIssueChecker()`; read by `collectFieldIssues()`.
+ */
+export declare const definitionFieldIssueRegistry: {
+    add(schema: z.ZodType, checker: DefinitionFieldIssueChecker): void;
+    get(schema: z.ZodType): FieldIssueCheckerSchemaMeta | undefined;
+};
+/**
+ * Creates a schema decorator that registers a field-level issue checker.
+ *
+ * Used with `.apply()`:
+ * ```typescript
+ * z.object({ ... }).apply(withIssueChecker<MyType>((value) => {
+ *   const issues: FieldIssueResult[] = [];
+ *   if (someCondition) {
+ *     issues.push({ message: '...', path: ['fieldName'], severity: 'error' });
+ *   }
+ *   return issues;
+ * }))
+ * ```
+ *
+ * @param checker - The issue checker function to register
+ * @returns A function that decorates a schema with the checker
+ */
+export declare function withIssueChecker<T extends z.ZodType>(checker: DefinitionFieldIssueChecker<z.output<T>>): (schema: T) => T;
+//# sourceMappingURL=definition-issue-registry.d.ts.map

package/dist/schema/creator/definition-issue-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-issue-registry.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/definition-issue-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,eAAe,EACf,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CACxC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,GAAG,OAAO,IAAI,CACrD,KAAK,EAAE,CAAC,KACL,gBAAgB,EAAE,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC3D;AAOD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;gBAGzB,CAAC,CAAC,OAAO,WAAW,2BAA2B,GAAG,IAAI;gBAQtD,CAAC,CAAC,OAAO,GAAG,2BAA2B,GAAG,SAAS;CAI/D,CAAC;AAEL;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAClD,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAChD,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAQlB"}

package/dist/schema/creator/definition-issue-registry.js

@@ -0,0 +1,47 @@
+/**
+ * Registry that stores field-level issue checker metadata on Zod schema instances.
+ *
+ * Uses a WeakMap to avoid interfering with Zod's type system.
+ * Annotated by `withIssueChecker()`; read by `collectFieldIssues()`.
+ */
+export const definitionFieldIssueRegistry = (() => {
+    const map = new WeakMap();
+    return {
+        add(schema, checker) {
+            const existing = map.get(schema);
+            if (existing) {
+                existing.checkers.push(checker);
+            }
+            else {
+                map.set(schema, { checkers: [checker] });
+            }
+        },
+        get(schema) {
+            return map.get(schema);
+        },
+    };
+})();
+/**
+ * Creates a schema decorator that registers a field-level issue checker.
+ *
+ * Used with `.apply()`:
+ * ```typescript
+ * z.object({ ... }).apply(withIssueChecker<MyType>((value) => {
+ *   const issues: FieldIssueResult[] = [];
+ *   if (someCondition) {
+ *     issues.push({ message: '...', path: ['fieldName'], severity: 'error' });
+ *   }
+ *   return issues;
+ * }))
+ * ```
+ *
+ * @param checker - The issue checker function to register
+ * @returns A function that decorates a schema with the checker
+ */
+export function withIssueChecker(checker) {
+    return (schema) => {
+        definitionFieldIssueRegistry.add(schema, checker);
+        return schema;
+    };
+}
+//# sourceMappingURL=definition-issue-registry.js.map

package/dist/schema/creator/definition-issue-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-issue-registry.js","sourceRoot":"","sources":["../../../src/schema/creator/definition-issue-registry.ts"],"names":[],"mappings":"AAwCA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE;IAChD,MAAM,GAAG,GAAG,IAAI,OAAO,EAAiD,CAAC;IACzE,OAAO;QACL,GAAG,CAAC,MAAiB,EAAE,OAAoC;YACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,GAAG,CAAC,MAAiB;YACnB,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAEL;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiD;IAEjD,OAAO,CAAC,MAAS,EAAK,EAAE;QACtB,4BAA4B,CAAC,GAAG,CAC9B,MAAM,EACN,OAAsC,CACvC,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/schema/creator/definition-issue-types.d.ts

@@ -0,0 +1,53 @@
+import type { ReferencePath } from '#src/references/types.js';
+/**
+ * An auto-fix proposal attached to an issue.
+ * The `apply` function receives the local value and returns a fixed value.
+ */
+export interface DefinitionIssueFix {
+    /** Short label for the fix action (e.g. "Remove duplicate port") */
+    readonly label: string;
+    /** Apply the fix to the local value, returning a fixed value */
+    readonly apply: (value: unknown) => unknown;
+}
+/**
+ * Common fields shared by all definition issues.
+ *
+ * - `'error'` severity blocks saving and shows toast errors
+ * - `'warning'` severity allows saving but blocks syncing, shown as toast warnings
+ */
+interface DefinitionIssueBase {
+    /** Human-readable description of the issue */
+    readonly message: string;
+    /** Severity: 'error' blocks save, 'warning' blocks sync only */
+    readonly severity: 'error' | 'warning';
+    /** Optional auto-fix proposal */
+    readonly fix?: DefinitionIssueFix;
+}
+/**
+ * An issue scoped to a specific entity. The path is relative to the entity root.
+ */
+export interface EntityDefinitionIssue extends DefinitionIssueBase {
+    /** The entity this issue belongs to */
+    readonly entityId: string;
+    /** Path relative to the entity root */
+    readonly path: ReferencePath;
+}
+/**
+ * A root-level issue with an absolute path from the definition root.
+ * Used for cross-cutting validations (e.g., duplicate names in arrays)
+ * and settings that aren't scoped to a specific entity.
+ */
+export interface RootDefinitionIssue extends DefinitionIssueBase {
+    readonly entityId?: undefined;
+    /** Absolute path from the definition root */
+    readonly path: ReferencePath;
+}
+/**
+ * A definition issue is either entity-scoped or root-scoped.
+ *
+ * - Entity-scoped: has `entityId` (string) + path relative to entity root
+ * - Root-scoped: no `entityId` + absolute path from definition root
+ */
+export type DefinitionIssue = EntityDefinitionIssue | RootDefinitionIssue;
+export {};
+//# sourceMappingURL=definition-issue-types.d.ts.map

package/dist/schema/creator/definition-issue-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-issue-types.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/definition-issue-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7C;AAED;;;;;GAKG;AACH,UAAU,mBAAmB;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,mBAAmB,CAAC"}

package/dist/schema/creator/definition-issue-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definition-issue-types.js.map

package/dist/schema/creator/definition-issue-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-issue-types.js","sourceRoot":"","sources":["../../../src/schema/creator/definition-issue-types.ts"],"names":[],"mappings":""}

package/dist/schema/creator/extend-parser-context-with-defaults.d.ts

@@ -1,13 +1,29 @@
 import type { z } from 'zod';
-import type { DefinitionSchemaCreatorOptions } from './types.js';
-export type WithDefaultType = <T extends z.ZodType>(schema: T, defaultValue: z.input<T>) => z.ZodOptional<z.ZodType<z.output<z.ZodOptional<T>>, z.input<z.ZodOptional<T>>>>;
+type WithDefaultResult<T extends z.ZodType> = z.ZodPrefault<T>;
+export type WithDefaultType = <T extends z.ZodType>(schema: T, defaultValue: z.input<T>) => WithDefaultResult<T>;
+/**
+ * Creates a schema decorator that applies a default value.
+ *
+ * Uses `prefault` to ensure defaults are populated during Zod parse, and
+ * registers the default value in the registry so `cleanDefaultValues()` can
+ * strip matching values during serialization.
+ *
+ * Can be used standalone with `.apply()`:
+ * ```typescript
+ * z.boolean().apply(withDefault(false))
+ * ```
+ *
+ * @param defaultValue - The default value to apply
+ * @returns A function that decorates a schema with the default value
+ */
+export declare function withDefault(defaultValue: unknown): <T extends z.ZodType>(schema: T) => WithDefaultResult<T>;
 /**
  * Extends the parser context with default value handling functionality.
  *
- * @param options - The schema creator options containing the defaultMode
  * @returns An object containing the withDefault method
  */
-export declare function extendParserContextWithDefaults(options: DefinitionSchemaCreatorOptions): {
+export declare function extendParserContextWithDefaults(): {
     withDefault: WithDefaultType;
 };
+export {};
 //# sourceMappingURL=extend-parser-context-with-defaults.d.ts.map

package/dist/schema/creator/extend-parser-context-with-defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extend-parser-context-with-defaults.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/extend-parser-context-with-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAqBjE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAChD,MAAM,EAAE,CAAC,EACT,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACrB,CAAC,CAAC,WAAW,CAChB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CACjE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,GACtC;IACD,WAAW,EAAE,eAAe,CAAC;CAC9B,CAmCA"}
+{"version":3,"file":"extend-parser-context-with-defaults.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/extend-parser-context-with-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAChD,MAAM,EAAE,CAAC,EACT,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACrB,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,OAAO,GACpB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI;IACjD,WAAW,EAAE,eAAe,CAAC;CAC9B,CAIA"}

package/dist/schema/creator/extend-parser-context-with-defaults.js

@@ -1,52 +1,34 @@
-function isEmpty(value) {
-    if (value === undefined || value === null) {
-        return true;
-    }
-    if (Array.isArray(value)) {
-        return value.length === 0;
-    }
-    if (typeof value === 'object' &&
-        Object.getPrototypeOf(value) === Object.prototype) {
-        return Object.values(value).every((val) => val === undefined);
-    }
-    if (typeof value === 'string') {
-        return value === '';
-    }
-    return false;
+import { definitionDefaultRegistry } from './definition-default-registry.js';
+/**
+ * Creates a schema decorator that applies a default value.
+ *
+ * Uses `prefault` to ensure defaults are populated during Zod parse, and
+ * registers the default value in the registry so `cleanDefaultValues()` can
+ * strip matching values during serialization.
+ *
+ * Can be used standalone with `.apply()`:
+ * ```typescript
+ * z.boolean().apply(withDefault(false))
+ * ```
+ *
+ * @param defaultValue - The default value to apply
+ * @returns A function that decorates a schema with the default value
+ */
+export function withDefault(defaultValue) {
+    return (schema) => {
+        const result = schema.prefault(defaultValue);
+        definitionDefaultRegistry.set(result, { defaultValue });
+        return result;
+    };
 }
 /**
  * Extends the parser context with default value handling functionality.
  *
- * @param options - The schema creator options containing the defaultMode
  * @returns An object containing the withDefault method
  */
-export function extendParserContextWithDefaults(options) {
-    const mode = options.defaultMode ?? 'populate';
+export function extendParserContextWithDefaults() {
     return {
-        withDefault: function withDefault(schema, defaultValue) {
-            switch (mode) {
-                case 'populate': {
-                    return schema.prefault(defaultValue).optional();
-                }
-                case 'strip': {
-                    // Use transform to remove values matching defaults after validation
-                    return schema
-                        .transform((value) => {
-                        if (value === defaultValue)
-                            return undefined;
-                        if (isEmpty(value)) {
-                            return undefined;
-                        }
-                        return value;
-                    })
-                        .optional();
-                }
-                case 'preserve': {
-                    // Return schema with .optional() added
-                    return schema.transform((x) => x).optional();
-                }
-            }
-        },
+        withDefault: (schema, defaultValue) => withDefault(defaultValue)(schema),
     };
 }
 //# sourceMappingURL=extend-parser-context-with-defaults.js.map

package/dist/schema/creator/extend-parser-context-with-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"extend-parser-context-with-defaults.js","sourceRoot":"","sources":["../../../src/schema/creator/extend-parser-context-with-defaults.ts"],"names":[],"mappings":"AAIA,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,EACjD,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,KAAK,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAuC;IAIvC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC;IAE/C,OAAO;QACL,WAAW,EAAE,SAAS,WAAW,CAC/B,MAAS,EACT,YAAwB;YAIxB,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAClD,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,oEAAoE;oBACpE,OAAO,MAAM;yBACV,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;wBACnB,IAAI,KAAK,KAAK,YAAY;4BAAE,OAAO,SAAS,CAAC;wBAC7C,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;4BACnB,OAAO,SAAS,CAAC;wBACnB,CAAC;wBAED,OAAO,KAAK,CAAC;oBACf,CAAC,CAAC;yBACD,QAAQ,EAAE,CAAC;gBAChB,CAAC;gBACD,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,uCAAuC;oBAEvC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"extend-parser-context-with-defaults.js","sourceRoot":"","sources":["../../../src/schema/creator/extend-parser-context-with-defaults.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAS7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,YAAqB;IAErB,OAAO,CAAsB,MAAS,EAAwB,EAAE;QAC9D,MAAM,MAAM,GAAI,MAAoB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC5D,yBAAyB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACxD,OAAO,MAA8B,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B;IAG7C,OAAO;QACL,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/schema/creator/index.d.ts

@@ -1,3 +1,9 @@
+export * from './definition-fix-registry.js';
+export * from './definition-issue-checker-spec.js';
+export * from './definition-issue-checkers.js';
+export * from './definition-issue-registry.js';
+export type * from './definition-issue-types.js';
+export { withDefault } from './extend-parser-context-with-defaults.js';
 export type * as def from './infer-types.js';
 export * from './schema-creator.js';
 export type * from './types.js';

package/dist/schema/creator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/index.ts"],"names":[],"mappings":"AAAA,YAAY,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AAEpC,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,mBAAmB,6BAA6B,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAEvE,YAAY,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAE7C,cAAc,qBAAqB,CAAC;AAEpC,mBAAmB,YAAY,CAAC"}

package/dist/schema/creator/index.js

@@ -1,2 +1,7 @@
+export * from './definition-fix-registry.js';
+export * from './definition-issue-checker-spec.js';
+export * from './definition-issue-checkers.js';
+export * from './definition-issue-registry.js';
+export { withDefault } from './extend-parser-context-with-defaults.js';
 export * from './schema-creator.js';
 //# sourceMappingURL=index.js.map

package/dist/schema/creator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/creator/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/creator/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAIvE,cAAc,qBAAqB,CAAC"}

package/dist/schema/creator/schema-creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-creator.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/schema-creator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,gCAAgC,EAChC,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAIpB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAM/B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAClD,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,CAAC,OAAO,EAAE,6BAA6B,KAAK,CAAC,CAE/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,SAAS,wBAAwB,EACzC,CAAC,SAAS,CAAC,CAAC,OAAO,EAEnB,cAAc,EAAE,QAAQ,EACxB,OAAO,EAAE,CACP,GAAG,EAAE,6BAA6B,EAClC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,KAC/B,CAAC,GACL,gCAAgC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAO/C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,CAAC,CAAC,OAAO,EACnB,QAAQ,SAAS,wBAAwB,EAEzC,aAAa,EAAE,gCAAgC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAC3D,uBAAuB,CAAC,CAAC,CAAC,CAO5B"}
+{"version":3,"file":"schema-creator.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/schema-creator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,gCAAgC,EAChC,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AASpB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAW/B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAClD,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,CAAC,OAAO,EAAE,6BAA6B,KAAK,CAAC,CAS/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,SAAS,wBAAwB,EACzC,CAAC,SAAS,CAAC,CAAC,OAAO,EAEnB,cAAc,EAAE,QAAQ,EACxB,OAAO,EAAE,CACP,GAAG,EAAE,6BAA6B,EAClC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,KAC/B,CAAC,GACL,gCAAgC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAO/C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,CAAC,CAAC,OAAO,EACnB,QAAQ,SAAS,wBAAwB,EAEzC,aAAa,EAAE,gCAAgC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAC3D,uBAAuB,CAAC,CAAC,CAAC,CAO5B"}

package/dist/schema/creator/schema-creator.js

@@ -1,15 +1,29 @@
 import { extendParserContextWithRefs } from '#src/references/extend-parser-context-with-refs.js';
 import { createRefContextSlotMap } from '#src/references/ref-context-slot.js';
 import { extendParserContextWithDefaults } from './extend-parser-context-with-defaults.js';
+const contextCache = new WeakMap();
 export function createDefinitionSchemaParserContext(options) {
-    return {
+    const cached = contextCache.get(options.plugins);
+    if (cached)
+        return cached;
+    const context = {
         ...options,
-        ...extendParserContextWithRefs(options),
-        ...extendParserContextWithDefaults(options),
+        ...extendParserContextWithRefs(),
+        ...extendParserContextWithDefaults(),
     };
+    contextCache.set(options.plugins, context);
+    return context;
 }
 export function definitionSchema(creator) {
-    return (context) => creator(context);
+    const cache = new WeakMap();
+    return (context) => {
+        const cached = cache.get(context);
+        if (cached)
+            return cached;
+        const result = creator(context);
+        cache.set(context, result);
+        return result;
+    };
 }
 /**
  * Creates a schema that requires slots to be passed from parent schemas.

package/dist/schema/creator/schema-creator.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-creator.js","sourceRoot":"","sources":["../../../src/schema/creator/schema-creator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAS9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAE3F,MAAM,UAAU,mCAAmC,CACjD,OAAuC;IAEvC,OAAO;QACL,GAAG,OAAO;QACV,GAAG,2BAA2B,CAAC,OAAO,CAAC;QACvC,GAAG,+BAA+B,CAAC,OAAO,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAmC;IAEnC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CAIvC,cAAwB,EACxB,OAGM;IAEN,MAAM,gBAAgB,GAAkD,CACtE,OAAO,EACP,KAAK,EACL,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,gBAAgB,CAAC,cAAc,GAAG,cAAc,CAAC;IACjD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAIlC,aAA4D;IAE5D,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,aAAa,CAAC,cAAc,CAC7B,CAAC;QACF,OAAO,aAAa,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schema-creator.js","sourceRoot":"","sources":["../../../src/schema/creator/schema-creator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAS9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAE3F,MAAM,YAAY,GAAG,IAAI,OAAO,EAG7B,CAAC;AAEJ,MAAM,UAAU,mCAAmC,CACjD,OAAuC;IAEvC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAkC;QAC7C,GAAG,OAAO;QACV,GAAG,2BAA2B,EAAE;QAChC,GAAG,+BAA+B,EAAE;KACrC,CAAC;IACF,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAmC;IAEnC,MAAM,KAAK,GAAG,IAAI,OAAO,EAAoC,CAAC;IAC9D,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CAIvC,cAAwB,EACxB,OAGM;IAEN,MAAM,gBAAgB,GAAkD,CACtE,OAAO,EACP,KAAK,EACL,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,gBAAgB,CAAC,cAAc,GAAG,cAAc,CAAC;IACjD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAIlC,aAA4D;IAE5D,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,aAAa,CAAC,cAAc,CAC7B,CAAC;QACF,OAAO,aAAa,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}

package/dist/schema/creator/types.d.ts

@@ -11,38 +11,12 @@ export interface DefinitionSchemaCreatorOptions {
      * The plugin implementation store that contains the instantiated plugin spec implementations.
      */
     plugins: PluginSpecStore;
-    /**
-     * If true, the schema will be transformed to include references.
-     *
-     * Note: The parsed data will not match the Typescript type definition of the schema
-     * because refs will be replaced with special marker classes. You must call extractRefs
-     * to convert the parsed data to the correct type.
-     */
-    transformReferences?: boolean;
-    /**
-     * How to handle default values in the schema.
-     *
-     * - 'populate': Ensure defaults are present (useful for React Hook Form)
-     * - 'strip': Remove values that match their defaults (useful for clean JSON serialization)
-     * - 'preserve': Keep values as-is without transformation
-     *
-     * @default 'populate'
-     */
-    defaultMode?: 'populate' | 'strip' | 'preserve';
 }
 export interface DefinitionSchemaParserContext {
     /**
      * The plugin implementation store that contains the instantiated plugin spec implementations.
      */
     plugins: PluginSpecStore;
-    /**
-     * If true, the schema will be transformed to include references.
-     */
-    transformReferences?: boolean;
-    /**
-     * How to handle default values in the schema.
-     */
-    defaultMode?: 'populate' | 'strip' | 'preserve';
     /**
      * Adds a reference to the schema.
      */
@@ -52,10 +26,9 @@ export interface DefinitionSchemaParserContext {
      */
     withEnt: WithEntType;
     /**
-     * Wraps a schema with default value handling based on the defaultMode.
-     * - 'populate': Uses preprocess to ensure defaults are present
-     * - 'strip': Uses transform to remove values matching defaults
-     * - 'preserve': Returns schema unchanged
+     * Wraps a schema with default value handling. Uses prefault to ensure defaults
+     * are populated during parsing, and registers the default so it can be stripped
+     * during serialization via `cleanDefaultValues()`.
      */
     withDefault: WithDefaultType;
     /**

package/dist/schema/creator/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;CACjD;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,WAAW,EAAE,eAAe,CAAC;IAC7B;;;OAGG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;;OAGG;IACH,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CACrE,GAAG,EAAE,6BAA6B,KAC/B,CAAC,CAAC;AAEP,MAAM,MAAM,gCAAgC,CAC1C,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAC/C,eAAe,SAAS,wBAAwB,GAAG,wBAAwB,IACzE,CAAC,CACH,GAAG,EAAE,6BAA6B,EAClC,KAAK,EAAE,iBAAiB,CAAC,eAAe,CAAC,KACtC,iBAAiB,CAAC,GAAG;IACxB,cAAc,EAAE,eAAe,CAAC;CACjC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schema/creator/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,eAAe,CAAC;IAC7B;;;OAGG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;;OAGG;IACH,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CACrE,GAAG,EAAE,6BAA6B,KAC/B,CAAC,CAAC;AAEP,MAAM,MAAM,gCAAgC,CAC1C,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAC/C,eAAe,SAAS,wBAAwB,GAAG,wBAAwB,IACzE,CAAC,CACH,GAAG,EAAE,6BAA6B,EAClC,KAAK,EAAE,iBAAiB,CAAC,eAAe,CAAC,KACtC,iBAAiB,CAAC,GAAG;IACxB,cAAc,EAAE,eAAe,CAAC;CACjC,CAAC"}

package/dist/schema/models/authorizer/authorizer-expression-acorn-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authorizer-expression-acorn-parser.d.ts","sourceRoot":"","sources":["../../../../src/schema/models/authorizer/authorizer-expression-acorn-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EACV,wBAAwB,EAOzB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GACZ,wBAAwB,CA6C1B"}
+{"version":3,"file":"authorizer-expression-acorn-parser.d.ts","sourceRoot":"","sources":["../../../../src/schema/models/authorizer/authorizer-expression-acorn-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EACV,wBAAwB,EAUzB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GACZ,wBAAwB,CA6C1B"}