@wildo-ai/zod-decorators 1.1.3 → 1.1.5

package/dist/esm/files/agent-file-formats.d.ts

@@ -1,72 +1,86 @@
 /**
- * Agent/Blueprint File Format Registry
+ * Agent file-format registry — the ONE named source for the formats an agent reads or writes.
  *
- * Handles file formats specific to agent/blueprint operations.
- * Maps AppsBlueprint_FileFormat to extensions and MIME types.
+ * This vocabulary used to exist twice: as `AppsBlueprint_FileFormat` / `AppsBlueprint_FileMimes` in
+ * `@wildo-ai/saas-models`, and as string literals here that a comment said were kept in step "to
+ * avoid circular dependencies". The duplication was the tell that the enum sat in the wrong
+ * package: `saas-models` depends on `zod-decorators`, never the reverse, so the lower layer is the
+ * only placement that can serve both without a cycle.
  *
- * NOTE: This registry uses string literals that match AppsBlueprint_FileFormat
- * and AppsBlueprint_FileMimes from @wildo-ai/saas-models to avoid circular
- * dependencies. The registry methods return/accept these string values which
- * are compatible with the enums defined in saas-models.
+ * The `saas-models` copy was deleted on 2026-09-19 with the rest of the `apps-blueprint` tree, and
+ * `FlowsActors_Agent_OutputSpecSchema` now reaches this enum directly. Nothing about a file format
+ * was ever app-creation-specific; the name was.
+ *
+ * @see `.claude/rules/design-philosophy.md` — one named runtime source per closed vocabulary.
  */
 /**
- * Agent/Blueprint file format string literals.
- * These match AppsBlueprint_FileFormat enum values from @wildo-ai/saas-models.
+ * Formats an agent may be asked to emit, and that the framework can map to an extension and a MIME
+ * type. Closed on purpose: a format belongs here only once the registry below can answer both
+ * mappings for it.
  */
-export declare const AgentFileFormat: {
-    readonly TEXT: "text";
-    readonly TYPESCRIPT: "typescript";
-    readonly TYPESCRIPT_JSX: "typescript_react";
-    readonly MARKDOWN: "markdown";
-    readonly JSON: "json";
-    readonly YAML: "yaml";
-};
+export declare enum AgentFileFormat {
+    /** Unstructured prose. The default when no format is declared. */
+    TEXT = "text",
+    /** TypeScript source. `.ts` — module code, schemas, configuration. */
+    TYPESCRIPT = "typescript",
+    /** TypeScript with JSX. `.tsx` — a component; distinct from TYPESCRIPT because the extension differs and a `.ts` file containing JSX does not compile. */
+    TYPESCRIPT_JSX = "typescript_react",
+    /** Markdown. Documentation, prompts, authored prose an agent produces for a human. */
+    MARKDOWN = "markdown",
+    /** JSON. Structured data an agent emits for a machine. */
+    JSON = "json",
+    /** YAML. Configuration and manifests, where comments and readability matter. */
+    YAML = "yaml"
+}
 /**
- * Agent/Blueprint file MIME type string literals.
- * These match AppsBlueprint_FileMimes enum values from @wildo-ai/saas-models.
+ * The MIME type each {@link AgentFileFormat} is served and recognised as.
+ *
+ * Kept as a separate vocabulary rather than derived, because the reverse map below accepts
+ * ALTERNATIVES this enum deliberately does not name as canonical (`text/yaml` for YAML).
  */
-export declare const AgentFileMime: {
-    readonly TEXT_PLAIN: "text/plain";
-    readonly MARKDOWN: "text/markdown";
-    readonly JSON: "application/json";
-    readonly TYPESCRIPT: "application/typescript";
-    readonly TYPESCRIPT_JSX: "application/typescript-jsx";
-    readonly YAML: "application/yaml";
-};
+export declare enum AgentFileMime {
+    TEXT_PLAIN = "text/plain",
+    MARKDOWN = "text/markdown",
+    JSON = "application/json",
+    TYPESCRIPT = "application/typescript",
+    TYPESCRIPT_JSX = "application/typescript-jsx",
+    YAML = "application/yaml"
+}
 /**
- * Type for agent file format (compatible with AppsBlueprint_FileFormat).
+ * The format union, kept as a named alias because callers that hold a plain `string` from a
+ * registry lookup need something to widen to.
  */
