@skmtc/core 0.0.799 → 0.0.802

package/script/dsl/model/toModelBase.d.ts

@@ -4,16 +4,82 @@ import type { ContentSettings } from '../ContentSettings.js';
 import { ModelBase } from './ModelBase.js';
 import type { Identifier } from '../Identifier.js';
 import * as v from 'valibot';
+/**
+ * Arguments for creating a model insertable instance.
+ *
+ * @template EnrichmentType - Type of enrichments to apply to the model
+ */
 export type ModelInsertableArgs<EnrichmentType = undefined> = {
+    /** The generation context providing access to OAS objects and utilities */
     context: GenerateContext;
+    /** Content settings for customizing model generation behavior */
     settings: ContentSettings<EnrichmentType>;
+    /** Reference name identifying the model schema */
     refName: RefName;
 };
+/**
+ * Configuration for creating a base model class.
+ *
+ * Defines the structure and behavior for model generators, including
+ * identifier generation, export path resolution, and enrichment schemas.
+ *
+ * @template EnrichmentType - Type of enrichments to apply to generated models
+ */
 export type BaseModelConfig<EnrichmentType = undefined> = {
+    /** Unique identifier for the model generator */
     id: string;
+    /** Function to generate identifiers from reference names */
     toIdentifier: (refName: RefName) => Identifier;
+    /** Function to generate export paths from reference names */
     toExportPath: (refName: RefName) => string;
+    /** Optional function to provide enrichment validation schema */
     toEnrichmentSchema?: () => v.BaseSchema<EnrichmentType, EnrichmentType, v.BaseIssue<unknown>>;
 };
+/**
+ * Creates a base model class constructor for generating type-safe model artifacts.
+ *
+ * This factory function creates a specialized ModelBase class that implements
+ * the provided configuration for identifier generation, export paths, and
+ * enrichment handling. The resulting class can be instantiated to generate
+ * model artifacts from OpenAPI schemas.
+ *
+ * @template EnrichmentType - Type of enrichments to apply to generated models
+ * @param config - Configuration defining the model generation behavior
+ * @returns Constructor function for creating model instances
+ *
+ * @example Creating a TypeScript interface generator
+ * ```typescript
+ * import { toModelBase } from '@skmtc/core';
+ *
+ * const TypeScriptModelBase = toModelBase({
+ *   id: 'typescript-interfaces',
+ *   toIdentifier: (refName) => new Identifier(pascalCase(refName)),
+ *   toExportPath: (refName) => `./models/${kebabCase(refName)}.ts`,
+ *   toEnrichmentSchema: () => v.object({
+ *     includeValidation: v.optional(v.boolean()),
+ *     readonly: v.optional(v.boolean())
+ *   })
+ * });
+ *
+ * class TypeScriptModelGenerator extends TypeScriptModelBase {
+ *   generate() {
+ *     const enrichments = this.enrichments;
+ *     const interface = generateInterface(this.schema, {
+ *       readonly: enrichments?.readonly ?? false
+ *     });
+ *     this.register({ file: this.createFile(interface) });
+ *   }
+ * }
+ * ```
+ *
+ * @example Creating a validation schema generator
+ * ```typescript
+ * const ValidationModelBase = toModelBase({
+ *   id: 'zod-schemas',
+ *   toIdentifier: (refName) => new Identifier(`${pascalCase(refName)}Schema`),
+ *   toExportPath: (refName) => `./schemas/${kebabCase(refName)}.schema.ts`
+ * });
+ * ```
+ */
 export declare const toModelBase: <EnrichmentType = undefined>(config: BaseModelConfig<EnrichmentType>) => new (args: ModelInsertableArgs<EnrichmentType>) => ModelBase<EnrichmentType>;
 //# sourceMappingURL=toModelBase.d.ts.map

