@dsillman2000/yaml-reference-ts 0.0.0

package/README.md

@@ -0,0 +1,225 @@
+# YAML Reference Resolver (TypeScript)
+
+A Node.js TypeScript library for resolving YAML documents containing `!reference` and `!reference-all` tags. The library uses the `eemeli/yaml` package to parse YAML with custom tags and resolve references to external YAML files.
+
+## Features
+
+- **Custom YAML Tags**: Support for `!reference` and `!reference-all` tags
+- **Recursive Resolution**: Automatically resolves nested references
+- **Circular Reference Detection**: Prevents infinite loops with proper error messages
+- **Glob Pattern Support**: `!reference-all` supports glob patterns for multiple files
+- **CLI Interface**: Command-line tool for resolving YAML files
+- **TypeScript Support**: Full type definitions included
+
+## Installation
+
+```bash
+npm install yaml-reference-ts
+```
+
+Or for global CLI usage:
+
+```bash
+npm install -g yaml-reference-ts
+```
+
+## YAML Syntax Examples
+
+### Single File Reference
+
+```yaml
+# Block mapping syntax
+database: !reference
+  path: ./config/database.yaml
+
+# Inline mapping syntax  
+settings: !reference {path: ./settings/production.yaml}
+```
+
+### Multiple File Reference
+
+```yaml
+# Block mapping syntax
+configs: !reference-all
+  glob: ./configs/*.yaml
+
+# Inline mapping syntax
+files: !reference-all {glob: ./data/*.yaml}
+```
+
+**Note**: Only mapping syntax is supported. Be sure to conform to the API (`!reference {path: <path>}` or `!reference-all {glob: <glob>}`).
+
+**Deterministic Ordering**: The `!reference-all` tag resolves files in alphabetical order to ensure consistent, predictable results across different systems and runs.
+
+## Library Usage
+
+### Basic Usage
+
+```typescript
+import { loadAndResolve } from 'yaml-reference-ts';
+
+async function loadConfig() {
+  try {
+    const resolved = await loadAndResolve('./config/main.yaml');
+    console.log(resolved);
+  } catch (error) {
+    console.error('Failed to resolve references:', error);
+  }
+}
+```
+
+### API Reference
+
+#### `loadYamlWithReferences(filePath: string): Promise<any>`
+Loads a YAML file and resolves all `!reference` and `!reference-all` tags, returning the fully resolved object.
+
+#### `parseYamlWithReferences(content: string, filePath: string): any`
+Parses YAML content with custom tags, setting `_location` on Reference objects.
+
+#### `loadYamlWithReferencesSync(filePath: string): any`
+Loads a YAML file and resolves all `!reference` and `!reference-all` tags, returning the fully resolved object synchronously.
+
+#### `parseYamlWithReferencesSync(content: string, filePath: string): any`
+Parses YAML content with custom tags, setting `_location` on Reference objects synchronously.
+
+#### `Reference` Class
+Represents a `!reference` tag with properties:
+- `_location`: Absolute path to the file containing the reference
+- `path`: Relative path to the referenced YAML file
+
+#### `ReferenceAll` Class
+Represents a `!reference-all` tag with properties:
+- `_location`: Absolute path to the file containing the reference
+- `glob`: Glob pattern to match YAML files
+
+## CLI Usage
+
+The package includes a CLI tool called `yaml-reference-cli`:
+
+```bash
+# Basic usage
+yaml-reference-cli config.yaml
+
+# With conversion back to YAML (requires yq)
+yaml-reference-cli config.yaml | yq -P
+
+# Save output to file
+yaml-reference-cli config.yaml | yq -P > .compiled/config.yaml
+
+# Show help
+yaml-reference-cli --help
+```
+
+### CLI Output
+The CLI outputs JSON with:
+- Keys sorted alphabetically
+- 2-space indentation
+- Exit code 0 for success, 1 for errors
+
+## Resolution Rules
+
+### For `!reference` tags:
+1. The `path` property is parsed from the YAML mapping
+2. `_location` is automatically set to the absolute path of the containing file
+3. The referenced YAML file is read and parsed relative to `_location`
+4. Any references within the referenced file are recursively resolved
+5. The `Reference` object is replaced with the resolved content
+
+### For `!reference-all` tags:
+1. The `glob` property is parsed from the YAML mapping
+2. `_location` is automatically set to the absolute path of the containing file
+3. The glob pattern is evaluated relative to `_location`
+4. For each matching YAML file:
+   - The file is read and parsed
+   - Any references are recursively resolved
+5. The `ReferenceAll` object is replaced with an array of resolved contents
+6. Files are sorted and resolved in deterministic alphabetical order for consistent results across systems
+7. If no files match, an error is thrown
+
+**Deterministic Behavior**: The library ensures predictable output by:
+- Sorting `!reference-all` file matches alphabetically before resolution
+- Rejecting scalar syntax (only mapping syntax is allowed)
+- Using consistent error messages for validation failures
+
+## Error Handling
+
+The library throws descriptive errors for:
+- Missing referenced files
+- Invalid YAML syntax
+- Circular references (detected via visited file path tracking)
+- Invalid glob patterns
+- Missing required properties (`path` for `!reference`, `glob` for `!reference-all`)
+
+## Development
+
+### Project Structure
+
+```
+yaml-reference-ts/
+├── src/
+│   ├── index.ts              # Main exports
+│   ├── Reference.ts          # Reference class
+│   ├── ReferenceAll.ts       # ReferenceAll class
+│   ├── resolver.ts           # loadAndResolve implementation
+│   ├── parser.ts             # YAML parser with custom tags
+│   └── cli/
+│       └── index.ts          # CLI implementation
+├── __tests__/               # Test files
+├── doc/
+│   └── Design.md           # Design specification
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Building
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Watch mode for development
+npm run dev
+```
+
+### Testing
+
+```bash
+# Run tests
+npm test
+
+# Watch mode
+npm run test:watch
+
+# Coverage report
+npm run test:coverage
+
+# Run specific test file
+npm test -- __tests__/parser.test.ts
+```
+
+### Linting
+
+```bash
+npm run lint
+```
+
+## Dependencies
+
+### Production
+- `yaml` (eemeli/yaml): YAML parsing with custom tag support
+- `glob`: Pattern matching for `!reference-all` tags
+
+### Development
+- TypeScript
+- Jest for testing
+- ESLint for code quality
+
+## Acknowledgments
+
+Author(s):
+
+- David Sillman <dsillman2000@gmail.com>

