@miethe/ui 0.2.0

package/dist/utils/frontmatter.js

@@ -0,0 +1,345 @@
+/**
+ * Frontmatter parsing utility for YAML frontmatter in markdown files.
+ *
+ * Handles detection, parsing, and stripping of YAML frontmatter blocks
+ * delimited by `---` markers at the start of content.
+ *
+ * NOTE: This implementation uses a simple YAML parser for common cases.
+ * For production use with complex YAML, consider adding `yaml` or `js-yaml` package.
+ */
+/** Regex pattern to detect and capture frontmatter */
+const FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+/**
+ * Detects whether content contains YAML frontmatter.
+ *
+ * Frontmatter must start at the beginning of the content with `---`
+ * followed by a newline, and end with `---` followed by a newline.
+ *
+ * @param content - The string content to check
+ * @returns true if frontmatter is present, false otherwise
+ *
+ * @example
+ * ```ts
+ * detectFrontmatter('---\ntitle: Hello\n---\nContent'); // true
+ * detectFrontmatter('# Just markdown'); // false
+ * detectFrontmatter(''); // false
+ * ```
+ */
+export function detectFrontmatter(content) {
+    if (!content || typeof content !== 'string') {
+        return false;
+    }
+    return FRONTMATTER_REGEX.test(content);
+}
+/**
+ * Parses YAML frontmatter from content.
+ *
+ * Extracts the YAML block and returns both the parsed frontmatter object
+ * and the remaining content with frontmatter stripped.
+ *
+ * @param content - The string content to parse
+ * @returns Object containing frontmatter (null if invalid/missing) and clean content
+ *
+ * @example
+ * ```ts
+ * const result = parseFrontmatter('---\ntitle: Hello\nauthor: World\n---\nContent here');
+ * // result.frontmatter = { title: 'Hello', author: 'World' }
+ * // result.content = 'Content here'
+ * ```
+ */
+export function parseFrontmatter(content) {
+    if (!content || typeof content !== 'string') {
+        return { frontmatter: null, content: content || '' };
+    }
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return { frontmatter: null, content };
+    }
+    const yamlContent = match[1] ?? '';
+    const cleanContent = content.slice(match[0].length);
+    try {
+        const frontmatter = parseYaml(yamlContent);
+        return { frontmatter, content: cleanContent };
+    }
+    catch (error) {
+        console.warn('[frontmatter] Failed to parse YAML frontmatter:', error instanceof Error ? error.message : String(error));
+        return { frontmatter: null, content: cleanContent };
+    }
+}
+/**
+ * Strips frontmatter from content, returning only the body.
+ *
+ * This is a convenience function when you only need the content
+ * without the frontmatter metadata.
+ *
+ * @param content - The string content to process
+ * @returns Content with frontmatter removed
+ *
+ * @example
+ * ```ts
+ * stripFrontmatter('---\ntitle: Hello\n---\nContent'); // 'Content'
+ * stripFrontmatter('No frontmatter'); // 'No frontmatter'
+ * ```
+ */
+export function stripFrontmatter(content) {
+    if (!content || typeof content !== 'string') {
+        return content || '';
+    }
+    return content.replace(FRONTMATTER_REGEX, '');
+}
+/**
+ * Simple YAML parser for frontmatter.
+ *
+ * Handles common frontmatter patterns:
+ * - Key-value pairs (string, number, boolean, null)
+ * - Arrays (inline [...] and block - item format)
+ * - Nested objects (indentation-based)
+ * - Quoted strings (single and double)
+ * - Multi-line strings (limited support)
+ *
+ * @internal
+ * @param yaml - Raw YAML string to parse
+ * @returns Parsed object
+ * @throws Error if YAML is malformed
+ */
+function parseYaml(yaml) {
+    if (!yaml.trim()) {
+        return {};
+    }
+    const result = {};
+    const lines = yaml.split(/\r?\n/);
+    const stack = [
+        { obj: result, indent: -1 },
+    ];
+    let currentArrayKey = null;
+    let currentArrayIndent = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip empty lines and comments (line is always defined in this loop)
+        if (!line || !line.trim() || line.trim().startsWith('#')) {
+            continue;
+        }
+        const indent = line.search(/\S/);
+        const trimmedLine = line.trim();
+        // Handle array items (- value)
+        if (trimmedLine.startsWith('- ')) {
+            if (currentArrayKey && indent > currentArrayIndent) {
+                const arrayValue = trimmedLine.slice(2).trim();
+                const currentFrame = stack[stack.length - 1];
+                if (currentFrame) {
+                    const arr = currentFrame.obj[currentArrayKey];
+                    arr.push(parseValue(arrayValue));
+                }
+                continue;
+            }
+        }
+        // Reset array context if indent changes
+        if (indent <= currentArrayIndent) {
+            currentArrayKey = null;
+            currentArrayIndent = -1;
+        }
+        // Pop stack for decreased indent
+        while (stack.length > 1) {
+            const topFrame = stack[stack.length - 1];
+            if (!topFrame || indent > topFrame.indent)
+                break;
+            stack.pop();
+        }
+        // Parse key-value pair
+        const colonIndex = trimmedLine.indexOf(':');
+        if (colonIndex === -1) {
+            continue;
+        }
+        const key = trimmedLine.slice(0, colonIndex).trim();
+        const rawValue = trimmedLine.slice(colonIndex + 1).trim();
+        if (!key) {
+            continue;
+        }
+        const targetFrame = stack[stack.length - 1];
+        if (!targetFrame) {
+            continue;
+        }
+        const target = targetFrame.obj;
+        if (rawValue === '') {
+            // Check if next line starts an array or nested object
+            const nextLine = lines[i + 1];
+            if (nextLine && nextLine.trim().startsWith('- ')) {
+                // Array starting on next line
+                target[key] = [];
+                currentArrayKey = key;
+                currentArrayIndent = indent;
+            }
+            else if (nextLine) {
+                const nextIndent = nextLine.search(/\S/);
+                if (nextIndent > indent && nextLine.includes(':')) {
+                    // Nested object
+                    const nested = {};
+                    target[key] = nested;
+                    stack.push({ obj: nested, indent });
+                }
+                else {
+                    target[key] = null;
+                }
+            }
+            else {
+                target[key] = null;
+            }
+        }
+        else if (rawValue.startsWith('[') && rawValue.endsWith(']')) {
+            // Inline array
+            target[key] = parseInlineArray(rawValue);
+        }
+        else if (rawValue.startsWith('{') && rawValue.endsWith('}')) {
+            // Inline object
+            target[key] = parseInlineObject(rawValue);
+        }
+        else {
+            target[key] = parseValue(rawValue);
+        }
+    }
+    return result;
+}
+/**
+ * Parse a single YAML value.
+ * @internal
+ */
+function parseValue(value) {
+    if (!value) {
+        return null;
+    }
+    // Handle quoted strings
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Handle booleans
+    const lowerValue = value.toLowerCase();
+    if (lowerValue === 'true' || lowerValue === 'yes' || lowerValue === 'on') {
+        return true;
+    }
+    if (lowerValue === 'false' || lowerValue === 'no' || lowerValue === 'off') {
+        return false;
+    }
+    // Handle null
+    if (lowerValue === 'null' || lowerValue === '~') {
+        return null;
+    }
+    // Handle numbers
+    if (/^-?\d+$/.test(value)) {
+        return parseInt(value, 10);
+    }
+    if (/^-?\d+\.\d+$/.test(value)) {
+        return parseFloat(value);
+    }
+    // Handle ISO date strings (keep as string for now)
+    // Return as-is string
+    return value;
+}
+/**
+ * Parse inline YAML array: [item1, item2, item3]
+ * @internal
+ */
+function parseInlineArray(value) {
+    const inner = value.slice(1, -1).trim();
+    if (!inner) {
+        return [];
+    }
+    const items = [];
+    let current = '';
+    let depth = 0;
+    let inQuote = null;
+    for (let i = 0; i < inner.length; i++) {
+        const char = inner[i];
+        if (inQuote) {
+            current += char;
+            if (char === inQuote && inner[i - 1] !== '\\') {
+                inQuote = null;
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            inQuote = char;
+            current += char;
+            continue;
+        }
+        if (char === '[' || char === '{') {
+            depth++;
+            current += char;
+            continue;
+        }
+        if (char === ']' || char === '}') {
+            depth--;
+            current += char;
+            continue;
+        }
+        if (char === ',' && depth === 0) {
+            items.push(parseValue(current.trim()));
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        items.push(parseValue(current.trim()));
+    }
+    return items;
+}
+/**
+ * Parse inline YAML object: {key1: value1, key2: value2}
+ * @internal
+ */
+function parseInlineObject(value) {
+    const inner = value.slice(1, -1).trim();
+    if (!inner) {
+        return {};
+    }
+    const result = {};
+    let current = '';
+    let depth = 0;
+    let inQuote = null;
+    const pairs = [];
+    for (let i = 0; i < inner.length; i++) {
+        const char = inner[i];
+        if (inQuote) {
+            current += char;
+            if (char === inQuote && inner[i - 1] !== '\\') {
+                inQuote = null;
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            inQuote = char;
+            current += char;
+            continue;
+        }
+        if (char === '[' || char === '{') {
+            depth++;
+            current += char;
+            continue;
+        }
+        if (char === ']' || char === '}') {
+            depth--;
+            current += char;
+            continue;
+        }
+        if (char === ',' && depth === 0) {
+            pairs.push(current.trim());
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        pairs.push(current.trim());
+    }
+    for (const pair of pairs) {
+        const colonIndex = pair.indexOf(':');
+        if (colonIndex !== -1) {
+            const key = pair.slice(0, colonIndex).trim();
+            const val = pair.slice(colonIndex + 1).trim();
+            result[key] = parseValue(val);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export { parseFrontmatter, stripFrontmatter, detectFrontmatter, } from './frontmatter';
+export { extractFirstParagraph, extractFolderReadme, } from './readme-utils';
+export type { ReadmeSearchEntry } from './readme-utils';
+export { markStart, markEnd } from './perf-marks';
+export { typeBarColors, TYPE_BAR_FALLBACK, getTypeBarColor, artifactTypeCardTints, getCardTint, } from './type-colors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+// @miethe/ui — utils submodule
+export { parseFrontmatter, stripFrontmatter, detectFrontmatter, } from './frontmatter';
+export { extractFirstParagraph, extractFolderReadme, } from './readme-utils';
+export { markStart, markEnd } from './perf-marks';
+export { typeBarColors, TYPE_BAR_FALLBACK, getTypeBarColor, artifactTypeCardTints, getCardTint, } from './type-colors';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/utils/perf-marks.d.ts

@@ -0,0 +1,28 @@
+/**
+ * perf-marks.ts
+ *
+ * Lightweight Performance API wrappers for instrumenting content-viewer
+ * render flows. Marks are visible in browser DevTools → Performance panel traces.
+ *
+ * All marks share the configurable prefix so they can be filtered as a
+ * group in the DevTools User Timings lane.
+ *
+ * Usage:
+ *   markStart('diff-viewer.render');
+ *   // ... work ...
+ *   markEnd('diff-viewer.render');
+ */
+/**
+ * Place a start mark.
+ * @param name  Logical name for the measurement (no prefix or suffix needed).
+ */
+export declare function markStart(name: string): void;
+/**
+ * Place an end mark and record a measure between the matching start mark and
+ * this end mark. If the start mark doesn't exist (e.g. the component mounted
+ * before instrumentation was added) the measure call is silently skipped.
+ *
+ * @param name  Must match the name used in the corresponding markStart call.
+ */
+export declare function markEnd(name: string): void;
+//# sourceMappingURL=perf-marks.d.ts.map

package/dist/utils/perf-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-marks.d.ts","sourceRoot":"","sources":["../../src/utils/perf-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAU1C"}

package/dist/utils/perf-marks.js

@@ -0,0 +1,45 @@
+/**
+ * perf-marks.ts
+ *
+ * Lightweight Performance API wrappers for instrumenting content-viewer
+ * render flows. Marks are visible in browser DevTools → Performance panel traces.
+ *
+ * All marks share the configurable prefix so they can be filtered as a
+ * group in the DevTools User Timings lane.
+ *
+ * Usage:
+ *   markStart('diff-viewer.render');
+ *   // ... work ...
+ *   markEnd('diff-viewer.render');
+ */
+const PREFIX = 'content-viewer';
+/**
+ * Place a start mark.
+ * @param name  Logical name for the measurement (no prefix or suffix needed).
+ */
+export function markStart(name) {
+    if (typeof performance !== 'undefined') {
+        performance.mark(`${PREFIX}.${name}.start`);
+    }
+}
+/**
+ * Place an end mark and record a measure between the matching start mark and
+ * this end mark. If the start mark doesn't exist (e.g. the component mounted
+ * before instrumentation was added) the measure call is silently skipped.
+ *
+ * @param name  Must match the name used in the corresponding markStart call.
+ */
+export function markEnd(name) {
+    if (typeof performance === 'undefined')
+        return;
+    const startMark = `${PREFIX}.${name}.start`;
+    const endMark = `${PREFIX}.${name}.end`;
+    performance.mark(endMark);
+    try {
+        performance.measure(`${PREFIX}.${name}`, startMark, endMark);
+    }
+    catch {
+        // Start mark may not exist if component mounted before instrumentation
+    }
+}
+//# sourceMappingURL=perf-marks.js.map

package/dist/utils/perf-marks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-marks.js","sourceRoot":"","sources":["../../src/utils/perf-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,QAAQ,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,OAAO,WAAW,KAAK,WAAW;QAAE,OAAO;IAC/C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,IAAI,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,IAAI,MAAM,CAAC;IACxC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC"}

package/dist/utils/readme-utils.d.ts

@@ -0,0 +1,67 @@
+/**
+ * README and first-paragraph extraction utilities for markdown content.
+ *
+ * These utilities are generic and work with any entry type that has a `path`
+ * field and optionally `content` and `metadata` fields. The `CatalogEntry`
+ * type from SkillMeat structurally satisfies `ReadmeSearchEntry`, so no
+ * call-site changes are required in the main app.
+ */
+/**
+ * Duck-typed interface for entries that can be searched for a README file.
+ *
+ * Only the fields actually accessed by `extractFolderReadme` are required.
+ * Any object with at least a `path` string field satisfies this interface,
+ * including SkillMeat's `CatalogEntry`.
+ */
+export interface ReadmeSearchEntry {
+    /** File path for this entry (forward or backward slash separators accepted) */
+    path: string;
+    /** Optional raw file content — used to extract the first paragraph */
+    content?: string;
+    /** Optional metadata object — checked for a `description` fallback */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Extract README content from folder artifacts.
+ *
+ * Looks for README.md or readme.md files in the folder's direct artifacts
+ * and extracts a summary (first paragraph or summary section).
+ *
+ * @param folderPath - The folder path to find README for
+ * @param entries - All catalog entries to search
+ * @returns Extracted summary string or null if no README found
+ *
+ * @example
+ * ```ts
+ * const readme = extractFolderReadme('plugins/dev-tools', catalogEntries);
+ * // Returns: "A collection of development tools for..."
+ * ```
+ */
+export declare function extractFolderReadme(folderPath: string, entries: ReadmeSearchEntry[]): string | null;
+/**
+ * Extract the first meaningful paragraph from markdown content.
+ *
+ * Skips headings, empty lines, and frontmatter.
+ * Returns first paragraph of at least 20 characters.
+ * Truncates at 300 characters with ellipsis if longer.
+ *
+ * @param content - Raw markdown content
+ * @returns First paragraph or null if none found
+ *
+ * @example
+ * ```ts
+ * const markdown = `---
+ * title: My Doc
+ * ---
+ * # Heading
+ *
+ * This is the first paragraph with meaningful content.
+ *
+ * This is the second paragraph.
+ * `;
+ * const paragraph = extractFirstParagraph(markdown);
+ * // Returns: "This is the first paragraph with meaningful content."
+ * ```
+ */
+export declare function extractFirstParagraph(content: string): string | null;
+//# sourceMappingURL=readme-utils.d.ts.map

package/dist/utils/readme-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-utils.d.ts","sourceRoot":"","sources":["../../src/utils/readme-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,GAAG,IAAI,CA4Df;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiFpE"}