package/script/dsl/model/toModelBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toModelBase.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/toModelBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,MAAM,MAAM,mBAAmB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC5D,OAAO,EAAE,eAAe,CAAA;IACxB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAOD,MAAM,MAAM,eAAe,CAAC,cAAc,GAAG,SAAS,IAAI;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,UAAU,CAAA;IAC9C,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;CAC9F,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,cAAc,GAAG,SAAS,EACpD,QAAQ,eAAe,CAAC,cAAc,CAAC,KACtC,KAAK,IAAI,EAAE,mBAAmB,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC,cAAc,CA0B7E,CAAA"}
+{"version":3,"file":"toModelBase.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/toModelBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC5D,2EAA2E;IAC3E,OAAO,EAAE,eAAe,CAAA;IACxB,iEAAiE;IACjE,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAOD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,cAAc,GAAG,SAAS,IAAI;IACxD,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,UAAU,CAAA;IAC9C,6DAA6D;IAC7D,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IAC1C,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;CAC9F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,WAAW,GAAI,cAAc,GAAG,SAAS,EACpD,QAAQ,eAAe,CAAC,cAAc,CAAC,KACtC,KAAK,IAAI,EAAE,mBAAmB,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC,cAAc,CA0B7E,CAAA"}

package/script/dsl/model/toModelBase.js

@@ -38,6 +38,52 @@ const GeneratorKeys_js_1 = require("../../types/GeneratorKeys.js");
 const ModelBase_js_1 = require("./ModelBase.js");
 const v = __importStar(require("valibot"));
 const lodash_es_1 = require("lodash-es");