package/dist/Reference.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Reference class representing a !reference tag in YAML
+ * This class is instantiated when the YAML parser encounters a !reference tag
+ */
+export declare class Reference {
+    /**
+     * Absolute path to the YAML file where this !reference tag was found
+     * This is automatically set by the library during parsing
+     */
+    _location: string;
+    /**
+     * Relative path to another YAML file
+     * Required, explicitly provided by the user in the YAML document
+     */
+    path: string;
+    /**
+     * Creates a new Reference instance
+     * @param path - Relative path to another YAML file
+     * @param location - Absolute path to the file containing this reference (optional, will be set later)
+     */
+    constructor(path: string, location?: string);
+    /**
+     * Returns a string representation of the Reference
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Reference.d.ts.map

package/dist/Reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reference.d.ts","sourceRoot":"","sources":["../src/Reference.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK3C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUrB"}

package/dist/Reference.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reference = void 0;
+/**
+ * Reference class representing a !reference tag in YAML
+ * This class is instantiated when the YAML parser encounters a !reference tag
+ */
+class Reference {
+    /**
+     * Creates a new Reference instance
+     * @param path - Relative path to another YAML file
+     * @param location - Absolute path to the file containing this reference (optional, will be set later)
+     */
+    constructor(path, location) {
+        this.path = path;
+        this._location = location || "";
+    }
+    /**
+     * Returns a string representation of the Reference
+     */
+    toString() {
+        return `Reference { path: "${this.path}", _location: "${this._location}" }`;
+    }
+    /**
+     * Custom inspection method for Node.js console
+     */
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return this.toString();
+    }
+}
+exports.Reference = Reference;
+//# sourceMappingURL=Reference.js.map

package/dist/Reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reference.js","sourceRoot":"","sources":["../src/Reference.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,SAAS;IAalB;;;;OAIG;IACH,YAAY,IAAY,EAAE,QAAiB;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,sBAAsB,IAAI,CAAC,IAAI,kBAAkB,IAAI,CAAC,SAAS,KAAK,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;CACJ;AApCD,8BAoCC"}

package/dist/ReferenceAll.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ReferenceAll class representing a !reference-all tag in YAML
+ * This class is instantiated when the YAML parser encounters a !reference-all tag
+ */
+export declare class ReferenceAll {
+    /**
+     * Absolute path to the YAML file where this !reference-all tag was found
+     * This is automatically set by the library during parsing
+     */
+    _location: string;
+    /**
+     * Glob pattern to match YAML files
+     * Required, explicitly provided by the user in the YAML document
+     */
+    glob: string;
+    /**
+     * Creates a new ReferenceAll instance
+     * @param glob - Glob pattern to match YAML files
+     * @param location - Absolute path to the file containing this reference (optional, will be set later)
+     */
+    constructor(glob: string, location?: string);
+    /**
+     * Returns a string representation of the ReferenceAll
+     */
+    toString(): string;
+}
+//# sourceMappingURL=ReferenceAll.d.ts.map

package/dist/ReferenceAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceAll.d.ts","sourceRoot":"","sources":["../src/ReferenceAll.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACrB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK3C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUrB"}

package/dist/ReferenceAll.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferenceAll = void 0;
+/**
+ * ReferenceAll class representing a !reference-all tag in YAML
+ * This class is instantiated when the YAML parser encounters a !reference-all tag
+ */
+class ReferenceAll {
+    /**
+     * Creates a new ReferenceAll instance
+     * @param glob - Glob pattern to match YAML files
+     * @param location - Absolute path to the file containing this reference (optional, will be set later)
+     */
+    constructor(glob, location) {
+        this.glob = glob;
+        this._location = location || "";
+    }
+    /**
+     * Returns a string representation of the ReferenceAll
+     */
+    toString() {
+        return `ReferenceAll { glob: "${this.glob}", _location: "${this._location}" }`;
+    }
+    /**
+     * Custom inspection method for Node.js console
+     */
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return this.toString();
+    }
+}
+exports.ReferenceAll = ReferenceAll;
+//# sourceMappingURL=ReferenceAll.js.map