-export type AgentFileFormatType = typeof AgentFileFormat[keyof typeof AgentFileFormat];
+export type AgentFileFormatType = `${AgentFileFormat}`;
 /**
  * Registry for agent/blueprint file formats.
  */
 export declare class AgentFileFormatRegistry {
     /**
-     * Get MIME type for AppsBlueprint_FileFormat.
+     * Get the MIME type for a format.
      *
-     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @param format - an `AgentFileFormat` value (or a compatible string)
      * @returns MIME type string
      */
     static getMimeType(format: string): string;
     /**
-     * Get extension for AppsBlueprint_FileFormat.
+     * Get the file extension for a format.
      *
-     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @param format - an `AgentFileFormat` value (or a compatible string)
      * @returns Extension string (without dot)
      */
     static getExtension(format: string): string;
     /**
-     * Get AppsBlueprint_FileFormat from extension.
+     * Get the format for a file extension.
      *
      * @param extension - File extension (without dot)
-     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     * @returns an `AgentFileFormat` value as a string, or undefined
      */
     static getFormatFromExtension(extension: string): string | undefined;
     /**
-     * Get AppsBlueprint_FileFormat from MIME type.
+     * Get the format for a MIME type.
      *
      * @param mimeType - MIME type string
-     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     * @returns an `AgentFileFormat` value as a string, or undefined
      */
     static getFormatFromMimeType(mimeType: string): string | undefined;
     /**

package/dist/esm/files/agent-file-formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-file-formats.d.ts","sourceRoot":"","sources":["../../../../src/files/agent-file-formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAoDvF;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpE;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOlE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAInC;;;;OAIG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM,EAAE;CAGnC"}
+{"version":3,"file":"agent-file-formats.d.ts","sourceRoot":"","sources":["../../../../src/files/agent-file-formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;GAIG;AACH,oBAAY,eAAe;IACzB,kEAAkE;IAClE,IAAI,SAAS;IACb,sEAAsE;IACtE,UAAU,eAAe;IACzB,0JAA0J;IAC1J,cAAc,qBAAqB;IACnC,sFAAsF;IACtF,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,IAAI,SAAS;IACb,gFAAgF;IAChF,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,QAAQ,kBAAkB;IAC1B,IAAI,qBAAqB;IACzB,UAAU,2BAA2B;IACrC,cAAc,+BAA+B;IAC7C,IAAI,qBAAqB;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,eAAe,EAAE,CAAC;AA4CvD;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpE;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOlE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAInC;;;;OAIG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM,EAAE;CAGnC"}

package/dist/esm/files/agent-file-formats.js

@@ -1,41 +1,54 @@
 /**
- * Agent/Blueprint File Format Registry
+ * Agent file-format registry — the ONE named source for the formats an agent reads or writes.
  *
- * Handles file formats specific to agent/blueprint operations.
- * Maps AppsBlueprint_FileFormat to extensions and MIME types.
+ * This vocabulary used to exist twice: as `AppsBlueprint_FileFormat` / `AppsBlueprint_FileMimes` in
+ * `@wildo-ai/saas-models`, and as string literals here that a comment said were kept in step "to
+ * avoid circular dependencies". The duplication was the tell that the enum sat in the wrong
+ * package: `saas-models` depends on `zod-decorators`, never the reverse, so the lower layer is the
+ * only placement that can serve both without a cycle.
  *
- * NOTE: This registry uses string literals that match AppsBlueprint_FileFormat
- * and AppsBlueprint_FileMimes from @wildo-ai/saas-models to avoid circular
- * dependencies. The registry methods return/accept these string values which
- * are compatible with the enums defined in saas-models.
- */
-/**
- * Agent/Blueprint file format string literals.
- * These match AppsBlueprint_FileFormat enum values from @wildo-ai/saas-models.
+ * The `saas-models` copy was deleted on 2026-09-19 with the rest of the `apps-blueprint` tree, and
+ * `FlowsActors_Agent_OutputSpecSchema` now reaches this enum directly. Nothing about a file format
+ * was ever app-creation-specific; the name was.
+ *
+ * @see `.claude/rules/design-philosophy.md` — one named runtime source per closed vocabulary.
  */
-export const AgentFileFormat = {
-    TEXT: 'text',
-    TYPESCRIPT: 'typescript',
-    TYPESCRIPT_JSX: 'typescript_react',
-    MARKDOWN: 'markdown',
-    JSON: 'json',
-    YAML: 'yaml',
-};
 /**
- * Agent/Blueprint file MIME type string literals.
- * These match AppsBlueprint_FileMimes enum values from @wildo-ai/saas-models.
+ * Formats an agent may be asked to emit, and that the framework can map to an extension and a MIME
+ * type. Closed on purpose: a format belongs here only once the registry below can answer both
+ * mappings for it.
  */
-export const AgentFileMime = {
-    TEXT_PLAIN: 'text/plain',
-    MARKDOWN: 'text/markdown',
-    JSON: 'application/json',
-    TYPESCRIPT: 'application/typescript',
-    TYPESCRIPT_JSX: 'application/typescript-jsx',
-    YAML: 'application/yaml',
-};
+export var AgentFileFormat;
+(function (AgentFileFormat) {
+    /** Unstructured prose. The default when no format is declared. */
+    AgentFileFormat["TEXT"] = "text";
+    /** TypeScript source. `.ts` — module code, schemas, configuration. */
+    AgentFileFormat["TYPESCRIPT"] = "typescript";
+    /** TypeScript with JSX. `.tsx` — a component; distinct from TYPESCRIPT because the extension differs and a `.ts` file containing JSX does not compile. */
+    AgentFileFormat["TYPESCRIPT_JSX"] = "typescript_react";
+    /** Markdown. Documentation, prompts, authored prose an agent produces for a human. */
+    AgentFileFormat["MARKDOWN"] = "markdown";
+    /** JSON. Structured data an agent emits for a machine. */
+    AgentFileFormat["JSON"] = "json";
+    /** YAML. Configuration and manifests, where comments and readability matter. */
+    AgentFileFormat["YAML"] = "yaml";
+})(AgentFileFormat || (AgentFileFormat = {}));
 /**
- * Maps AppsBlueprint_FileFormat to MIME types.
+ * The MIME type each {@link AgentFileFormat} is served and recognised as.
+ *
+ * Kept as a separate vocabulary rather than derived, because the reverse map below accepts
+ * ALTERNATIVES this enum deliberately does not name as canonical (`text/yaml` for YAML).
  */
+export var AgentFileMime;
+(function (AgentFileMime) {
+    AgentFileMime["TEXT_PLAIN"] = "text/plain";
+    AgentFileMime["MARKDOWN"] = "text/markdown";
+    AgentFileMime["JSON"] = "application/json";
+    AgentFileMime["TYPESCRIPT"] = "application/typescript";
+    AgentFileMime["TYPESCRIPT_JSX"] = "application/typescript-jsx";
+    AgentFileMime["YAML"] = "application/yaml";
+})(AgentFileMime || (AgentFileMime = {}));
+/** Canonical MIME type per format. */
 const FORMAT_TO_MIME = {
     [AgentFileFormat.TEXT]: AgentFileMime.TEXT_PLAIN,
     [AgentFileFormat.MARKDOWN]: AgentFileMime.MARKDOWN,
@@ -44,9 +57,7 @@ const FORMAT_TO_MIME = {
     [AgentFileFormat.TYPESCRIPT_JSX]: AgentFileMime.TYPESCRIPT_JSX,
     [AgentFileFormat.YAML]: AgentFileMime.YAML,
 };
-/**
- * Maps AppsBlueprint_FileFormat to extensions.
- */
+/** Canonical file extension per format. */
 const FORMAT_TO_EXTENSION = {
     [AgentFileFormat.TEXT]: 'txt',
     [AgentFileFormat.MARKDOWN]: 'md',
@@ -55,9 +66,7 @@ const FORMAT_TO_EXTENSION = {
     [AgentFileFormat.TYPESCRIPT_JSX]: 'tsx',
     [AgentFileFormat.YAML]: 'yaml',
 };
-/**
- * Reverse mapping: extension to AppsBlueprint_FileFormat.
- */
+/** Extension to format, including accepted alternatives. */
 const EXTENSION_TO_FORMAT = {
     'txt': AgentFileFormat.TEXT,
     'md': AgentFileFormat.MARKDOWN,
@@ -67,9 +76,7 @@ const EXTENSION_TO_FORMAT = {
     'yaml': AgentFileFormat.YAML,
     'yml': AgentFileFormat.YAML, // Alternative extension for YAML
 };
-/**
- * Reverse mapping: MIME type to AppsBlueprint_FileFormat.
- */
+/** MIME type to format, including accepted alternatives. */
 const MIME_TO_FORMAT = {
     'text/plain': AgentFileFormat.TEXT,
     'text/markdown': AgentFileFormat.MARKDOWN,
@@ -84,28 +91,28 @@ const MIME_TO_FORMAT = {
  */
 export class AgentFileFormatRegistry {
     /**
-     * Get MIME type for AppsBlueprint_FileFormat.
+     * Get the MIME type for a format.
      *
-     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @param format - an `AgentFileFormat` value (or a compatible string)
      * @returns MIME type string
      */
     static getMimeType(format) {
         return FORMAT_TO_MIME[format] || '';
     }
     /**
-     * Get extension for AppsBlueprint_FileFormat.
+     * Get the file extension for a format.
      *
-     * @param format - AppsBlueprint_FileFormat enum value (or compatible string)
+     * @param format - an `AgentFileFormat` value (or a compatible string)
      * @returns Extension string (without dot)
      */
     static getExtension(format) {
         return FORMAT_TO_EXTENSION[format] || '';
     }
     /**
-     * Get AppsBlueprint_FileFormat from extension.
+     * Get the format for a file extension.
      *
      * @param extension - File extension (without dot)
-     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     * @returns an `AgentFileFormat` value as a string, or undefined
      */
     static getFormatFromExtension(extension) {
         if (!extension)
@@ -114,10 +121,10 @@ export class AgentFileFormatRegistry {
         return EXTENSION_TO_FORMAT[normalizedExt];
     }
     /**
-     * Get AppsBlueprint_FileFormat from MIME type.
+     * Get the format for a MIME type.
      *
      * @param mimeType - MIME type string
-     * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined
+     * @returns an `AgentFileFormat` value as a string, or undefined
      */
     static getFormatFromMimeType(mimeType) {
         if (!mimeType)

package/dist/esm/files/agent-file-formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-file-formats.js","sourceRoot":"","sources":["../../../../src/files/agent-file-formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,kBAAkB;IAClC,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,kBAAkB;IACxB,UAAU,EAAE,wBAAwB;IACpC,cAAc,EAAE,4BAA4B;IAC5C,IAAI,EAAE,kBAAkB;CAChB,CAAC;AAOX;;GAEG;AACH,MAAM,cAAc,GAA2B;IAC7C,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,UAAU;IAChD,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,QAAQ;IAClD,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI;IAC1C,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,UAAU;IACtD,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,cAAc;IAC9D,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAA2B;IAClD,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK;IAC7B,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI;IAChC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM;IAC9B,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,IAAI;IAClC,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,KAAK;IACvC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAA2B;IAClD,KAAK,EAAE,eAAe,CAAC,IAAI;IAC3B,IAAI,EAAE,eAAe,CAAC,QAAQ;IAC9B,MAAM,EAAE,eAAe,CAAC,IAAI;IAC5B,IAAI,EAAE,eAAe,CAAC,UAAU;IAChC,KAAK,EAAE,eAAe,CAAC,cAAc;IACrC,MAAM,EAAE,eAAe,CAAC,IAAI;IAC5B,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,iCAAiC;CAC/D,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAA2B;IAC7C,YAAY,EAAE,eAAe,CAAC,IAAI;IAClC,eAAe,EAAE,eAAe,CAAC,QAAQ;IACzC,kBAAkB,EAAE,eAAe,CAAC,IAAI;IACxC,wBAAwB,EAAE,eAAe,CAAC,UAAU;IACpD,4BAA4B,EAAE,eAAe,CAAC,cAAc;IAC5D,kBAAkB,EAAE,eAAe,CAAC,IAAI;IACxC,WAAW,EAAE,eAAe,CAAC,IAAI,EAAE,wBAAwB;CAC5D,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,MAAc;QAC/B,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,MAAc;QAChC,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAiB;QAC7C,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAgB;QAC3C,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,cAAc,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAgB;QACrC,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,gBAAgB;QACrB,OAAO,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["/**\n * Agent/Blueprint File Format Registry\n * \n * Handles file formats specific to agent/blueprint operations.\n * Maps AppsBlueprint_FileFormat to extensions and MIME types.\n * \n * NOTE: This registry uses string literals that match AppsBlueprint_FileFormat\n * and AppsBlueprint_FileMimes from @wildo-ai/saas-models to avoid circular\n * dependencies. The registry methods return/accept these string values which\n * are compatible with the enums defined in saas-models.\n */\n\nimport mime from 'mime';\n\n/**\n * Agent/Blueprint file format string literals.\n * These match AppsBlueprint_FileFormat enum values from @wildo-ai/saas-models.\n */\nexport const AgentFileFormat = {\n  TEXT: 'text',\n  TYPESCRIPT: 'typescript',\n  TYPESCRIPT_JSX: 'typescript_react',\n  MARKDOWN: 'markdown',\n  JSON: 'json',\n  YAML: 'yaml',\n} as const;\n\n/**\n * Agent/Blueprint file MIME type string literals.\n * These match AppsBlueprint_FileMimes enum values from @wildo-ai/saas-models.\n */\nexport const AgentFileMime = {\n  TEXT_PLAIN: 'text/plain',\n  MARKDOWN: 'text/markdown',\n  JSON: 'application/json',\n  TYPESCRIPT: 'application/typescript',\n  TYPESCRIPT_JSX: 'application/typescript-jsx',\n  YAML: 'application/yaml',\n} as const;\n\n/**\n * Type for agent file format (compatible with AppsBlueprint_FileFormat).\n */\nexport type AgentFileFormatType = typeof AgentFileFormat[keyof typeof AgentFileFormat];\n\n/**\n * Maps AppsBlueprint_FileFormat to MIME types.\n */\nconst FORMAT_TO_MIME: Record<string, string> = {\n  [AgentFileFormat.TEXT]: AgentFileMime.TEXT_PLAIN,\n  [AgentFileFormat.MARKDOWN]: AgentFileMime.MARKDOWN,\n  [AgentFileFormat.JSON]: AgentFileMime.JSON,\n  [AgentFileFormat.TYPESCRIPT]: AgentFileMime.TYPESCRIPT,\n  [AgentFileFormat.TYPESCRIPT_JSX]: AgentFileMime.TYPESCRIPT_JSX,\n  [AgentFileFormat.YAML]: AgentFileMime.YAML,\n};\n\n/**\n * Maps AppsBlueprint_FileFormat to extensions.\n */\nconst FORMAT_TO_EXTENSION: Record<string, string> = {\n  [AgentFileFormat.TEXT]: 'txt',\n  [AgentFileFormat.MARKDOWN]: 'md',\n  [AgentFileFormat.JSON]: 'json',\n  [AgentFileFormat.TYPESCRIPT]: 'ts',\n  [AgentFileFormat.TYPESCRIPT_JSX]: 'tsx',\n  [AgentFileFormat.YAML]: 'yaml',\n};\n\n/**\n * Reverse mapping: extension to AppsBlueprint_FileFormat.\n */\nconst EXTENSION_TO_FORMAT: Record<string, string> = {\n  'txt': AgentFileFormat.TEXT,\n  'md': AgentFileFormat.MARKDOWN,\n  'json': AgentFileFormat.JSON,\n  'ts': AgentFileFormat.TYPESCRIPT,\n  'tsx': AgentFileFormat.TYPESCRIPT_JSX,\n  'yaml': AgentFileFormat.YAML,\n  'yml': AgentFileFormat.YAML, // Alternative extension for YAML\n};\n\n/**\n * Reverse mapping: MIME type to AppsBlueprint_FileFormat.\n */\nconst MIME_TO_FORMAT: Record<string, string> = {\n  'text/plain': AgentFileFormat.TEXT,\n  'text/markdown': AgentFileFormat.MARKDOWN,\n  'application/json': AgentFileFormat.JSON,\n  'application/typescript': AgentFileFormat.TYPESCRIPT,\n  'application/typescript-jsx': AgentFileFormat.TYPESCRIPT_JSX,\n  'application/yaml': AgentFileFormat.YAML,\n  'text/yaml': AgentFileFormat.YAML, // Alternative MIME type\n};\n\n/**\n * Registry for agent/blueprint file formats.\n */\nexport class AgentFileFormatRegistry {\n  /**\n   * Get MIME type for AppsBlueprint_FileFormat.\n   * \n   * @param format - AppsBlueprint_FileFormat enum value (or compatible string)\n   * @returns MIME type string\n   */\n  static getMimeType(format: string): string {\n    return FORMAT_TO_MIME[format] || '';\n  }\n  \n  /**\n   * Get extension for AppsBlueprint_FileFormat.\n   * \n   * @param format - AppsBlueprint_FileFormat enum value (or compatible string)\n   * @returns Extension string (without dot)\n   */\n  static getExtension(format: string): string {\n    return FORMAT_TO_EXTENSION[format] || '';\n  }\n  \n  /**\n   * Get AppsBlueprint_FileFormat from extension.\n   * \n   * @param extension - File extension (without dot)\n   * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined\n   */\n  static getFormatFromExtension(extension: string): string | undefined {\n    if (!extension) return undefined;\n    \n    const normalizedExt = extension.toLowerCase().trim();\n    return EXTENSION_TO_FORMAT[normalizedExt];\n  }\n  \n  /**\n   * Get AppsBlueprint_FileFormat from MIME type.\n   * \n   * @param mimeType - MIME type string\n   * @returns Format string (compatible with AppsBlueprint_FileFormat) or undefined\n   */\n  static getFormatFromMimeType(mimeType: string): string | undefined {\n    if (!mimeType) return undefined;\n    \n    const normalizedMime = mimeType.toLowerCase().trim();\n    return MIME_TO_FORMAT[normalizedMime];\n  }\n  \n  /**\n   * Check if extension is an agent file format.\n   * \n   * @param extension - File extension (without dot)\n   * @returns true if extension is an agent format\n   */\n  static isAgentFormat(extension: string): boolean {\n    return this.getFormatFromExtension(extension) !== undefined;\n  }\n  \n  /**\n   * Check if MIME type is an agent file format.\n   * \n   * @param mimeType - MIME type string\n   * @returns true if MIME type is an agent format\n   */\n  static isAgentMimeType(mimeType: string): boolean {\n    return this.getFormatFromMimeType(mimeType) !== undefined;\n  }\n  \n  /**\n   * Get all agent format extensions.\n   * \n   * @returns Array of extension strings\n   */\n  static getAllExtensions(): string[] {\n    return Object.values(FORMAT_TO_EXTENSION);\n  }\n  \n  /**\n   * Get all agent format MIME types.\n   * \n   * @returns Array of MIME type strings\n   */\n  static getAllMimeTypes(): string[] {\n    return Object.values(FORMAT_TO_MIME);\n  }\n}\n"]}
+{"version":3,"file":"agent-file-formats.js","sourceRoot":"","sources":["../../../../src/files/agent-file-formats.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agent file-format registry — the ONE named source for the formats an agent reads or writes.\n *\n * This vocabulary used to exist twice: as `AppsBlueprint_FileFormat` / `AppsBlueprint_FileMimes` in\n * `@wildo-ai/saas-models`, and as string literals here that a comment said were kept in step \"to\n * avoid circular dependencies\". The duplication was the tell that the enum sat in the wrong\n * package: `saas-models` depends on `zod-decorators`, never the reverse, so the lower layer is the\n * only placement that can serve both without a cycle.\n *\n * The `saas-models` copy was deleted on 2026-09-19 with the rest of the `apps-blueprint` tree, and\n * `FlowsActors_Agent_OutputSpecSchema` now reaches this enum directly. Nothing about a file format\n * was ever app-creation-specific; the name was.\n *\n * @see `.claude/rules/design-philosophy.md` — one named runtime source per closed vocabulary.\n */\n\nimport mime from 'mime';\n\n/**\n * Formats an agent may be asked to emit, and that the framework can map to an extension and a MIME\n * type. Closed on purpose: a format belongs here only once the registry below can answer both\n * mappings for it.\n */\nexport enum AgentFileFormat {\n  /** Unstructured prose. The default when no format is declared. */\n  TEXT = 'text',\n  /** TypeScript source. `.ts` — module code, schemas, configuration. */\n  TYPESCRIPT = 'typescript',\n  /** TypeScript with JSX. `.tsx` — a component; distinct from TYPESCRIPT because the extension differs and a `.ts` file containing JSX does not compile. */\n  TYPESCRIPT_JSX = 'typescript_react',\n  /** Markdown. Documentation, prompts, authored prose an agent produces for a human. */\n  MARKDOWN = 'markdown',\n  /** JSON. Structured data an agent emits for a machine. */\n  JSON = 'json',\n  /** YAML. Configuration and manifests, where comments and readability matter. */\n  YAML = 'yaml',\n}\n\n/**\n * The MIME type each {@link AgentFileFormat} is served and recognised as.\n *\n * Kept as a separate vocabulary rather than derived, because the reverse map below accepts\n * ALTERNATIVES this enum deliberately does not name as canonical (`text/yaml` for YAML).\n */\nexport enum AgentFileMime {\n  TEXT_PLAIN = 'text/plain',\n  MARKDOWN = 'text/markdown',\n  JSON = 'application/json',\n  TYPESCRIPT = 'application/typescript',\n  TYPESCRIPT_JSX = 'application/typescript-jsx',\n  YAML = 'application/yaml',\n}\n\n/**\n * The format union, kept as a named alias because callers that hold a plain `string` from a\n * registry lookup need something to widen to.\n */\nexport type AgentFileFormatType = `${AgentFileFormat}`;\n\n/** Canonical MIME type per format. */\nconst FORMAT_TO_MIME: Record<string, string> = {\n  [AgentFileFormat.TEXT]: AgentFileMime.TEXT_PLAIN,\n  [AgentFileFormat.MARKDOWN]: AgentFileMime.MARKDOWN,\n  [AgentFileFormat.JSON]: AgentFileMime.JSON,\n  [AgentFileFormat.TYPESCRIPT]: AgentFileMime.TYPESCRIPT,\n  [AgentFileFormat.TYPESCRIPT_JSX]: AgentFileMime.TYPESCRIPT_JSX,\n  [AgentFileFormat.YAML]: AgentFileMime.YAML,\n};\n\n/** Canonical file extension per format. */\nconst FORMAT_TO_EXTENSION: Record<string, string> = {\n  [AgentFileFormat.TEXT]: 'txt',\n  [AgentFileFormat.MARKDOWN]: 'md',\n  [AgentFileFormat.JSON]: 'json',\n  [AgentFileFormat.TYPESCRIPT]: 'ts',\n  [AgentFileFormat.TYPESCRIPT_JSX]: 'tsx',\n  [AgentFileFormat.YAML]: 'yaml',\n};\n\n/** Extension to format, including accepted alternatives. */\nconst EXTENSION_TO_FORMAT: Record<string, string> = {\n  'txt': AgentFileFormat.TEXT,\n  'md': AgentFileFormat.MARKDOWN,\n  'json': AgentFileFormat.JSON,\n  'ts': AgentFileFormat.TYPESCRIPT,\n  'tsx': AgentFileFormat.TYPESCRIPT_JSX,\n  'yaml': AgentFileFormat.YAML,\n  'yml': AgentFileFormat.YAML, // Alternative extension for YAML\n};\n\n/** MIME type to format, including accepted alternatives. */\nconst MIME_TO_FORMAT: Record<string, string> = {\n  'text/plain': AgentFileFormat.TEXT,\n  'text/markdown': AgentFileFormat.MARKDOWN,\n  'application/json': AgentFileFormat.JSON,\n  'application/typescript': AgentFileFormat.TYPESCRIPT,\n  'application/typescript-jsx': AgentFileFormat.TYPESCRIPT_JSX,\n  'application/yaml': AgentFileFormat.YAML,\n  'text/yaml': AgentFileFormat.YAML, // Alternative MIME type\n};\n\n/**\n * Registry for agent/blueprint file formats.\n */\nexport class AgentFileFormatRegistry {\n  /**\n   * Get the MIME type for a format.\n   * \n   * @param format - an `AgentFileFormat` value (or a compatible string)\n   * @returns MIME type string\n   */\n  static getMimeType(format: string): string {\n    return FORMAT_TO_MIME[format] || '';\n  }\n  \n  /**\n   * Get the file extension for a format.\n   * \n   * @param format - an `AgentFileFormat` value (or a compatible string)\n   * @returns Extension string (without dot)\n   */\n  static getExtension(format: string): string {\n    return FORMAT_TO_EXTENSION[format] || '';\n  }\n  \n  /**\n   * Get the format for a file extension.\n   * \n   * @param extension - File extension (without dot)\n   * @returns an `AgentFileFormat` value as a string, or undefined\n   */\n  static getFormatFromExtension(extension: string): string | undefined {\n    if (!extension) return undefined;\n    \n    const normalizedExt = extension.toLowerCase().trim();\n    return EXTENSION_TO_FORMAT[normalizedExt];\n  }\n  \n  /**\n   * Get the format for a MIME type.\n   * \n   * @param mimeType - MIME type string\n   * @returns an `AgentFileFormat` value as a string, or undefined\n   */\n  static getFormatFromMimeType(mimeType: string): string | undefined {\n    if (!mimeType) return undefined;\n    \n    const normalizedMime = mimeType.toLowerCase().trim();\n    return MIME_TO_FORMAT[normalizedMime];\n  }\n  \n  /**\n   * Check if extension is an agent file format.\n   * \n   * @param extension - File extension (without dot)\n   * @returns true if extension is an agent format\n   */\n  static isAgentFormat(extension: string): boolean {\n    return this.getFormatFromExtension(extension) !== undefined;\n  }\n  \n  /**\n   * Check if MIME type is an agent file format.\n   * \n   * @param mimeType - MIME type string\n   * @returns true if MIME type is an agent format\n   */\n  static isAgentMimeType(mimeType: string): boolean {\n    return this.getFormatFromMimeType(mimeType) !== undefined;\n  }\n  \n  /**\n   * Get all agent format extensions.\n   * \n   * @returns Array of extension strings\n   */\n  static getAllExtensions(): string[] {\n    return Object.values(FORMAT_TO_EXTENSION);\n  }\n  \n  /**\n   * Get all agent format MIME types.\n   * \n   * @returns Array of MIME type strings\n   */\n  static getAllMimeTypes(): string[] {\n    return Object.values(FORMAT_TO_MIME);\n  }\n}\n"]}

package/dist/esm/files/unified-registry.d.ts

@@ -7,7 +7,7 @@
 import { FileNature } from '../zod-decorators.types';
 /**
  * Result type for format type detection.
- * format is a string compatible with AppsBlueprint_FileFormat enum.
+ * format is a string compatible with the `AgentFileFormat` enum.
  */
 export type FormatTypeResult = {
     type: 'nature';
@@ -43,7 +43,7 @@ export declare class UnifiedFileFormatRegistry {
      */
     static getExtensions(mimeType: string): string[];
     /**
-     * Get format type (FileNature or AppsBlueprint_FileFormat) from extension.
+     * Get format type (FileNature or `AgentFileFormat`) from extension.
      *
      * @param extension - File extension (without dot)
      * @returns FormatTypeResult indicating whether it's a nature or agent format

package/dist/esm/files/unified-registry.js

@@ -61,7 +61,7 @@ export class UnifiedFileFormatRegistry {
         return FileMimeTypeRegistry.getExtensions(mimeType);
     }
     /**
-     * Get format type (FileNature or AppsBlueprint_FileFormat) from extension.
+     * Get format type (FileNature or `AgentFileFormat`) from extension.
      *
      * @param extension - File extension (without dot)
      * @returns FormatTypeResult indicating whether it's a nature or agent format

package/dist/esm/files/unified-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-registry.js","sourceRoot":"","sources":["../../../../src/files/unified-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAW/D;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACtC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACjE,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAiB;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1D,CAAC;QAED,qCAAqC;QACrC,OAAO,oBAAoB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,4BAA4B;QAC5B,MAAM,WAAW,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,uBAAuB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAC9D,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,CAAC;QAED,qCAAqC;QACrC,OAAO,oBAAoB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAiB;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAgB;QAC/C,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,OAAO,uBAAuB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAgB;QACrC,OAAO,uBAAuB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAiB,EAAE,QAAgB;QACnE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE1C,4BAA4B;QAC5B,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACtE,OAAO,YAAY,KAAK,QAAQ,CAAC;QACnC,CAAC;QAED,uCAAuC;QACvC,OAAO,oBAAoB,CAAC,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAiB;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,gCAAgC;QAChC,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,qDAAqD;YACrD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,iCAAiC;QACjC,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAkB;QAC9C,OAAO,oBAAoB,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAkB;QAC7C,OAAO,oBAAoB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF","sourcesContent":["/**\n * Unified File Format Registry\n * \n * Unified registry that handles both general files and agent/blueprint formats.\n * Provides a single API for all file format operations.\n */\n\nimport { FileNature } from '../zod-decorators.types';\nimport { FileMimeTypeRegistry } from './mime-registry';\nimport { AgentFileFormatRegistry } from './agent-file-formats';\n\n/**\n * Result type for format type detection.\n * format is a string compatible with AppsBlueprint_FileFormat enum.\n */\nexport type FormatTypeResult =\n  | { type: 'nature'; nature: FileNature }\n  | { type: 'agent'; format: string } // Compatible with AppsBlueprint_FileFormat\n  | undefined;\n\n/**\n * Unified registry for all file formats (general + agent).\n */\nexport class UnifiedFileFormatRegistry {\n  /**\n   * Extract file extension from filename (without dot, lowercase).\n   * \n   * @param filename - Full filename or path\n   * @returns File extension (without dot) or empty string if not found\n   */\n  static getFileExtension(filename: string): string {\n    if (!filename) return '';\n    const lastDot = filename.lastIndexOf('.');\n    if (lastDot === -1 || lastDot === filename.length - 1) return '';\n    return filename.substring(lastDot + 1).toLowerCase();\n  }\n\n  /**\n   * Get MIME type from extension (works for both general files and agent formats).\n   * \n   * @param extension - File extension (without dot)\n   * @returns MIME type string or undefined if not found\n   */\n  static getMimeType(extension: string): string | undefined {\n    if (!extension) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      return AgentFileFormatRegistry.getMimeType(agentFormat);\n    }\n    \n    // Fall back to general file registry\n    return FileMimeTypeRegistry.getMimeType(extension);\n  }\n  \n  /**\n   * Get all extensions for a MIME type.\n   * Works for both general files and agent formats.\n   * \n   * @param mimeType - MIME type string\n   * @returns Array of extensions (without dots)\n   */\n  static getExtensions(mimeType: string): string[] {\n    if (!mimeType) return [];\n    \n    // Check agent formats first\n    const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);\n    if (agentFormat) {\n      const ext = AgentFileFormatRegistry.getExtension(agentFormat);\n      return ext ? [ext] : [];\n    }\n    \n    // Fall back to general file registry\n    return FileMimeTypeRegistry.getExtensions(mimeType);\n  }\n\n  /**\n   * Get format type (FileNature or AppsBlueprint_FileFormat) from extension.\n   * \n   * @param extension - File extension (without dot)\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatType(extension: string): FormatTypeResult {\n    if (!extension) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      return { type: 'agent', format: agentFormat };\n    }\n    \n    // Check general file nature\n    const nature = FileMimeTypeRegistry.getNatureFromExtension(extension);\n    if (nature) {\n      return { type: 'nature', nature };\n    }\n    \n    return undefined;\n  }\n  \n  /**\n   * Get format type from extension (alias for getFormatType for consistency).\n   * \n   * @param extension - File extension (without dot)\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatTypeFromExtension(extension: string): FormatTypeResult {\n    return this.getFormatType(extension);\n  }\n\n  /**\n   * Get format type from MIME type.\n   * \n   * @param mimeType - MIME type string\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatTypeFromMimeType(mimeType: string): FormatTypeResult {\n    if (!mimeType) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);\n    if (agentFormat) {\n      return { type: 'agent', format: agentFormat };\n    }\n    \n    // Check general file nature\n    const nature = FileMimeTypeRegistry.getNatureFromMimeType(mimeType);\n    if (nature) {\n      return { type: 'nature', nature };\n    }\n    \n    return undefined;\n  }\n  \n  /**\n   * Check if file is an agent/blueprint format.\n   * \n   * @param extension - File extension (without dot)\n   * @returns true if extension is an agent format\n   */\n  static isAgentFormat(extension: string): boolean {\n    return AgentFileFormatRegistry.isAgentFormat(extension);\n  }\n  \n  /**\n   * Check if MIME type is an agent/blueprint format.\n   * \n   * @param mimeType - MIME type string\n   * @returns true if MIME type is an agent format\n   */\n  static isAgentMimeType(mimeType: string): boolean {\n    return AgentFileFormatRegistry.isAgentMimeType(mimeType);\n  }\n  \n  /**\n   * Validate that extension matches MIME type.\n   * Works for both general files and agent formats.\n   * \n   * @param extension - File extension (without dot)\n   * @param mimeType - MIME type string\n   * @returns true if extension matches MIME type\n   */\n  static validateExtensionMimeMatch(extension: string, mimeType: string): boolean {\n    if (!extension || !mimeType) return false;\n    \n    // Check agent formats first\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      const expectedMime = AgentFileFormatRegistry.getMimeType(agentFormat);\n      return expectedMime === mimeType;\n    }\n    \n    // Fall back to general file validation\n    return FileMimeTypeRegistry.validateExtensionMimeMatch(extension, mimeType);\n  }\n  \n  /**\n   * Normalize extension to canonical format name.\n   * Works for both general files and agent formats.\n   * \n   * @param extension - File extension (without dot)\n   * @returns Normalized format name\n   */\n  static normalizeExtension(extension: string): string {\n    if (!extension) return extension;\n    \n    // Check if it's an agent format\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      // For agent formats, return the format name directly\n      return agentFormat;\n    }\n    \n    // Use general file normalization\n    return FileMimeTypeRegistry.normalizeExtension(extension);\n  }\n  \n  /**\n   * Get all extensions for a FileNature.\n   * \n   * @param nature - FileNature enum value\n   * @returns Array of extensions (without dots)\n   */\n  static getExtensionsForNature(nature: FileNature): string[] {\n    return FileMimeTypeRegistry.getExtensionsForNature(nature);\n  }\n  \n  /**\n   * Get all MIME types for a FileNature.\n   * \n   * @param nature - FileNature enum value\n   * @returns Array of MIME type strings\n   */\n  static getMimeTypesForNature(nature: FileNature): string[] {\n    return FileMimeTypeRegistry.getMimeTypesForNature(nature);\n  }\n}\n"]}
+{"version":3,"file":"unified-registry.js","sourceRoot":"","sources":["../../../../src/files/unified-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAW/D;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACtC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACjE,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAiB;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1D,CAAC;QAED,qCAAqC;QACrC,OAAO,oBAAoB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,4BAA4B;QAC5B,MAAM,WAAW,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,uBAAuB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAC9D,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,CAAC;QAED,qCAAqC;QACrC,OAAO,oBAAoB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAiB;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAgB;QAC/C,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,4CAA4C;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,OAAO,uBAAuB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAgB;QACrC,OAAO,uBAAuB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,0BAA0B,CAAC,SAAiB,EAAE,QAAgB;QACnE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE1C,4BAA4B;QAC5B,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACtE,OAAO,YAAY,KAAK,QAAQ,CAAC;QACnC,CAAC;QAED,uCAAuC;QACvC,OAAO,oBAAoB,CAAC,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAiB;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAEjC,gCAAgC;QAChC,MAAM,WAAW,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,EAAE,CAAC;YAChB,qDAAqD;YACrD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,iCAAiC;QACjC,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,MAAkB;QAC9C,OAAO,oBAAoB,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAkB;QAC7C,OAAO,oBAAoB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF","sourcesContent":["/**\n * Unified File Format Registry\n * \n * Unified registry that handles both general files and agent/blueprint formats.\n * Provides a single API for all file format operations.\n */\n\nimport { FileNature } from '../zod-decorators.types';\nimport { FileMimeTypeRegistry } from './mime-registry';\nimport { AgentFileFormatRegistry } from './agent-file-formats';\n\n/**\n * Result type for format type detection.\n * format is a string compatible with the `AgentFileFormat` enum.\n */\nexport type FormatTypeResult =\n  | { type: 'nature'; nature: FileNature }\n  | { type: 'agent'; format: string } // Compatible with `AgentFileFormat`\n  | undefined;\n\n/**\n * Unified registry for all file formats (general + agent).\n */\nexport class UnifiedFileFormatRegistry {\n  /**\n   * Extract file extension from filename (without dot, lowercase).\n   * \n   * @param filename - Full filename or path\n   * @returns File extension (without dot) or empty string if not found\n   */\n  static getFileExtension(filename: string): string {\n    if (!filename) return '';\n    const lastDot = filename.lastIndexOf('.');\n    if (lastDot === -1 || lastDot === filename.length - 1) return '';\n    return filename.substring(lastDot + 1).toLowerCase();\n  }\n\n  /**\n   * Get MIME type from extension (works for both general files and agent formats).\n   * \n   * @param extension - File extension (without dot)\n   * @returns MIME type string or undefined if not found\n   */\n  static getMimeType(extension: string): string | undefined {\n    if (!extension) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      return AgentFileFormatRegistry.getMimeType(agentFormat);\n    }\n    \n    // Fall back to general file registry\n    return FileMimeTypeRegistry.getMimeType(extension);\n  }\n  \n  /**\n   * Get all extensions for a MIME type.\n   * Works for both general files and agent formats.\n   * \n   * @param mimeType - MIME type string\n   * @returns Array of extensions (without dots)\n   */\n  static getExtensions(mimeType: string): string[] {\n    if (!mimeType) return [];\n    \n    // Check agent formats first\n    const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);\n    if (agentFormat) {\n      const ext = AgentFileFormatRegistry.getExtension(agentFormat);\n      return ext ? [ext] : [];\n    }\n    \n    // Fall back to general file registry\n    return FileMimeTypeRegistry.getExtensions(mimeType);\n  }\n\n  /**\n   * Get format type (FileNature or `AgentFileFormat`) from extension.\n   * \n   * @param extension - File extension (without dot)\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatType(extension: string): FormatTypeResult {\n    if (!extension) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      return { type: 'agent', format: agentFormat };\n    }\n    \n    // Check general file nature\n    const nature = FileMimeTypeRegistry.getNatureFromExtension(extension);\n    if (nature) {\n      return { type: 'nature', nature };\n    }\n    \n    return undefined;\n  }\n  \n  /**\n   * Get format type from extension (alias for getFormatType for consistency).\n   * \n   * @param extension - File extension (without dot)\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatTypeFromExtension(extension: string): FormatTypeResult {\n    return this.getFormatType(extension);\n  }\n\n  /**\n   * Get format type from MIME type.\n   * \n   * @param mimeType - MIME type string\n   * @returns FormatTypeResult indicating whether it's a nature or agent format\n   */\n  static getFormatTypeFromMimeType(mimeType: string): FormatTypeResult {\n    if (!mimeType) return undefined;\n    \n    // Check agent formats first (more specific)\n    const agentFormat = AgentFileFormatRegistry.getFormatFromMimeType(mimeType);\n    if (agentFormat) {\n      return { type: 'agent', format: agentFormat };\n    }\n    \n    // Check general file nature\n    const nature = FileMimeTypeRegistry.getNatureFromMimeType(mimeType);\n    if (nature) {\n      return { type: 'nature', nature };\n    }\n    \n    return undefined;\n  }\n  \n  /**\n   * Check if file is an agent/blueprint format.\n   * \n   * @param extension - File extension (without dot)\n   * @returns true if extension is an agent format\n   */\n  static isAgentFormat(extension: string): boolean {\n    return AgentFileFormatRegistry.isAgentFormat(extension);\n  }\n  \n  /**\n   * Check if MIME type is an agent/blueprint format.\n   * \n   * @param mimeType - MIME type string\n   * @returns true if MIME type is an agent format\n   */\n  static isAgentMimeType(mimeType: string): boolean {\n    return AgentFileFormatRegistry.isAgentMimeType(mimeType);\n  }\n  \n  /**\n   * Validate that extension matches MIME type.\n   * Works for both general files and agent formats.\n   * \n   * @param extension - File extension (without dot)\n   * @param mimeType - MIME type string\n   * @returns true if extension matches MIME type\n   */\n  static validateExtensionMimeMatch(extension: string, mimeType: string): boolean {\n    if (!extension || !mimeType) return false;\n    \n    // Check agent formats first\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      const expectedMime = AgentFileFormatRegistry.getMimeType(agentFormat);\n      return expectedMime === mimeType;\n    }\n    \n    // Fall back to general file validation\n    return FileMimeTypeRegistry.validateExtensionMimeMatch(extension, mimeType);\n  }\n  \n  /**\n   * Normalize extension to canonical format name.\n   * Works for both general files and agent formats.\n   * \n   * @param extension - File extension (without dot)\n   * @returns Normalized format name\n   */\n  static normalizeExtension(extension: string): string {\n    if (!extension) return extension;\n    \n    // Check if it's an agent format\n    const agentFormat = AgentFileFormatRegistry.getFormatFromExtension(extension);\n    if (agentFormat) {\n      // For agent formats, return the format name directly\n      return agentFormat;\n    }\n    \n    // Use general file normalization\n    return FileMimeTypeRegistry.normalizeExtension(extension);\n  }\n  \n  /**\n   * Get all extensions for a FileNature.\n   * \n   * @param nature - FileNature enum value\n   * @returns Array of extensions (without dots)\n   */\n  static getExtensionsForNature(nature: FileNature): string[] {\n    return FileMimeTypeRegistry.getExtensionsForNature(nature);\n  }\n  \n  /**\n   * Get all MIME types for a FileNature.\n   * \n   * @param nature - FileNature enum value\n   * @returns Array of MIME type strings\n   */\n  static getMimeTypesForNature(nature: FileNature): string[] {\n    return FileMimeTypeRegistry.getMimeTypesForNature(nature);\n  }\n}\n"]}

package/dist/esm/index.d.ts

@@ -8,6 +8,7 @@ export * from './zod-money';
 export * from './zod-bigdecimal';
 export * from './zod-duration';
 export * from './zod-phone';
+export * from './zod-address';
 export * from './zod-code';
 export * from './zod-file';
 export * from './zod-versioned';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,OAAO,CAAK,GAAG,OAAO,CAAC,CAErE;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,OAAO,CAAK,GAAG,OAAO,CAAC,CAErE;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG"}

package/dist/esm/index.js

@@ -23,6 +23,7 @@ export * from './zod-money.js';
 export * from './zod-bigdecimal.js';
 export * from './zod-duration.js';
 export * from './zod-phone.js';
+export * from './zod-address.js';
 export * from './zod-code.js';
 export * from './zod-file.js';
 export * from './zod-versioned.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,uEAAuE;AACvE,4FAA4F;AAC5F,0FAA0F;AAC1F,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,kFAAkF;AAClF,yBAAyB,EAAE,CAAC;AAE5B,MAAM,UAAU,iBAAiB,CAAC,cAAwB,CAAC;IACzD,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG","sourcesContent":["import { z } from 'zod';\nimport { ensureZodDecoratorsLoaded } from './zod.module-override';\nimport { installBigIntJsonEncoding } from './install-bigint-json-encoding';\n\n// CRITICAL: Apply decorators immediately when this module is imported.\n// This ensures z.string().isUnique() etc. work without needing to call initZodDecorators().\n// The bundler may tree-shake the call in zod.module-override.ts, so we duplicate it here.\nensureZodDecoratorsLoaded(z);\n\n// Install the type-level `bigint → decimal string` JSON encoding at the SAME\n// bootstrap. `z_money` (owned by this package) stores `amount` as a `bigint`,\n// which `JSON.stringify` cannot serialize (it has no `toJSON`, unlike `Date`).\n// Installing it here — the earliest point, before any schema or serializer runs —\n// makes every JSON boundary (res.json, socket.io, queue, redis, HMAC, third-party)\n// bigint-safe with no per-boundary opt-in. See `install-bigint-json-encoding.ts`.\ninstallBigIntJsonEncoding();\n\nexport function initZodDecorators(zodInstance: typeof z = z): typeof z {\n  return ensureZodDecoratorsLoaded(zodInstance);\n}\n\nexport * from './commons';\n\nexport * from './install-bigint-json-encoding';\nexport * from './zod-color';\nexport * from './zod-range';\nexport * from './zod-money';\nexport * from './zod-bigdecimal';\nexport * from './zod-duration';\nexport * from './zod-phone';\nexport * from './zod-code';\nexport * from './zod-file';\nexport * from './zod-versioned';\nexport * from './currencies.shared.schemas';\nexport * from './zod-utils.shared';\nexport * from './zod-decorators.types';\nexport * from './zod.module-override';\nexport * from './files/file-extensions.enum';\nexport * from './files/extension-nature-map';\nexport * from './files/mime-registry';\nexport * from './files/agent-file-formats';\nexport * from './files/unified-registry';\n\n\n\n/**\n * Initialize Zod decorators for the current Zod instance.\n * Safe to call multiple times - will only apply decorators once.\n *\n * This function should be called early in your application startup,\n * especially when using custom-shared-lib or custom-backend-lib packages.\n */\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,uEAAuE;AACvE,4FAA4F;AAC5F,0FAA0F;AAC1F,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAE7B,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,kFAAkF;AAClF,yBAAyB,EAAE,CAAC;AAE5B,MAAM,UAAU,iBAAiB,CAAC,cAAwB,CAAC;IACzD,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,cAAc,WAAW,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AAIzC;;;;;;GAMG","sourcesContent":["import { z } from 'zod';\nimport { ensureZodDecoratorsLoaded } from './zod.module-override';\nimport { installBigIntJsonEncoding } from './install-bigint-json-encoding';\n\n// CRITICAL: Apply decorators immediately when this module is imported.\n// This ensures z.string().isUnique() etc. work without needing to call initZodDecorators().\n// The bundler may tree-shake the call in zod.module-override.ts, so we duplicate it here.\nensureZodDecoratorsLoaded(z);\n\n// Install the type-level `bigint → decimal string` JSON encoding at the SAME\n// bootstrap. `z_money` (owned by this package) stores `amount` as a `bigint`,\n// which `JSON.stringify` cannot serialize (it has no `toJSON`, unlike `Date`).\n// Installing it here — the earliest point, before any schema or serializer runs —\n// makes every JSON boundary (res.json, socket.io, queue, redis, HMAC, third-party)\n// bigint-safe with no per-boundary opt-in. See `install-bigint-json-encoding.ts`.\ninstallBigIntJsonEncoding();\n\nexport function initZodDecorators(zodInstance: typeof z = z): typeof z {\n  return ensureZodDecoratorsLoaded(zodInstance);\n}\n\nexport * from './commons';\n\nexport * from './install-bigint-json-encoding';\nexport * from './zod-color';\nexport * from './zod-range';\nexport * from './zod-money';\nexport * from './zod-bigdecimal';\nexport * from './zod-duration';\nexport * from './zod-phone';\nexport * from './zod-address';\nexport * from './zod-code';\nexport * from './zod-file';\nexport * from './zod-versioned';\nexport * from './currencies.shared.schemas';\nexport * from './zod-utils.shared';\nexport * from './zod-decorators.types';\nexport * from './zod.module-override';\nexport * from './files/file-extensions.enum';\nexport * from './files/extension-nature-map';\nexport * from './files/mime-registry';\nexport * from './files/agent-file-formats';\nexport * from './files/unified-registry';\n\n\n\n/**\n * Initialize Zod decorators for the current Zod instance.\n * Safe to call multiple times - will only apply decorators once.\n *\n * This function should be called early in your application startup,\n * especially when using custom-shared-lib or custom-backend-lib packages.\n */\n"]}

package/dist/esm/testing.d.ts

@@ -1,6 +1,17 @@
 /**
  * Public testing surface for @wildo-ai/zod-decorators.
  * Import from `@wildo-ai/zod-decorators/testing`.
+ *
+ * entrypoint-waiver: an AUDIENCE boundary, not a file alias. Folding these fixtures into the root
+ * barrel would put them in the production graph of every consumer — the root is `sideEffects`-marked
+ * and reaches every frontend bundle — so the subpath is what keeps a test-only surface out of it.
+ * Rule 3 counts re-exported FILES and cannot see that distinction; the sibling `/testing` surfaces on
+ * `saas-models` and `saas-frontend-lib` are the same shape. Growing a second file purely to satisfy
+ * the count was rejected: it would invent surface nobody asked for.
+ *
+ * The waiver also suppresses rule 1 (`root-barrel-overlap`) for this barrel, which is a real loss.
+ * `published-testing-surface.contract.test.ts` restores it: it asserts the root barrel publishes
+ * none of the symbols below, which is the overlap rule 1 would have caught.
  */
 export * from './testing/decorated-test-schemas';
 //# sourceMappingURL=testing.d.ts.map

package/dist/esm/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,kCAAkC,CAAC"}

package/dist/esm/testing.js

@@ -1,6 +1,17 @@
 /**
  * Public testing surface for @wildo-ai/zod-decorators.
  * Import from `@wildo-ai/zod-decorators/testing`.
+ *
+ * entrypoint-waiver: an AUDIENCE boundary, not a file alias. Folding these fixtures into the root
+ * barrel would put them in the production graph of every consumer — the root is `sideEffects`-marked
+ * and reaches every frontend bundle — so the subpath is what keeps a test-only surface out of it.
+ * Rule 3 counts re-exported FILES and cannot see that distinction; the sibling `/testing` surfaces on
+ * `saas-models` and `saas-frontend-lib` are the same shape. Growing a second file purely to satisfy
+ * the count was rejected: it would invent surface nobody asked for.
+ *
+ * The waiver also suppresses rule 1 (`root-barrel-overlap`) for this barrel, which is a real loss.
+ * `published-testing-surface.contract.test.ts` restores it: it asserts the root barrel publishes
+ * none of the symbols below, which is the overlap rule 1 would have caught.
  */
 export * from './testing/decorated-test-schemas.js';
 //# sourceMappingURL=testing.js.map

package/dist/esm/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kCAAkC,CAAC","sourcesContent":["/**\n * Public testing surface for @wildo-ai/zod-decorators.\n * Import from `@wildo-ai/zod-decorators/testing`.\n */\nexport * from './testing/decorated-test-schemas';\n"]}
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,kCAAkC,CAAC","sourcesContent":["/**\n * Public testing surface for @wildo-ai/zod-decorators.\n * Import from `@wildo-ai/zod-decorators/testing`.\n *\n * entrypoint-waiver: an AUDIENCE boundary, not a file alias. Folding these fixtures into the root\n * barrel would put them in the production graph of every consumer — the root is `sideEffects`-marked\n * and reaches every frontend bundle — so the subpath is what keeps a test-only surface out of it.\n * Rule 3 counts re-exported FILES and cannot see that distinction; the sibling `/testing` surfaces on\n * `saas-models` and `saas-frontend-lib` are the same shape. Growing a second file purely to satisfy\n * the count was rejected: it would invent surface nobody asked for.\n *\n * The waiver also suppresses rule 1 (`root-barrel-overlap`) for this barrel, which is a real loss.\n * `published-testing-surface.contract.test.ts` restores it: it asserts the root barrel publishes\n * none of the symbols below, which is the overlap rule 1 would have caught.\n */\nexport * from './testing/decorated-test-schemas';\n"]}