@noego/stitch 1.0.0

package/README-schema.md

@@ -0,0 +1,139 @@
+# VSCode Schema Validation Setup
+
+This project now has VSCode schema validation configured for OpenAPI YAML files using the Dinner framework schema.
+
+## What's Configured
+
+- **Schema**: `./schemas/schema.json` - Extended OpenAPI 3.0 schema with Dinner framework extensions
+- **Target Files**: All `*.yaml` files in the project
+- **VSCode Settings**: `.vscode/settings.json` automatically configured
+
+## Supported Extensions
+
+### Dinner Framework Extensions
+
+#### Required for all operations:
+- `x-controller`: Controller class path (e.g., `controllers/user.controller`) - **REQUIRED**
+- `x-action`: Controller method name (e.g., `create`, `getAll`) - **REQUIRED**
+
+#### Optional:
+- `x-middleware`: Middleware chain array (e.g., `["auth.middleware", "validation.middleware"]`)
+
+### Module System
+- `module`: Object containing module definitions with `basePath` and `paths`
+- Each module must have:
+  - `basePath`: Base URL path for the module (e.g., `"/users"`)
+  - `paths`: Object with route definitions (same structure as main `paths`)
+
+## Example Valid YAML
+
+```yaml
+openapi: 3.0.0
+info:
+  title: My API
+  version: 1.0.0
+paths:
+  /users:
+    get:
+      x-controller: controllers/user.controller
+      x-action: getAll
+      summary: Get all users
+      responses:
+        '200':
+          description: Success
+    post:
+      x-controller: controllers/user.controller
+      x-action: create
+      x-middleware: 
+        - auth.middleware
+      summary: Create user
+      responses:
+        '201':
+          description: Created
+
+# Module system example
+module:
+  posts:
+    basePath: "/posts"
+    paths:
+      "/":
+        get:
+          x-controller: controllers/post.controller
+          x-action: getAll
+          summary: Get all posts
+          responses:
+            '200':
+              description: Success
+      "/{id}":
+        get:
+          x-controller: controllers/post.controller
+          x-action: getById
+          x-middleware:
+            - auth.middleware
+          summary: Get post by ID
+          parameters:
+            - name: id
+              in: path
+              required: true
+              schema:
+                type: integer
+          responses:
+            '200':
+              description: Success
+            '404':
+              description: Post not found
+```
+
+## Features
+
+- **Real-time validation** as you type in VSCode
+- **Required field validation** - ensures `x-controller` and `x-action` are present
+- **Autocomplete** for OpenAPI properties and Dinner extensions
+- **Error highlighting** for invalid properties or structure
+- **Module validation** - validates module structure and paths
+- **Schema-based IntelliSense** with descriptions for all Dinner extensions
+
+## Manual Installation
+
+If you need to install the schema for a different project:
+
+```bash
+# Using Stitch CLI (if available)
+stitch install ./schemas/schema.json --target "**/*.yaml"
+
+# Or manually add to .vscode/settings.json:
+{
+  "yaml.schemas": {
+    "./schemas/schema.json": ["**/*.yaml"]
+  }
+}
+```
+
+## Validation Examples
+
+✅ **Valid Dinner operation**:
+```yaml
+get:
+  x-controller: controllers/user.controller
+  x-action: getAll
+  x-middleware: ["auth.middleware"]
+  summary: Get all users
+  responses:
+    '200':
+      description: Success
+```
+
+❌ **Invalid - missing required fields**:
+```yaml
+get:
+  # Error: missing required x-controller and x-action
+  summary: Get all users
+  responses:
+    '200':
+      description: Success
+```
+
+## Requirements
+
+- VSCode with "YAML" extension by Red Hat
+- Local `schemas/schema.json` file in project