package/dist/ReferenceAll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceAll.js","sourceRoot":"","sources":["../src/ReferenceAll.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,YAAY;IAarB;;;;OAIG;IACH,YAAY,IAAY,EAAE,QAAiB;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,yBAAyB,IAAI,CAAC,IAAI,kBAAkB,IAAI,CAAC,SAAS,KAAK,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;CACJ;AApCD,oCAoCC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CLI implementation for yaml-reference-ts
+ * Reads YAML file with !reference and !reference-all tags, resolves references,
+ * and outputs JSON to stdout with sorted keys and 2-space indentation
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/cli/index.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI implementation for yaml-reference-ts
+ * Reads YAML file with !reference and !reference-all tags, resolves references,
+ * and outputs JSON to stdout with sorted keys and 2-space indentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const resolver_1 = require("../resolver");
+const fs = __importStar(require("fs/promises"));
+/**
+ * Display help message
+ */
+function showHelp() {
+    console.log(`
+YAML Reference Resolver CLI
+
+Usage: yaml-reference-cli <file_path>
+
+Resolves !reference and !reference-all tags in YAML files and outputs
+the resolved JSON to stdout.
+
+Arguments:
+  file_path    Path to YAML file containing references (required)
+
+Options:
+  -h, --help   Show this help message
+
+Output:
+  JSON with keys sorted alphabetically and 2-space indentation
+
+Examples:
+  yaml-reference-cli config.yaml
+  yaml-reference-cli config.yaml | yq -P
+  yaml-reference-cli config.yaml | yq -P > .compiled/config.yaml
+
+Exit Codes:
+  0 - Success
+  1 - General error (file not found, invalid YAML, circular reference, etc.)
+`);
+}
+/**
+ * Sort object keys alphabetically (recursively)
+ */
+function sortObjectKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map((item) => sortObjectKeys(item));
+    }
+    if (obj && typeof obj === "object" && !(obj instanceof Date)) {
+        const sortedObj = {};
+        // Get keys, sort them alphabetically
+        const keys = Object.keys(obj).sort();
+        for (const key of keys) {
+            sortedObj[key] = sortObjectKeys(obj[key]);
+        }
+        return sortedObj;
+    }
+    return obj;
+}
+/**
+ * Main CLI function
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    // Check for help flag
+    if (args.includes("-h") || args.includes("--help")) {
+        showHelp();
+        process.exit(0);
+    }
+    // Check for file path argument
+    if (args.length === 0) {
+        console.error("Error: No file path provided");
+        console.error("Usage: yaml-reference-cli <file_path>");
+        console.error("Use -h or --help for more information");
+        process.exit(1);
+    }
+    if (args.length > 1) {
+        console.error("Error: Too many arguments");
+        console.error("Usage: yaml-reference-cli <file_path>");
+        console.error("Use -h or --help for more information");
+        process.exit(1);
+    }
+    const filePath = args[0];
+    try {
+        // Check if file exists
+        await fs.access(filePath);
+    }
+    catch (error) {
+        console.error(`Error: File not found: ${filePath}`);
+        process.exit(1);
+    }
+    try {
+        // Resolve references
+        const resolved = await (0, resolver_1.loadAndResolve)(filePath);
+        // Sort keys alphabetically
+        const sorted = sortObjectKeys(resolved);
+        // Output JSON with 2-space indentation
+        console.log(JSON.stringify(sorted, null, 2));
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+// Run the CLI
+if (require.main === module) {
+    main().catch((error) => {
+        console.error(`Fatal error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/example/additional/extra.yaml

@@ -0,0 +1,15 @@
+# Additional configuration file
+extra_config:
+  enabled: true
+  options:
+    - option1
+    - option2
+    - option3
+  settings:
+    timeout: 5000
+    retry_count: 5
+    fallback: true
+  metadata:
+    created: 2024-01-15
+    updated: 2024-01-20
+    version: 2.1.0

package/dist/example/config/database.yaml

@@ -0,0 +1,11 @@
+# Database configuration
+host: localhost
+port: 5432
+database: myapp_production
+username: admin
+password: secret123
+pool:
+  max: 20
+  min: 5
+  idle: 10000
+ssl: true

package/dist/example/config/settings.yaml

@@ -0,0 +1,15 @@
+# Application settings
+debug: false
+log_level: info
+cache:
+  enabled: true
+  ttl: 3600
+  max_size: 1000
+api:
+  timeout: 30000
+  retries: 3
+  base_url: https://api.example.com
+features:
+  analytics: true
+  notifications: false
+  dark_mode: true

package/dist/example/data/products.yaml

@@ -0,0 +1,30 @@
+# Products data file
+products:
+  - id: 101
+    name: Laptop Pro
+    category: electronics
+    price: 1299.99
+    in_stock: true
+    features:
+      - 16GB RAM
+      - 512GB SSD
+      - Intel i7
+      - 15.6" Display
+  - id: 102
+    name: Wireless Mouse
+    category: accessories
+    price: 49.99
+    in_stock: true
+    features:
+      - Bluetooth 5.0
+      - Rechargeable
+      - Ergonomic design
+  - id: 103
+    name: USB-C Cable
+    category: accessories
+    price: 19.99
+    in_stock: false
+    features:
+      - 3m length
+      - Fast charging
+      - Data transfer

package/dist/example/data/users.yaml

@@ -0,0 +1,17 @@
+# Users data file
+users:
+  - id: 1
+    name: Alice Smith
+    email: alice@example.com
+    role: admin
+    active: true
+  - id: 2
+    name: Bob Johnson
+    email: bob@example.com
+    role: user
+    active: true
+  - id: 3
+    name: Charlie Brown
+    email: charlie@example.com
+    role: user
+    active: false

package/dist/example/main.yaml

@@ -0,0 +1,19 @@
+# Example main.yaml file with !reference and !reference-all tags
+# This demonstrates the usage of the yaml-reference-ts library
+
+app:
+  name: My Application
+  version: 1.0.0
+  config: !reference
+    path: ./config/database.yaml
+  settings: !reference { path: ./config/settings.yaml }
+
+data:
+  files: !reference-all
+    glob: ./data/*.yaml
+  additional: !reference-all { glob: ./additional/*.yaml }
+
+metadata:
+  author: John Doe
+  created: 2024-01-01
+  description: Example configuration with references

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Main exports for yaml-reference-ts library
+ */
+export { Reference } from "./Reference";
+export { ReferenceAll } from "./ReferenceAll";
+export { parseYamlWithReferencesSync, parseYamlWithReferences } from "./parser";
+/**
+ * Convenience alias for loadAndResolve
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+export declare function loadYamlWithReferences(filePath: string): Promise<any>;
+/**
+ * Convenience alias for loadAndResolveSync
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+export declare function loadYamlWithReferencesSync(filePath: string): any;
+//# 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;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEhF;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAEhE"}

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Main exports for yaml-reference-ts library
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseYamlWithReferences = exports.parseYamlWithReferencesSync = exports.ReferenceAll = exports.Reference = void 0;
+exports.loadYamlWithReferences = loadYamlWithReferences;
+exports.loadYamlWithReferencesSync = loadYamlWithReferencesSync;
+var Reference_1 = require("./Reference");
+Object.defineProperty(exports, "Reference", { enumerable: true, get: function () { return Reference_1.Reference; } });
+var ReferenceAll_1 = require("./ReferenceAll");
+Object.defineProperty(exports, "ReferenceAll", { enumerable: true, get: function () { return ReferenceAll_1.ReferenceAll; } });
+const resolver_1 = require("./resolver");
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseYamlWithReferencesSync", { enumerable: true, get: function () { return parser_1.parseYamlWithReferencesSync; } });
+Object.defineProperty(exports, "parseYamlWithReferences", { enumerable: true, get: function () { return parser_1.parseYamlWithReferences; } });
+/**
+ * Convenience alias for loadAndResolve
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+async function loadYamlWithReferences(filePath) {
+    return await (0, resolver_1.loadAndResolve)(filePath);
+}
+/**
+ * Convenience alias for loadAndResolveSync
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+function loadYamlWithReferencesSync(filePath) {
+    return (0, resolver_1.loadAndResolveSync)(filePath);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAYH,wDAEC;AAOD,gEAEC;AArBD,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,yCAAgE;AAChE,mCAAgF;AAAvE,qHAAA,2BAA2B,OAAA;AAAE,iHAAA,uBAAuB,OAAA;AAE7D;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IACzD,OAAO,MAAM,IAAA,yBAAc,EAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAgB,0BAA0B,CAAC,QAAgB;IACvD,OAAO,IAAA,6BAAkB,EAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parser module for handling YAML with custom !reference and !reference-all tags
+ * Uses the eemeli/yaml package to parse YAML with custom tags
+ */
+/**
+ * Parse YAML content with custom !reference and !reference-all tags
+ * @param filePath - Path to the YAML file to be parsed (used for setting _location)
+ * @returns Parsed object with Reference and ReferenceAll instances
+ */
+export declare function parseYamlWithReferencesSync(filePath: string): any;
+/**
+ * Parse YAML content with custom !reference and !reference-all tags (async).
+ * @param filePath - Path to the YAML file to be parsed (used for setting _location)
+ * @returns Parsed object with Reference and ReferenceAll instances
+ */
+export declare function parseYamlWithReferences(filePath: string): Promise<any>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsEH;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAgBjE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAgB5E"}

