pug-tail 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0-alpha.0] - 2026-01-10
+
+### Added
+
+- Initial release
+- Component system with multiple named slots (Vue/Svelte-like syntax)
+- Props/attrs separation (Vue 3-style)
+- Zero runtime cost - fully expanded at build time
+- Works with standard Pug features (includes, extends, mixins, etc.)
+- Programmatic API (`transform()` function)
+- CLI tool with watch mode support
+- Data file loading system (`$dataFiles` directive)
+- Scope isolation validation
+- TypeScript type definitions
+- Comprehensive test suite
+
+### Features
+
+- **Component Definition**: Define reusable components with `component` keyword
+- **Named Slots**: Multiple named slots with default content support
+- **Props/Attrs Separation**: Clear separation of props and attrs (Vue 3-style with `$props`/`$attrs`)
+- **Attrs Inheritance**: Automatic attribute passthrough with `&attributes()`
+- **Control Flow**: Pug control structures (if/unless/each/while/case) work seamlessly in components
+- **Dynamic Data**: Pass external data (from CLI, config, or frontmatter) as component attributes
+- **Nested Components**: Components can use other components
+- **Scope Isolation**: Component scope validation with configurable modes (error/warn/off)
+- **Watch Mode**: CLI supports file watching for development
+- **Error Handling**: Detailed error messages with file locations
+
+[0.1.0-alpha.0]: https://github.com/megurock/pug-tail/releases/tag/v0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eiji Meguro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,318 @@
+# pug-tail
+
+A build tool that brings Vue/Svelte-like component syntax to Pug.
+
+<img src="./images/pug-tail-logo.png" alt="pug-tail logo"/>
+
+[![npm version](https://img.shields.io/npm/v/pug-tail.svg)](https://www.npmjs.com/package/pug-tail)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+[日本語 (Japanese)](README-ja.md)
+
+### 🤖 Note on AI-Assisted Development
+
+> [!NOTE]
+> This is an **experimental project** developed heavily with the assistance of Large Language Models (LLMs).
+>
+> While functional, the codebase may contain unconventional solutions or require further refinement. Feedback and contributions are highly welcome.
+
+## ✨ Features
+
+- 🎯 **Multiple Named Slots** - Intuitive component syntax like Vue and Svelte.
+- 📦 **Props/Attrs Separation** - Clear separation of props and attributes, inspired by Vue 3.
+- ⚡ **Zero Runtime Cost** - Fully expanded at build time, generating a pure Pug AST.
+- 🔄 **Control Flow Support** - Use `if`/`unless`/`each`/`while`/`case` within components.
+- 🔧 **Pug Integration** - Works with other Pug features like `include`, `extends`, and `mixin`.
+- 🚫 **No Runtime Extensions** - No modifications to Pug's runtime.
+- ⚙️ **Powerful CLI** - Supports watch mode, configuration files, and data file loading.
+- 📝 **Built with TypeScript** - Type-safe implementation and a great developer experience.
+
+## 🌐 Live Demo
+
+Explore pug-tail features in action:
+
+- **[Main Demo](https://megurock.github.io/pug-tail/)** - Interactive examples and feature showcase
+- **[CLI Guide](https://megurock.github.io/pug-tail/cli-guide.html)** - Complete CLI documentation
+- **[Slots & Props](https://megurock.github.io/pug-tail/about.html)** - Advanced usage examples
+
+## 🤔 Why pug-tail?
+
+Pug's mixins can only accept a single content block, and named blocks are limited to `extends`. pug-tail solves this limitation at the AST level, enabling a component system with multiple named slots.
+
+### Before (Pug's mixin limitation)
+
+```pug
+mixin Card()
+  .card
+    .card-header
+      block
+    .card-body
+      // Multiple blocks are not possible
+```
+
+### After (pug-tail)
+
+```pug
+component Card()
+  .card
+    .card-header
+      slot(header)
+        p Default Header
+    .card-body
+      slot(body)
+        p Default Body
+    .card-footer
+      slot(footer)
+        p Default Footer
+
+// Usage
+Card()
+  slot(header)
+    h1 Title
+  slot(body)
+    p Content
+  slot(footer)
+    button OK
+```
+
+## 📦 Installation
+
+```bash
+npm install pug-tail
+```
+
+or
+
+```bash
+yarn add pug-tail
+```
+
+## 🚀 Quick Start
+
+### Using the CLI
+
+```bash
+# Basic usage
+npx pug-tail src/index.pug -o dist/index.html
+
+# Convert a directory
+npx pug-tail src -o dist
+
+# Development with watch mode
+npx pug-tail src -o dist -w
+
+# Use with a data file
+npx pug-tail src/index.pug -o dist/index.html --obj data.json
+
+# Use a configuration file
+npx pug-tail -c pugtail.config.js
+```
+
+**Key CLI Options**:
+- `-o, --out <dir>` - Output directory or file
+- `-w, --watch` - Watch mode (monitors file changes)
+- `-c, --config <path>` - Path to the configuration file
+- `--obj <path>` - Path to a data file (JSON/YAML)
+- `--pretty` - Formats the HTML output
+- `--basedir <path>` - Base directory for absolute includes
+- `-d, --debug` - Enable debug output (shows details like component registration, slot detection, etc.)
+
+#### Per-Page Data Files
+
+You can load page-specific external data files using the `$dataFiles` directive within your entry Pug file.
+
+```pug
+// pages/index.pug
+- const $dataFiles = ['/data/navigation.json', '/data/footer.json']
+
+// Data from these files will be available
+header
+  each item in navigation
+    a(href=item.url)= item.label
+```
+
+**Important Constraints**:
+- Only available in entry files (top-level files being compiled).
+- Cannot be used within included component files.
+- Absolute paths (starting with `/`) are resolved relative to `basedir`.
+- Relative paths are resolved relative to the entry file.
+
+See the [Configuration Guide](./docs/CONFIGURATION.md) for more details.
+
+### Programmatic API
+
+```typescript
+import { transform } from 'pug-tail'
+
+const source = `
+component Card()
+  .card
+    slot(header)
+    slot(body)
+
+Card()
+  slot(header)
+    h1 Hello
+  slot(body)
+    p World
+`
+
+const result = transform(source, { output: 'html' })
+console.log(result.html)
+```
+
+## 📖 Component DSL
+
+### Basic Usage
+
+```pug
+// Component Definition
+component Card()
+  .card
+    .card-header
+      slot(header)
+        p Default Header
+    .card-body
+      slot(body)
+        p Default Body
+
+// Component Invocation
+Card()
+  slot(header)
+    h1 Title
+  slot(body)
+    p Content
+```
+
+This DSL is expanded into pure Pug at build time to generate the final HTML.
+
+### Key Features
+
+#### Multiple Named Slots
+
+Define multiple named slots, just like in Vue or Svelte.
+
+```pug
+component Layout()
+  header
+    slot(header)
+  main
+    slot(main)
+  footer
+    slot(footer)
+
+Layout()
+  slot(header)
+    h1 My Site
+  slot(main)
+    p Content
+  slot(footer)
+    p © 2026
+```
+
+#### Props/Attrs Separation
+
+Clear separation of props and attributes with `$props` and `$attrs`, inspired by Vue 3.
+
+```pug
+component Button()
+  - const { label, type = "button" } = $props
+  - const { class: className = "btn" } = $attrs
+  button(type=type class=className)= label
+
+Button(label="Submit", type="submit", class="btn-primary")
+```
+
+- Properties not declared in `$props` are automatically categorized into `$attrs`.
+- Default values and renaming are also supported.
+
+#### Automatic Attribute Fallthrough
+
+Attributes passed to a component are automatically applied to the root element.
+
+```pug
+component Card()
+  .card
+    h2 Title
+
+Card(class="my-card", id="card-1")
+// → <div class="card my-card" id="card-1">...</div>
+```
+
+Manual control is also possible.
+
+```pug
+component Input()
+  .wrapper
+    input&attributes(attributes)
+
+Input(type="text", class="primary")
+// Attributes are applied to the input
+```
+
+#### Scope Isolation
+
+Components have an isolated scope, preventing direct access to external variables.
+
+```pug
+// ❌ Error
+- const message = 'Hello'
+component Card()
+  p= message
+
+// ✅ Correct way: Pass via props
+- const message = 'Hello'
+component Card()
+  - const { text } = $props
+  p= text
+Card(text=message)
+```
+
+### Detailed Documentation
+
+The complete Component DSL documentation is here:
+
+- [Component DSL Reference](./docs/COMPONENTS.md) - Complete reference guide
+- [Configuration Guide](./docs/CONFIGURATION.md) - Configuration options
+
+## 📚 Documentation
+
+- [Configuration Guide](./docs/CONFIGURATION.md) - CLI options, configuration files, and data loading
+- [Component DSL Reference](./docs/COMPONENTS.md) - Complete component syntax reference
+- [Architecture](./docs/ARCHITECTURE.md) - Internal design and processing flow
+- [Contributing](./docs/CONTRIBUTING.md) - Development setup and guidelines
+
+## 🔧 Development
+
+### Setup
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Lint & Format
+npm run check
+```
+
+### Contributing
+
+Interested in contributing? Please see the [Contribution Guide](./docs/CONTRIBUTING.md).
+
+## 📄 License
+
+MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## 🙏 Acknowledgements
+
+- [Pug](https://pugjs.org/) - The amazing template engine
+- Inspired by the component system of [Vue.js](https://vuejs.org/)
+
+---
+
+**Status**: Alpha Release (v0.1.0-alpha.0) - 286 tests passing ✅

package/dist/cli/config/loader.d.ts

@@ -0,0 +1,9 @@
+import type { PugTailConfig } from './types.js';
+export declare function findConfigFile(startDir?: string): string | null;
+export declare function loadConfigFile(configPath: string): Promise<PugTailConfig>;
+export declare function loadConfig(configPath?: string): Promise<{
+    config: PugTailConfig;
+    configDir: string | null;
+}>;
+export declare function mergeConfig(config: PugTailConfig, cliOptions: Partial<PugTailConfig>): PugTailConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/cli/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/cli/config/loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAqB/C,wBAAgB,cAAc,CAC5B,QAAQ,GAAE,MAAsB,GAC/B,MAAM,GAAG,IAAI,CAyBf;AAQD,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAQD,wBAAsB,UAAU,CAC9B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmB9D;AAUD,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAuBf"}

package/dist/cli/config/loader.js

@@ -0,0 +1,82 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const CONFIG_FILE_NAMES = [
+    'pugtail.config.js',
+    'pugtail.config.mjs',
+    'pugtail.config.json',
+    '.pugtailrc.js',
+    '.pugtailrc.mjs',
+    '.pugtailrc.json',
+    '.pugtailrc',
+];
+export function findConfigFile(startDir = process.cwd()) {
+    let currentDir = resolve(startDir);
+    const root = dirname(currentDir);
+    while (currentDir !== root) {
+        for (const filename of CONFIG_FILE_NAMES) {
+            const configPath = join(currentDir, filename);
+            if (existsSync(configPath)) {
+                return configPath;
+            }
+        }
+        if (existsSync(join(currentDir, 'package.json')) ||
+            existsSync(join(currentDir, '.git'))) {
+            break;
+        }
+        currentDir = dirname(currentDir);
+    }
+    return null;
+}
+export async function loadConfigFile(configPath) {
+    const ext = configPath.split('.').pop();
+    try {
+        if (ext === 'json' || configPath.endsWith('.pugtailrc')) {
+            const content = readFileSync(configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        else {
+            const fileUrl = pathToFileURL(configPath).href;
+            const module = await import(fileUrl);
+            return (module.default || module);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to load config file "${configPath}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export async function loadConfig(configPath) {
+    if (configPath) {
+        if (!existsSync(configPath)) {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        const config = await loadConfigFile(configPath);
+        return { config, configDir: dirname(resolve(configPath)) };
+    }
+    const foundConfig = findConfigFile();
+    if (foundConfig) {
+        const config = await loadConfigFile(foundConfig);
+        return { config, configDir: dirname(resolve(foundConfig)) };
+    }
+    return { config: {}, configDir: null };
+}
+export function mergeConfig(config, cliOptions) {
+    return {
+        ...config,
+        ...cliOptions,
+        files: {
+            ...config.files,
+            ...cliOptions.files,
+            input: cliOptions.files?.input || config.files?.input,
+            output: cliOptions.files?.output || config.files?.output,
+            render: cliOptions.files?.render === undefined && cliOptions.files?.input
+                ? undefined
+                : cliOptions.files?.render || config.files?.render,
+        },
+        watch: {
+            ...config.watch,
+            ...cliOptions.watch,
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/cli/config/loader.js.map

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

package/dist/cli/config/matcher.d.ts

@@ -0,0 +1,3 @@
+export declare function shouldIncludeFile(filePath: string, patterns: string[], basePath: string): boolean;
+export declare function getDefaultOutputPatterns(): string[];
+//# sourceMappingURL=matcher.d.ts.map

package/dist/cli/config/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/cli/config/matcher.ts"],"names":[],"mappings":"AA4BA,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAwBT;AAQD,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAOnD"}

package/dist/cli/config/matcher.js

@@ -0,0 +1,29 @@
+import { relative } from 'node:path';
+import { minimatch } from 'minimatch';
+export function shouldIncludeFile(filePath, patterns, basePath) {
+    const relativePath = relative(basePath, filePath);
+    let included = patterns.length === 0;
+    for (const pattern of patterns) {
+        if (pattern.startsWith('!')) {
+            const negatedPattern = pattern.slice(1);
+            if (minimatch(relativePath, negatedPattern, { dot: true })) {
+                included = false;
+            }
+        }
+        else {
+            if (minimatch(relativePath, pattern, { dot: true })) {
+                included = true;
+            }
+        }
+    }
+    return included;
+}
+export function getDefaultOutputPatterns() {
+    return [
+        '**/*.pug',
+        '!**/_*.pug',
+        '!**/*.component.pug',
+        '!**/components/**/*.pug',
+    ];
+}
+//# sourceMappingURL=matcher.js.map

package/dist/cli/config/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../../src/cli/config/matcher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAuBrC,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,QAAkB,EAClB,QAAgB;IAGhB,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAGjD,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;IAGpC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAE5B,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACvC,IAAI,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3D,QAAQ,GAAG,KAAK,CAAA;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YAEN,IAAI,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpD,QAAQ,GAAG,IAAI,CAAA;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAQD,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,UAAU;QACV,YAAY;QACZ,qBAAqB;QACrB,yBAAyB;KAC1B,CAAA;AACH,CAAC"}

package/dist/cli/config/types.d.ts

@@ -0,0 +1,26 @@
+export interface PugTailConfig {
+    files?: {
+        input?: string | string[];
+        output?: string;
+        root?: string;
+        render?: string[];
+    };
+    extension?: string;
+    basedir?: string;
+    doctype?: string;
+    pretty?: boolean;
+    format?: 'html' | 'ast' | 'pug-code';
+    data?: string | Record<string, unknown>;
+    dataKey?: string;
+    watch?: {
+        enabled?: boolean;
+        debounce?: number;
+    };
+    silent?: boolean;
+    debug?: boolean;
+    validation?: {
+        scopeIsolation?: 'error' | 'warn' | 'off';
+        allowedGlobals?: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAE5B,KAAK,CAAC,EAAE;QAEN,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QAGzB,MAAM,CAAC,EAAE,MAAM,CAAA;QAaf,IAAI,CAAC,EAAE,MAAM,CAAA;QAqBb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;IAGD,SAAS,CAAC,EAAE,MAAM,CAAA;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,MAAM,CAAC,EAAE,OAAO,CAAA;IAGhB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAA;IAGpC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAGvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,KAAK,CAAC,EAAE;QAEN,OAAO,CAAC,EAAE,OAAO,CAAA;QAEjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IAGD,MAAM,CAAC,EAAE,OAAO,CAAA;IAGhB,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,UAAU,CAAC,EAAE;QAEX,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;QAEzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAC1B,CAAA;CACF"}

package/dist/cli/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":""}

package/dist/cli/dataLoader.d.ts

@@ -0,0 +1,8 @@
+export declare function loadData(input: string, basedir?: string): Record<string, unknown>;
+export declare function mergeData(...sources: Array<Record<string, unknown> | undefined>): Record<string, unknown>;
+declare class DataLoader {
+    loadDataFiles(filePaths: string[], basePath?: string, basedir?: string): Record<string, unknown>;
+}
+export declare const dataLoader: DataLoader;
+export {};
+//# sourceMappingURL=dataLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataLoader.d.ts","sourceRoot":"","sources":["../../src/cli/dataLoader.ts"],"names":[],"mappings":"AAoCA,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB;AAmBD,wBAAgB,SAAS,CACvB,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GACrD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAKD,cAAM,UAAU;IASd,aAAa,CACX,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgD3B;AAED,eAAO,MAAM,UAAU,YAAmB,CAAA"}

package/dist/cli/dataLoader.js

@@ -0,0 +1,70 @@
+import { readFileSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+export function loadData(input, basedir) {
+    const basePath = basedir || process.cwd();
+    const filePath = resolve(basePath, input);
+    try {
+        const fileContent = readFileSync(filePath, 'utf-8');
+        try {
+            return JSON.parse(fileContent);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse file "${input}" as JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    catch (fileError) {
+        try {
+            return JSON.parse(input);
+        }
+        catch (parseError) {
+            throw new Error(`Failed to load data from "${input}". ` +
+                `It must be either a valid JSON file path or a JSON string. ` +
+                `File error: ${fileError instanceof Error ? fileError.message : String(fileError)}. ` +
+                `Parse error: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+        }
+    }
+}
+export function mergeData(...sources) {
+    const result = {};
+    for (const source of sources) {
+        if (source) {
+            Object.assign(result, source);
+        }
+    }
+    return result;
+}
+class DataLoader {
+    loadDataFiles(filePaths, basePath, basedir) {
+        const mergedData = {};
+        for (const filePath of filePaths) {
+            try {
+                let resolvedPath;
+                const isPugStyleAbsolute = filePath.startsWith('/') &&
+                    !filePath.startsWith('/Users/') &&
+                    !filePath.startsWith('/home/') &&
+                    !/^[A-Z]:\\/.test(filePath);
+                if (isPugStyleAbsolute) {
+                    const normalizedPath = filePath.slice(1);
+                    const resolveBase = basedir || basePath || process.cwd();
+                    resolvedPath = resolve(resolveBase, normalizedPath);
+                }
+                else if (isAbsolute(filePath)) {
+                    resolvedPath = filePath;
+                }
+                else {
+                    const resolveBase = basePath || basedir || process.cwd();
+                    resolvedPath = resolve(resolveBase, filePath);
+                }
+                const fileContent = readFileSync(resolvedPath, 'utf-8');
+                const data = JSON.parse(fileContent);
+                Object.assign(mergedData, data);
+            }
+            catch (error) {
+                console.warn(`Warning: Failed to load data file "${filePath}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return mergedData;
+    }
+}
+export const dataLoader = new DataLoader();
+//# sourceMappingURL=dataLoader.js.map

package/dist/cli/dataLoader.js.map

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

package/dist/cli/dependencyTracker.d.ts

@@ -0,0 +1,19 @@
+export interface FileDependencies {
+    dependencies: Set<string>;
+    dependents: Set<string>;
+}
+export declare class DependencyTracker {
+    private dependencyMap;
+    private basedir?;
+    constructor(basedir?: string);
+    analyzeDependencies(filePath: string): Set<string>;
+    getDependents(filePath: string): Set<string>;
+    removeFile(filePath: string): void;
+    hasCircularDependency(filePath: string): boolean;
+    private resolveDependencyPath;
+    private addPugExtension;
+    private updateDependencyGraph;
+    private clearFileDependencies;
+    private isDebug;
+}
+//# sourceMappingURL=dependencyTracker.d.ts.map