embedoc 0.9.0

package/dist/datasources/sqlite.js

@@ -0,0 +1,40 @@
+/**
+ * SQLite Datasource
+ */
+import Database from 'better-sqlite3';
+export class SqliteDatasource {
+    type = 'sqlite';
+    db;
+    queryString;
+    constructor(config) {
+        if (!config.path) {
+            throw new Error('SQLite datasource requires "path" configuration');
+        }
+        this.db = new Database(config.path, { readonly: true });
+        this.queryString = config.query;
+    }
+    async query(sql, params = []) {
+        try {
+            const stmt = this.db.prepare(sql);
+            const rows = stmt.all(...params);
+            return rows;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`SQLite query failed: ${message}`);
+        }
+    }
+    async getAll() {
+        if (!this.queryString) {
+            throw new Error('No query defined for this datasource. Use query() method instead.');
+        }
+        return this.query(this.queryString);
+    }
+    async close() {
+        this.db.close();
+    }
+}
+export function createSqliteDatasource(config) {
+    return new SqliteDatasource(config);
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/datasources/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/datasources/sqlite.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,QAAQ,CAAC;IACjB,EAAE,CAAoB;IACtB,WAAW,CAAU;IAE7B,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAAoB,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YACjC,OAAO,IAAmB,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/datasources/yaml.d.ts

@@ -0,0 +1,16 @@
+/**
+ * YAML Datasource
+ */
+import type { Datasource, DatasourceConfig, QueryResult } from '../types/index.js';
+export declare class YamlDatasource implements Datasource {
+    readonly type = "yaml";
+    private data;
+    private filePath;
+    constructor(config: DatasourceConfig);
+    private loadData;
+    query(sql: string, params?: unknown[]): Promise<QueryResult>;
+    getAll(): Promise<QueryResult>;
+    close(): Promise<void>;
+}
+export declare function createYamlDatasource(config: DatasourceConfig): YamlDatasource;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/datasources/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/datasources/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnF,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,gBAAgB;YAQtB,QAAQ;IAoBhB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBhE,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAE7E"}

package/dist/datasources/yaml.js

@@ -0,0 +1,60 @@
+/**
+ * YAML Datasource
+ */
+import { readFile } from 'node:fs/promises';
+import yaml from 'js-yaml';
+export class YamlDatasource {
+    type = 'yaml';
+    data = null;
+    filePath;
+    constructor(config) {
+        if (!config.path) {
+            throw new Error('YAML datasource requires "path" configuration');
+        }
+        this.filePath = config.path;
+    }
+    async loadData() {
+        if (this.data !== null) {
+            return this.data;
+        }
+        const content = await readFile(this.filePath, { encoding: 'utf-8' });
+        const parsed = yaml.load(content);
+        // Use as-is if array, wrap in array if object
+        if (Array.isArray(parsed)) {
+            this.data = parsed;
+        }
+        else if (typeof parsed === 'object' && parsed !== null) {
+            this.data = [parsed];
+        }
+        else {
+            throw new Error('YAML file must contain an array or object');
+        }
+        return this.data;
+    }
+    async query(sql, params = []) {
+        // YAML does not support SQL queries
+        // Simple filtering only
+        const data = await this.loadData();
+        // Only supports simple WHERE column = value
+        const whereMatch = sql.match(/WHERE\s+(\w+)\s*=\s*\?/i);
+        if (whereMatch && params.length > 0) {
+            const column = whereMatch[1];
+            const value = params[0];
+            return data.filter((row) => {
+                const rowValue = row[column ?? ''];
+                return rowValue === value || String(rowValue) === String(value);
+            });
+        }
+        return data;
+    }
+    async getAll() {
+        return this.loadData();
+    }
+    async close() {
+        this.data = null;
+    }
+}
+export function createYamlDatasource(config) {
+    return new YamlDatasource(config);
+}
+//# sourceMappingURL=yaml.js.map

package/dist/datasources/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/datasources/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,MAAM,CAAC;IACf,IAAI,GAAuB,IAAI,CAAC;IAChC,QAAQ,CAAS;IAEzB,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElC,8CAA8C;QAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,GAAG,MAAqB,CAAC;QACpC,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACzD,IAAI,CAAC,IAAI,GAAG,CAAC,MAAiC,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAAoB,EAAE;QAC7C,oCAAoC;QACpC,wBAAwB;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEnC,4CAA4C;QAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACxD,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBACnC,OAAO,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/helpers/markdown.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Markdown Helper
+ * Utilities for generating Markdown strings
+ */
+import type { MarkdownHelper } from '../types/index.js';
+/**
+ * Create a Markdown helper instance
+ */
+export declare function createMarkdownHelper(): MarkdownHelper;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/helpers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/helpers/markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAexD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAwFrD"}

package/dist/helpers/markdown.js

@@ -0,0 +1,93 @@
+/**
+ * Markdown Helper
+ * Utilities for generating Markdown strings
+ */
+/**
+ * Escape cell content for Markdown tables
+ */
+function escapeCell(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    const str = String(value);
+    // Escape pipe characters and newlines
+    return str.replace(/\|/g, '\\|').replace(/\n/g, '<br>');
+}
+/**
+ * Create a Markdown helper instance
+ */
+export function createMarkdownHelper() {
+    return {
+        /**
+         * Generate a table
+         */
+        table(headers, rows) {
+            if (headers.length === 0) {
+                return '';
+            }
+            const lines = [];
+            // Header row
+            const headerLine = '| ' + headers.map(escapeCell).join(' | ') + ' |';
+            lines.push(headerLine);
+            // Separator row
+            const separatorLine = '| ' + headers.map(() => '---').join(' | ') + ' |';
+            lines.push(separatorLine);
+            // Data rows
+            for (const row of rows) {
+                const cells = headers.map((_, i) => escapeCell(row[i]));
+                const rowLine = '| ' + cells.join(' | ') + ' |';
+                lines.push(rowLine);
+            }
+            return lines.join('\n');
+        },
+        /**
+         * Generate a list
+         */
+        list(items, ordered = false) {
+            return items
+                .map((item, index) => {
+                const prefix = ordered ? `${index + 1}.` : '-';
+                return `${prefix} ${item}`;
+            })
+                .join('\n');
+        },
+        /**
+         * Generate a code block
+         */
+        codeBlock(code, language = '') {
+            return '```' + language + '\n' + code + '\n```';
+        },
+        /**
+         * Generate a link
+         */
+        link(text, url) {
+            return `[${text}](${url})`;
+        },
+        /**
+         * Generate a heading
+         */
+        heading(text, level = 1) {
+            const prefix = '#'.repeat(Math.min(Math.max(level, 1), 6));
+            return `${prefix} ${text}`;
+        },
+        /**
+         * Generate bold text
+         */
+        bold(text) {
+            return `**${text}**`;
+        },
+        /**
+         * Generate italic text
+         */
+        italic(text) {
+            return `*${text}*`;
+        },
+        /**
+         * Generate a checkbox
+         */
+        checkbox(checked) {
+            return checked ? '✔' : '';
+        },
+    };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/helpers/markdown.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * embedoc - In-Place Document Generator
+ *
+ * @example
+ * ```typescript
+ * import { defineEmbed, build, generateAll } from 'embedoc';
+ *
+ * const myEmbed = defineEmbed({
+ *   dependsOn: ['my_datasource'],
+ *   async render(ctx) {
+ *     const data = await ctx.datasources.my_datasource.query('SELECT * FROM table');
+ *     return { content: ctx.markdown.table(['Column'], data.map(r => [r.name])) };
+ *   }
+ * });
+ * ```
+ */
+export type { CommentStyle, TargetConfig, GeneratorConfig, DatasourceConfig, OutputConfig, GithubConfig, EmbedifyConfig, InlineDatasourceConfig, ParsedMarker, DetectedComment, QueryResult, Datasource, DatasourceFactory, MarkdownHelper, EmbedContext, EmbedResult, EmbedDefinition, DefineEmbedFn, ParsedFrontmatter, ProcessResult, GenerateResult, BuildResult, CLIOptions, } from './types/index.js';
+export { build, processFile } from './core/processor.js';
+export { generateAll, generateFromDatasource } from './core/generator.js';
+export { parseMarkers, parseFrontmatter, parseAttributes, resolveVariables, getCommentStyle, guessCommentStyle, parseInlineDataMarkers, DEFAULT_COMMENT_STYLES, } from './core/parser.js';
+export { InlineDatasource, buildInlineDatasources, parseDotPath, resolveDotPath, setDotPath, getRootName, parseInlineContent, } from './core/inline-datasource.js';
+export type { ParsedInlineData, ContentProcessingOptions } from './core/inline-datasource.js';
+export { DependencyGraph } from './core/dependency.js';
+export type { DependencyType, DependencyNode } from './core/dependency.js';
+export { createDatasource, initializeDatasources, closeDatasources, SqliteDatasource, CsvDatasource, JsonDatasource, YamlDatasource, GlobDatasource, } from './datasources/index.js';
+export { createMarkdownHelper } from './helpers/markdown.js';
+import type { DefineEmbedFn } from './types/index.js';
+/**
+ * Helper function to define an embed
+ *
+ * @example
+ * ```typescript
+ * import { defineEmbed } from 'embedoc';
+ *
+ * export default defineEmbed({
+ *   dependsOn: ['metadata_db'],
+ *   async render(ctx) {
+ *     const { id } = ctx.params;
+ *     const data = await ctx.datasources.metadata_db.query(
+ *       'SELECT * FROM tables WHERE name = ?',
+ *       [id]
+ *     );
+ *     return { content: ctx.markdown.table(['Name'], data.map(r => [r.name])) };
+ *   }
+ * });
+ * ```
+ */
+export declare const defineEmbed: DefineEmbedFn;
+export declare const defineTemplate: DefineEmbedFn;
+//# 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;AAGH,YAAY,EAEV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,sBAAsB,EAEtB,YAAY,EACZ,eAAe,EAEf,WAAW,EACX,UAAU,EACV,iBAAiB,EAEjB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EAEb,iBAAiB,EAEjB,aAAa,EACb,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,EAAE,aAA2D,CAAC;AAGtF,eAAO,MAAM,cAAc,eAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+/**
+ * embedoc - In-Place Document Generator
+ *
+ * @example
+ * ```typescript
+ * import { defineEmbed, build, generateAll } from 'embedoc';
+ *
+ * const myEmbed = defineEmbed({
+ *   dependsOn: ['my_datasource'],
+ *   async render(ctx) {
+ *     const data = await ctx.datasources.my_datasource.query('SELECT * FROM table');
+ *     return { content: ctx.markdown.table(['Column'], data.map(r => [r.name])) };
+ *   }
+ * });
+ * ```
+ */
+// Core functions
+export { build, processFile } from './core/processor.js';
+export { generateAll, generateFromDatasource } from './core/generator.js';
+export { parseMarkers, parseFrontmatter, parseAttributes, resolveVariables, getCommentStyle, guessCommentStyle, parseInlineDataMarkers, DEFAULT_COMMENT_STYLES, } from './core/parser.js';
+// Inline datasource
+export { InlineDatasource, buildInlineDatasources, parseDotPath, resolveDotPath, setDotPath, getRootName, parseInlineContent, } from './core/inline-datasource.js';
+export { DependencyGraph } from './core/dependency.js';
+// Datasources
+export { createDatasource, initializeDatasources, closeDatasources, SqliteDatasource, CsvDatasource, JsonDatasource, YamlDatasource, GlobDatasource, } from './datasources/index.js';
+// Helpers
+export { createMarkdownHelper } from './helpers/markdown.js';
+/**
+ * Helper function to define an embed
+ *
+ * @example
+ * ```typescript
+ * import { defineEmbed } from 'embedoc';
+ *
+ * export default defineEmbed({
+ *   dependsOn: ['metadata_db'],
+ *   async render(ctx) {
+ *     const { id } = ctx.params;
+ *     const data = await ctx.datasources.metadata_db.query(
+ *       'SELECT * FROM tables WHERE name = ?',
+ *       [id]
+ *     );
+ *     return { content: ctx.markdown.table(['Name'], data.map(r => [r.name])) };
+ *   }
+ * });
+ * ```
+ */
+export const defineEmbed = (definition) => definition;
+// Export alias for documentation consistency
+export const defineTemplate = defineEmbed;
+//# 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;AAmCH,iBAAiB;AACjB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,cAAc;AACd,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAK7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB,CAAC,UAA2B,EAAE,EAAE,CAAC,UAAU,CAAC;AAEtF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,254 @@
+/**
+ * embedoc Type Definitions
+ */
+/**
+ * Comment style definition
+ */
+export interface CommentStyle {
+    start: string;
+    end: string;
+}
+/**
+ * Target file pattern configuration
+ */
+export interface TargetConfig {
+    pattern: string;
+    comment_style: string;
+    exclude?: string[];
+}
+/**
+ * Generator configuration
+ */
+export interface GeneratorConfig {
+    output_path: string;
+    template: string;
+    overwrite?: boolean;
+}
+/**
+ * Datasource configuration
+ */
+export interface DatasourceConfig {
+    type: 'sqlite' | 'csv' | 'json' | 'yaml' | 'glob';
+    path?: string;
+    pattern?: string;
+    query?: string;
+    encoding?: string;
+    generators?: GeneratorConfig[];
+}
+/**
+ * Output configuration
+ */
+export interface OutputConfig {
+    encoding?: BufferEncoding;
+    line_ending?: 'lf' | 'crlf';
+}
+/**
+ * GitHub configuration
+ */
+export interface GithubConfig {
+    base_url?: string;
+}
+/**
+ * Inline datasource configuration
+ */
+export interface InlineDatasourceConfig {
+    /** Enable/disable inline datasources (default: true) */
+    enabled?: boolean;
+    /** Maximum size in bytes (default: 10240) */
+    maxBytes?: number;
+    /** Allowed formats (default: all) */
+    allowedFormats?: string[];
+    /** Conflict policy when inline name matches external (default: warn) */
+    conflictPolicy?: 'warn' | 'error' | 'prefer_external';
+    /** Allow anonymous inline data (default: false) */
+    allowAnonymous?: boolean;
+    /** Strip code fences from content (default: true) */
+    stripCodeFences?: boolean;
+    /** Custom regex patterns to strip from content start/end */
+    stripPatterns?: string[];
+}
+/**
+ * Main configuration file
+ */
+export interface EmbedifyConfig {
+    version: string;
+    targets: TargetConfig[];
+    comment_styles?: Record<string, CommentStyle>;
+    datasources?: Record<string, DatasourceConfig>;
+    embeds_dir?: string;
+    templates_dir?: string;
+    output?: OutputConfig;
+    github?: GithubConfig;
+    /** Inline datasource configuration */
+    inline_datasource?: InlineDatasourceConfig;
+}
+/**
+ * Parsed marker information
+ */
+export interface ParsedMarker {
+    /** Start position of entire marker */
+    startIndex: number;
+    /** End position of entire marker */
+    endIndex: number;
+    /** Template name */
+    templateName: string;
+    /** Parameters (attribute values) */
+    params: Record<string, string>;
+    /** Existing content (between markers) */
+    existingContent: string;
+    /** Full start marker line */
+    startMarkerLine: string;
+    /** Full end marker line */
+    endMarkerLine: string;
+}
+/**
+ * Detected comment format result
+ */
+export interface DetectedComment {
+    style: CommentStyle;
+    styleName: string;
+}
+/**
+ * Datasource query result
+ */
+export type QueryResult = Record<string, unknown>[];
+/**
+ * Datasource interface
+ */
+export interface Datasource {
+    /** Datasource type */
+    readonly type: string;
+    /** Execute query */
+    query(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /** Get all data (for generators) */
+    getAll(): Promise<QueryResult>;
+    /** Close connection */
+    close(): Promise<void>;
+}
+/**
+ * Datasource factory
+ */
+export type DatasourceFactory = (config: DatasourceConfig) => Promise<Datasource>;
+/**
+ * Markdown helper
+ */
+export interface MarkdownHelper {
+    /** Generate table */
+    table(headers: string[], rows: (string | number | boolean | null | undefined)[][]): string;
+    /** Generate list */
+    list(items: string[], ordered?: boolean): string;
+    /** Generate code block */
+    codeBlock(code: string, language?: string): string;
+    /** Generate link */
+    link(text: string, url: string): string;
+    /** Generate heading */
+    heading(text: string, level?: number): string;
+    /** Bold text */
+    bold(text: string): string;
+    /** Italic text */
+    italic(text: string): string;
+    /** Checkbox */
+    checkbox(checked: boolean): string;
+}
+/**
+ * Embed context
+ */
+export interface EmbedContext {
+    /** Marker parameters */
+    params: Record<string, string>;
+    /** Frontmatter properties */
+    frontmatter: Record<string, unknown>;
+    /** Datasource access */
+    datasources: Record<string, Datasource>;
+    /** Markdown helper */
+    markdown: MarkdownHelper;
+    /** Current file path being processed */
+    filePath: string;
+}
+/**
+ * Embed execution result
+ */
+export interface EmbedResult {
+    content: string;
+}
+/**
+ * Embed definition
+ */
+export interface EmbedDefinition {
+    /** Dependent datasource names */
+    dependsOn?: string[];
+    /** Render function */
+    render(ctx: EmbedContext): Promise<EmbedResult>;
+}
+/**
+ * Helper function type for embed definition
+ */
+export type DefineEmbedFn = (definition: EmbedDefinition) => EmbedDefinition;
+/**
+ * Parsed frontmatter
+ */
+export interface ParsedFrontmatter {
+    /** Frontmatter data */
+    data: Record<string, unknown>;
+    /** Content after frontmatter */
+    content: string;
+    /** Original frontmatter string (including ---) */
+    raw: string;
+}
+/**
+ * File processing result
+ */
+export interface ProcessResult {
+    /** Processed file path */
+    filePath: string;
+    /** Whether successful */
+    success: boolean;
+    /** Number of updated markers */
+    markersUpdated: number;
+    /** Error (if any) */
+    error?: Error;
+    /** Whether changed */
+    changed: boolean;
+}
+/**
+ * Generation result
+ */
+export interface GenerateResult {
+    /** Generated file path */
+    filePath: string;
+    /** Whether successful */
+    success: boolean;
+    /** Whether skipped (existing file without overwrite) */
+    skipped: boolean;
+    /** Error (if any) */
+    error?: Error;
+}
+/**
+ * Build result
+ */
+export interface BuildResult {
+    /** Number of processed files */
+    totalFiles: number;
+    /** Number of successful files */
+    successFiles: number;
+    /** Number of failed files */
+    failedFiles: number;
+    /** Total number of updated markers */
+    totalMarkersUpdated: number;
+    /** Results for each file */
+    results: ProcessResult[];
+    /** Processing time (milliseconds) */
+    duration: number;
+}
+/**
+ * CLI options
+ */
+export interface CLIOptions {
+    config?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    datasource?: string;
+    generator?: string;
+    all?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * embedoc Type Definitions
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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