@workos/oagen 0.30.1 → 0.31.0

package/dist/differ-B0DSuKUZ.d.mts

@@ -0,0 +1,72 @@
+import { Et as LanguageHints, Gt as CompatPolicyHints, Lt as CompatSymbol, Pt as CompatSnapshot, St as ApiSurface, Vt as LanguageId, ot as CompatChangeCategory, st as CompatChangeSeverity, ut as CompatProvenance, wt as DiffResult } from "./types-I7W7CNl1.mjs";
+//#region src/compat/classify.d.ts
+/** A single classified compatibility change. */
+interface ClassifiedChange {
+  /** Specific change category. */
+  category: CompatChangeCategory;
+  /** Policy-aware severity (may differ from defaultSeverityForCategory). */
+  severity: CompatChangeSeverity;
+  /** Fully-qualified symbol path. */
+  symbol: string;
+  /** Deterministic ID for grouping related changes across languages. */
+  conceptualChangeId: string;
+  /** Where the drift originated. */
+  provenance: CompatProvenance;
+  /** Description of the old state. */
+  old: Record<string, string>;
+  /** Description of the new state. */
+  new: Record<string, string>;
+  /** Human-readable explanation. */
+  message: string;
+  /**
+   * Optional spec-level remediation hint. Set by post-classification rules
+   * (see `detectForkedSchemas` in differ.ts) when a change has a recognized
+   * upstream root cause that the spec author can fix. Surfaces in both the
+   * machine-readable report and the human-readable summary.
+   */
+  remediation?: string;
+}
+/** Result of classifying all changes between two snapshots. */
+interface ClassificationResult {
+  changes: ClassifiedChange[];
+  summary: {
+    breaking: number;
+    softRisk: number;
+    additive: number;
+  };
+}
+/**
+ * Classify changes between a baseline and candidate symbol.
+ * Returns one or more classified changes for the diff.
+ */
+declare function classifySymbolChanges(baseline: CompatSymbol, candidate: CompatSymbol | undefined, policy: CompatPolicyHints, language?: LanguageId): ClassifiedChange[];
+/**
+ * Classify a new symbol as additive.
+ */
+declare function classifyAddedSymbol(symbol: CompatSymbol): ClassifiedChange;
+/** Summarize a list of classified changes by severity. */
+declare function summarizeChanges(changes: ClassifiedChange[]): ClassificationResult['summary'];
+//#endregion
+//#region src/compat/differ.d.ts
+/** Result of diffing two compat snapshots. */
+interface CompatDiffResult {
+  changes: ClassifiedChange[];
+  summary: ClassificationResult['summary'];
+}
+/**
+ * Diff two compat snapshots, producing classified changes with
+ * policy-aware severity.
+ */
+declare function diffSnapshots(baseline: CompatSnapshot, candidate: CompatSnapshot, policy?: CompatPolicyHints): CompatDiffResult;
+/**
+ * Compare two ApiSurface objects and return a DiffResult.
+ *
+ * This preserves the existing diffing behavior used by the overlay retry loop,
+ * compat check, and all existing tests. The internal implementation uses the
+ * same algorithms as before to maintain full backward compatibility with
+ * overlay patching and verification workflows.
+ */
+declare function diffSurfaces(baseline: ApiSurface, candidate: ApiSurface, hints: LanguageHints): DiffResult;
+//#endregion
+export { ClassifiedChange as a, summarizeChanges as c, ClassificationResult as i, diffSnapshots as n, classifyAddedSymbol as o, diffSurfaces as r, classifySymbolChanges as s, CompatDiffResult as t };
+//# sourceMappingURL=differ-B0DSuKUZ.d.mts.map

