@klarocards/cli 1.0.0

package/dist/lib/types.js

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

package/dist/lib/types.js.map

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

package/dist/utils/content.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get the content directory path for a project.
+ */
+export declare function getContentDir(project: string): string;
+/**
+ * Ensure the content directory exists, creating it if necessary.
+ * Returns the directory path.
+ */
+export declare function ensureContentDir(project: string): string;
+/**
+ * List all markdown files in the content directory for a project.
+ * Returns an array of filenames (not full paths).
+ */
+export declare function listContentFiles(project: string): string[];
+/**
+ * Extract the card identifier from a content filename.
+ * Filename format: {identifier}-{slugified-title}.md
+ * Returns null if the filename doesn't match the expected pattern.
+ */
+export declare function extractIdentifierFromFilename(filename: string): number | null;
+/**
+ * Build a content filename from identifier and title.
+ * Format: {identifier}-{slugified-title}.md
+ */
+export declare function buildContentFilename(identifier: string | number, title: string): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/utils/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvF"}

package/dist/utils/content.js

@@ -0,0 +1,52 @@
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { getConfigDir } from '../lib/config.js';
+import { slugify } from './slugify.js';
+/**
+ * Get the content directory path for a project.
+ */
+export function getContentDir(project) {
+    return join(getConfigDir(), 'content', project);
+}
+/**
+ * Ensure the content directory exists, creating it if necessary.
+ * Returns the directory path.
+ */
+export function ensureContentDir(project) {
+    const dir = getContentDir(project);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/**
+ * List all markdown files in the content directory for a project.
+ * Returns an array of filenames (not full paths).
+ */
+export function listContentFiles(project) {
+    const dir = getContentDir(project);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir).filter(f => f.endsWith('.md'));
+}
+/**
+ * Extract the card identifier from a content filename.
+ * Filename format: {identifier}-{slugified-title}.md
+ * Returns null if the filename doesn't match the expected pattern.
+ */
+export function extractIdentifierFromFilename(filename) {
+    const match = filename.match(/^(\d+)-.*\.md$/);
+    if (!match) {
+        return null;
+    }
+    return parseInt(match[1], 10);
+}
+/**
+ * Build a content filename from identifier and title.
+ * Format: {identifier}-{slugified-title}.md
+ */
+export function buildContentFilename(identifier, title) {
+    return `${identifier}-${slugify(title)}.md`;
+}
+//# sourceMappingURL=content.js.map

package/dist/utils/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA2B,EAAE,KAAa;IAC7E,OAAO,GAAG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AAC9C,CAAC"}

package/dist/utils/dimensions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Split command line args into regular args and key=value dimensions.
+ * @param args - Array of command line arguments
+ * @returns Object with regularArgs and dimensionArgs separated
+ */
+export declare function splitArgs(args: string[]): {
+    regularArgs: string[];
+    dimensionArgs: string[];
+};
+/**
+ * Parse dimension arguments from command line (key=value format).
+ * @param dimensionArgs - Array of dimension strings in "key=value" format
+ * @returns Object mapping dimension keys to values
+ * @throws Error if any dimension is not in "key=value" format
+ */
+export declare function parseDimensions(dimensionArgs?: string[]): Record<string, string>;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/utils/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/utils/dimensions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAa5F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBhF"}

package/dist/utils/dimensions.js