package/dist/parser.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Parser module for handling YAML with custom !reference and !reference-all tags
+ * Uses the eemeli/yaml package to parse YAML with custom tags
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseYamlWithReferencesSync = parseYamlWithReferencesSync;
+exports.parseYamlWithReferences = parseYamlWithReferences;
+const yaml_1 = require("yaml");
+const Reference_1 = require("./Reference");
+const ReferenceAll_1 = require("./ReferenceAll");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const fsSync = __importStar(require("fs"));
+/**
+ * Custom tag for !reference
+ */
+const referenceTag = {
+    identify: (value) => value instanceof Reference_1.Reference,
+    tag: "!reference",
+    collection: "map",
+    resolve: (value, _) => {
+        // value should be a YAMLMap for mapping syntax
+        if (!(value instanceof yaml_1.YAMLMap)) {
+            throw new Error('!reference tag must be followed by a mapping with a "path" property');
+        }
+        // Get the path property from the map
+        const pathValue = value.get("path");
+        if (!pathValue) {
+            throw new Error('!reference tag requires a "path" property');
+        }
+        if (typeof pathValue !== "string") {
+            throw new Error('!reference "path" property must be a string');
+        }
+        return new Reference_1.Reference(pathValue);
+    },
+};
+/**
+ * Custom tag for !reference-all
+ */
+const referenceAllTag = {
+    identify: (value) => value instanceof ReferenceAll_1.ReferenceAll,
+    tag: "!reference-all",
+    collection: "map",
+    resolve: (value, _) => {
+        // value should be a YAMLMap for mapping syntax
+        if (!(value instanceof yaml_1.YAMLMap)) {
+            throw new Error('!reference-all tag must be followed by a mapping with a "glob" property');
+        }
+        // Get the glob property from the map
+        const globValue = value.get("glob");
+        if (!globValue) {
+            throw new Error('!reference-all tag requires a "glob" property');
+        }
+        if (typeof globValue !== "string") {
+            throw new Error('!reference-all "glob" property must be a string');
+        }
+        return new ReferenceAll_1.ReferenceAll(globValue);
+    },
+};
+// Custom tags array for parsing
+const customTags = [referenceTag, referenceAllTag];
+/**
+ * Parse YAML content with custom !reference and !reference-all tags
+ * @param filePath - Path to the YAML file to be parsed (used for setting _location)
+ * @returns Parsed object with Reference and ReferenceAll instances
+ */
+function parseYamlWithReferencesSync(filePath) {
+    try {
+        const absolutePath = path.resolve(filePath);
+        const content = fsSync.readFileSync(absolutePath, "utf8");
+        const parsed = (0, yaml_1.parse)(content, { customTags });
+        // Process the parsed document to set _location on Reference and ReferenceAll objects
+        return processParsedDocument(parsed, filePath);
+    }
+    catch (error) {
+        // Re-throw the error with context about which file failed to parse
+        throw new Error(`Failed to parse YAML file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Parse YAML content with custom !reference and !reference-all tags (async).
+ * @param filePath - Path to the YAML file to be parsed (used for setting _location)
+ * @returns Parsed object with Reference and ReferenceAll instances
+ */
+async function parseYamlWithReferences(filePath) {
+    try {
+        const absolutePath = path.resolve(filePath);
+        const content = await fs.readFile(absolutePath, "utf8");
+        const parsed = (0, yaml_1.parse)(content, { customTags });
+        // Process the parsed document to set _location on Reference and ReferenceAll objects
+        return processParsedDocument(parsed, filePath);
+    }
+    catch (error) {
+        // Re-throw the error with context about which file failed to parse
+        throw new Error(`Failed to parse YAML file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Recursively process parsed document to set _location on Reference and ReferenceAll objects
+ */
+function processParsedDocument(obj, filePath) {
+    if (obj instanceof Reference_1.Reference) {
+        obj._location = filePath;
+        return obj;
+    }
+    if (obj instanceof ReferenceAll_1.ReferenceAll) {
+        obj._location = filePath;
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => processParsedDocument(item, filePath));
+    }
+    if (obj && typeof obj === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = processParsedDocument(value, filePath);
+        }
+        return result;
+    }
+    return obj;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/resolver.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Resolver module for resolving !reference and !reference-all tags
+ * Handles recursive resolution of references with proper path tracking
+ */
+/**
+ * Load a YAML file containing references and resolve all references. (async)
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+export declare function loadAndResolve(filePath: string): Promise<any>;
+/**
+ * Load a YAML file containing references and resolve all references.
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+export declare function loadAndResolveSync(filePath: string): any;
+/**
+ * Recursively resolve all references in an object (async)
+ * @param obj - Object that may contain Reference or ReferenceAll instances
+ * @param visitedPaths - Set of visited file paths to detect circular references
+ * @returns Object with all references resolved
+ */
+export declare function _recursivelyResolveReferences(obj: any, visitedPaths?: Set<string>): Promise<any>;
+/**
+ * Recursively resolve all references in an object
+ * @param obj - Object that may contain Reference or ReferenceAll instances
+ * @param visitedPaths - Set of visited file paths to detect circular references
+ * @returns Object with all references resolved
+ */
+export declare function _recursivelyResolveReferencesSync(obj: any, visitedPaths?: Set<string>): any;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAGxD;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAC/C,GAAG,EAAE,GAAG,EACR,YAAY,GAAE,GAAG,CAAC,MAAM,CAAa,GACtC,OAAO,CAAC,GAAG,CAAC,CA+Bd;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC7C,GAAG,EAAE,GAAG,EACR,YAAY,GAAE,GAAG,CAAC,MAAM,CAAa,GACtC,GAAG,CA+BL"}

package/dist/resolver.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Resolver module for resolving !reference and !reference-all tags
+ * Handles recursive resolution of references with proper path tracking
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAndResolve = loadAndResolve;
+exports.loadAndResolveSync = loadAndResolveSync;
+exports._recursivelyResolveReferences = _recursivelyResolveReferences;
+exports._recursivelyResolveReferencesSync = _recursivelyResolveReferencesSync;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const fsSync = __importStar(require("fs"));
+const glob_1 = require("glob");
+const Reference_1 = require("./Reference");
+const ReferenceAll_1 = require("./ReferenceAll");
+const parser_1 = require("./parser");
+/**
+ * Load a YAML file containing references and resolve all references. (async)
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+async function loadAndResolve(filePath) {
+    const parsed = await (0, parser_1.parseYamlWithReferences)(filePath);
+    return await _recursivelyResolveReferences(parsed, new Set());
+}
+/**
+ * Load a YAML file containing references and resolve all references.
+ * @param filePath - Path to YAML file containing references
+ * @returns Resolved object with all references resolved
+ */
+function loadAndResolveSync(filePath) {
+    const parsed = (0, parser_1.parseYamlWithReferencesSync)(filePath);
+    return _recursivelyResolveReferencesSync(parsed, new Set());
+}
+/**
+ * Recursively resolve all references in an object (async)
+ * @param obj - Object that may contain Reference or ReferenceAll instances
+ * @param visitedPaths - Set of visited file paths to detect circular references
+ * @returns Object with all references resolved
+ */
+async function _recursivelyResolveReferences(obj, visitedPaths = new Set()) {
+    if (obj instanceof Reference_1.Reference) {
+        return await resolveReference(obj, visitedPaths);
+    }
+    if (obj instanceof ReferenceAll_1.ReferenceAll) {
+        return await resolveReferenceAll(obj, visitedPaths);
+    }
+    if (Array.isArray(obj)) {
+        const resolvedArray = [];
+        for (const item of obj) {
+            resolvedArray.push(await _recursivelyResolveReferences(item, visitedPaths));
+        }
+        return resolvedArray;
+    }
+    if (obj && typeof obj === "object") {
+        const resolvedObj = {};
+        for (const [key, value] of Object.entries(obj)) {
+            resolvedObj[key] = await _recursivelyResolveReferences(value, visitedPaths);
+        }
+        return resolvedObj;
+    }
+    return obj;
+}
+/**
+ * Recursively resolve all references in an object
+ * @param obj - Object that may contain Reference or ReferenceAll instances
+ * @param visitedPaths - Set of visited file paths to detect circular references
+ * @returns Object with all references resolved
+ */
+function _recursivelyResolveReferencesSync(obj, visitedPaths = new Set()) {
+    if (obj instanceof Reference_1.Reference) {
+        return resolveReferenceSync(obj, visitedPaths);
+    }
+    if (obj instanceof ReferenceAll_1.ReferenceAll) {
+        return resolveReferenceAllSync(obj, visitedPaths);
+    }
+    if (Array.isArray(obj)) {
+        const resolvedArray = [];
+        for (const item of obj) {
+            resolvedArray.push(_recursivelyResolveReferencesSync(item, visitedPaths));
+        }
+        return resolvedArray;
+    }
+    if (obj && typeof obj === "object") {
+        const resolvedObj = {};
+        for (const [key, value] of Object.entries(obj)) {
+            resolvedObj[key] = _recursivelyResolveReferencesSync(value, visitedPaths);
+        }
+        return resolvedObj;
+    }
+    return obj;
+}
+/**
+ * Resolve a single Reference object (async)
+ * @param ref Reference object to resolve
+ * @param visitedPaths Set of visited paths to detect circular references
+ * @returns Resolved object. Will not contain any references.
+ * @throws Error if circular reference is detected, or if a reference cannot be resolved
+ */
+async function resolveReference(ref, visitedPaths) {
+    if (!ref._location) {
+        throw new Error(`Reference missing _location: ${ref.toString()}`);
+    }
+    const refDir = path.dirname(ref._location);
+    const targetPath = path.resolve(refDir, ref.path);
+    // Check for circular references
+    if (visitedPaths.has(targetPath)) {
+        throw new Error(`Circular reference detected: ${targetPath} (visited: ${Array.from(visitedPaths).join(" -> ")})`);
+    }
+    // Add to visited paths
+    visitedPaths.add(targetPath);
+    try {
+        // Check if file exists
+        await fs.access(targetPath);
+    }
+    catch (error) {
+        throw new Error(`Referenced file not found: ${targetPath} (from ${ref._location})`);
+    }
+    // Load and parse the referenced file
+    const parsed = await (0, parser_1.parseYamlWithReferences)(targetPath);
+    // Recursively resolve references in the parsed content
+    const resolved = await _recursivelyResolveReferences(parsed, visitedPaths);
+    // Remove from visited paths after resolution
+    visitedPaths.delete(targetPath);
+    return resolved;
+}
+/**
+ * Resolve a single Reference object
+ * @param ref Reference object to resolve
+ * @param visitedPaths Set of visited paths to detect circular references
+ * @returns Resolved object. Will not contain any references.
+ * @throws Error if circular reference is detected, or if a reference cannot be resolved
+ */
+function resolveReferenceSync(ref, visitedPaths) {
+    if (!ref._location) {
+        throw new Error(`Reference missing _location: ${ref.toString()}`);
+    }
+    const refDir = path.dirname(ref._location);
+    const targetPath = path.resolve(refDir, ref.path);
+    // Check for circular references
+    if (visitedPaths.has(targetPath)) {
+        throw new Error(`Circular reference detected: ${targetPath} (visited: ${Array.from(visitedPaths).join(" -> ")})`);
+    }
+    // Add to visited paths
+    visitedPaths.add(targetPath);
+    try {
+        // Check if file exists
+        fsSync.accessSync(targetPath);
+    }
+    catch (error) {
+        throw new Error(`Referenced file not found: ${targetPath} (from ${ref._location})`);
+    }
+    // Load and parse the referenced file
+    const parsed = (0, parser_1.parseYamlWithReferencesSync)(targetPath);
+    // Recursively resolve references in the parsed content
+    const resolved = _recursivelyResolveReferencesSync(parsed, visitedPaths);
+    // Remove from visited paths after resolution
+    visitedPaths.delete(targetPath);
+    return resolved;
+}
+/**
+ * Resolve a ReferenceAll object (async)
+ * @param refAll ReferenceAll object to resolve
+ * @param visitedPaths Set of visited paths to detect circular references
+ * @returns Resolved array of objects. Will not contain any references.
+ * @throws Error if the ReferenceAll object is missing _location or if the glob pattern is invalid.
+ */
+async function resolveReferenceAll(refAll, visitedPaths) {
+    if (!refAll._location) {
+        throw new Error(`ReferenceAll missing _location: ${refAll.toString()}`);
+    }
+    const refDir = path.dirname(refAll._location);
+    const globPattern = path.resolve(refDir, refAll.glob);
+    // Find files matching the glob pattern
+    let matchingFiles;
+    try {
+        matchingFiles = await (0, glob_1.glob)(globPattern, { absolute: true });
+    }
+    catch (error) {
+        throw new Error(`Invalid glob pattern: ${globPattern} (from ${refAll._location})`);
+    }
+    // Filter to only include YAML files
+    matchingFiles = matchingFiles.filter((file) => file.endsWith(".yaml") || file.endsWith(".yml"));
+    if (matchingFiles.length === 0) {
+        throw new Error(`No YAML files found matching glob pattern: ${globPattern} (from ${refAll._location})`);
+    }
+    // Sort files alphabetically for consistent ordering
+    matchingFiles.sort();
+    // Resolve each matching file
+    const resolvedContents = [];
+    for (const filePath of matchingFiles) {
+        // Check for circular references
+        if (visitedPaths.has(filePath)) {
+            throw new Error(`Circular reference detected: ${filePath} (visited: ${Array.from(visitedPaths).join(" -> ")})`);
+        }
+        visitedPaths.add(filePath);
+        try {
+            // Load and parse the file
+            const parsed = await (0, parser_1.parseYamlWithReferences)(filePath);
+            // Recursively resolve references
+            const resolved = await _recursivelyResolveReferences(parsed, visitedPaths);
+            resolvedContents.push(resolved);
+        }
+        catch (error) {
+            // Remove from visited paths on error
+            visitedPaths.delete(filePath);
+            throw error;
+        }
+        visitedPaths.delete(filePath);
+    }
+    return resolvedContents;
+}
+/**
+ * Resolve a ReferenceAll object
+ * @param refAll ReferenceAll object to resolve
+ * @param visitedPaths Set of visited paths to detect circular references
+ * @returns Resolved array of objects. Will not contain any references.
+ * @throws Error if the ReferenceAll object is missing _location or if the glob pattern is invalid.
+ */
+function resolveReferenceAllSync(refAll, visitedPaths) {
+    if (!refAll._location) {
+        throw new Error(`ReferenceAll missing _location: ${refAll.toString()}`);
+    }
+    const refDir = path.dirname(refAll._location);
+    const globPattern = path.resolve(refDir, refAll.glob);
+    // Find files matching the glob pattern
+    let matchingFiles;
+    try {
+        matchingFiles = (0, glob_1.globSync)(globPattern, { absolute: true });
+    }
+    catch (error) {
+        throw new Error(`Invalid glob pattern: ${globPattern} (from ${refAll._location})`);
+    }
+    // Filter to only include YAML files
+    matchingFiles = matchingFiles.filter((file) => file.endsWith(".yaml") || file.endsWith(".yml"));
+    if (matchingFiles.length === 0) {
+        throw new Error(`No YAML files found matching glob pattern: ${globPattern} (from ${refAll._location})`);
+    }
+    // Sort files alphabetically for consistent ordering
+    matchingFiles.sort();
+    // Resolve each matching file
+    const resolvedContents = [];
+    for (const filePath of matchingFiles) {
+        // Check for circular references
+        if (visitedPaths.has(filePath)) {
+            throw new Error(`Circular reference detected: ${filePath} (visited: ${Array.from(visitedPaths).join(" -> ")})`);
+        }
+        visitedPaths.add(filePath);
+        try {
+            // Load and parse the file
+            const parsed = (0, parser_1.parseYamlWithReferencesSync)(filePath);
+            // Recursively resolve references
+            const resolved = _recursivelyResolveReferencesSync(parsed, visitedPaths);
+            resolvedContents.push(resolved);
+        }
+        catch (error) {
+            // Remove from visited paths on error
+            visitedPaths.delete(filePath);
+            throw error;
+        }
+        visitedPaths.delete(filePath);
+    }
+    return resolvedContents;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,wCAGC;AAOD,gDAGC;AAQD,sEAkCC;AAQD,8EAkCC;AA9GD,2CAA6B;AAC7B,gDAAkC;AAClC,2CAA6B;AAC7B,+BAAsC;AACtC,2CAAwC;AACxC,iDAA8C;AAC9C,qCAAgF;AAEhF;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,QAAgB;IACjD,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAuB,EAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,MAAM,6BAA6B,CAAC,MAAM,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IAC/C,MAAM,MAAM,GAAG,IAAA,oCAA2B,EAAC,QAAQ,CAAC,CAAC;IACrD,OAAO,iCAAiC,CAAC,MAAM,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,6BAA6B,CAC/C,GAAQ,EACR,eAA4B,IAAI,GAAG,EAAE;IAErC,IAAI,GAAG,YAAY,qBAAS,EAAE,CAAC;QAC3B,OAAO,MAAM,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,GAAG,YAAY,2BAAY,EAAE,CAAC;QAC9B,OAAO,MAAM,mBAAmB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;YACrB,aAAa,CAAC,IAAI,CACd,MAAM,6BAA6B,CAAC,IAAI,EAAE,YAAY,CAAC,CAC1D,CAAC;QACN,CAAC;QACD,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,WAAW,GAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM,6BAA6B,CAClD,KAAK,EACL,YAAY,CACf,CAAC;QACN,CAAC;QACD,OAAO,WAAW,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iCAAiC,CAC7C,GAAQ,EACR,eAA4B,IAAI,GAAG,EAAE;IAErC,IAAI,GAAG,YAAY,qBAAS,EAAE,CAAC;QAC3B,OAAO,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,GAAG,YAAY,2BAAY,EAAE,CAAC;QAC9B,OAAO,uBAAuB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;YACrB,aAAa,CAAC,IAAI,CACd,iCAAiC,CAAC,IAAI,EAAE,YAAY,CAAC,CACxD,CAAC;QACN,CAAC;QACD,OAAO,aAAa,CAAC;IACzB,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,WAAW,GAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,WAAW,CAAC,GAAG,CAAC,GAAG,iCAAiC,CAChD,KAAK,EACL,YAAY,CACf,CAAC;QACN,CAAC;QACD,OAAO,WAAW,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,gBAAgB,CAC3B,GAAc,EACd,YAAyB;IAEzB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAElD,gCAAgC;IAChC,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACX,gCAAgC,UAAU,cAAc,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACnG,CAAC;IACN,CAAC;IAED,uBAAuB;IACvB,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE7B,IAAI,CAAC;QACD,uBAAuB;QACvB,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,8BAA8B,UAAU,UAAU,GAAG,CAAC,SAAS,GAAG,CACrE,CAAC;IACN,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAuB,EAAC,UAAU,CAAC,CAAC;IAEzD,uDAAuD;IACvD,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE3E,6CAA6C;IAC7C,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,GAAc,EAAE,YAAyB;IACnE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAElD,gCAAgC;IAChC,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACX,gCAAgC,UAAU,cAAc,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACnG,CAAC;IACN,CAAC;IAED,uBAAuB;IACvB,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE7B,IAAI,CAAC;QACD,uBAAuB;QACvB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,8BAA8B,UAAU,UAAU,GAAG,CAAC,SAAS,GAAG,CACrE,CAAC;IACN,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAG,IAAA,oCAA2B,EAAC,UAAU,CAAC,CAAC;IAEvD,uDAAuD;IACvD,MAAM,QAAQ,GAAG,iCAAiC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEzE,6CAA6C;IAC7C,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,mBAAmB,CAC9B,MAAoB,EACpB,YAAyB;IAEzB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,uCAAuC;IACvC,IAAI,aAAuB,CAAC;IAC5B,IAAI,CAAC;QACD,aAAa,GAAG,MAAM,IAAA,WAAI,EAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,yBAAyB,WAAW,UAAU,MAAM,CAAC,SAAS,GAAG,CACpE,CAAC;IACN,CAAC;IAED,oCAAoC;IACpC,aAAa,GAAG,aAAa,CAAC,MAAM,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5D,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACX,8CAA8C,WAAW,UAAU,MAAM,CAAC,SAAS,GAAG,CACzF,CAAC;IACN,CAAC;IAED,oDAAoD;IACpD,aAAa,CAAC,IAAI,EAAE,CAAC;IAErB,6BAA6B;IAC7B,MAAM,gBAAgB,GAAU,EAAE,CAAC;IACnC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACnC,gCAAgC;QAChC,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACX,gCAAgC,QAAQ,cAAc,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACjG,CAAC;QACN,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3B,IAAI,CAAC;YACD,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAuB,EAAC,QAAQ,CAAC,CAAC;YAEvD,iCAAiC;YACjC,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAChD,MAAM,EACN,YAAY,CACf,CAAC;YACF,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,qCAAqC;YACrC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AACD;;;;;;GAMG;AACH,SAAS,uBAAuB,CAC5B,MAAoB,EACpB,YAAyB;IAEzB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,uCAAuC;IACvC,IAAI,aAAuB,CAAC;IAC5B,IAAI,CAAC;QACD,aAAa,GAAG,IAAA,eAAQ,EAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,yBAAyB,WAAW,UAAU,MAAM,CAAC,SAAS,GAAG,CACpE,CAAC;IACN,CAAC;IAED,oCAAoC;IACpC,aAAa,GAAG,aAAa,CAAC,MAAM,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5D,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACX,8CAA8C,WAAW,UAAU,MAAM,CAAC,SAAS,GAAG,CACzF,CAAC;IACN,CAAC;IAED,oDAAoD;IACpD,aAAa,CAAC,IAAI,EAAE,CAAC;IAErB,6BAA6B;IAC7B,MAAM,gBAAgB,GAAU,EAAE,CAAC;IACnC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACnC,gCAAgC;QAChC,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACX,gCAAgC,QAAQ,cAAc,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACjG,CAAC;QACN,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3B,IAAI,CAAC;YACD,0BAA0B;YAC1B,MAAM,MAAM,GAAG,IAAA,oCAA2B,EAAC,QAAQ,CAAC,CAAC;YAErD,iCAAiC;YACjC,MAAM,QAAQ,GAAG,iCAAiC,CAC9C,MAAM,EACN,YAAY,CACf,CAAC;YACF,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,qCAAqC;YACrC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@dsillman2000/yaml-reference-ts",
+    "version": "0.0.0",
+    "description": "A Node.js TypeScript library for resolving YAML documents containing !reference and !reference-all tags",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "bin": {
+        "yaml-reference-cli": "./dist/cli/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "jest",
+        "test:watch": "jest --watch",
+        "test:coverage": "jest --coverage",
+        "lint": "eslint --config .eslintrc.js src/**/*.ts",
+        "prepublishOnly": "npm run build",
+        "prepare": "npm run build"
+    },
+    "keywords": [
+        "yaml",
+        "reference",
+        "resolver",
+        "configuration",
+        "typescript"
+    ],
+    "author": "David Sillman <dsillman2000@gmail.com>",
+    "license": "MIT",
+    "dependencies": {
+        "glob": "^13.0.1",
+        "yaml": "^2.8.2"
+    },
+    "devDependencies": {
+        "@types/glob": "^8.1.0",
+        "@types/jest": "^30.0.0",
+        "@types/node": "^25.2.2",
+        "@typescript-eslint/eslint-plugin": "^8.54.0",
+        "@typescript-eslint/parser": "^8.54.0",
+        "eslint": "^9.39.2",
+        "jest": "^30.2.0",
+        "ts-jest": "^29.4.6",
+        "typescript": "^5.9.3"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ]
+}