package/dist/differ-B0DSuKUZ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ-B0DSuKUZ.d.mts","names":[],"sources":["../src/compat/classify.ts","../src/compat/differ.ts"],"mappings":";;;UAaiB;;EAEf,UAAU;;EAEV,UAAU;;EAEV;;EAEA;;EAEA,YAAY;;EAEZ,KAAK;;EAEL,KAAK;;EAEL;;;;;;;EAOA;;;UAIe;EACf,SAAS;EACT;IACE;IACA;IACA;;;;;;;iBAmMY,sBACd,UAAU,cACV,WAAW,0BACX,QAAQ,mBACR,WAAW,aACV;;;;iBAgYa,oBAAoB,QAAQ,eAAe;;iBAc3C,iBAAiB,SAAS,qBAAqB;;;;UCpmB9C;EACf,SAAS;EACT,SAAS;;;;;;iBAOK,cACd,UAAU,gBACV,WAAW,gBACX,SAAS,oBACR;;;;;;;;;iBAkqBa,aAAa,UAAU,YAAY,WAAW,YAAY,OAAO,gBAAgB"}

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import { A as collectEnumRefs, B as ErrorPolicy, C as Service, D as UnionType, E as TypeRef, F as validateModelHints, G as RequestGuardPolicy, H as LogEvent, I as walkTypeRef, J as TelemetryPolicy, K as RetryPolicy, L as AiAgentEnvVar, M as collectModelRefs, N as collectRequestBodyModels, O as assertNever, P as mapTypeRef, Q as mergeSdkBehavior, R as BackoffStrategy, S as ServerEntry, T as TypeParam, U as LoggingPolicy, V as IdempotencyPolicy, W as PaginationPolicy, X as UserAgentPolicy, Y as TimeoutPolicy, Z as defaultSdkBehavior, _ as Parameter, a as EnumRef, b as PrimitiveType, c as Field, d as MapType, f as Model, g as PaginationMeta, h as Operation, i as Enum, it as CompatConfig, j as collectFieldDependencies, k as assignModelsToServices, l as HttpMethod, m as NullableType, n as ArrayType, o as EnumValue, p as ModelRef, q as SdkBehavior, r as AuthScheme, s as ErrorResponse, t as ApiSpec, u as LiteralType, v as ParameterGroup, vt as ApiSurface, w as SuccessResponse, wt as OverlayLookup, x as SecurityRequirement, xt as Extractor, y as ParameterGroupVariant, z as DeepPartial } from "./types-yrBidOg3.mjs";
-
+import { $ as TimeoutPolicy, A as UnionType, B as walkTypeRef, C as SecurityRequirement, D as SuccessResponse, E as Service, F as collectModelRefs, G as IdempotencyPolicy, H as BackoffStrategy, I as collectRequestBodyModels, J as PaginationPolicy, K as LogEvent, L as collectResponseHeaders, M as assignModelsToServices, N as collectEnumRefs, O as TypeParam, Ot as OverlayLookup, P as collectFieldDependencies, Q as TelemetryPolicy, R as mapTypeRef, S as ResponseHeader, St as ApiSurface, T as ServerEntry, Tt as Extractor, U as DeepPartial, V as AiAgentEnvVar, W as ErrorPolicy, X as RetryPolicy, Y as RequestGuardPolicy, Z as SdkBehavior, _ as PaginationMeta, a as Enum, b as ParameterGroupVariant, c as ErrorResponse, ct as CompatConfig, d as LiteralType, et as UserAgentPolicy, f as MapType, g as Operation, h as NullableType, i as Constraints, j as assertNever, k as TypeRef, l as Field, m as ModelRef, n as ArrayType, nt as mergeSdkBehavior, o as EnumRef, p as Model, q as LoggingPolicy, r as AuthScheme, s as EnumValue, t as ApiSpec, tt as defaultSdkBehavior, u as HttpMethod, v as Parameter, w as SecurityRequirementSet, x as PrimitiveType, y as ParameterGroup, z as validateModelHints } from "./types-I7W7CNl1.mjs";
 //#region src/ir/operation-hints.d.ts
 /** Per-operation override keyed by "METHOD /path" (e.g. "POST /auth/token"). */
 interface OperationHint {
@@ -84,7 +83,7 @@ interface ResolvedWrapper {
  * 5. For POST on a resource path, if only one path param, use "create" singular
  * 6. Singularize the resource noun for single-resource operations
  */
-declare function deriveMethodName(op: Operation, _service: Service): string;
+export declare function deriveMethodName(op: Operation, _service: Service): string;
 /**
  * Resolve a service name to its mount target.
  *
@@ -102,7 +101,7 @@ declare function deriveMethodName(op: Operation, _service: Service): string;
  * @param mounts - Exact-name or trailing-`*` pattern → target service mappings.
  * @returns The mount target, or `name` unchanged when no rule matches.
  */
-declare function resolveMountTarget(name: string, mounts: Record<string, string>): string;
+export declare function resolveMountTarget(name: string, mounts: Record<string, string>): string;
 /**
  * Resolve all operations in the spec, applying hints and mount rules.
  *
@@ -112,7 +111,7 @@ declare function resolveMountTarget(name: string, mounts: Record<string, string>
  *   exact names or trailing-`*` prefix patterns (see {@link resolveMountTarget})
  * @returns Resolved operations ready for emitter consumption
  */
-declare function resolveOperations(spec: ApiSpec, hints?: Record<string, OperationHint>, mountRules?: Record<string, string>): ResolvedOperation[];
+export declare function resolveOperations(spec: ApiSpec, hints?: Record<string, OperationHint>, mountRules?: Record<string, string>): ResolvedOperation[];
 /** One pair of distinct paths that resolved to the same `mountOn.methodName`. */
 interface ResolvedMethodCollision {
   /** The shared `Service.method_name` key both paths resolved to. */
@@ -141,7 +140,7 @@ interface ResolvedMethodCollision {
  * will actually emit before calling this: a collision between two out-of-scope
  * paths is not that run's problem.
  */
-declare function findResolvedMethodCollisions(resolved: ResolvedOperation[]): ResolvedMethodCollision[];
+export declare function findResolvedMethodCollisions(resolved: ResolvedOperation[]): ResolvedMethodCollision[];
 //#endregion
 //#region src/errors.d.ts
 /**
@@ -151,41 +150,41 @@ declare function findResolvedMethodCollisions(resolved: ResolvedOperation[]): Re
  * The hint is appended to the `message` so it appears in stack traces and logs.
  */
 /** Base class for all oagen errors. */
-declare class OagenError extends Error {
+export declare class OagenError extends Error {
   readonly hint: string;
   constructor(message: string, hint: string);
 }
 /** Thrown when a command should terminate with a specific exit code. */
-declare class CommandError extends OagenError {
+export declare class CommandError extends OagenError {
   readonly exitCode: number;
   constructor(message: string, hint: string, exitCode: number);
 }
 /** Thrown when an OpenAPI spec cannot be parsed or has an unsupported version. */
-declare class SpecParseError extends OagenError {
+export declare class SpecParseError extends OagenError {
   constructor(message: string, hint: string);
 }
 /** Thrown when configuration files (manifests, API surfaces, overlays) are missing or malformed. */
-declare class ConfigError extends OagenError {
+export declare class ConfigError extends OagenError {
   constructor(message: string, hint: string);
 }
 /** Thrown when a config file exists but cannot be loaded or evaluated. */
-declare class ConfigLoadError extends ConfigError {
+export declare class ConfigLoadError extends ConfigError {
   constructor(message: string, hint: string);
 }
 /** Thrown when a config targets a different IR version than the installed package. */
-declare class ConfigVersionMismatchError extends ConfigError {
+export declare class ConfigVersionMismatchError extends ConfigError {
   constructor(message: string, hint: string);
 }
 /** Thrown when an API surface extractor encounters a problem. */
-declare class ExtractorError extends OagenError {
+export declare class ExtractorError extends OagenError {
   constructor(message: string, hint: string);
 }
 /** Thrown when a requested language or extractor is not found in a registry. */
-declare class RegistryError extends OagenError {
+export declare class RegistryError extends OagenError {
   constructor(message: string, hint: string);
 }
 /** Thrown for internal invariant violations that indicate a bug. */
-declare class InternalError extends OagenError {
+export declare class InternalError extends OagenError {
   constructor(message: string, hint: string);
 }
 //#endregion
@@ -428,6 +427,15 @@ interface ParamChange {
   details?: string;
 }
 //#endregion
+//#region src/parser/schemas.d.ts
+/**
+ * Signature of the `schemaNameTransform` hook. `name` is the cleaned
+ * PascalCase name; `originalName` is the `components.schemas` key exactly
+ * as spelled in the document, or `undefined` for names oagen synthesises.
+ * See `SchemaExtractionOptions.schemaNameTransform`.
+ */
+type SchemaNameTransform = (name: string, originalName?: string) => string;
+//#endregion
 //#region src/parser/parse.d.ts
 /**
  * A bundled OpenAPI document, post-`$ref` resolution but pre-IR extraction.
@@ -440,7 +448,13 @@ interface ParamChange {
 type OpenApiDocument = Record<string, unknown>;
 interface ParseOptions {
   operationIdTransform?: (id: string) => string;
-  schemaNameTransform?: (name: string) => string;
+  /**
+   * Custom transform for schema (model/enum) names. Receives the cleaned
+   * PascalCase name and, for component schemas, the original name as spelled
+   * in the document. Returning `originalName` opts out of normalization.
+   * See `SchemaExtractionOptions.schemaNameTransform`.
+   */
+  schemaNameTransform?: SchemaNameTransform;
   /**
    * Domain-facing field-name overrides, keyed by IR model name then wire field
    * name: `{ Connection: { connection_type: 'type' } }`. Sets `Field.domainName`
@@ -464,10 +478,10 @@ interface ParseOptions {
    */
   transformSpec?: (spec: OpenApiDocument) => OpenApiDocument;
 }
-declare function parseSpec(specPath: string, options?: ParseOptions): Promise<ApiSpec>;
+export declare function parseSpec(specPath: string, options?: ParseOptions): Promise<ApiSpec>;
 //#endregion
 //#region src/engine/orchestrator.d.ts
-declare function generate(spec: ApiSpec, emitter: Emitter, options: {
+export declare function generate(spec: ApiSpec, emitter: Emitter, options: {
   namespace: string;
   dryRun?: boolean;
   outputDir: string;
@@ -477,7 +491,8 @@ declare function generate(spec: ApiSpec, emitter: Emitter, options: {
   operationHints?: Record<string, OperationHint>;
   mountRules?: Record<string, string>;
   modelHints?: Record<string, string>;
-  emitterOptions?: Record<string, unknown>; /** When true, skip deletion of files recorded in the previous manifest but not in the current emission. */
+  emitterOptions?: Record<string, unknown>;
+  /** When true, skip deletion of files recorded in the previous manifest but not in the current emission. */
   noPrune?: boolean;
   /**
    * Post-mount service names to generate (a `--services` run). When non-empty,
@@ -491,7 +506,7 @@ declare function generate(spec: ApiSpec, emitter: Emitter, options: {
 }): Promise<GeneratedFile[]>;
 //#endregion
 //#region src/engine/generate-files.d.ts
-declare function buildEmitterContext(spec: ApiSpec, options: {
+export declare function buildEmitterContext(spec: ApiSpec, options: {
   namespace: string;
   outputDir: string;
   apiSurface?: ApiSurface;
@@ -508,9 +523,9 @@ declare function buildEmitterContext(spec: ApiSpec, options: {
 /**
  * Collect model and enum names transitively referenced by service operations.
  * Walks operation parameters, request bodies, responses, and pagination item
- * types, then chases model field references until the set stabilizes.
+ * and envelope types, then chases model field references until the set stabilizes.
  */
-declare function collectReferencedNames(services: Service[], models: Model[], opts?: {
+export declare function collectReferencedNames(services: Service[], models: Model[], opts?: {
   preserveAllDiscriminated?: boolean;
 }): {
   models: Set<string>;
@@ -531,10 +546,10 @@ declare function collectReferencedNames(services: Service[], models: Model[], op
  * consult `ctx.scopedServices` to emit only the selected services' per-service
  * resource/test files.
  */
-declare function generateAllFiles(spec: ApiSpec, emitter: Emitter, ctx: EmitterContext): GeneratedFile[];
+export declare function generateAllFiles(spec: ApiSpec, emitter: Emitter, ctx: EmitterContext): GeneratedFile[];
 /** Apply file header to generated files, respecting headerPlacement and JSON files. */
-declare function applyFileHeaders(files: GeneratedFile[], header: string): GeneratedFile[];
-declare function generateFiles(spec: ApiSpec, emitter: Emitter, options: {
+export declare function applyFileHeaders(files: GeneratedFile[], header: string): GeneratedFile[];
+export declare function generateFiles(spec: ApiSpec, emitter: Emitter, options: {
   namespace: string;
   outputDir: string;
   apiSurface?: ApiSurface;
@@ -544,8 +559,10 @@ declare function generateFiles(spec: ApiSpec, emitter: Emitter, options: {
   modelHints?: Record<string, string>;
   emitterOptions?: Record<string, unknown>;
   target?: string;
-  priorTargetManifestPaths?: Set<string>; /** Scoped-generation signal (POST-MOUNT names); set on ctx for emitters to gate per-service emission. */
-  scopedServices?: Set<string>; /** Canonical keys of services already on disk (prior manifest); narrows the scoped aggregate surface. */
+  priorTargetManifestPaths?: Set<string>;
+  /** Scoped-generation signal (POST-MOUNT names); set on ctx for emitters to gate per-service emission. */
+  scopedServices?: Set<string>;
+  /** Canonical keys of services already on disk (prior manifest); narrows the scoped aggregate surface. */
   presentServiceKeys?: Set<string>;
 }): {
   files: GeneratedFile[];
@@ -568,13 +585,13 @@ interface WriteResult {
  * Build a file-level dependency graph from generated files and return only
  * files reachable from root entry points.  Uses tree-sitter to parse imports.
  */
-declare function treeShakeFiles(files: GeneratedFile[], language: string): Promise<GeneratedFile[]>;
-declare function mapFilesForTargetIntegration(files: GeneratedFile[], language: string): GeneratedFile[];
+export declare function treeShakeFiles(files: GeneratedFile[], language: string): Promise<GeneratedFile[]>;
+export declare function mapFilesForTargetIntegration(files: GeneratedFile[], language: string): GeneratedFile[];
 interface IntegrateResult extends WriteResult {
   /** Final set of paths this run claims ownership of in the target (post tree-shake + conflict resolution). */
   emittedPaths: string[];
 }
-declare function integrateGeneratedFiles(opts: {
+export declare function integrateGeneratedFiles(opts: {
   files: GeneratedFile[];
   language: string;
   targetDir: string;
@@ -582,11 +599,11 @@ declare function integrateGeneratedFiles(opts: {
 }): Promise<IntegrateResult>;
 //#endregion
 //#region src/engine/registry.d.ts
-declare function registerEmitter(emitter: Emitter): void;
-declare function getEmitter(language: string): Emitter;
+export declare function registerEmitter(emitter: Emitter): void;
+export declare function getEmitter(language: string): Emitter;
 //#endregion
 //#region src/differ/diff.d.ts
-declare function diffSpecs(oldSpec: ApiSpec, newSpec: ApiSpec): DiffReport;
+export declare function diffSpecs(oldSpec: ApiSpec, newSpec: ApiSpec): DiffReport;
 //#endregion
 //#region src/differ/direction.d.ts
 /**
@@ -611,18 +628,18 @@ type DirectionIndex = ReadonlyMap<string, ModelDirection>;
  * operations weren't supplied) stay `unknown`, which preserves the conservative
  * pre-direction classification.
  */
-declare function buildDirectionIndex(...specs: ApiSpec[]): DirectionIndex;
-declare function directionOf(index: DirectionIndex | undefined, modelName: string): ModelDirection;
+export declare function buildDirectionIndex(...specs: ApiSpec[]): DirectionIndex;
+export declare function directionOf(index: DirectionIndex | undefined, modelName: string): ModelDirection;
 //#endregion
 //#region src/utils/naming.d.ts
-declare const ACRONYM_SET: Set<string>;
-declare function toPascalCase(s: string, acronyms?: Set<string>): string;
-declare function toCamelCase(s: string, acronyms?: Set<string>): string;
-declare function toSnakeCase(s: string): string;
-declare function toKebabCase(s: string): string;
-declare function toUpperSnakeCase(s: string): string;
-declare function stripBackendPrefixes(name: string): string;
-declare function cleanSchemaName(name: string): string;
+export declare const ACRONYM_SET: Set<string>;
+export declare function toPascalCase(s: string, acronyms?: Set<string>): string;
+export declare function toCamelCase(s: string, acronyms?: Set<string>): string;
+export declare function toSnakeCase(s: string): string;
+export declare function toKebabCase(s: string): string;
+export declare function toUpperSnakeCase(s: string): string;
+export declare function stripBackendPrefixes(name: string): string;
+export declare function cleanSchemaName(name: string): string;
 //#endregion
 //#region src/engine/operation-plan.d.ts
 interface OperationPlan {
@@ -644,7 +661,7 @@ interface OperationPlan {
   hasQueryParams: boolean;
   isAsync: boolean;
 }
-declare function planOperation(op: Operation): OperationPlan;
+export declare function planOperation(op: Operation): OperationPlan;
 //#endregion
 //#region src/utils/escape.d.ts
 /**
@@ -661,7 +678,7 @@ declare function planOperation(op: Operation): OperationPlan;
  * `"""`, Ruby `=begin`/`#`, ...) must apply language-appropriate escaping
  * instead of, or in addition to, this helper.
  */
-declare function escapeBlockComment(text: string): string;
+export declare function escapeBlockComment(text: string): string;
 /**
  * Sanitize a string for safe interpolation into a JS/TS identifier position
  * (class name, variable, property, ...).
@@ -677,7 +694,7 @@ declare function escapeBlockComment(text: string): string;
  * this does not disturb legitimate output. A leading digit is prefixed with `_`
  * so the result is always a usable identifier.
  */
-declare function sanitizeIdentifier(text: string): string;
+export declare function sanitizeIdentifier(text: string): string;
 //#endregion
 //#region src/cli/config-loader.d.ts
 interface OagenConfig {
@@ -698,11 +715,18 @@ interface OagenConfig {
   operationIdTransform?: (id: string) => string;
   /**
    * Custom transform for schema (model/enum) names. Applied after the built-in
-   * cleanSchemaName normalization. Receives the cleaned PascalCase name; return
-   * the desired name. Collisions are detected automatically -- if a transform
-   * would produce a duplicate name, the original is kept.
+   * cleanSchemaName normalization. Receives the cleaned PascalCase name and,
+   * for component schemas, the original name exactly as spelled in the
+   * document (`originalName`); return the desired name. Returning
+   * `originalName` opts that schema out of normalization (e.g. keeps
+   * `HTTPConfig` instead of `HttpConfig`); only do so when it is a valid
+   * identifier, since keys like `user-profile` are otherwise fixed by
+   * cleanSchemaName. `originalName` is undefined for
+   * any name oagen synthesises (inline enums, request-body variant models,
+   * title-derived names). Collisions are detected automatically -- if a
+   * transform would produce a duplicate name, the cleaned name is kept.
    */
-  schemaNameTransform?: (name: string) => string;
+  schemaNameTransform?: SchemaNameTransform;
   /** Base URL for documentation links. When set, relative paths in descriptions
    *  (e.g. `/reference/users/user`) are expanded to full URLs. */
   docUrl?: string;
@@ -769,20 +793,64 @@ interface OagenConfig {
  *   1. An explicit `example` carried on the field/param.
  *   2. The `default` from the schema.
  *   3. The first enum value, when the type is an enum.
- *   4. A type-driven default (e.g. `"string_example"`, `1`, `true`).
+ *   4. A type-driven value (e.g. `"string_example"`, `1`, `true`), generated
+ *      inside the field's/param's `constraints` when it carries any.
+ *
+ * A document-given `example` or `default` is returned verbatim, never
+ * adjusted, even when it violates a limit the same document declares: the
+ * author's value is the better illustration, and a snippet is not a
+ * validator. Only generated values are shaped by `constraints`:
+ *
+ *   - Numbers are chosen to satisfy every declared bound and `multipleOf`:
+ *     with only a lower bound, the smallest value at or just past it (rounded
+ *     up to the next multiple); with only an upper bound, the largest value
+ *     at or just below it (rounded down); with both, the smallest integer
+ *     inside for `integer` and the midpoint for `number`, snapped to a
+ *     multiple inside the range; with none, `1` (or the first multiple).
+ *     Only when no value can satisfy the limits together (contradictory
+ *     bounds, or no multiple between them) is the lower bound returned as
+ *     is.
+ *   - Plain strings are padded (by repeating the sample) to `minLength` and
+ *     truncated to `maxLength`; format-driven values (`date-time`, `email`,
+ *     `uuid`, ...) are never touched. A `pattern` is not synthesized: the
+ *     sample is kept even when it does not match, since generating a string
+ *     from an arbitrary regex is out of scope.
+ *   - Arrays emit `max(1, minItems)` items capped at `maxItems` (an explicit
+ *     `maxItems: 0` gives `[]`). Under `uniqueItems`, generated primitives
+ *     vary by index (strings get the index appended, numbers get it added,
+ *     booleans alternate — so a unique boolean array holds at most two
+ *     items); enum, literal and model items are not varied.
+ *   - Maps emit `max(1, minProperties)` entries capped at `maxProperties`:
+ *     one entry keeps the `key` name, more are `key1`, `key2`, ...
+ *   - Model-level `minProperties` / `maxProperties` are ignored: every
+ *     non-deprecated, non-readOnly field is emitted anyway.
+ *
+ * Snippets are illustrative, so generation has a size budget: at most
+ * {@link MAX_GENERATED_LENGTH} characters per string and
+ * {@link MAX_GENERATED_ITEMS} items per array or entries per map. A
+ * `minLength`, `minItems` or `minProperties` above the budget yields the
+ * capped size — a readable sample rather than a conforming one.
+ *
+ * Limits nested inside array items or map values are not carried by the
+ * IR, so items and values are generated unconstrained.
  *
  * Recursion through models/arrays/maps is depth-limited; cyclic models
  * collapse to a placeholder object rather than blowing the stack.
  */
 interface ExampleBuilder {
-  /** Build an example value for a single type reference (no field metadata). */
-  forType(type: TypeRef): unknown;
-  /** Build an example value for a field, honoring its `example`/`default`. */
+  /**
+   * Build an example value for a single type reference (no field metadata),
+   * generated inside `constraints` when given.
+   */
+  forType(type: TypeRef, constraints?: Constraints): unknown;
+  /** Build an example value for a field, honoring its `example`/`default` and `constraints`. */
   forField(field: Field): unknown;
+  /** Build an example value for a parameter, honoring its `example`/`default` and `constraints`. */
+  forParameter(param: Parameter): unknown;
   /** Build an example object from a model, keyed by field wire name. */
   forModel(model: Model | string): Record<string, unknown>;
 }
-declare function createExampleBuilder(spec: ApiSpec): ExampleBuilder;
+export declare function createExampleBuilder(spec: ApiSpec): ExampleBuilder;
 //#endregion
 //#region src/snippets/types.d.ts
 /**
@@ -847,7 +915,7 @@ interface SnippetEmitter {
  * {@link snippetResultsToFiles} for a convenience that writes
  * `<outputDir>/<language>/<methodName>-request.<ext>`.
  */
-declare function runSnippetEmitters(emitters: SnippetEmitter[], ctx: EmitterContext): SnippetResult[];
+export declare function runSnippetEmitters(emitters: SnippetEmitter[], ctx: EmitterContext): SnippetResult[];
 /**
  * Convenience: turn snippet results into oagen-style {@link GeneratedFile}s
  * under `<outputDir>/<language>/<methodName>-request.<extension>`.
@@ -857,7 +925,7 @@ declare function runSnippetEmitters(emitters: SnippetEmitter[], ctx: EmitterCont
  * `content/reference/{tag}/_code/...`) typically skip this helper and route
  * `SnippetResult.operationId` / `mountTarget` through their own mapping.
  */
-declare function snippetResultsToFiles(results: SnippetResult[], outputDir?: string): GeneratedFile[];
+export declare function snippetResultsToFiles(results: SnippetResult[], outputDir?: string): GeneratedFile[];
 //#endregion
 //#region src/snippets/shared.d.ts
 /**
@@ -897,15 +965,15 @@ interface CollectedArgs {
   /** Body field wire names that also appear as path params. */
   collisionNames: Set<string>;
 }
-declare function collectSnippetArgs(resolved: ResolvedOperation, ctx: EmitterContext, examples: ExampleBuilder): CollectedArgs;
+export declare function collectSnippetArgs(resolved: ResolvedOperation, ctx: EmitterContext, examples: ExampleBuilder): CollectedArgs;
 /**
  * Build the arg list for a single split (wrapper) variant. The wrapper's
  * `exposedParams` is the contract; fields are looked up on the variant model
  * by exact name and then snake-case-normalized name. Optional status comes
  * from `wrapper.optionalParams` first, then from the field's `required` flag.
  */
-declare function collectWrapperArgs(wrapper: ResolvedWrapper, ctx: EmitterContext, examples: ExampleBuilder): SnippetArg[];
-declare function hiddenParamSet(resolved: ResolvedOperation): Set<string>;
+export declare function collectWrapperArgs(wrapper: ResolvedWrapper, ctx: EmitterContext, examples: ExampleBuilder): SnippetArg[];
+export declare function hiddenParamSet(resolved: ResolvedOperation): Set<string>;
 //#endregion
-export { ACRONYM_SET, type AiAgentEnvVar, type ApiSpec, type ArrayType, type AuthScheme, type BackoffStrategy, type Change, type CollectedArgs, CommandError, ConfigError, ConfigLoadError, ConfigVersionMismatchError, type DeepPartial, type DiffReport, type DirectionIndex, type Emitter, type EmitterContext, type Enum, type EnumAdded, type EnumModified, type EnumRef, type EnumRemoved, type EnumValue, type EnumValueChange, type ErrorPolicy, type ErrorResponse, type ExampleBuilder, ExtractorError, type Field, type FieldChange, type FormatCommand, type GeneratedFile, type HttpMethod, type IdempotencyPolicy, InternalError, type LiteralType, type LogEvent, type LoggingPolicy, type MapType, type Model, type ModelAdded, type ModelDirection, type ModelModified, type ModelRef, type ModelRemoved, type NullableType, type OagenConfig, OagenError, type OpenApiDocument, type Operation, type OperationAdded, type OperationHint, type OperationModified, type OperationPlan, type OperationRemoved, type OperationsMap, type OperationsMapEntry, type PaginationMeta, type PaginationPolicy, type ParamChange, type Parameter, type ParameterGroup, type ParameterGroupVariant, type ParseOptions, type PrimitiveType, RegistryError, type RequestGuardPolicy, type ResolvedMethodCollision, type ResolvedOperation, type ResolvedWrapper, type RetryPolicy, type SdkBehavior, type SecurityRequirement, type ServerEntry, type Service, type ServiceAdded, type ServiceRemoved, type SnippetArg, type SnippetEmitter, type SnippetResult, SpecParseError, type SplitHint, type SuccessResponse, type TelemetryPolicy, type TimeoutPolicy, type TypeParam, type TypeRef, type UnionType, type UserAgentPolicy, applyFileHeaders, assertNever, assignModelsToServices, buildDirectionIndex, buildEmitterContext, cleanSchemaName, collectEnumRefs, collectFieldDependencies, collectModelRefs, collectReferencedNames, collectRequestBodyModels, collectSnippetArgs, collectWrapperArgs, createExampleBuilder, defaultSdkBehavior, deriveMethodName, diffSpecs, directionOf, escapeBlockComment, findResolvedMethodCollisions, generate, generateAllFiles, generateFiles, getEmitter, hiddenParamSet, integrateGeneratedFiles, mapFilesForTargetIntegration, mapTypeRef, mergeSdkBehavior, parseSpec, planOperation, registerEmitter, resolveMountTarget, resolveOperations, runSnippetEmitters, sanitizeIdentifier, snippetResultsToFiles, stripBackendPrefixes, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toUpperSnakeCase, treeShakeFiles, validateModelHints, walkTypeRef };
+export { type AiAgentEnvVar, type ApiSpec, type ArrayType, type AuthScheme, type BackoffStrategy, type Change, type CollectedArgs, type Constraints, type DeepPartial, type DiffReport, type DirectionIndex, type Emitter, type EmitterContext, type Enum, type EnumAdded, type EnumModified, type EnumRef, type EnumRemoved, type EnumValue, type EnumValueChange, type ErrorPolicy, type ErrorResponse, type ExampleBuilder, type Field, type FieldChange, type FormatCommand, type GeneratedFile, type HttpMethod, type IdempotencyPolicy, type LiteralType, type LogEvent, type LoggingPolicy, type MapType, type Model, type ModelAdded, type ModelDirection, type ModelModified, type ModelRef, type ModelRemoved, type NullableType, type OagenConfig, type OpenApiDocument, type Operation, type OperationAdded, type OperationHint, type OperationModified, type OperationPlan, type OperationRemoved, type OperationsMap, type OperationsMapEntry, type PaginationMeta, type PaginationPolicy, type ParamChange, type Parameter, type ParameterGroup, type ParameterGroupVariant, type ParseOptions, type PrimitiveType, type RequestGuardPolicy, type ResolvedMethodCollision, type ResolvedOperation, type ResolvedWrapper, type ResponseHeader, type RetryPolicy, type SchemaNameTransform, type SdkBehavior, type SecurityRequirement, type SecurityRequirementSet, type ServerEntry, type Service, type ServiceAdded, type ServiceRemoved, type SnippetArg, type SnippetEmitter, type SnippetResult, type SplitHint, type SuccessResponse, type TelemetryPolicy, type TimeoutPolicy, type TypeParam, type TypeRef, type UnionType, type UserAgentPolicy, assertNever, assignModelsToServices, collectEnumRefs, collectFieldDependencies, collectModelRefs, collectRequestBodyModels, collectResponseHeaders, defaultSdkBehavior, mapTypeRef, mergeSdkBehavior, validateModelHints, walkTypeRef };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/ir/operation-hints.ts","../src/errors.ts","../src/engine/types.ts","../src/differ/types.ts","../src/parser/parse.ts","../src/engine/orchestrator.ts","../src/engine/generate-files.ts","../src/engine/writer.ts","../src/engine/integrate.ts","../src/engine/registry.ts","../src/differ/diff.ts","../src/differ/direction.ts","../src/utils/naming.ts","../src/engine/operation-plan.ts","../src/utils/escape.ts","../src/cli/config-loader.ts","../src/snippets/example-builder.ts","../src/snippets/types.ts","../src/snippets/runner.ts","../src/snippets/shared.ts"],"mappings":";;;;UAeiB,aAAA;EAAA;EAEf,IAAA;;EAEA,OAAA;EAFA;EAIA,KAAA,GAAQ,SAAA;EAAR;EAEA,QAAA,GAAW,MAAA;EAAX;EAEA,eAAA;EAAA;;;;AAUF;;EAHE,UAAA;AAAA;AAAA,UAGe,SAAA;EAIf;EAFA,IAAA;EAIW;EAFX,aAAA;EAMA;EAJA,QAAA,GAAW,MAAA;EAUG;EARd,eAAA;EAee;EAbf,aAAA;;;;;;EAMA,cAAA;AAAA;AAAA,UAOe,iBAAA;EAEJ;EAAX,SAAA,EAAW,SAAA;EAEF;EAAT,OAAA,EAAS,OAAA;EAIT;EAFA,UAAA;EAIW;EAFX,OAAA;EAIU;EAFV,QAAA,GAAW,eAAA;EAMX;EAJA,QAAA,EAAU,MAAA;EAIA;EAFV,eAAA;EAK8B;EAH9B,UAAA;AAAA;AAAA,UAGe,eAAA;EAIf;EAFA,IAAA;EAIU;EAFV,aAAA;EAMA;EAJA,QAAA,EAAU,MAAA;EAQV;EANA,eAAA;EAMiB;EAJjB,aAAA;EAgF8B;EA9E9B,cAAA;EA8E+D;EA5E/D,iBAAA;AAAA;;;;;AAoKF;;;;;;;iBAxFgB,gBAAA,CAAiB,EAAA,EAAI,SAAA,EAAW,QAAA,EAAU,OAAA;;AAkH1D;;;;;;;;;;;;;;;;iBA1BgB,kBAAA,CAAmB,IAAA,UAAc,MAAA,EAAQ,MAAA;;;;AAsFzD;;;;;;iBA5DgB,iBAAA,CACd,IAAA,EAAM,OAAA,EACN,KAAA,GAAQ,MAAA,SAAe,aAAA,GACvB,UAAA,GAAa,MAAA,mBACZ,iBAAA;;UAwDc,uBAAA;EAIL;EAFV,GAAA;EACA,KAAA;IAAS,UAAA;IAAoB,IAAA;EAAA;EAC7B,MAAA;IAAU,UAAA;IAAoB,IAAA;EAAA;AAAA;;;;;;ACjVhC;;;;;;;;;;iBDmWgB,4BAAA,CAA6B,QAAA,EAAU,iBAAA,KAAsB,uBAAA;;;;;;AA5V7E;;;;cCPa,UAAA,SAAmB,KAAA;EAAA,SACrB,IAAA;cAEG,OAAA,UAAiB,IAAA;AAAA;;cASlB,YAAA,SAAqB,UAAA;EAAA,SACvB,QAAA;cAEG,OAAA,UAAiB,IAAA,UAAc,QAAA;AAAA;;cAQhC,cAAA,SAAuB,UAAA;cACtB,OAAA,UAAiB,IAAA;AAAA;;cAOlB,WAAA,SAAoB,UAAA;cACnB,OAAA,UAAiB,IAAA;AAAA;;cAOlB,eAAA,SAAwB,WAAA;cACvB,OAAA,UAAiB,IAAA;AAAA;;cAOlB,0BAAA,SAAmC,WAAA;cAClC,OAAA,UAAiB,IAAA;AAAA;;cAOlB,cAAA,SAAuB,UAAA;cACtB,OAAA,UAAiB,IAAA;AAAA;;cAOlB,aAAA,SAAsB,UAAA;cACrB,OAAA,UAAiB,IAAA;AAAA;;cAOlB,aAAA,SAAsB,UAAA;cACrB,OAAA,UAAiB,IAAA;AAAA;;;UC5Ed,aAAA;EACf,IAAA;EACA,OAAA;EACA,YAAA;EACA,eAAA;EFWA;EETA,eAAA;EFWQ;EETR,iBAAA;AAAA;AAAA,UAGe,cAAA;EACf,SAAA;EACA,eAAA;EACA,IAAA,EAAM,OAAA;EACN,SAAA;EACA,UAAA,GAAa,UAAA;EACb,aAAA,GAAgB,aAAA;EFoBC;EElBjB,kBAAA,GAAqB,iBAAA;EFgBrB;;;;;EEVA,UAAA,GAAa,MAAA;EFsBC;EEpBd,cAAA,GAAiB,MAAA;EF2BF;EEzBf,SAAA;;;;;;;;;;;;;;;;EAgBA,cAAA,GAAiB,GAAA;EFqBP;;;;;AAOZ;;EEpBE,kBAAA,GAAqB,GAAA;EF0BL;;;;;;;;EEjBhB,gBAAA,GAAmB,GAAA;EACnB,eAAA,GAAkB,GAAA;EFwBD;AA4EnB;;;;;;EE5FE,wBAAA,GAA2B,GAAA;AAAA;AAAA,UAGZ,aAAA;EFyFgD;EEvF/D,GAAA;EF+KgC;EE7KhC,IAAA;EF6K6D;EE3K7D,SAAA;AAAA;;KAIU,kBAAA;EAAuB,SAAA;EAAmB,OAAA;AAAA;AAAA,KAC1C,aAAA,GAAgB,MAAA,SAAe,kBAAA,GAAqB,kBAAA;AAAA,UAE/C,OAAA;EACf,QAAA;EAEA,cAAA,CAAe,MAAA,EAAQ,KAAA,IAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;EAEtD,aAAA,CAAc,KAAA,EAAO,IAAA,IAAQ,GAAA,EAAK,cAAA,GAAiB,aAAA;EAEnD,iBAAA,CAAkB,QAAA,EAAU,OAAA,IAAW,GAAA,EAAK,cAAA,GAAiB,aAAA;EAE7D,cAAA,CAAe,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;EAEpD,cAAA,CAAe,GAAA,EAAK,cAAA,GAAiB,aAAA;EAErC,sBAAA,EAAwB,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;EAE7D,aAAA,CAAc,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;EFiL3C;EE9KR,kBAAA,EAAoB,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;EAEzD,UAAA;EF6Ka;;;;;AAyDf;EE9NE,aAAA,EAAe,SAAA,WAAoB,aAAA;AAAA;;;UCvHpB,UAAA;EACf,UAAA;EACA,UAAA;EACA,OAAA,EAAS,MAAA;EHYmB;;;;;;EGL5B,eAAA,EAAiB,cAAA;EACjB,OAAA;IACE,KAAA;IACA,OAAA;IACA,QAAA;IACA,QAAA;IACA,QAAA;IACA,eAAA;EAAA;AAAA;AAAA,UAIa,cAAA;EACf,IAAA;EHiBA;EGfA,WAAA;EHiBW;EGfX,aAAA;EHmBA;EGjBA,SAAA;EHuBc;EGrBd,aAAA;EH4Be;EG1Bf,UAAA;;EAEA,UAAA;EACA,cAAA;AAAA;AAAA,KAGU,MAAA,GACR,UAAA,GACA,YAAA,GACA,aAAA,GACA,SAAA,GACA,WAAA,GACA,YAAA,GACA,YAAA,GACA,cAAA,GACA,cAAA,GACA,gBAAA,GACA,iBAAA;AAAA,UAEa,UAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,YAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,IAAA;EACA,YAAA,EAAc,WAAA;EACd,cAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA;EAOA,SAAA;EACA,cAAA;EACA,OAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,YAAA;EACf,IAAA;EACA,IAAA;EACA,YAAA,EAAc,eAAA;EACd,cAAA;AAAA;AAAA,UAGe,eAAA;EACf,IAAA;EACA,SAAA;EACA,cAAA;EACA,OAAA;AAAA;AAAA,UAGe,YAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA;EACA,IAAA;EACA,cAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA;EACA,WAAA;EACA,aAAA;EACA,cAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,WAAA;EACA,aAAA;EACA,cAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,aAAA;EACA,YAAA,EAAc,WAAA;EACd,eAAA;EACA,kBAAA;EACA,iBAAA;EACA,WAAA;EACA,gBAAA;EACA,2BAAA;EACA,aAAA;EACA,cAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA;EAOA,SAAA;EACA,cAAA;;EAEA,UAAA;EH0MqD;EGxMrD,UAAA;EHwM2E;EGtM3E,aAAA;EACA,OAAA;AAAA;;;;;AHvJF;;;;;;KIQY,eAAA,GAAkB,MAAA;AAAA,UAEb,YAAA;EACf,oBAAA,IAAwB,EAAA;EACxB,mBAAA,IAAuB,IAAA;EJFvB;;;;AAUF;;EIDE,UAAA,GAAa,MAAA,SAAe,MAAA;EJOX;;;;;;;;;;AAiBnB;;;;EITE,aAAA,IAAiB,IAAA,EAAM,eAAA,KAAoB,eAAA;AAAA;AAAA,iBAGvB,SAAA,CAAU,QAAA,UAAkB,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,OAAA;;;iBChC7D,QAAA,CACpB,IAAA,EAAM,OAAA,EACN,OAAA,EAAS,OAAA,EACT,OAAA;EACE,SAAA;EACA,MAAA;EACA,SAAA;EACA,MAAA;EACA,UAAA,GAAa,UAAA;EACb,aAAA,GAAgB,aAAA;EAChB,cAAA,GAAiB,MAAA,SAAe,aAAA;EAChC,UAAA,GAAa,MAAA;EACb,UAAA,GAAa,MAAA;EACb,cAAA,GAAiB,MAAA,mBLDT;EKGR,OAAA;ELAa;;;;;;;;EKSb,QAAA;AAAA,IAED,OAAA,CAAQ,aAAA;;;iBCrCK,mBAAA,CACd,IAAA,EAAM,OAAA,EACN,OAAA;EACE,SAAA;EACA,SAAA;EACA,UAAA,GAAa,UAAA;EACb,aAAA,GAAgB,aAAA;EAChB,cAAA,GAAiB,MAAA,SAAe,aAAA;EAChC,UAAA,GAAa,MAAA;EACb,UAAA,GAAa,MAAA;EACb,cAAA,GAAiB,MAAA;EACjB,MAAA;EACA,wBAAA,GAA2B,GAAA;EAC3B,cAAA,GAAiB,GAAA;EACjB,kBAAA,GAAqB,GAAA;AAAA,IAEtB,cAAA;;ANiCH;;;;iBMyDgB,sBAAA,CACd,QAAA,EAAU,OAAA,IACV,MAAA,EAAQ,KAAA,IACR,IAAA;EAAQ,wBAAA;AAAA;EACL,MAAA,EAAQ,GAAA;EAAa,KAAA,EAAO,GAAA;AAAA;;;;;;;;;;;;;;AN1CjC;;iBM+JgB,gBAAA,CAAiB,IAAA,EAAM,OAAA,EAAS,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,cAAA,GAAiB,aAAA;;iBA2BxE,gBAAA,CAAiB,KAAA,EAAO,aAAA,IAAiB,MAAA,WAAiB,aAAA;AAAA,iBAS1D,aAAA,CACd,IAAA,EAAM,OAAA,EACN,OAAA,EAAS,OAAA,EACT,OAAA;EACE,SAAA;EACA,SAAA;EACA,UAAA,GAAa,UAAA;EACb,aAAA,GAAgB,aAAA;EAChB,cAAA,GAAiB,MAAA,SAAe,aAAA;EAChC,UAAA,GAAa,MAAA;EACb,UAAA,GAAa,MAAA;EACb,cAAA,GAAiB,MAAA;EACjB,MAAA;EACA,wBAAA,GAA2B,GAAA;EAE3B,cAAA,GAAiB,GAAA,UNxHgB;EM0HjC,kBAAA,GAAqB,GAAA;AAAA;EAEpB,KAAA,EAAO,aAAA;EAAiB,GAAA,EAAK,cAAA;EAAgB,MAAA;EAAgB,UAAA,GAAa,aAAA;AAAA;;;UCpR9D,WAAA;EACf,OAAA;EACA,MAAA;EACA,OAAA;EACA,SAAA;EACA,OAAA;AAAA;;;;APLF;;;iBQ0CsB,cAAA,CAAe,KAAA,EAAO,aAAA,IAAiB,QAAA,WAAmB,OAAA,CAAQ,aAAA;AAAA,iBAiFxE,4BAAA,CAA6B,KAAA,EAAO,aAAA,IAAiB,QAAA,WAAmB,aAAA;AAAA,UAyEvE,eAAA,SAAwB,WAAA;ER9LvC;EQgMA,YAAA;AAAA;AAAA,iBAGoB,uBAAA,CAAwB,IAAA;EAC5C,KAAA,EAAO,aAAA;EACP,QAAA;EACA,SAAA;EACA,MAAA;AAAA,IACE,OAAA,CAAQ,eAAA;;;iBCxNI,eAAA,CAAgB,OAAA,EAAS,OAAA;AAAA,iBAIzB,UAAA,CAAW,QAAA,WAAmB,OAAA;;;iBCH9B,SAAA,CAAU,OAAA,EAAS,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,UAAA;;;;;AVS/D;;;;;KWNY,cAAA;AAAA,KAEA,cAAA,GAAiB,WAAA,SAAoB,cAAA;;;;;;;;AXwBjD;;;;;;iBWTgB,mBAAA,CAAA,GAAuB,KAAA,EAAO,OAAA,KAAY,cAAA;AAAA,iBAqC1C,WAAA,CAAY,KAAA,EAAO,cAAA,cAA4B,SAAA,WAAoB,cAAA;;;cCHtE,WAAA,EAAW,GAAA;AAAA,iBAER,YAAA,CAAa,CAAA,UAAW,QAAA,GAAW,GAAA;AAAA,iBAanC,WAAA,CAAY,CAAA,UAAW,QAAA,GAAW,GAAA;AAAA,iBAelC,WAAA,CAAY,CAAA;AAAA,iBAMZ,WAAA,CAAY,CAAA;AAAA,iBAMZ,gBAAA,CAAiB,CAAA;AAAA,iBAiBjB,oBAAA,CAAqB,IAAA;AAAA,iBAqErB,eAAA,CAAgB,IAAA;;;UCzLf,aAAA;EACf,SAAA,EAAW,SAAA;EACX,QAAA;EACA,OAAA;EACA,gBAAA;EACA,mBAAA;EACA,WAAA;EACA,iBAAA;EbWA;;EaRA,sBAAA;EACA,eAAA;EbWA;;;EaPA,eAAA;EACA,cAAA;EACA,OAAA;AAAA;AAAA,iBAGc,aAAA,CAAc,EAAA,EAAI,SAAA,GAAY,aAAA;;;;;;AbR9C;;;;;;;;;;;iBcDgB,kBAAA,CAAmB,IAAA;;;AdqBnC;;;;;;;;;;;;;iBcFgB,kBAAA,CAAmB,IAAA;;;UCvBlB,WAAA;EACf,QAAA,GAAW,OAAA;EACX,UAAA,GAAa,SAAA;EfOb;EeLA,MAAA,GAAS,YAAA;EfOD;EeLR,cAAA;EfOW;EeLX,YAAA,GAAe,MAAA;Efcf;;;AAGF;;;EeVE,oBAAA,IAAwB,EAAA;EfYxB;;;;;;EeLA,mBAAA,IAAuB,IAAA;EfmBT;;EehBd,MAAA;EfuBgC;;;;;;;;;;;EeXhC,aAAA,IAAiB,IAAA,EAAM,eAAA,KAAoB,eAAA;EfiB3C;;;;;EeXA,cAAA,GAAiB,MAAA,SAAe,aAAA;EfmBhC;;;;AAKF;;;;EefE,UAAA,GAAa,MAAA;EfmBb;;;;;;;;;AAsFF;;;Ee5FE,UAAA,GAAa,MAAA;Ef4FsB;;;;;;EerFnC,UAAA,GAAa,MAAA,SAAe,MAAA;Ef6KI;;;;EexKhC,cAAA,GAAiB,MAAA,SAAe,MAAA;AAAA;;;;;AfxElC;;;;;;;;;;;UgBAiB,cAAA;EhBiBL;EgBfV,OAAA,CAAQ,IAAA,EAAM,OAAA;EhBkBC;EgBhBf,QAAA,CAAS,KAAA,EAAO,KAAA;;EAEhB,QAAA,CAAS,KAAA,EAAO,KAAA,YAAiB,MAAA;AAAA;AAAA,iBAKnB,oBAAA,CAAqB,IAAA,EAAM,OAAA,GAAU,cAAA;;;AhBXrD;;;;;;;;AAAA,UiBHiB,aAAA;EjBWJ;EiBTX,QAAA;EjBkBA;EiBhBA,aAAA;EjBgBU;EiBdV,WAAA;EjBiBwB;EiBfxB,WAAA;EjBqBiB;EiBnBjB,UAAA;EjBiBA;EiBfA,OAAA;AAAA;;;;;;AjBkCF;;;;;;;;UiBlBiB,cAAA;EjBoBf;EiBlBA,QAAA;EjBoBA;EiBlBA,aAAA;EjBoBA;;;;;;EiBbA,eAAA,CAAgB,QAAA,EAAU,iBAAA,EAAmB,GAAA,EAAK,cAAA,EAAgB,QAAA,EAAU,cAAA;AAAA;;;;AjBpC9E;;;;;;;;;;;iBkBEgB,kBAAA,CAAmB,QAAA,EAAU,cAAA,IAAkB,GAAA,EAAK,cAAA,GAAiB,aAAA;;;AlBkBrF;;;;;;;iBkBgBgB,qBAAA,CAAsB,OAAA,EAAS,aAAA,IAAiB,SAAA,YAAyB,aAAA;;;;;;;;;;;;;UClCxE,UAAA;EnBeL;EmBbV,MAAA;EnBgBe;EmBdf,QAAA;;EAEA,KAAA;EnBcA;EmBZA,SAAA,EAAW,SAAA;EnBgBX;EmBdA,KAAA,EAAO,KAAA;AAAA;;;;;AnB+BT;;;;;;UmBlBiB,aAAA;EACf,IAAA,EAAM,UAAA;EnB6BU;EmB3BhB,cAAA,EAAgB,GAAA;AAAA;AAAA,iBAGF,kBAAA,CACd,QAAA,EAAU,iBAAA,EACV,GAAA,EAAK,cAAA,EACL,QAAA,EAAU,cAAA,GACT,aAAA;;;;;;;iBAqEa,kBAAA,CACd,OAAA,EAAS,eAAA,EACT,GAAA,EAAK,cAAA,EACL,QAAA,EAAU,cAAA,GACT,UAAA;AAAA,iBA4Ca,cAAA,CAAe,QAAA,EAAU,iBAAA,GAAoB,GAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/ir/operation-hints.ts","../src/errors.ts","../src/engine/types.ts","../src/differ/types.ts","../src/parser/schemas.ts","../src/parser/parse.ts","../src/engine/orchestrator.ts","../src/engine/generate-files.ts","../src/engine/writer.ts","../src/engine/integrate.ts","../src/engine/registry.ts","../src/differ/diff.ts","../src/differ/direction.ts","../src/utils/naming.ts","../src/engine/operation-plan.ts","../src/utils/escape.ts","../src/cli/config-loader.ts","../src/snippets/example-builder.ts","../src/snippets/types.ts","../src/snippets/runner.ts","../src/snippets/shared.ts"],"mappings":"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"}