+/**
+ * Creates a base model class constructor for generating type-safe model artifacts.
+ *
+ * This factory function creates a specialized ModelBase class that implements
+ * the provided configuration for identifier generation, export paths, and
+ * enrichment handling. The resulting class can be instantiated to generate
+ * model artifacts from OpenAPI schemas.
+ *
+ * @template EnrichmentType - Type of enrichments to apply to generated models
+ * @param config - Configuration defining the model generation behavior
+ * @returns Constructor function for creating model instances
+ *
+ * @example Creating a TypeScript interface generator
+ * ```typescript
+ * import { toModelBase } from '@skmtc/core';
+ *
+ * const TypeScriptModelBase = toModelBase({
+ *   id: 'typescript-interfaces',
+ *   toIdentifier: (refName) => new Identifier(pascalCase(refName)),
+ *   toExportPath: (refName) => `./models/${kebabCase(refName)}.ts`,
+ *   toEnrichmentSchema: () => v.object({
+ *     includeValidation: v.optional(v.boolean()),
+ *     readonly: v.optional(v.boolean())
+ *   })
+ * });
+ *
+ * class TypeScriptModelGenerator extends TypeScriptModelBase {
+ *   generate() {
+ *     const enrichments = this.enrichments;
+ *     const interface = generateInterface(this.schema, {
+ *       readonly: enrichments?.readonly ?? false
+ *     });
+ *     this.register({ file: this.createFile(interface) });
+ *   }
+ * }
+ * ```
+ *
+ * @example Creating a validation schema generator
+ * ```typescript
+ * const ValidationModelBase = toModelBase({
+ *   id: 'zod-schemas',
+ *   toIdentifier: (refName) => new Identifier(`${pascalCase(refName)}Schema`),
+ *   toExportPath: (refName) => `./schemas/${kebabCase(refName)}.schema.ts`
+ * });
+ * ```
+ */
 const toModelBase = (config) => {
     var _a;
     return _a = class extends ModelBase_js_1.ModelBase {

package/script/dsl/model/toModelEntry.d.ts

@@ -11,6 +11,69 @@ type ToModelEntryArgs<EnrichmentType = undefined, Acc = void> = {
     toMappingModule?: ({ context, refName }: ToModelMappingArgs) => MappingModule;
     toEnrichmentRequest?: <RequestedEnrichment extends EnrichmentType>(refName: RefName) => EnrichmentRequest<RequestedEnrichment> | undefined;
 };
+/**
+ * Creates a model transformation entry for the SKMTC pipeline.
+ *
+ * This function creates a standardized model entry that defines how to transform
+ * OpenAPI schema objects into model artifacts. Model entries are used by the
+ * generation pipeline to process schemas and create output files.
+ *
+ * The resulting entry includes transformation logic, preview generation,
+ * mapping generation, enrichment handling, and schema validation.
+ *
+ * @template EnrichmentType - Type of enrichments that can be applied to models
+ * @template Acc - Accumulator type for the transformation process
+ * @param args - Configuration for the model entry
+ * @param args.id - Unique identifier for this model entry
+ * @param args.transform - Function to transform schemas into artifacts
+ * @param args.toPreviewModule - Optional function to generate preview modules
+ * @param args.toMappingModule - Optional function to generate mapping modules
+ * @param args.toEnrichmentSchema - Optional function to provide enrichment validation
+ * @param args.toEnrichmentRequest - Optional function to request enrichments
+ * @returns Model entry object for use in the generation pipeline
+ *
+ * @example Basic model entry
+ * ```typescript
+ * import { toModelEntry } from '@skmtc/core';
+ *
+ * const typeScriptModelEntry = toModelEntry({
+ *   id: 'typescript-models',
+ *   transform: ({ context, refName, acc }) => {
+ *     const schema = context.getSchemaByRefName(refName);
+ *     const tsInterface = generateTypeScriptInterface(schema);
+ *     return { ...acc, [refName]: tsInterface };
+ *   },
+ *   toPreviewModule: ({ context, refName }) => ({
+ *     group: 'forms',
+ *     title: `${refName} Model`,
+ *     description: 'Generated TypeScript interface'
+ *   })
+ * });
+ * ```
+ *
+ * @example Model entry with enrichments
+ * ```typescript
+ * const validationModelEntry = toModelEntry({
+ *   id: 'validation-schemas',
+ *   transform: ({ context, refName, acc }) => {
+ *     const enrichments = context.getEnrichments(refName);
+ *     const schema = context.getSchemaByRefName(refName);
+ *     const validationSchema = generateValidationSchema(schema, {
+ *       strict: enrichments?.strict ?? false
+ *     });
+ *     return { ...acc, [refName]: validationSchema };
+ *   },
+ *   toEnrichmentSchema: () => v.object({
+ *     strict: v.optional(v.boolean()),
+ *     nullable: v.optional(v.boolean())
+ *   }),
+ *   toEnrichmentRequest: (refName) => ({
+ *     path: `models.${refName}`,
+ *     schema: enrichmentSchema
+ *   })
+ * });
+ * ```
+ */
 export declare const toModelEntry: <EnrichmentType = undefined, Acc = void>({ id, transform, toPreviewModule, toMappingModule, toEnrichmentSchema, toEnrichmentRequest }: ToModelEntryArgs<EnrichmentType, Acc>) => {
     id: string;
     type: "model";

package/script/dsl/model/toModelEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toModelEntry.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/toModelEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAClG,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE1E,KAAK,gBAAgB,CAAC,cAAc,GAAG,SAAS,EAAE,GAAG,GAAG,IAAI,IAAI;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,GAAG,CAAA;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IAC1D,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,wBAAwB,KAAK,aAAa,CAAA;IACnF,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,aAAa,CAAA;IAC7E,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,SAAS,cAAc,EAC/D,OAAO,EAAE,OAAO,KACb,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAA;CACxD,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,cAAc,GAAG,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,8FAOlE,gBAAgB,CAAC,cAAc,EAAE,GAAG,CAAC,KAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;IACvE,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,wBAAwB,KAAK,aAAa,CAAC;IACpF,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,aAAa,CAAC;IAC9E,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAC3D,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,SAAS,cAAc,EAC/D,OAAO,EAAE,OAAO,KACb,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC;CAWzD,CAAA"}
+{"version":3,"file":"toModelEntry.d.ts","sourceRoot":"","sources":["../../../src/dsl/model/toModelEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAClG,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE1E,KAAK,gBAAgB,CAAC,cAAc,GAAG,SAAS,EAAE,GAAG,GAAG,IAAI,IAAI;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,GAAG,CAAA;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IAC1D,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,wBAAwB,KAAK,aAAa,CAAA;IACnF,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,aAAa,CAAA;IAC7E,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,SAAS,cAAc,EAC/D,OAAO,EAAE,OAAO,KACb,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAA;CACxD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,eAAO,MAAM,YAAY,GAAI,cAAc,GAAG,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,8FAOlE,gBAAgB,CAAC,cAAc,EAAE,GAAG,CAAC,KAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;IACvE,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,wBAAwB,KAAK,aAAa,CAAC;IACpF,eAAe,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,aAAa,CAAC;IAC9E,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAC3D,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,SAAS,cAAc,EAC/D,OAAO,EAAE,OAAO,KACb,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC;CAWzD,CAAA"}

package/script/dsl/model/toModelEntry.js

@@ -1,6 +1,69 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toModelEntry = void 0;
+/**
+ * Creates a model transformation entry for the SKMTC pipeline.
+ *
+ * This function creates a standardized model entry that defines how to transform
+ * OpenAPI schema objects into model artifacts. Model entries are used by the
+ * generation pipeline to process schemas and create output files.
+ *
+ * The resulting entry includes transformation logic, preview generation,
+ * mapping generation, enrichment handling, and schema validation.
+ *
+ * @template EnrichmentType - Type of enrichments that can be applied to models
+ * @template Acc - Accumulator type for the transformation process
+ * @param args - Configuration for the model entry
+ * @param args.id - Unique identifier for this model entry
+ * @param args.transform - Function to transform schemas into artifacts
+ * @param args.toPreviewModule - Optional function to generate preview modules
+ * @param args.toMappingModule - Optional function to generate mapping modules
+ * @param args.toEnrichmentSchema - Optional function to provide enrichment validation
+ * @param args.toEnrichmentRequest - Optional function to request enrichments
+ * @returns Model entry object for use in the generation pipeline
+ *
+ * @example Basic model entry
+ * ```typescript
+ * import { toModelEntry } from '@skmtc/core';
+ *
+ * const typeScriptModelEntry = toModelEntry({
+ *   id: 'typescript-models',
+ *   transform: ({ context, refName, acc }) => {
+ *     const schema = context.getSchemaByRefName(refName);
+ *     const tsInterface = generateTypeScriptInterface(schema);
+ *     return { ...acc, [refName]: tsInterface };
+ *   },
+ *   toPreviewModule: ({ context, refName }) => ({
+ *     group: 'forms',
+ *     title: `${refName} Model`,
+ *     description: 'Generated TypeScript interface'
+ *   })
+ * });
+ * ```
+ *
+ * @example Model entry with enrichments
+ * ```typescript
+ * const validationModelEntry = toModelEntry({
+ *   id: 'validation-schemas',
+ *   transform: ({ context, refName, acc }) => {
+ *     const enrichments = context.getEnrichments(refName);
+ *     const schema = context.getSchemaByRefName(refName);
+ *     const validationSchema = generateValidationSchema(schema, {
+ *       strict: enrichments?.strict ?? false
+ *     });
+ *     return { ...acc, [refName]: validationSchema };
+ *   },
+ *   toEnrichmentSchema: () => v.object({
+ *     strict: v.optional(v.boolean()),
+ *     nullable: v.optional(v.boolean())
+ *   }),
+ *   toEnrichmentRequest: (refName) => ({
+ *     path: `models.${refName}`,
+ *     schema: enrichmentSchema
+ *   })
+ * });
+ * ```
+ */
 const toModelEntry = ({ id, transform, toPreviewModule, toMappingModule, toEnrichmentSchema, toEnrichmentRequest }) => {
     return {
         id,

package/script/dsl/model/types.d.ts

@@ -6,33 +6,73 @@ import type { EnrichmentRequest } from '../../types/EnrichmentRequest.js';
 import type * as v from 'valibot';
 import type { MappingModule, PreviewModule } from '../../types/Preview.js';
 import type { SchemaToValueFn } from '../../types/TypeSystem.js';
-type ModelInsertableConstructorArgs<EnrichmentType = undefined> = {
+/**
+ * Constructor arguments for model insertable instances.
+ *
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
+export type ModelInsertableConstructorArgs<EnrichmentType = undefined> = {
     context: GenerateContext;
     refName: RefName;
     settings: ContentSettings<EnrichmentType>;
     destinationPath: string;
     rootRef?: RefName;
 };
+/**
+ * Interface for objects that provide model transformation capabilities.
+ *
+ * Used by generator configurations to transform model definitions
+ * during the code generation process.
+ */
 export type WithTransformModel = {
     transformModel: (refName: RefName) => void;
 };
-type ToEnrichmentsArgs = {
+/**
+ * Arguments for generating enrichment data for models.
+ */
+export type ModelToEnrichmentsArgs = {
     refName: RefName;
     context: GenerateContext;
 };
+/**
+ * Arguments passed to model transformation functions.
+ *
+ * @template Acc - Accumulator type for collecting transformation results
+ */
 export type TransformModelArgs<Acc> = {
     context: GenerateContext;
     refName: RefName;
     acc: Acc | undefined;
 };
+/**
+ * Arguments for generating model preview modules.
+ *
+ * Preview modules provide quick insights into generated models
+ * without full code generation.
+ */
 export type ToModelPreviewModuleArgs = {
     context: GenerateContext;
     refName: RefName;
 };
+/**
+ * Arguments for generating model mapping information.
+ *
+ * Mappings track relationships between OAS schemas and generated models,
+ * enabling cross-references and dependency analysis.
+ */
 export type ToModelMappingArgs = {
     context: GenerateContext;
     refName: RefName;
 };
+/**
+ * Configuration object for insertable model generators.
+ *
+ * Defines the contract for model generator classes that can be inserted
+ * into the generation context to produce type-safe model definitions.
+ *
+ * @template V - Generated value type produced by the model generator
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type ModelInsertable<V, EnrichmentType = undefined> = {
     prototype: V;
 } & {
@@ -41,10 +81,18 @@ export type ModelInsertable<V, EnrichmentType = undefined> = {
     type: 'model';
     toIdentifier: (refName: RefName) => Identifier;
     toExportPath: (refName: RefName) => string;
-    toEnrichments: ({ refName, context }: ToEnrichmentsArgs) => EnrichmentType;
+    toEnrichments: ({ refName, context }: ModelToEnrichmentsArgs) => EnrichmentType;
     schemaToValueFn: SchemaToValueFn;
     createIdentifier: (name: string) => Identifier;
 } & Function;
+/**
+ * Configuration object for model generators.
+ *
+ * Defines the behavior and capabilities of model generators including
+ * transformation logic, preview generation, and enrichment handling.
+ *
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type ModelConfig<EnrichmentType = undefined> = {
     id: string;
     type: 'model';
@@ -54,5 +102,4 @@ export type ModelConfig<EnrichmentType = undefined> = {
     toEnrichmentSchema?: () => v.BaseSchema<EnrichmentType, EnrichmentType, v.BaseIssue<unknown>>;
     toEnrichmentRequest?: <RequestedEnrichment extends EnrichmentType>(refName: RefName) => EnrichmentRequest<RequestedEnrichment> | undefined;
 };
-export {};
 //# sourceMappingURL=types.d.ts.map

package/script/dsl/model/types.d.ts.map

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

package/script/dsl/operation/OperationBase.d.ts

@@ -9,9 +9,9 @@ import type { Definition } from '../Definition.js';
 import type { Inserted } from '../Inserted.js';
 import type { ModelInsertable } from '../model/types.js';
 import type { RefName } from '../../types/RefName.js';
-import { OasSchema } from '../../oas/schema/Schema.js';
-import { OasRef } from '../../oas/ref/Ref.js';
-import { OasVoid } from '../../oas/void/Void.js';
+import type { OasSchema } from '../../oas/schema/Schema.js';
+import type { OasRef } from '../../oas/ref/Ref.js';
+import type { OasVoid } from '../../oas/void/Void.js';
 /**
  * Constructor arguments for {@link OperationBase}.
  *

package/script/dsl/operation/OperationBase.d.ts.map

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

package/script/dsl/operation/OperationDriver.d.ts

@@ -12,14 +12,62 @@ type CreateOperationArgs<V extends GeneratedValue, T extends GenerationType, Enr
     destinationPath?: string;
     noExport?: boolean;
 };
+/**
+ * Driver class for generating operation-based artifacts from OpenAPI operations.
+ *
+ * The `OperationDriver` manages the transformation of OpenAPI operation objects
+ * into code artifacts, handling path generation, identifier resolution, and
+ * definition management. It serves as the core orchestrator for operation-based
+ * code generation in the SKMTC pipeline.
+ *
+ * @template V - Type of generated values produced by this driver
+ * @template T - Type of generation strategy (e.g., 'function', 'class', 'hook')
+ * @template EnrichmentType - Type of enrichments that can be applied
+ *
+ * @example Basic usage in an operation generator
+ * ```typescript
+ * class APIClientGenerator extends OperationBase {
+ *   generate() {
+ *     const driver = new OperationDriver({
+ *       context: this.context,
+ *       insertable: this,
+ *       operation: this.operation,
+ *       generation: 'function'
+ *     });
+ *
+ *     const functionCode = driver.definition.toValueString();
+ *     const file = this.createFile(functionCode);
+ *     this.register({ file });
+ *   }
+ * }
+ * ```
+ */
 export declare class OperationDriver<V extends GeneratedValue, T extends GenerationType, EnrichmentType = undefined> {
+    /** The generation context providing access to OAS objects and utilities */
     context: GenerateContext;
+    /** The insertable object that provides generation configuration */
     insertable: OperationInsertable<V, EnrichmentType>;
+    /** The OpenAPI operation object being processed */
     operation: OasOperation;
+    /** Content settings for customizing generation behavior */
     settings: ContentSettings<EnrichmentType>;
+    /** Optional custom destination path for generated files */
     destinationPath?: string;
+    /** The generated definition containing the transformed operation */
     definition: GeneratedDefinition<V, T>;
+    /** Whether to exclude this operation from exports */
     noExport?: boolean;
+    /**
+     * Creates a new OperationDriver instance.
+     *
+     * @param args - Configuration for the operation driver
+     * @param args.context - Generation context
+     * @param args.insertable - Insertable providing generation configuration
+     * @param args.operation - OpenAPI operation to process
+     * @param args.generation - Optional generation type
+     * @param args.destinationPath - Optional custom destination path
+     * @param args.noExport - Whether to exclude from exports
+     */
     constructor({ context, insertable, operation, generation, destinationPath, noExport }: CreateOperationArgs<V, T, EnrichmentType>);
     private apply;
     private getDefinition;

package/script/dsl/operation/OperationDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OperationDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/operation/OperationDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,KAAK,mBAAmB,CACtB,CAAC,SAAS,cAAc,EACxB,CAAC,SAAS,cAAc,EACxB,cAAc,GAAG,SAAS,IACxB;IACF,OAAO,EAAE,eAAe,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAClD,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAYD,qBAAa,eAAe,CAC1B,CAAC,SAAS,cAAc,EACxB,CAAC,SAAS,cAAc,EACxB,cAAc,GAAG,SAAS;IAE1B,OAAO,EAAE,eAAe,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAClD,SAAS,EAAE,YAAY,CAAA;IACvB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;gBACN,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,QAAQ,EACT,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC;IAc5C,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,gBAAgB;CAqBzB"}
+{"version":3,"file":"OperationDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/operation/OperationDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,KAAK,mBAAmB,CACtB,CAAC,SAAS,cAAc,EACxB,CAAC,SAAS,cAAc,EACxB,cAAc,GAAG,SAAS,IACxB;IACF,OAAO,EAAE,eAAe,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAClD,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,CAAC,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,eAAe,CAC1B,CAAC,SAAS,cAAc,EACxB,CAAC,SAAS,cAAc,EACxB,cAAc,GAAG,SAAS;IAE1B,2EAA2E;IAC3E,OAAO,EAAE,eAAe,CAAA;IACxB,mEAAmE;IACnE,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAClD,mDAAmD;IACnD,SAAS,EAAE,YAAY,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oEAAoE;IACpE,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;;;;;;;OAUG;gBACS,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,QAAQ,EACT,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC;IAc5C,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,gBAAgB;CAqBzB"}

package/script/dsl/operation/OperationDriver.js

@@ -4,44 +4,92 @@ exports.OperationDriver = void 0;
 const normalize_js_1 = require("../../deps/jsr.io/@std/path/1.1.2/normalize.js");
 const Definition_js_1 = require("../Definition.js");
 const GeneratorKeys_js_1 = require("../../types/GeneratorKeys.js");
+/**
+ * Driver class for generating operation-based artifacts from OpenAPI operations.
+ *
+ * The `OperationDriver` manages the transformation of OpenAPI operation objects
+ * into code artifacts, handling path generation, identifier resolution, and
+ * definition management. It serves as the core orchestrator for operation-based
+ * code generation in the SKMTC pipeline.
+ *
+ * @template V - Type of generated values produced by this driver
+ * @template T - Type of generation strategy (e.g., 'function', 'class', 'hook')
+ * @template EnrichmentType - Type of enrichments that can be applied
+ *
+ * @example Basic usage in an operation generator
+ * ```typescript
+ * class APIClientGenerator extends OperationBase {
+ *   generate() {
+ *     const driver = new OperationDriver({
+ *       context: this.context,
+ *       insertable: this,
+ *       operation: this.operation,
+ *       generation: 'function'
+ *     });
+ *
+ *     const functionCode = driver.definition.toValueString();
+ *     const file = this.createFile(functionCode);
+ *     this.register({ file });
+ *   }
+ * }
+ * ```
+ */
 class OperationDriver {
+    /**
+     * Creates a new OperationDriver instance.
+     *
+     * @param args - Configuration for the operation driver
+     * @param args.context - Generation context
+     * @param args.insertable - Insertable providing generation configuration
+     * @param args.operation - OpenAPI operation to process
+     * @param args.generation - Optional generation type
+     * @param args.destinationPath - Optional custom destination path
+     * @param args.noExport - Whether to exclude from exports
+     */
     constructor({ context, insertable, operation, generation, destinationPath, noExport }) {
+        /** The generation context providing access to OAS objects and utilities */
         Object.defineProperty(this, "context", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** The insertable object that provides generation configuration */
         Object.defineProperty(this, "insertable", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** The OpenAPI operation object being processed */
         Object.defineProperty(this, "operation", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Content settings for customizing generation behavior */
         Object.defineProperty(this, "settings", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Optional custom destination path for generated files */
         Object.defineProperty(this, "destinationPath", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** The generated definition containing the transformed operation */
         Object.defineProperty(this, "definition", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Whether to exclude this operation from exports */
         Object.defineProperty(this, "noExport", {
             enumerable: true,
             configurable: true,
@@ -59,7 +107,7 @@ class OperationDriver {
         });
         this.definition = this.apply({ generation, destinationPath });
     }
-    apply({ generation, destinationPath } = {}) {
+    apply({ generation: _generation, destinationPath } = {}) {
         const { identifier, exportPath } = this.settings;
         // Everything is selected (for now)
         // if (/*!selected && */ generation !== 'force') {