package/bin/stitch.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+// Production CLI entry point - uses compiled JavaScript
+// Import from built ESM bundle
+import { StitchEngine } from '../dist-ssr/server.js';
+import { StitchCLIFactory } from '../dist-ssr/server.js';
+
+const args = StitchCLIFactory.setup(process.argv);
+
+// Validate that at least one command is provided
+if (!args.commands || args.commands.length === 0) {
+    console.error("Error: No command specified");
+    printUsage();
+    process.exit(1);
+}
+
+const commands = args.commands;
+const command = commands[0];
+
+// Handle help command
+if (command.toLowerCase() === 'help' || args.flags.help) {
+    printUsage();
+    process.exit(0);
+}
+
+// Handle version command
+if (command.toLowerCase() === 'version' || args.flags.version) {
+    // Read package.json from relative path
+    const packageJson = JSON.parse(
+        await import('fs').then(fs => 
+            fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')
+        )
+    );
+    console.log(`stitch v${packageJson.version}`);
+    process.exit(0);
+}
+
+async function main() {
+    try {
+        const engine = new StitchEngine();
+
+        switch(command.toLowerCase()){
+            case "build":
+                const inputFile = commands[1] || 'stitch.yaml';
+                const result = await engine.build(inputFile, {
+                    output: args.flags.output,
+                    format: args.flags.format || 'yaml',
+                    validate: args.flags.validate,
+                    quiet: args.flags.quiet
+                });
+                
+                if (result.success) {
+                    if (!args.flags.quiet) {
+                        if (args.flags.output) {
+                            console.log(result.message);
+                        } else {
+                            console.log(result.data); // Output to stdout
+                        }
+                    }
+                } else {
+                    console.error(result.error);
+                    process.exit(1);
+                }
+                break;
+
+            case "watch":
+                const watchFile = commands[1] || 'stitch.yaml';
+                await engine.watch(watchFile, {
+                    output: args.flags.output,
+                    format: args.flags.format || 'yaml',
+                    validate: args.flags.validate,
+                    quiet: args.flags.quiet
+                });
+                break;
+
+            case "install":
+                const schemaFile = commands[1];
+                if (!schemaFile) {
+                    throw new Error("Schema file is required for install command");
+                }
+                
+                if (!args.flags.target) {
+                    throw new Error("--target option is required for install command");
+                }
+                
+                const targets = args.flags.target.split(',').map(t => t.trim());
+                const installResult = engine.install({
+                    schemaPath: schemaFile,
+                    targets: targets,
+                    vscodeSettingsPath: args.flags.vscode
+                });
+                
+                if (installResult.success) {
+                    if (!args.flags.quiet) {
+                        console.log(installResult.message);
+                    }
+                } else {
+                    console.error(installResult.error);
+                    process.exit(1);
+                }
+                break;
+
+            default:
+                throw new Error(`Unknown command: ${command}`);
+        }
+    } catch (error) {
+        console.error(`Error: ${error.message}`);
+        if (error.stack && process.env.DEBUG) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+}
+
+function printUsage() {
+    console.log(`
+Stitch - YAML modularization tool
+
+Usage: 
+  stitch <command> [input-file] [options]
+
+Commands:
+  build [input-file]    Build and output to stdout in YAML format (defaults to stitch.yaml)
+  watch [input-file]    Watch for changes and rebuild (defaults to stitch.yaml)
+  install <schema-file> Install JSON schema for VSCode YAML validation
+  help                  Show this help message
+  version               Show version information
+
+Options:
+  --output <file>       Write the result to the specified file instead of stdout
+  --format <json|yaml>  Specify the output format (default: yaml)
+  --validate [schema]   Validate the output (optionally against a schema, otherwise just valid YAML)
+  --target <patterns>   Comma-separated list of file patterns for schema validation (install only)
+  --vscode <path>       Custom path to .vscode/settings.json (install only, defaults to .vscode/settings.json)
+  --quiet               Build and validate but don't emit content
+  -h, --help           Show help
+  -v, --version        Show version
+
+Examples:
+  stitch build                       Build stitch.yaml and output YAML to stdout
+  stitch build my-config.yaml        Build my-config.yaml and output to stdout
+  stitch watch                       Watch stitch.yaml for changes and rebuild
+  stitch build --output result.yaml  Build and write to file
+  stitch build --format json         Build and output JSON to stdout
+  stitch build --validate            Build with YAML validation
+  stitch build --validate schema.json Build with schema validation
+  stitch build --quiet               Build and validate without output
+  stitch install schema.json --target "*.yaml,openapi/*.yaml"  Install schema for YAML files
+  stitch install openapi-schema.json --target "stitch.yaml"    Install schema for specific file
+    `);
+}
+
+main().catch(error => {
+    console.error('Unhandled error:', error);
+    process.exit(1);
+});

package/dist/browser/index.d.ts

@@ -0,0 +1,4 @@
+export { YamlMerger } from '../core/YamlMergerBrowser';
+export { stitchFromViteImports, stitchFromOrderedViteImports, stitchFromSortedViteImports, stitchFromContent, stitchFromRawContent } from '../core/ViteHelper';
+export * from '../types/StitchTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/cli/StitchCLI.d.ts

@@ -0,0 +1,12 @@
+export declare class StitchCLIFactory {
+    /**
+     * Parse command line arguments into commands and flags
+     * @param argv Optional array of command line arguments. If not provided, process.argv will be used.
+     * @returns Object containing parsed commands and flags
+     */
+    static setup(argv?: string[]): {
+        commands: string[];
+        flags: Record<string, any>;
+    };
+}
+//# sourceMappingURL=StitchCLI.d.ts.map

package/dist/cli/StitchCLI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StitchCLI.d.ts","sourceRoot":"","sources":["../../src/cli/StitchCLI.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAgB;IACzB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE;CA8CpF"}

package/dist/client.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("js-yaml");function f(r){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(r){for(const t in r)if(t!=="default"){const o=Object.getOwnPropertyDescriptor(r,t);Object.defineProperty(e,t,o.get?o:{enumerable:!0,get:()=>r[t]})}}return e.default=r,Object.freeze(e)}const u=f(l);class s{mergeContent(e){let t={};for(const o of e){let n;try{n=u.load(o.content)}catch(i){const m=o.name||"unknown content";throw new Error(`Invalid YAML in ${m}: ${i instanceof Error?i.message:String(i)}`)}n!==null&&typeof n=="object"&&(t=this.deepMerge(t,n))}return t}deepMerge(e,t){if(t==null)return e;if(e==null||typeof t!="object"||Array.isArray(t)||typeof e!="object"||Array.isArray(e))return t;const o={...e};for(const n in t)t.hasOwnProperty(n)&&(n in o?o[n]=this.deepMerge(o[n],t[n]):o[n]=t[n]);return o}}async function d(r){const e=await Promise.all(Object.entries(r).map(async([o,n])=>({content:(await n()).default,name:o})));return new s().mergeContent(e)}async function c(r,e){const t=await Promise.all(r.map(async n=>{const i=e[n];if(!i)throw new Error(`Import not found for path: ${n}`);return{content:(await i()).default,name:n}}));return new s().mergeContent(t)}async function p(r){const e=Object.keys(r).sort();return c(e,r)}function a(r){return new s().mergeContent(r)}function y(r){const e=r.map((t,o)=>({content:t,name:`content-${o}`}));return a(e)}exports.YamlMerger=s;exports.stitchFromContent=a;exports.stitchFromOrderedViteImports=c;exports.stitchFromRawContent=y;exports.stitchFromSortedViteImports=p;exports.stitchFromViteImports=d;
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","sources":["../src/core/YamlMergerBrowser.ts","../src/core/ViteHelper.ts"],"sourcesContent":["import * as yaml from 'js-yaml';\n\nexport class YamlMerger {\n  /**\n   * Merge multiple YAML content strings in order\n   */\n  mergeContent(contents: Array<{ content: string; name?: string }>): any {\n    let result = {};\n\n    for (const item of contents) {\n      let parsedContent: any;\n\n      try {\n        parsedContent = yaml.load(item.content);\n      } catch (error) {\n        const name = item.name || 'unknown content';\n        throw new Error(`Invalid YAML in ${name}: ${error instanceof Error ? error.message : String(error)}`);\n      }\n\n      if (parsedContent !== null && typeof parsedContent === 'object') {\n        result = this.deepMerge(result, parsedContent);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Deep merge two objects\n   * Rules:\n   * - Objects: merge properties, source overrides target\n   * - Arrays: source replaces target completely\n   * - Primitives: source overrides target\n   */\n  deepMerge(target: any, source: any): any {\n    // If source is null/undefined, return target\n    if (source === null || source === undefined) {\n      return target;\n    }\n\n    // If target is null/undefined, return source\n    if (target === null || target === undefined) {\n      return source;\n    }\n\n    // If source is not an object, it replaces target\n    if (typeof source !== 'object' || Array.isArray(source)) {\n      return source;\n    }\n\n    // If target is not an object, source replaces it\n    if (typeof target !== 'object' || Array.isArray(target)) {\n      return source;\n    }\n\n    // Both are objects, merge them\n    const result = { ...target };\n\n    for (const key in source) {\n      if (source.hasOwnProperty(key)) {\n        if (key in result) {\n          result[key] = this.deepMerge(result[key], source[key]);\n        } else {\n          result[key] = source[key];\n        }\n      }\n    }\n\n    return result;\n  }\n}","import { YamlMerger } from './YamlMergerBrowser';\n\n/**\n * Helper function for Vite environments\n * Works with import.meta.glob() to merge YAML files\n */\nexport async function stitchFromViteImports(\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const contents = await Promise.all(\n    Object.entries(imports).map(async ([path, importFn]) => ({\n      content: (await importFn()).default,\n      name: path\n    }))\n  );\n  \n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Helper function for ordered Vite imports\n * Ensures files are merged in a specific order based on the array\n */\nexport async function stitchFromOrderedViteImports(\n  orderedPaths: string[],\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const contents = await Promise.all(\n    orderedPaths.map(async (path) => {\n      const importFn = imports[path];\n      if (!importFn) {\n        throw new Error(`Import not found for path: ${path}`);\n      }\n      return {\n        content: (await importFn()).default,\n        name: path\n      };\n    })\n  );\n  \n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Helper function for glob pattern imports with sorting\n * Useful when you want alphabetical ordering of files\n */\nexport async function stitchFromSortedViteImports(\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const sortedPaths = Object.keys(imports).sort();\n  return stitchFromOrderedViteImports(sortedPaths, imports);\n}\n\n/**\n * Direct content merging for when you already have the YAML strings\n */\nexport function stitchFromContent(\n  contents: Array<{ content: string; name?: string }>\n): any {\n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Convenience function for merging raw YAML strings without names\n */\nexport function stitchFromRawContent(yamlStrings: string[]): any {\n  const contents = yamlStrings.map((content, index) => ({\n    content,\n    name: `content-${index}`\n  }));\n  \n  return stitchFromContent(contents);\n}"],"names":["YamlMerger","contents","result","item","parsedContent","yaml","error","name","target","source","key","stitchFromViteImports","imports","path","importFn","stitchFromOrderedViteImports","orderedPaths","stitchFromSortedViteImports","sortedPaths","stitchFromContent","stitchFromRawContent","yamlStrings","content","index"],"mappings":"qYAEO,MAAMA,CAAW,CAItB,aAAaC,EAA0D,CACrE,IAAIC,EAAS,CAAC,EAEd,UAAWC,KAAQF,EAAU,CACvB,IAAAG,EAEA,GAAA,CACcA,EAAAC,EAAK,KAAKF,EAAK,OAAO,QAC/BG,EAAO,CACR,MAAAC,EAAOJ,EAAK,MAAQ,kBAC1B,MAAM,IAAI,MAAM,mBAAmBI,CAAI,KAAKD,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CAAC,EAAE,CAAA,CAGlGF,IAAkB,MAAQ,OAAOA,GAAkB,WAC5CF,EAAA,KAAK,UAAUA,EAAQE,CAAa,EAC/C,CAGK,OAAAF,CAAA,CAUT,UAAUM,EAAaC,EAAkB,CAEnC,GAAAA,GAAW,KACN,OAAAD,EAcT,GAVIA,GAAW,MAKX,OAAOC,GAAW,UAAY,MAAM,QAAQA,CAAM,GAKlD,OAAOD,GAAW,UAAY,MAAM,QAAQA,CAAM,EAC7C,OAAAC,EAIH,MAAAP,EAAS,CAAE,GAAGM,CAAO,EAE3B,UAAWE,KAAOD,EACZA,EAAO,eAAeC,CAAG,IACvBA,KAAOR,EACFA,EAAAQ,CAAG,EAAI,KAAK,UAAUR,EAAOQ,CAAG,EAAGD,EAAOC,CAAG,CAAC,EAE9CR,EAAAQ,CAAG,EAAID,EAAOC,CAAG,GAKvB,OAAAR,CAAA,CAEX,CChEA,eAAsBS,EACpBC,EACc,CACR,MAAAX,EAAW,MAAM,QAAQ,IAC7B,OAAO,QAAQW,CAAO,EAAE,IAAI,MAAO,CAACC,EAAMC,CAAQ,KAAO,CACvD,SAAU,MAAMA,EAAA,GAAY,QAC5B,KAAMD,CAAA,EACN,CACJ,EAGO,OADQ,IAAIb,EAAW,EAChB,aAAaC,CAAQ,CACrC,CAMsB,eAAAc,EACpBC,EACAJ,EACc,CACR,MAAAX,EAAW,MAAM,QAAQ,IAC7Be,EAAa,IAAI,MAAOH,GAAS,CACzB,MAAAC,EAAWF,EAAQC,CAAI,EAC7B,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,8BAA8BD,CAAI,EAAE,EAE/C,MAAA,CACL,SAAU,MAAMC,EAAA,GAAY,QAC5B,KAAMD,CACR,CACD,CAAA,CACH,EAGO,OADQ,IAAIb,EAAW,EAChB,aAAaC,CAAQ,CACrC,CAMA,eAAsBgB,EACpBL,EACc,CACd,MAAMM,EAAc,OAAO,KAAKN,CAAO,EAAE,KAAK,EACvC,OAAAG,EAA6BG,EAAaN,CAAO,CAC1D,CAKO,SAASO,EACdlB,EACK,CAEE,OADQ,IAAID,EAAW,EAChB,aAAaC,CAAQ,CACrC,CAKO,SAASmB,EAAqBC,EAA4B,CAC/D,MAAMpB,EAAWoB,EAAY,IAAI,CAACC,EAASC,KAAW,CACpD,QAAAD,EACA,KAAM,WAAWC,CAAK,EAAA,EACtB,EAEF,OAAOJ,EAAkBlB,CAAQ,CACnC"}

package/dist/client.mjs

@@ -0,0 +1,83 @@
+import * as m from "js-yaml";
+class s {
+  /**
+   * Merge multiple YAML content strings in order
+   */
+  mergeContent(e) {
+    let t = {};
+    for (const r of e) {
+      let n;
+      try {
+        n = m.load(r.content);
+      } catch (i) {
+        const a = r.name || "unknown content";
+        throw new Error(`Invalid YAML in ${a}: ${i instanceof Error ? i.message : String(i)}`);
+      }
+      n !== null && typeof n == "object" && (t = this.deepMerge(t, n));
+    }
+    return t;
+  }
+  /**
+   * Deep merge two objects
+   * Rules:
+   * - Objects: merge properties, source overrides target
+   * - Arrays: source replaces target completely
+   * - Primitives: source overrides target
+   */
+  deepMerge(e, t) {
+    if (t == null)
+      return e;
+    if (e == null || typeof t != "object" || Array.isArray(t) || typeof e != "object" || Array.isArray(e))
+      return t;
+    const r = { ...e };
+    for (const n in t)
+      t.hasOwnProperty(n) && (n in r ? r[n] = this.deepMerge(r[n], t[n]) : r[n] = t[n]);
+    return r;
+  }
+}
+async function l(o) {
+  const e = await Promise.all(
+    Object.entries(o).map(async ([r, n]) => ({
+      content: (await n()).default,
+      name: r
+    }))
+  );
+  return new s().mergeContent(e);
+}
+async function c(o, e) {
+  const t = await Promise.all(
+    o.map(async (n) => {
+      const i = e[n];
+      if (!i)
+        throw new Error(`Import not found for path: ${n}`);
+      return {
+        content: (await i()).default,
+        name: n
+      };
+    })
+  );
+  return new s().mergeContent(t);
+}
+async function y(o) {
+  const e = Object.keys(o).sort();
+  return c(e, o);
+}
+function f(o) {
+  return new s().mergeContent(o);
+}
+function p(o) {
+  const e = o.map((t, r) => ({
+    content: t,
+    name: `content-${r}`
+  }));
+  return f(e);
+}
+export {
+  s as YamlMerger,
+  f as stitchFromContent,
+  c as stitchFromOrderedViteImports,
+  p as stitchFromRawContent,
+  y as stitchFromSortedViteImports,
+  l as stitchFromViteImports
+};
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","sources":["../src/core/YamlMergerBrowser.ts","../src/core/ViteHelper.ts"],"sourcesContent":["import * as yaml from 'js-yaml';\n\nexport class YamlMerger {\n  /**\n   * Merge multiple YAML content strings in order\n   */\n  mergeContent(contents: Array<{ content: string; name?: string }>): any {\n    let result = {};\n\n    for (const item of contents) {\n      let parsedContent: any;\n\n      try {\n        parsedContent = yaml.load(item.content);\n      } catch (error) {\n        const name = item.name || 'unknown content';\n        throw new Error(`Invalid YAML in ${name}: ${error instanceof Error ? error.message : String(error)}`);\n      }\n\n      if (parsedContent !== null && typeof parsedContent === 'object') {\n        result = this.deepMerge(result, parsedContent);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Deep merge two objects\n   * Rules:\n   * - Objects: merge properties, source overrides target\n   * - Arrays: source replaces target completely\n   * - Primitives: source overrides target\n   */\n  deepMerge(target: any, source: any): any {\n    // If source is null/undefined, return target\n    if (source === null || source === undefined) {\n      return target;\n    }\n\n    // If target is null/undefined, return source\n    if (target === null || target === undefined) {\n      return source;\n    }\n\n    // If source is not an object, it replaces target\n    if (typeof source !== 'object' || Array.isArray(source)) {\n      return source;\n    }\n\n    // If target is not an object, source replaces it\n    if (typeof target !== 'object' || Array.isArray(target)) {\n      return source;\n    }\n\n    // Both are objects, merge them\n    const result = { ...target };\n\n    for (const key in source) {\n      if (source.hasOwnProperty(key)) {\n        if (key in result) {\n          result[key] = this.deepMerge(result[key], source[key]);\n        } else {\n          result[key] = source[key];\n        }\n      }\n    }\n\n    return result;\n  }\n}","import { YamlMerger } from './YamlMergerBrowser';\n\n/**\n * Helper function for Vite environments\n * Works with import.meta.glob() to merge YAML files\n */\nexport async function stitchFromViteImports(\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const contents = await Promise.all(\n    Object.entries(imports).map(async ([path, importFn]) => ({\n      content: (await importFn()).default,\n      name: path\n    }))\n  );\n  \n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Helper function for ordered Vite imports\n * Ensures files are merged in a specific order based on the array\n */\nexport async function stitchFromOrderedViteImports(\n  orderedPaths: string[],\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const contents = await Promise.all(\n    orderedPaths.map(async (path) => {\n      const importFn = imports[path];\n      if (!importFn) {\n        throw new Error(`Import not found for path: ${path}`);\n      }\n      return {\n        content: (await importFn()).default,\n        name: path\n      };\n    })\n  );\n  \n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Helper function for glob pattern imports with sorting\n * Useful when you want alphabetical ordering of files\n */\nexport async function stitchFromSortedViteImports(\n  imports: Record<string, () => Promise<{ default: string }>>\n): Promise<any> {\n  const sortedPaths = Object.keys(imports).sort();\n  return stitchFromOrderedViteImports(sortedPaths, imports);\n}\n\n/**\n * Direct content merging for when you already have the YAML strings\n */\nexport function stitchFromContent(\n  contents: Array<{ content: string; name?: string }>\n): any {\n  const merger = new YamlMerger();\n  return merger.mergeContent(contents);\n}\n\n/**\n * Convenience function for merging raw YAML strings without names\n */\nexport function stitchFromRawContent(yamlStrings: string[]): any {\n  const contents = yamlStrings.map((content, index) => ({\n    content,\n    name: `content-${index}`\n  }));\n  \n  return stitchFromContent(contents);\n}"],"names":["YamlMerger","contents","result","item","parsedContent","yaml","error","name","target","source","key","stitchFromViteImports","imports","path","importFn","stitchFromOrderedViteImports","orderedPaths","stitchFromSortedViteImports","sortedPaths","stitchFromContent","stitchFromRawContent","yamlStrings","content","index"],"mappings":";AAEO,MAAMA,EAAW;AAAA;AAAA;AAAA;AAAA,EAItB,aAAaC,GAA0D;AACrE,QAAIC,IAAS,CAAC;AAEd,eAAWC,KAAQF,GAAU;AACvB,UAAAG;AAEA,UAAA;AACc,QAAAA,IAAAC,EAAK,KAAKF,EAAK,OAAO;AAAA,eAC/BG,GAAO;AACR,cAAAC,IAAOJ,EAAK,QAAQ;AAC1B,cAAM,IAAI,MAAM,mBAAmBI,CAAI,KAAKD,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CAAC,EAAE;AAAA,MAAA;AAGtG,MAAIF,MAAkB,QAAQ,OAAOA,KAAkB,aAC5CF,IAAA,KAAK,UAAUA,GAAQE,CAAa;AAAA,IAC/C;AAGK,WAAAF;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUT,UAAUM,GAAaC,GAAkB;AAEnC,QAAAA,KAAW;AACN,aAAAD;AAcT,QAVIA,KAAW,QAKX,OAAOC,KAAW,YAAY,MAAM,QAAQA,CAAM,KAKlD,OAAOD,KAAW,YAAY,MAAM,QAAQA,CAAM;AAC7C,aAAAC;AAIH,UAAAP,IAAS,EAAE,GAAGM,EAAO;AAE3B,eAAWE,KAAOD;AACZ,MAAAA,EAAO,eAAeC,CAAG,MACvBA,KAAOR,IACFA,EAAAQ,CAAG,IAAI,KAAK,UAAUR,EAAOQ,CAAG,GAAGD,EAAOC,CAAG,CAAC,IAE9CR,EAAAQ,CAAG,IAAID,EAAOC,CAAG;AAKvB,WAAAR;AAAA,EAAA;AAEX;AChEA,eAAsBS,EACpBC,GACc;AACR,QAAAX,IAAW,MAAM,QAAQ;AAAA,IAC7B,OAAO,QAAQW,CAAO,EAAE,IAAI,OAAO,CAACC,GAAMC,CAAQ,OAAO;AAAA,MACvD,UAAU,MAAMA,EAAA,GAAY;AAAA,MAC5B,MAAMD;AAAA,IAAA,EACN;AAAA,EACJ;AAGO,SADQ,IAAIb,EAAW,EAChB,aAAaC,CAAQ;AACrC;AAMsB,eAAAc,EACpBC,GACAJ,GACc;AACR,QAAAX,IAAW,MAAM,QAAQ;AAAA,IAC7Be,EAAa,IAAI,OAAOH,MAAS;AACzB,YAAAC,IAAWF,EAAQC,CAAI;AAC7B,UAAI,CAACC;AACH,cAAM,IAAI,MAAM,8BAA8BD,CAAI,EAAE;AAE/C,aAAA;AAAA,QACL,UAAU,MAAMC,EAAA,GAAY;AAAA,QAC5B,MAAMD;AAAA,MACR;AAAA,IACD,CAAA;AAAA,EACH;AAGO,SADQ,IAAIb,EAAW,EAChB,aAAaC,CAAQ;AACrC;AAMA,eAAsBgB,EACpBL,GACc;AACd,QAAMM,IAAc,OAAO,KAAKN,CAAO,EAAE,KAAK;AACvC,SAAAG,EAA6BG,GAAaN,CAAO;AAC1D;AAKO,SAASO,EACdlB,GACK;AAEE,SADQ,IAAID,EAAW,EAChB,aAAaC,CAAQ;AACrC;AAKO,SAASmB,EAAqBC,GAA4B;AAC/D,QAAMpB,IAAWoB,EAAY,IAAI,CAACC,GAASC,OAAW;AAAA,IACpD,SAAAD;AAAA,IACA,MAAM,WAAWC,CAAK;AAAA,EAAA,EACtB;AAEF,SAAOJ,EAAkBlB,CAAQ;AACnC;"}

package/dist/core/ConfigParser.d.ts

@@ -0,0 +1,16 @@
+import { StitchConfig } from '../types/StitchTypes';
+export declare class ConfigParser {
+    /**
+     * Parse a stitch.yaml configuration file
+     */
+    parseConfig(configPath: string): StitchConfig;
+    /**
+     * Resolve file paths and expand globs relative to the config file directory
+     */
+    resolveFilePaths(patterns: string[], baseDir: string): Promise<string[]>;
+    /**
+     * Get the directory containing the config file
+     */
+    getConfigDir(configPath: string): string;
+}
+//# sourceMappingURL=ConfigParser.d.ts.map

package/dist/core/ConfigParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigParser.d.ts","sourceRoot":"","sources":["../../src/core/ConfigParser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,qBAAa,YAAY;IACvB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAqB7C;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6B9E;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAGzC"}

package/dist/core/StitchEngine.d.ts

@@ -0,0 +1,31 @@
+import { BuildOptions, WatchOptions, StitchResult, ContentItem, InstallOptions } from '../types/StitchTypes';
+export declare class StitchEngine {
+    private configParser;
+    private yamlMerger;
+    private validator;
+    /**
+     * Build from a stitch configuration file (async)
+     */
+    build(configPath: string, options?: BuildOptions): Promise<StitchResult>;
+    /**
+     * Build from a stitch configuration file (sync)
+     */
+    buildSync(configPath: string, options?: BuildOptions): StitchResult;
+    /**
+     * Watch mode - rebuild when files change
+     */
+    watch(configPath: string, options?: WatchOptions): Promise<void>;
+    /**
+     * Build from content directly (no file system access)
+     */
+    buildFromContent(contents: ContentItem[], options?: Omit<BuildOptions, 'input'>): StitchResult;
+    /**
+     * Synchronous version of file path resolution for buildSync
+     */
+    private resolveFilePathsSync;
+    /**
+     * Install JSON schema for VSCode YAML validation
+     */
+    install(options: InstallOptions): StitchResult;
+}
+//# sourceMappingURL=StitchEngine.d.ts.map

package/dist/core/StitchEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StitchEngine.d.ts","sourceRoot":"","sources":["../../src/core/StitchEngine.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7G,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,SAAS,CAAmB;IAEpC;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA4DlF;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY;IA4DvE;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqD1E;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAM,GAAG,YAAY;IA+ClG;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY;CA0D/C"}

package/dist/core/Validator.d.ts

@@ -0,0 +1,18 @@
+import { ValidationResult } from '../types/StitchTypes';
+export declare class Validator {
+    private ajv;
+    constructor();
+    /**
+     * Validate YAML syntax
+     */
+    validateYamlSyntax(yamlString: string): ValidationResult;
+    /**
+     * Validate against OpenAPI schema
+     */
+    validateOpenAPI(yamlContent: any, schemaPath?: string): ValidationResult;
+    /**
+     * Validate against a JSON schema file
+     */
+    private validateAgainstSchema;
+}
+//# sourceMappingURL=Validator.d.ts.map

package/dist/core/Validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../src/core/Validator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAM;;IAOjB;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAYxD;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAyBxE;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAmC9B"}

package/dist/core/ViteHelper.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Helper function for Vite environments
+ * Works with import.meta.glob() to merge YAML files
+ */
+export declare function stitchFromViteImports(imports: Record<string, () => Promise<{
+    default: string;
+}>>): Promise<any>;
+/**
+ * Helper function for ordered Vite imports
+ * Ensures files are merged in a specific order based on the array
+ */
+export declare function stitchFromOrderedViteImports(orderedPaths: string[], imports: Record<string, () => Promise<{
+    default: string;
+}>>): Promise<any>;
+/**
+ * Helper function for glob pattern imports with sorting
+ * Useful when you want alphabetical ordering of files
+ */
+export declare function stitchFromSortedViteImports(imports: Record<string, () => Promise<{
+    default: string;
+}>>): Promise<any>;
+/**
+ * Direct content merging for when you already have the YAML strings
+ */
+export declare function stitchFromContent(contents: Array<{
+    content: string;
+    name?: string;
+}>): any;
+/**
+ * Convenience function for merging raw YAML strings without names
+ */
+export declare function stitchFromRawContent(yamlStrings: string[]): any;
+//# sourceMappingURL=ViteHelper.d.ts.map

package/dist/core/ViteHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViteHelper.d.ts","sourceRoot":"","sources":["../../src/core/ViteHelper.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAC1D,OAAO,CAAC,GAAG,CAAC,CAUd;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAC1D,OAAO,CAAC,GAAG,CAAC,CAgBd;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAC1D,OAAO,CAAC,GAAG,CAAC,CAGd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,GAAG,CAGL;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,CAO/D"}

package/dist/core/YamlMerger.d.ts

@@ -0,0 +1,29 @@
+export declare class YamlMerger {
+    /**
+     * Merge multiple YAML files in order
+     */
+    mergeFiles(filePaths: string[]): any;
+    /**
+     * Merge multiple YAML content strings in order
+     */
+    mergeContent(contents: Array<{
+        content: string;
+        name?: string;
+    }>): any;
+    /**
+     * Merge mixed items (files and content) in order
+     */
+    merge(items: Array<string | {
+        content: string;
+        name?: string;
+    }>): any;
+    /**
+     * Deep merge two objects
+     * Rules:
+     * - Objects: merge properties, source overrides target
+     * - Arrays: source replaces target completely
+     * - Primitives: source overrides target
+     */
+    deepMerge(target: any, source: any): any;
+}
+//# sourceMappingURL=YamlMerger.d.ts.map

package/dist/core/YamlMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YamlMerger.d.ts","sourceRoot":"","sources":["../../src/core/YamlMerger.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IACrB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG;IAyBpC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,GAAG;IAqBtE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,GAAG;IAwCrE;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG;CAoCzC"}

package/dist/core/YamlMergerBrowser.d.ts

@@ -0,0 +1,18 @@
+export declare class YamlMerger {
+    /**
+     * Merge multiple YAML content strings in order
+     */
+    mergeContent(contents: Array<{
+        content: string;
+        name?: string;
+    }>): any;
+    /**
+     * Deep merge two objects
+     * Rules:
+     * - Objects: merge properties, source overrides target
+     * - Arrays: source replaces target completely
+     * - Primitives: source overrides target
+     */
+    deepMerge(target: any, source: any): any;
+}
+//# sourceMappingURL=YamlMergerBrowser.d.ts.map

package/dist/core/YamlMergerBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YamlMergerBrowser.d.ts","sourceRoot":"","sources":["../../src/core/YamlMergerBrowser.ts"],"names":[],"mappings":"AAEA,qBAAa,UAAU;IACrB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,GAAG;IAqBtE;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG;CAoCzC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { BuildOptions, WatchOptions, ContentItem, InstallOptions } from './types/StitchTypes';
+export { StitchEngine } from './core/StitchEngine';
+export { ConfigParser } from './core/ConfigParser';
+export { YamlMerger } from './core/YamlMerger';
+export { Validator } from './core/Validator';
+export { StitchCLIFactory } from './cli/StitchCLI';
+export * from './types/StitchTypes';
+export declare const stitch: {
+    build: (options: BuildOptions) => Promise<import('./browser').StitchResult>;
+    buildSync: (options: BuildOptions) => import('./browser').StitchResult;
+    buildFromContent: (contents: ContentItem[], options?: Omit<BuildOptions, "input">) => import('./browser').StitchResult;
+    watch: (options: WatchOptions) => Promise<void>;
+    install: (options: InstallOptions) => import('./browser').StitchResult;
+};
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,qBAAqB,CAAC;AAIpC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE9F,eAAO,MAAM,MAAM;qBACM,YAAY;yBAKd,YAAY;iCAKJ,WAAW,EAAE,YAAW,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;qBAKzD,YAAY;uBAKhB,cAAc;CAIlC,CAAC"}