@contractspec/integration.example-generator 10.0.0 → 11.0.0

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import type { ExampleGeneratorPluginConfig } from './types.js';
+/**
+ * Default configuration for the ExampleGeneratorPlugin
+ */
+export declare const defaultConfig: ExampleGeneratorPluginConfig;
+/**
+ * Merge user config with defaults
+ */
+export declare function mergeConfig(userConfig: Partial<ExampleGeneratorPluginConfig>): ExampleGeneratorPluginConfig;
+/**
+ * Validate configuration
+ */
+export declare function validateConfig(config: ExampleGeneratorPluginConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,4BAM3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAChD,4BAA4B,CAK9B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAmBzE"}

package/dist/config.js

@@ -0,0 +1,34 @@
+// @bun
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+export {
+  validateConfig,
+  mergeConfig,
+  defaultConfig
+};

package/dist/generator.d.ts

@@ -0,0 +1,11 @@
+import type { ExampleGeneratorPluginConfig, GeneratorContext, GeneratorResult, PluginMetadata } from './types.js';
+export declare class ExampleGeneratorPlugin {
+    private config;
+    private readonly metadata;
+    constructor(config?: Partial<ExampleGeneratorPluginConfig>);
+    getConfig(): ExampleGeneratorPluginConfig;
+    updateConfig(config: Partial<ExampleGeneratorPluginConfig>): void;
+    getMetadata(): PluginMetadata;
+    generate(context: GeneratorContext): Promise<GeneratorResult>;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,MAAM,GAAE,OAAO,CAAC,4BAA4B,CAAM;IAa9D,SAAS,IAAI,4BAA4B;IAIzC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG,IAAI;IAMjE,WAAW,IAAI,cAAc;IAIvB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CA2BpE"}

package/dist/generator.js

@@ -0,0 +1,86 @@
+// @bun
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+
+// src/generator.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+class ExampleGeneratorPlugin {
+  config;
+  metadata;
+  constructor(config = {}) {
+    const merged = mergeConfig(config);
+    validateConfig(merged);
+    this.config = merged;
+    this.metadata = {
+      id: "example-generator",
+      name: "@contractspec/integration.example-generator",
+      version: "1.0.0",
+      description: "Example markdown documentation generator",
+      author: "ContractSpec"
+    };
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  updateConfig(config) {
+    const merged = mergeConfig({ ...this.config, ...config });
+    validateConfig(merged);
+    this.config = merged;
+  }
+  getMetadata() {
+    return { ...this.metadata };
+  }
+  async generate(context) {
+    if (!context.spec) {
+      throw new Error("Spec is required to generate documentation");
+    }
+    const outputDir = this.config.outputDir;
+    mkdirSync(outputDir, { recursive: true });
+    const fileName = "spec-" + Date.now() + ".md";
+    const outputPath = join(outputDir, fileName);
+    const content = `# Spec Documentation
+
+Generated for spec: ${String(context.spec.id ?? "unknown")}`;
+    writeFileSync(outputPath, content, "utf8");
+    return {
+      outputPath,
+      itemCount: 1,
+      metadata: {
+        specId: String(context.spec.id ?? "unknown"),
+        generatedAt: new Date,
+        format: this.config.format ?? "auto",
+        config: this.config
+      }
+    };
+  }
+}
+export {
+  ExampleGeneratorPlugin
+};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @contractspec/lib.plugin.example-generator
+ * Example plugin: Markdown documentation generator for ContractSpec specs
+ */
+export { ExampleGeneratorPlugin } from './generator.js';
+export type { ExampleGeneratorPluginConfig, GeneratorResult, PluginMetadata, ExampleGeneratorError, ValidationError, ConfigurationError, GenerationError, } from './types.js';
+export { defaultConfig, mergeConfig, validateConfig } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,YAAY,EACV,4BAA4B,EAC5B,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,89 @@
+// @bun
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+
+// src/generator.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+class ExampleGeneratorPlugin {
+  config;
+  metadata;
+  constructor(config = {}) {
+    const merged = mergeConfig(config);
+    validateConfig(merged);
+    this.config = merged;
+    this.metadata = {
+      id: "example-generator",
+      name: "@contractspec/integration.example-generator",
+      version: "1.0.0",
+      description: "Example markdown documentation generator",
+      author: "ContractSpec"
+    };
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  updateConfig(config) {
+    const merged = mergeConfig({ ...this.config, ...config });
+    validateConfig(merged);
+    this.config = merged;
+  }
+  getMetadata() {
+    return { ...this.metadata };
+  }
+  async generate(context) {
+    if (!context.spec) {
+      throw new Error("Spec is required to generate documentation");
+    }
+    const outputDir = this.config.outputDir;
+    mkdirSync(outputDir, { recursive: true });
+    const fileName = "spec-" + Date.now() + ".md";
+    const outputPath = join(outputDir, fileName);
+    const content = `# Spec Documentation
+
+Generated for spec: ${String(context.spec.id ?? "unknown")}`;
+    writeFileSync(outputPath, content, "utf8");
+    return {
+      outputPath,
+      itemCount: 1,
+      metadata: {
+        specId: String(context.spec.id ?? "unknown"),
+        generatedAt: new Date,
+        format: this.config.format ?? "auto",
+        config: this.config
+      }
+    };
+  }
+}
+export {
+  validateConfig,
+  mergeConfig,
+  defaultConfig,
+  ExampleGeneratorPlugin
+};

package/dist/node/config.js

@@ -0,0 +1,33 @@
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+export {
+  validateConfig,
+  mergeConfig,
+  defaultConfig
+};

package/dist/node/generator.js

@@ -0,0 +1,85 @@
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+
+// src/generator.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+class ExampleGeneratorPlugin {
+  config;
+  metadata;
+  constructor(config = {}) {
+    const merged = mergeConfig(config);
+    validateConfig(merged);
+    this.config = merged;
+    this.metadata = {
+      id: "example-generator",
+      name: "@contractspec/integration.example-generator",
+      version: "1.0.0",
+      description: "Example markdown documentation generator",
+      author: "ContractSpec"
+    };
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  updateConfig(config) {
+    const merged = mergeConfig({ ...this.config, ...config });
+    validateConfig(merged);
+    this.config = merged;
+  }
+  getMetadata() {
+    return { ...this.metadata };
+  }
+  async generate(context) {
+    if (!context.spec) {
+      throw new Error("Spec is required to generate documentation");
+    }
+    const outputDir = this.config.outputDir;
+    mkdirSync(outputDir, { recursive: true });
+    const fileName = "spec-" + Date.now() + ".md";
+    const outputPath = join(outputDir, fileName);
+    const content = `# Spec Documentation
+
+Generated for spec: ${String(context.spec.id ?? "unknown")}`;
+    writeFileSync(outputPath, content, "utf8");
+    return {
+      outputPath,
+      itemCount: 1,
+      metadata: {
+        specId: String(context.spec.id ?? "unknown"),
+        generatedAt: new Date,
+        format: this.config.format ?? "auto",
+        config: this.config
+      }
+    };
+  }
+}
+export {
+  ExampleGeneratorPlugin
+};

package/dist/node/index.js

@@ -0,0 +1,88 @@
+// src/config.ts
+var defaultConfig = {
+  outputDir: "./docs",
+  format: "auto",
+  maxItems: 100,
+  maxDepth: 2,
+  excludeFields: []
+};
+function mergeConfig(userConfig) {
+  return {
+    ...defaultConfig,
+    ...userConfig
+  };
+}
+function validateConfig(config) {
+  if (!config.outputDir) {
+    throw new Error("outputDir is required");
+  }
+  if (config.format && !["table", "list", "detail", "auto"].includes(config.format)) {
+    throw new Error("format must be one of: table, list, detail, auto");
+  }
+  if (config.maxItems !== undefined && config.maxItems < 1) {
+    throw new Error("maxItems must be greater than 0");
+  }
+  if (config.maxDepth !== undefined && config.maxDepth < 1) {
+    throw new Error("maxDepth must be greater than 0");
+  }
+}
+
+// src/generator.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+class ExampleGeneratorPlugin {
+  config;
+  metadata;
+  constructor(config = {}) {
+    const merged = mergeConfig(config);
+    validateConfig(merged);
+    this.config = merged;
+    this.metadata = {
+      id: "example-generator",
+      name: "@contractspec/integration.example-generator",
+      version: "1.0.0",
+      description: "Example markdown documentation generator",
+      author: "ContractSpec"
+    };
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  updateConfig(config) {
+    const merged = mergeConfig({ ...this.config, ...config });
+    validateConfig(merged);
+    this.config = merged;
+  }
+  getMetadata() {
+    return { ...this.metadata };
+  }
+  async generate(context) {
+    if (!context.spec) {
+      throw new Error("Spec is required to generate documentation");
+    }
+    const outputDir = this.config.outputDir;
+    mkdirSync(outputDir, { recursive: true });
+    const fileName = "spec-" + Date.now() + ".md";
+    const outputPath = join(outputDir, fileName);
+    const content = `# Spec Documentation
+
+Generated for spec: ${String(context.spec.id ?? "unknown")}`;
+    writeFileSync(outputPath, content, "utf8");
+    return {
+      outputPath,
+      itemCount: 1,
+      metadata: {
+        specId: String(context.spec.id ?? "unknown"),
+        generatedAt: new Date,
+        format: this.config.format ?? "auto",
+        config: this.config
+      }
+    };
+  }
+}
+export {
+  validateConfig,
+  mergeConfig,
+  defaultConfig,
+  ExampleGeneratorPlugin
+};

package/dist/node/types.js

@@ -0,0 +1,38 @@
+// src/types.ts
+class ExampleGeneratorError extends Error {
+  code;
+  details;
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "ExampleGeneratorError";
+  }
+}
+
+class ValidationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "VALIDATION_ERROR", details);
+    this.name = "ValidationError";
+  }
+}
+
+class ConfigurationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "CONFIGURATION_ERROR", details);
+    this.name = "ConfigurationError";
+  }
+}
+
+class GenerationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "GENERATION_ERROR", details);
+    this.name = "GenerationError";
+  }
+}
+export {
+  ValidationError,
+  GenerationError,
+  ExampleGeneratorError,
+  ConfigurationError
+};

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+import type { AnySchemaModel } from '@contractspec/lib.schema';
+export type SpecDefinition = unknown;
+/**
+ * Configuration for the ExampleGeneratorPlugin
+ */
+export interface ExampleGeneratorPluginConfig {
+    /** Directory where markdown files will be generated */
+    outputDir: string;
+    /** Output format: table, list, detail, or auto */
+    format?: 'table' | 'list' | 'detail' | 'auto';
+    /** Title for the generated documentation */
+    title?: string;
+    /** Description to include below the title */
+    description?: string;
+    /** Maximum number of items to render in tables */
+    maxItems?: number;
+    /** Maximum nesting depth for nested objects */
+    maxDepth?: number;
+    /** Only include these fields (if not specified, all fields are included) */
+    includeFields?: string[];
+    /** Exclude these fields from output */
+    excludeFields?: string[];
+    /** Custom field labels (field name -> display label) */
+    fieldLabels?: Record<string, string>;
+    /** Fields to use for summary in list format */
+    summaryFields?: string[];
+}
+/**
+ * Context provided during generation
+ */
+export interface GeneratorContext {
+    /** The spec definition being processed */
+    spec: SpecDefinition;
+    /** Schema models from the spec */
+    schemas: Record<string, AnySchemaModel>;
+    /** Instance data (optional) */
+    data?: unknown;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of generation
+ */
+export interface GeneratorResult {
+    /** Path to the generated file */
+    outputPath: string;
+    /** Number of items processed */
+    itemCount: number;
+    /** Generation metadata */
+    metadata: {
+        specId: string;
+        generatedAt: Date;
+        format: string;
+        config: Partial<ExampleGeneratorPluginConfig>;
+    };
+}
+/**
+ * Plugin metadata
+ */
+export interface PluginMetadata {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+    readonly author: string;
+    readonly homepage?: string;
+}
+/**
+ * Error types for the plugin
+ */
+export declare class ExampleGeneratorError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends ExampleGeneratorError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Configuration errors
+ */
+export declare class ConfigurationError extends ExampleGeneratorError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Generation errors
+ */
+export declare class GenerationError extends ExampleGeneratorError {
+    constructor(message: string, details?: unknown);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,cAAc,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;KAC/C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,qBAAqB;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C"}

package/dist/types.js

@@ -0,0 +1,39 @@
+// @bun
+// src/types.ts
+class ExampleGeneratorError extends Error {
+  code;
+  details;
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "ExampleGeneratorError";
+  }
+}
+
+class ValidationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "VALIDATION_ERROR", details);
+    this.name = "ValidationError";
+  }
+}
+
+class ConfigurationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "CONFIGURATION_ERROR", details);
+    this.name = "ConfigurationError";
+  }
+}
+
+class GenerationError extends ExampleGeneratorError {
+  constructor(message, details) {
+    super(message, "GENERATION_ERROR", details);
+    this.name = "GenerationError";
+  }
+}
+export {
+  ValidationError,
+  GenerationError,
+  ExampleGeneratorError,
+  ConfigurationError
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/integration.example-generator",
-  "version": "10.0.0",
+  "version": "11.0.0",
   "description": "Example plugin: Markdown documentation generator for ContractSpec specs",
   "keywords": [
     "contractspec",
@@ -14,11 +14,10 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./types": "./dist/types.js",
-    "./generator": "./dist/generator.js",
-    "./config": "./dist/config.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./config": "./src/config.ts",
+    "./generator": "./src/generator.ts",
+    "./types": "./src/types.ts"
   },
   "files": [
     "dist",
@@ -28,38 +27,65 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
     "test": "bun test",
     "test:watch": "bun test --watch",
-    "test:coverage": "bun test --coverage"
+    "test:coverage": "bun test --coverage",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.57.0",
-    "@contractspec/lib.schema": "1.57.0",
+    "@contractspec/lib.contracts": "1.58.0",
+    "@contractspec/lib.schema": "1.58.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
+    "@contractspec/tool.typescript": "1.58.0",
     "typescript": "^5.9.3",
     "@types/node": "^25.2.1",
-    "rimraf": "^6.0.1"
+    "rimraf": "^6.0.1",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "peerDependencies": {
-    "@contractspec/lib.contracts": "^1.57.0",
-    "@contractspec/lib.schema": "^1.57.0"
+    "@contractspec/lib.contracts": "^1.58.0",
+    "@contractspec/lib.schema": "^1.58.0"
   },
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "default": "./dist/index.js"
+      },
+      "./config": {
+        "types": "./dist/config.d.ts",
+        "bun": "./dist/config.js",
+        "node": "./dist/node/config.mjs",
+        "default": "./dist/config.js"
+      },
+      "./generator": {
+        "types": "./dist/generator.d.ts",
+        "bun": "./dist/generator.js",
+        "node": "./dist/node/generator.mjs",
+        "default": "./dist/generator.js"
+      },
+      "./types": {
+        "types": "./dist/types.d.ts",
+        "bun": "./dist/types.js",
+        "node": "./dist/node/types.mjs",
+        "default": "./dist/types.js"
+      }
+    }
   },
   "license": "MIT",
   "repository": {

package/dist/index.d.mts

@@ -1,123 +0,0 @@
-import { AnySchemaModel } from "@contractspec/lib.schema";
-
-//#region src/types.d.ts
-type SpecDefinition = unknown;
-/**
- * Configuration for the ExampleGeneratorPlugin
- */
-interface ExampleGeneratorPluginConfig {
-  /** Directory where markdown files will be generated */
-  outputDir: string;
-  /** Output format: table, list, detail, or auto */
-  format?: 'table' | 'list' | 'detail' | 'auto';
-  /** Title for the generated documentation */
-  title?: string;
-  /** Description to include below the title */
-  description?: string;
-  /** Maximum number of items to render in tables */
-  maxItems?: number;
-  /** Maximum nesting depth for nested objects */
-  maxDepth?: number;
-  /** Only include these fields (if not specified, all fields are included) */
-  includeFields?: string[];
-  /** Exclude these fields from output */
-  excludeFields?: string[];
-  /** Custom field labels (field name -> display label) */
-  fieldLabels?: Record<string, string>;
-  /** Fields to use for summary in list format */
-  summaryFields?: string[];
-}
-/**
- * Context provided during generation
- */
-interface GeneratorContext {
-  /** The spec definition being processed */
-  spec: SpecDefinition;
-  /** Schema models from the spec */
-  schemas: Record<string, AnySchemaModel>;
-  /** Instance data (optional) */
-  data?: unknown;
-  /** Additional metadata */
-  metadata?: Record<string, unknown>;
-}
-/**
- * Result of generation
- */
-interface GeneratorResult {
-  /** Path to the generated file */
-  outputPath: string;
-  /** Number of items processed */
-  itemCount: number;
-  /** Generation metadata */
-  metadata: {
-    specId: string;
-    generatedAt: Date;
-    format: string;
-    config: Partial<ExampleGeneratorPluginConfig>;
-  };
-}
-/**
- * Plugin metadata
- */
-interface PluginMetadata {
-  readonly id: string;
-  readonly name: string;
-  readonly version: string;
-  readonly description: string;
-  readonly author: string;
-  readonly homepage?: string;
-}
-/**
- * Error types for the plugin
- */
-declare class ExampleGeneratorError extends Error {
-  readonly code: string;
-  readonly details?: unknown | undefined;
-  constructor(message: string, code: string, details?: unknown | undefined);
-}
-/**
- * Validation errors
- */
-declare class ValidationError extends ExampleGeneratorError {
-  constructor(message: string, details?: unknown);
-}
-/**
- * Configuration errors
- */
-declare class ConfigurationError extends ExampleGeneratorError {
-  constructor(message: string, details?: unknown);
-}
-/**
- * Generation errors
- */
-declare class GenerationError extends ExampleGeneratorError {
-  constructor(message: string, details?: unknown);
-}
-//#endregion
-//#region src/generator.d.ts
-declare class ExampleGeneratorPlugin {
-  private config;
-  private readonly metadata;
-  constructor(config?: Partial<ExampleGeneratorPluginConfig>);
-  getConfig(): ExampleGeneratorPluginConfig;
-  updateConfig(config: Partial<ExampleGeneratorPluginConfig>): void;
-  getMetadata(): PluginMetadata;
-  generate(context: GeneratorContext): Promise<GeneratorResult>;
-}
-//#endregion
-//#region src/config.d.ts
-/**
- * Default configuration for the ExampleGeneratorPlugin
- */
-declare const defaultConfig: ExampleGeneratorPluginConfig;
-/**
- * Merge user config with defaults
- */
-declare function mergeConfig(userConfig: Partial<ExampleGeneratorPluginConfig>): ExampleGeneratorPluginConfig;
-/**
- * Validate configuration
- */
-declare function validateConfig(config: ExampleGeneratorPluginConfig): void;
-//#endregion
-export { type ConfigurationError, type ExampleGeneratorError, ExampleGeneratorPlugin, type ExampleGeneratorPluginConfig, type GenerationError, type GeneratorResult, type PluginMetadata, type ValidationError, defaultConfig, mergeConfig, validateConfig };
-//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/generator.ts","../src/config.ts"],"mappings":";;;KACY,cAAA;;AAAZ;;UAKiB,4BAAA;EALS;EAOxB,SAAA;EAFe;EAIf,MAAA;;EAEA,KAAA;EAJA;EAMA,WAAA;EAFA;EAIA,QAAA;EAAA;EAEA,QAAA;EAEA;EAAA,aAAA;EAIA;EAFA,aAAA;EAIA;EAFA,WAAA,GAAc,MAAA;EAED;EAAb,aAAA;AAAA;;;;UAMe,gBAAA;EAQJ;EANX,IAAA,EAAM,cAAA;EAMW;EAJjB,OAAA,EAAS,MAAA,SAAe,cAAA;EAFlB;EAIN,IAAA;EAFS;EAIT,QAAA,GAAW,MAAA;AAAA;;;;UAMI,eAAA;EAAA;EAEf,UAAA;;EAEA,SAAA;EAMkB;EAJlB,QAAA;IACE,MAAA;IACA,WAAA,EAAa,IAAA;IACb,MAAA;IACA,MAAA,EAAQ,OAAA,CAAQ,4BAAA;EAAA;AAAA;;;;UAOH,cAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA;EAAA,SACA,MAAA;EAAA,SACA,QAAA;AAAA;;;;cAME,qBAAA,SAA8B,KAAA;EAAA,SAGvB,IAAA;EAAA,SACA,OAAA;cAFhB,OAAA,UACgB,IAAA,UACA,OAAA;AAAA;;AAJpB;;cAca,eAAA,SAAwB,qBAAA;cACvB,OAAA,UAAiB,OAAA;AAAA;;;;cASlB,kBAAA,SAA2B,qBAAA;cAC1B,OAAA,UAAiB,OAAA;AAAA;;;AAX/B;cAoBa,eAAA,SAAwB,qBAAA;cACvB,OAAA,UAAiB,OAAA;AAAA;;;cCpGlB,sBAAA;EAAA,QACH,MAAA;EAAA,iBACS,QAAA;cAEL,MAAA,GAAQ,OAAA,CAAQ,4BAAA;EAa5B,SAAA,CAAA,GAAa,4BAAA;EAIb,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,4BAAA;EAM7B,WAAA,CAAA,GAAe,cAAA;EAIT,QAAA,CAAS,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;AAAA;;;;;ADxCrD;cEIa,aAAA,EAAe,4BAAA;;;;iBAWZ,WAAA,CACd,UAAA,EAAY,OAAA,CAAQ,4BAAA,IACnB,4BAAA;;;;iBAUa,cAAA,CAAe,MAAA,EAAQ,4BAAA"}

package/dist/index.mjs

@@ -1,91 +0,0 @@
-import { mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
-
-//#region src/config.ts
-/**
-* Default configuration for the ExampleGeneratorPlugin
-*/
-const defaultConfig = {
-	outputDir: "./docs",
-	format: "auto",
-	maxItems: 100,
-	maxDepth: 2,
-	excludeFields: []
-};
-/**
-* Merge user config with defaults
-*/
-function mergeConfig(userConfig) {
-	return {
-		...defaultConfig,
-		...userConfig
-	};
-}
-/**
-* Validate configuration
-*/
-function validateConfig(config) {
-	if (!config.outputDir) throw new Error("outputDir is required");
-	if (config.format && ![
-		"table",
-		"list",
-		"detail",
-		"auto"
-	].includes(config.format)) throw new Error("format must be one of: table, list, detail, auto");
-	if (config.maxItems !== void 0 && config.maxItems < 1) throw new Error("maxItems must be greater than 0");
-	if (config.maxDepth !== void 0 && config.maxDepth < 1) throw new Error("maxDepth must be greater than 0");
-}
-
-//#endregion
-//#region src/generator.ts
-var ExampleGeneratorPlugin = class {
-	config;
-	metadata;
-	constructor(config = {}) {
-		const merged = mergeConfig(config);
-		validateConfig(merged);
-		this.config = merged;
-		this.metadata = {
-			id: "example-generator",
-			name: "@contractspec/integration.example-generator",
-			version: "1.0.0",
-			description: "Example markdown documentation generator",
-			author: "ContractSpec"
-		};
-	}
-	getConfig() {
-		return { ...this.config };
-	}
-	updateConfig(config) {
-		const merged = mergeConfig({
-			...this.config,
-			...config
-		});
-		validateConfig(merged);
-		this.config = merged;
-	}
-	getMetadata() {
-		return { ...this.metadata };
-	}
-	async generate(context) {
-		if (!context.spec) throw new Error("Spec is required to generate documentation");
-		const outputDir = this.config.outputDir;
-		mkdirSync(outputDir, { recursive: true });
-		const outputPath = join(outputDir, "spec-" + Date.now() + ".md");
-		writeFileSync(outputPath, `# Spec Documentation\n\nGenerated for spec: ${String(context.spec.id ?? "unknown")}`, "utf8");
-		return {
-			outputPath,
-			itemCount: 1,
-			metadata: {
-				specId: String(context.spec.id ?? "unknown"),
-				generatedAt: /* @__PURE__ */ new Date(),
-				format: this.config.format ?? "auto",
-				config: this.config
-			}
-		};
-	}
-};
-
-//#endregion
-export { ExampleGeneratorPlugin, defaultConfig, mergeConfig, validateConfig };
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/config.ts","../src/generator.ts"],"sourcesContent":["import type { ExampleGeneratorPluginConfig } from './types.js';\n\n/**\n * Default configuration for the ExampleGeneratorPlugin\n */\nexport const defaultConfig: ExampleGeneratorPluginConfig = {\n  outputDir: './docs',\n  format: 'auto',\n  maxItems: 100,\n  maxDepth: 2,\n  excludeFields: [],\n};\n\n/**\n * Merge user config with defaults\n */\nexport function mergeConfig(\n  userConfig: Partial<ExampleGeneratorPluginConfig>\n): ExampleGeneratorPluginConfig {\n  return {\n    ...defaultConfig,\n    ...userConfig,\n  };\n}\n\n/**\n * Validate configuration\n */\nexport function validateConfig(config: ExampleGeneratorPluginConfig): void {\n  if (!config.outputDir) {\n    throw new Error('outputDir is required');\n  }\n\n  if (\n    config.format &&\n    !['table', 'list', 'detail', 'auto'].includes(config.format)\n  ) {\n    throw new Error('format must be one of: table, list, detail, auto');\n  }\n\n  if (config.maxItems !== undefined && config.maxItems < 1) {\n    throw new Error('maxItems must be greater than 0');\n  }\n\n  if (config.maxDepth !== undefined && config.maxDepth < 1) {\n    throw new Error('maxDepth must be greater than 0');\n  }\n}\n","import { mkdirSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { mergeConfig, validateConfig } from './config.js';\nimport type {\n  ExampleGeneratorPluginConfig,\n  GeneratorContext,\n  GeneratorResult,\n  PluginMetadata,\n} from './types.js';\n\nexport class ExampleGeneratorPlugin {\n  private config: ExampleGeneratorPluginConfig;\n  private readonly metadata: PluginMetadata;\n\n  constructor(config: Partial<ExampleGeneratorPluginConfig> = {}) {\n    const merged = mergeConfig(config);\n    validateConfig(merged);\n    this.config = merged;\n    this.metadata = {\n      id: 'example-generator',\n      name: '@contractspec/integration.example-generator',\n      version: '1.0.0',\n      description: 'Example markdown documentation generator',\n      author: 'ContractSpec',\n    };\n  }\n\n  getConfig(): ExampleGeneratorPluginConfig {\n    return { ...this.config };\n  }\n\n  updateConfig(config: Partial<ExampleGeneratorPluginConfig>): void {\n    const merged = mergeConfig({ ...this.config, ...config });\n    validateConfig(merged);\n    this.config = merged;\n  }\n\n  getMetadata(): PluginMetadata {\n    return { ...this.metadata };\n  }\n\n  async generate(context: GeneratorContext): Promise<GeneratorResult> {\n    if (!context.spec) {\n      throw new Error('Spec is required to generate documentation');\n    }\n\n    const outputDir = this.config.outputDir;\n    mkdirSync(outputDir, { recursive: true });\n\n    const fileName = 'spec-' + Date.now() + '.md';\n    const outputPath = join(outputDir, fileName);\n    const content = `# Spec Documentation\\n\\nGenerated for spec: ${String(\n      (context.spec as { id?: string }).id ?? 'unknown'\n    )}`;\n\n    writeFileSync(outputPath, content, 'utf8');\n\n    return {\n      outputPath,\n      itemCount: 1,\n      metadata: {\n        specId: String((context.spec as { id?: string }).id ?? 'unknown'),\n        generatedAt: new Date(),\n        format: this.config.format ?? 'auto',\n        config: this.config,\n      },\n    };\n  }\n}\n"],"mappings":";;;;;;;AAKA,MAAa,gBAA8C;CACzD,WAAW;CACX,QAAQ;CACR,UAAU;CACV,UAAU;CACV,eAAe,EAAE;CAClB;;;;AAKD,SAAgB,YACd,YAC8B;AAC9B,QAAO;EACL,GAAG;EACH,GAAG;EACJ;;;;;AAMH,SAAgB,eAAe,QAA4C;AACzE,KAAI,CAAC,OAAO,UACV,OAAM,IAAI,MAAM,wBAAwB;AAG1C,KACE,OAAO,UACP,CAAC;EAAC;EAAS;EAAQ;EAAU;EAAO,CAAC,SAAS,OAAO,OAAO,CAE5D,OAAM,IAAI,MAAM,mDAAmD;AAGrE,KAAI,OAAO,aAAa,UAAa,OAAO,WAAW,EACrD,OAAM,IAAI,MAAM,kCAAkC;AAGpD,KAAI,OAAO,aAAa,UAAa,OAAO,WAAW,EACrD,OAAM,IAAI,MAAM,kCAAkC;;;;;ACnCtD,IAAa,yBAAb,MAAoC;CAClC,AAAQ;CACR,AAAiB;CAEjB,YAAY,SAAgD,EAAE,EAAE;EAC9D,MAAM,SAAS,YAAY,OAAO;AAClC,iBAAe,OAAO;AACtB,OAAK,SAAS;AACd,OAAK,WAAW;GACd,IAAI;GACJ,MAAM;GACN,SAAS;GACT,aAAa;GACb,QAAQ;GACT;;CAGH,YAA0C;AACxC,SAAO,EAAE,GAAG,KAAK,QAAQ;;CAG3B,aAAa,QAAqD;EAChE,MAAM,SAAS,YAAY;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ,CAAC;AACzD,iBAAe,OAAO;AACtB,OAAK,SAAS;;CAGhB,cAA8B;AAC5B,SAAO,EAAE,GAAG,KAAK,UAAU;;CAG7B,MAAM,SAAS,SAAqD;AAClE,MAAI,CAAC,QAAQ,KACX,OAAM,IAAI,MAAM,6CAA6C;EAG/D,MAAM,YAAY,KAAK,OAAO;AAC9B,YAAU,WAAW,EAAE,WAAW,MAAM,CAAC;EAGzC,MAAM,aAAa,KAAK,WADP,UAAU,KAAK,KAAK,GAAG,MACI;AAK5C,gBAAc,YAJE,+CAA+C,OAC5D,QAAQ,KAAyB,MAAM,UACzC,IAEkC,OAAO;AAE1C,SAAO;GACL;GACA,WAAW;GACX,UAAU;IACR,QAAQ,OAAQ,QAAQ,KAAyB,MAAM,UAAU;IACjE,6BAAa,IAAI,MAAM;IACvB,QAAQ,KAAK,OAAO,UAAU;IAC9B,QAAQ,KAAK;IACd;GACF"}