@@ -0,0 +1,41 @@
+/**
+ * Split command line args into regular args and key=value dimensions.
+ * @param args - Array of command line arguments
+ * @returns Object with regularArgs and dimensionArgs separated
+ */
+export function splitArgs(args) {
+    const regularArgs = [];
+    const dimensionArgs = [];
+    for (const arg of args) {
+        if (arg.includes('=')) {
+            dimensionArgs.push(arg);
+        }
+        else {
+            regularArgs.push(arg);
+        }
+    }
+    return { regularArgs, dimensionArgs };
+}
+/**
+ * Parse dimension arguments from command line (key=value format).
+ * @param dimensionArgs - Array of dimension strings in "key=value" format
+ * @returns Object mapping dimension keys to values
+ * @throws Error if any dimension is not in "key=value" format
+ */
+export function parseDimensions(dimensionArgs) {
+    const dimensions = {};
+    if (!dimensionArgs) {
+        return dimensions;
+    }
+    for (const arg of dimensionArgs) {
+        const eqIndex = arg.indexOf('=');
+        if (eqIndex === -1) {
+            throw new Error(`Invalid dimension format: "${arg}". Expected format: key=value`);
+        }
+        const key = arg.substring(0, eqIndex);
+        const value = arg.substring(eqIndex + 1);
+        dimensions[key] = value;
+    }
+    return dimensions;
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/utils/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/utils/dimensions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,aAAwB;IACtD,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,+BAA+B,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACzC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/utils/editor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get the user's preferred editor from environment variables.
+ * Follows the same convention as git: $VISUAL, then $EDITOR, then 'vi'.
+ */
+export declare function getEditor(): string;
+/**
+ * Open content in the user's editor and return the edited content.
+ *
+ * @param content - Initial content to edit
+ * @param filename - Optional filename hint for the temp file (for syntax highlighting)
+ * @returns The edited content, or null if the editor exited with an error
+ */
+export declare function openInEditor(content: string, filename?: string): string | null;
+//# sourceMappingURL=editor.d.ts.map

package/dist/utils/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/utils/editor.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,GAAG,IAAI,CAuCjF"}

package/dist/utils/editor.js

@@ -0,0 +1,56 @@
+import { spawnSync } from 'child_process';
+import { writeFileSync, readFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * Get the user's preferred editor from environment variables.
+ * Follows the same convention as git: $VISUAL, then $EDITOR, then 'vi'.
+ */
+export function getEditor() {
+    return process.env.VISUAL || process.env.EDITOR || 'vi';
+}
+const MAX_FILENAME_LENGTH = 100;
+/**
+ * Open content in the user's editor and return the edited content.
+ *
+ * @param content - Initial content to edit
+ * @param filename - Optional filename hint for the temp file (for syntax highlighting)
+ * @returns The edited content, or null if the editor exited with an error
+ */
+export function openInEditor(content, filename = 'edit.md') {
+    // Truncate filename to avoid ENAMETOOLONG errors
+    const safeName = filename.length > MAX_FILENAME_LENGTH
+        ? filename.slice(0, MAX_FILENAME_LENGTH - 3) + '.md'
+        : filename;
+    const tempPath = join(tmpdir(), `klaro-${Date.now()}-${safeName}`);
+    try {
+        // Write content to temp file
+        writeFileSync(tempPath, content, 'utf-8');
+        // Get editor command
+        const editor = getEditor();
+        // Spawn editor and wait for it to close
+        // Parse editor command to handle cases like "code --wait"
+        const parts = editor.split(/\s+/);
+        const cmd = parts[0];
+        const args = [...parts.slice(1), tempPath];
+        const result = spawnSync(cmd, args, {
+            stdio: 'inherit',
+        });
+        if (result.status !== 0) {
+            return null;
+        }
+        // Read edited content
+        const edited = readFileSync(tempPath, 'utf-8');
+        return edited;
+    }
+    finally {
+        // Clean up temp file
+        try {
+            unlinkSync(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/utils/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/utils/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAQ,GAAG,SAAS;IAChE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,mBAAmB;QACpD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,GAAG,CAAC,CAAC,GAAG,KAAK;QACpD,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,6BAA6B;QAC7B,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE1C,qBAAqB;QACrB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,wCAAwC;QACxC,0DAA0D;QAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sBAAsB;QACtB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,qBAAqB;QACrB,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Truncate a string to a maximum length, adding ellipsis if truncated.
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Format dimension values for display.
+ * Shows up to 6 IDs, with ellipsis if there are more.
+ * Filters out null IDs.
+ *
+ * @param values - Array of dimension values with id and optional label
+ * @returns Formatted string of IDs
+ */
+export declare function formatDimensionValues(values: Array<{
+    id: number | null;
+    label?: string;
+}> | undefined): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GAC/D,MAAM,CAOR"}

package/dist/utils/format.js

@@ -0,0 +1,27 @@
+/**
+ * Truncate a string to a maximum length, adding ellipsis if truncated.
+ */
+export function truncate(str, maxLength) {
+    if (maxLength < 4)
+        return str.slice(0, maxLength);
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - 1) + '…';
+}
+/**
+ * Format dimension values for display.
+ * Shows up to 6 IDs, with ellipsis if there are more.
+ * Filters out null IDs.
+ *
+ * @param values - Array of dimension values with id and optional label
+ * @returns Formatted string of IDs
+ */
+export function formatDimensionValues(values) {
+    if (!values || values.length === 0) {
+        return '';
+    }
+    const filtered = values.filter(v => v.id !== null);
+    const ids = filtered.slice(0, 6).map(v => v.id);
+    return filtered.length > 6 ? `${ids.join(', ')}, ...` : ids.join(', ');
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,SAAiB;IACrD,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAgE;IAEhE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/dist/utils/markdown.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Render markdown text with terminal formatting (colors, styles).
+ */
+export declare function renderMarkdown(text: string): string;
+/**
+ * Extract YAML frontmatter from markdown content.
+ *
+ * @param markdown - Markdown content that may contain frontmatter
+ * @returns Object with frontmatter (including delimiters) and content
+ */
+export declare function extractFrontmatter(markdown: string): {
+    frontmatter: string;
+    content: string;
+};
+/**
+ * Render markdown with terminal formatting, preserving YAML frontmatter as-is.
+ * Frontmatter is not rendered as markdown but preserved verbatim.
+ *
+ * @param markdown - Markdown content that may contain frontmatter
+ * @param raw - If true, return markdown unchanged
+ * @returns Formatted string with frontmatter preserved
+ */
+export declare function renderMarkdownWithFrontmatter(markdown: string, raw: boolean): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAc7F;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAYpF"}

package/dist/utils/markdown.js

@@ -0,0 +1,50 @@
+import { marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+// Configure marked with terminal renderer
+// Type assertion needed due to outdated @types/marked-terminal
+marked.use(markedTerminal());
+/**
+ * Render markdown text with terminal formatting (colors, styles).
+ */
+export function renderMarkdown(text) {
+    return marked.parse(text);
+}
+/**
+ * Extract YAML frontmatter from markdown content.
+ *
+ * @param markdown - Markdown content that may contain frontmatter
+ * @returns Object with frontmatter (including delimiters) and content
+ */
+export function extractFrontmatter(markdown) {
+    if (!markdown.startsWith('---')) {
+        return { frontmatter: '', content: markdown };
+    }
+    const endIndex = markdown.indexOf('---', 3);
+    if (endIndex === -1) {
+        return { frontmatter: '', content: markdown };
+    }
+    return {
+        frontmatter: markdown.slice(0, endIndex + 3),
+        content: markdown.slice(endIndex + 3).trim(),
+    };
+}
+/**
+ * Render markdown with terminal formatting, preserving YAML frontmatter as-is.
+ * Frontmatter is not rendered as markdown but preserved verbatim.
+ *
+ * @param markdown - Markdown content that may contain frontmatter
+ * @param raw - If true, return markdown unchanged
+ * @returns Formatted string with frontmatter preserved
+ */
+export function renderMarkdownWithFrontmatter(markdown, raw) {
+    if (raw) {
+        return markdown;
+    }
+    const { frontmatter, content } = extractFrontmatter(markdown);
+    const renderedContent = renderMarkdown(content);
+    if (frontmatter) {
+        return frontmatter + '\n\n' + renderedContent;
+    }
+    return renderedContent;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/utils/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,0CAA0C;AAC1C,+DAA+D;AAC/D,MAAM,CAAC,GAAG,CAAC,cAAc,EAAgC,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC;QAC5C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAgB,EAAE,GAAY;IAC1E,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC;IAChD,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/utils/objects.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deep merge two objects recursively.
+ * Properties from source override properties in target.
+ * Nested objects are merged recursively.
+ * Arrays and non-object values are replaced, not merged.
+ *
+ * @param target - Base object to merge into
+ * @param source - Object with values to merge from
+ * @returns New merged object
+ */
+export declare function deepMerge<T extends object>(target: T, source: Partial<T>): T;
+//# sourceMappingURL=objects.d.ts.map

package/dist/utils/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/utils/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAuB5E"}

package/dist/utils/objects.js

@@ -0,0 +1,31 @@
+/**
+ * Deep merge two objects recursively.
+ * Properties from source override properties in target.
+ * Nested objects are merged recursively.
+ * Arrays and non-object values are replaced, not merged.
+ *
+ * @param target - Base object to merge into
+ * @param source - Object with values to merge from
+ * @returns New merged object
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = result[key];
+        if (sourceValue !== undefined &&
+            typeof sourceValue === 'object' &&
+            sourceValue !== null &&
+            !Array.isArray(sourceValue) &&
+            typeof targetValue === 'object' &&
+            targetValue !== null &&
+            !Array.isArray(targetValue)) {
+            result[key] = deepMerge(targetValue, sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=objects.js.map

package/dist/utils/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/utils/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAmB,MAAS,EAAE,MAAkB;IACvE,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAO,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IACE,WAAW,KAAK,SAAS;YACzB,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI;YACpB,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI;YACpB,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAqB,EACrB,WAAqB,CACR,CAAC;QAClB,CAAC;aAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAyB,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/slugify.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert a string to a URL-friendly slug.
+ * - Removes accents (normalizes to NFD and strips diacritics)
+ * - Converts to lowercase
+ * - Replaces spaces and special characters with dashes
+ * - Collapses multiple dashes
+ * - Trims leading/trailing dashes
+ */
+export declare function slugify(text: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/utils/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C"}

package/dist/utils/slugify.js

@@ -0,0 +1,18 @@
+/**
+ * Convert a string to a URL-friendly slug.
+ * - Removes accents (normalizes to NFD and strips diacritics)
+ * - Converts to lowercase
+ * - Replaces spaces and special characters with dashes
+ * - Collapses multiple dashes
+ * - Trims leading/trailing dashes
+ */
+export function slugify(text) {
+    return text
+        .normalize('NFD') // Decompose accents (é -> e + ́)
+        .replace(/[\u0300-\u036f]/g, '') // Remove diacritics
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with dashes
+        .replace(/^-+|-+$/g, '') // Trim leading/trailing dashes
+        .replace(/-+/g, '-'); // Collapse multiple dashes
+}
+//# sourceMappingURL=slugify.js.map

package/dist/utils/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,SAAS,CAAC,KAAK,CAAC,CAAoB,iCAAiC;SACrE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAK,oBAAoB;SACxD,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAS,uCAAuC;SAC3E,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAa,+BAA+B;SACnE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAgB,2BAA2B;AACpE,CAAC"}

package/dist/utils/story-editor.d.ts

@@ -0,0 +1,15 @@
+import type { Story, UpdateStoryInput } from '../lib/types.js';
+export interface EditStoryResult {
+    changed: boolean;
+    update?: UpdateStoryInput;
+    error?: string;
+}
+/**
+ * Open a story in the editor and return the parsed changes.
+ *
+ * @param story - The story to edit
+ * @param dimensions - Optional dimensions to include in YAML frontmatter
+ * @returns Result object with changed flag, update data, or error
+ */
+export declare function editStoryInEditor(story: Story, dimensions?: string[]): EditStoryResult;
+//# sourceMappingURL=story-editor.d.ts.map

package/dist/utils/story-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-editor.d.ts","sourceRoot":"","sources":["../../src/utils/story-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAK/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,eAAe,CAiCtF"}

package/dist/utils/story-editor.js

@@ -0,0 +1,43 @@
+import { formatStoryMarkdown, parseStoryMarkdown } from './story-markdown.js';
+import { openInEditor } from './editor.js';
+import { slugify } from './slugify.js';
+/**
+ * Open a story in the editor and return the parsed changes.
+ *
+ * @param story - The story to edit
+ * @param dimensions - Optional dimensions to include in YAML frontmatter
+ * @returns Result object with changed flag, update data, or error
+ */
+export function editStoryInEditor(story, dimensions) {
+    const markdown = formatStoryMarkdown(story, dimensions);
+    const filename = `${story.identifier}-${slugify(story.title)}.md`;
+    const edited = openInEditor(markdown, filename);
+    if (edited === null) {
+        return { changed: false, error: 'Editor exited with an error' };
+    }
+    if (edited.trim() === markdown.trim()) {
+        return { changed: false };
+    }
+    try {
+        const parsed = parseStoryMarkdown(edited);
+        const update = {
+            identifier: parseInt(story.identifier, 10),
+            title: parsed.title,
+            specification: parsed.specification ?? '',
+        };
+        // Add dimensions if present
+        if (parsed.dimensions) {
+            for (const [key, value] of Object.entries(parsed.dimensions)) {
+                if (typeof value === 'string' || typeof value === 'number') {
+                    update[key] = value;
+                }
+            }
+        }
+        return { changed: true, update };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to parse edited content';
+        return { changed: false, error: message };
+    }
+}
+//# sourceMappingURL=story-editor.js.map

package/dist/utils/story-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-editor.js","sourceRoot":"","sources":["../../src/utils/story-editor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,UAAqB;IACnE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEhD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAqB;YAC/B,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;SAC1C,CAAC;QACF,4BAA4B;QAC5B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC3D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAAC;QAC1F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/utils/story-markdown.d.ts

@@ -0,0 +1,36 @@
+import type { Story } from '../lib/types.js';
+export interface ParsedStory {
+    title: string;
+    specification?: string;
+    dimensions?: Record<string, unknown>;
+}
+/**
+ * Format a story as markdown output.
+ *
+ * - toptitle: first line of the title
+ * - summary: remaining lines of the title (if any)
+ * - description: the specification field
+ * - dimensions: optional array of dimension names to include as YAML frontmatter
+ */
+export declare function formatStoryMarkdown(story: Story, dimensions?: string[]): string;
+/**
+ * Parse markdown back into story fields.
+ *
+ * Format expected:
+ * ```
+ * ---
+ * dimension: value
+ * ---
+ *
+ * # toptitle
+ *
+ * [summary - optional]
+ *
+ * [description - optional]
+ * ```
+ *
+ * If two content blocks exist (separated by blank line), first is summary, second is description.
+ * If only one content block exists, it's treated as description.
+ */
+export declare function parseStoryMarkdown(markdown: string): ParsedStory;
+//# sourceMappingURL=story-markdown.d.ts.map

package/dist/utils/story-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-markdown.d.ts","sourceRoot":"","sources":["../../src/utils/story-markdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAwC/E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA4DhE"}