@miethe/ui 0.2.0 → 0.6.0

package/dist/components/content-viewer/callouts/Callout.js

@@ -0,0 +1,86 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../../primitives/utils';
+// ============================================================================
+// Icon labels (text-based; icon library optional in P2)
+// ============================================================================
+const TYPE_CONFIG = {
+    note: {
+        label: 'Note',
+        borderClass: 'border-l-blue-400',
+        bgClass: 'bg-blue-50 dark:bg-blue-950/30',
+        labelClass: 'text-blue-700 dark:text-blue-300',
+        role: 'note',
+    },
+    reference: {
+        label: 'Reference',
+        borderClass: 'border-l-purple-400',
+        bgClass: 'bg-purple-50 dark:bg-purple-950/30',
+        labelClass: 'text-purple-700 dark:text-purple-300',
+        role: 'complementary',
+    },
+    warning: {
+        label: 'Warning',
+        borderClass: 'border-l-amber-400',
+        bgClass: 'bg-amber-50 dark:bg-amber-950/30',
+        labelClass: 'text-amber-700 dark:text-amber-300',
+        role: 'alert',
+    },
+    info: {
+        label: 'Info',
+        borderClass: 'border-l-teal-400',
+        bgClass: 'bg-teal-50 dark:bg-teal-950/30',
+        labelClass: 'text-teal-700 dark:text-teal-300',
+        role: 'note',
+    },
+};
+// ============================================================================
+// Base Callout component
+// ============================================================================
+/**
+ * Base callout renderer used by all type-specific variants.
+ * Accepts an explicit `type` prop for cases where the component is used
+ * without a type-specific wrapper.
+ */
+export function Callout({ type, children, className }) {
+    const config = TYPE_CONFIG[type] ?? TYPE_CONFIG.note;
+    return (_jsxs("aside", { role: config.role, "aria-label": `${config.label} callout`, "data-callout-type": type, className: cn(
+        // Base layout
+        'my-4 rounded-r-md border-l-4 px-4 py-3', 
+        // Type-specific accent
+        config.borderClass, config.bgClass, 
+        // CSS variable hooks (override in consumer stylesheet)
+        '[border-left-color:var(--callout-border-color,inherit)]', '[background-color:var(--callout-bg-color,inherit)]', className), children: [_jsx("p", { className: cn('mb-1 text-xs font-semibold uppercase tracking-wider', config.labelClass, '[color:var(--callout-label-color,inherit)]'), "aria-hidden": "true", children: config.label }), _jsx("div", { className: "text-sm text-foreground [&>*:last-child]:mb-0 [&>p]:mb-2", children: children })] }));
+}
+// ============================================================================
+// Type-specific convenience components
+// ============================================================================
+/**
+ * Note callout — informational content that supplements the main text.
+ * @example `::: note\n...\n:::`
+ */
+export function NoteCallout({ children, className }) {
+    return (_jsx(Callout, { type: "note", className: className, children: children }));
+}
+/**
+ * Reference callout — citations, sources, or cross-references.
+ * @example `::: reference\n...\n:::`
+ */
+export function ReferenceCallout({ children, className }) {
+    return (_jsx(Callout, { type: "reference", className: className, children: children }));
+}
+/**
+ * Warning callout — potentially destructive or dangerous information.
+ * @example `::: warning\n...\n:::`
+ */
+export function WarningCallout({ children, className }) {
+    return (_jsx(Callout, { type: "warning", className: className, children: children }));
+}
+/**
+ * Info callout — supplementary information or tips.
+ * @example `::: info\n...\n:::`
+ */
+export function InfoCallout({ children, className }) {
+    return (_jsx(Callout, { type: "info", className: className, children: children }));
+}
+//# sourceMappingURL=Callout.js.map

package/dist/components/content-viewer/callouts/Callout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Callout.js","sourceRoot":"","sources":["../../../../src/components/content-viewer/callouts/Callout.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAmBb,OAAO,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AAE/C,+EAA+E;AAC/E,wDAAwD;AACxD,+EAA+E;AAE/E,MAAM,WAAW,GAab;IACF,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,gCAAgC;QACzC,UAAU,EAAE,kCAAkC;QAC9C,IAAI,EAAE,MAAM;KACb;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,oCAAoC;QAC7C,UAAU,EAAE,sCAAsC;QAClD,IAAI,EAAE,eAAe;KACtB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,kCAAkC;QAC3C,UAAU,EAAE,oCAAoC;QAChD,IAAI,EAAE,OAAO;KACd;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,gCAAgC;QACzC,UAAU,EAAE,kCAAkC;QAC9C,IAAI,EAAE,MAAM;KACb;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAgB;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAErD,OAAO,CACL,iBACE,IAAI,EAAE,MAAM,CAAC,IAAI,gBACL,GAAG,MAAM,CAAC,KAAK,UAAU,uBAClB,IAAI,EACvB,SAAS,EAAE,EAAE;QACX,cAAc;QACd,wCAAwC;QACxC,uBAAuB;QACvB,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,OAAO;QACd,uDAAuD;QACvD,yDAAyD,EACzD,oDAAoD,EACpD,SAAS,CACV,aAGD,YACE,SAAS,EAAE,EAAE,CACX,qDAAqD,EACrD,MAAM,CAAC,UAAU,EACjB,4CAA4C,CAC7C,iBACW,MAAM,YAEjB,MAAM,CAAC,KAAK,GACX,EAEJ,cAAK,SAAS,EAAC,0DAA0D,YACtE,QAAQ,GACL,IACA,CACT,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAA8B;IAC7E,OAAO,CACL,KAAC,OAAO,IAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAE,SAAS,YACtC,QAAQ,GACD,CACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAA8B;IAClF,OAAO,CACL,KAAC,OAAO,IAAC,IAAI,EAAC,WAAW,EAAC,SAAS,EAAE,SAAS,YAC3C,QAAQ,GACD,CACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAA8B;IAChF,OAAO,CACL,KAAC,OAAO,IAAC,IAAI,EAAC,SAAS,EAAC,SAAS,EAAE,SAAS,YACzC,QAAQ,GACD,CACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAA8B;IAC7E,OAAO,CACL,KAAC,OAAO,IAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAE,SAAS,YACtC,QAAQ,GACD,CACX,CAAC;AACJ,CAAC"}

package/dist/components/content-viewer/callouts/index.d.ts

@@ -0,0 +1,2 @@
+export { Callout, NoteCallout, ReferenceCallout, WarningCallout, InfoCallout, } from './Callout';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/content-viewer/callouts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/content-viewer/callouts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/components/content-viewer/callouts/index.js

@@ -0,0 +1,2 @@
+export { Callout, NoteCallout, ReferenceCallout, WarningCallout, InfoCallout, } from './Callout';
+//# sourceMappingURL=index.js.map

package/dist/components/content-viewer/callouts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/content-viewer/callouts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/components/content-viewer/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @miethe/ui — content-viewer component submodule
+ *
+ * Exports ArticleViewer + default callout components + frontmatter utilities.
+ * Import via:
+ *   import { ArticleViewer } from '@miethe/ui';
+ *   import { ArticleViewer } from '@miethe/ui/content-viewer';  // submodule path
+ */
+export { ArticleViewer } from './ArticleViewer';
+export { default as ArticleViewerDefault } from './ArticleViewer';
+export { Callout, NoteCallout, ReferenceCallout, WarningCallout, InfoCallout } from './callouts';
+export { FrontmatterHeader } from './FrontmatterHeader';
+export { remarkCallouts, CALLOUT_TYPES } from './plugins';
+export { rehypeExternalLinks, isExternalHref } from './plugins/rehypeExternalLinks';
+export { createHighlightPlugin, warmHighlightCache } from './plugins/rehypeCodeHighlight';
+export { createHeadingIdsPlugin, slugify } from './plugins/rehypeHeadingIds';
+export { sanitizeWithRehype, sanitizeWithDOMPurify, warmDOMPurifyCache, ARTICLE_VIEWER_SCHEMA } from './sanitize';
+export { detectFormat } from './ArticleViewer';
+export { VARIANT_CLASSES, getVariantTokenNames, variantClass } from './variants';
+export type { ArticleViewerProps, ArticleViewerComponents, CalloutProps, CalloutType, CalloutComponents, ContentFormat, ArticleVariant, VariantTokenShape, FrontmatterDisplayMode, FrontmatterData, FrontmatterHeaderProps, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/content-viewer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/content-viewer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGlH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGjF,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/components/content-viewer/index.js

@@ -0,0 +1,29 @@
+/**
+ * @miethe/ui — content-viewer component submodule
+ *
+ * Exports ArticleViewer + default callout components + frontmatter utilities.
+ * Import via:
+ *   import { ArticleViewer } from '@miethe/ui';
+ *   import { ArticleViewer } from '@miethe/ui/content-viewer';  // submodule path
+ */
+// Main component
+export { ArticleViewer } from './ArticleViewer';
+export { default as ArticleViewerDefault } from './ArticleViewer';
+// Callout components
+export { Callout, NoteCallout, ReferenceCallout, WarningCallout, InfoCallout } from './callouts';
+// FrontmatterHeader (PU2-02)
+export { FrontmatterHeader } from './FrontmatterHeader';
+// Plugins (exported for testing and advanced composition)
+export { remarkCallouts, CALLOUT_TYPES } from './plugins';
+export { rehypeExternalLinks, isExternalHref } from './plugins/rehypeExternalLinks';
+// Code highlighting helpers (PU4-01) — import these to warm the highlight cache at app startup
+export { createHighlightPlugin, warmHighlightCache } from './plugins/rehypeCodeHighlight';
+// Heading ID plugin (PU4-04 / A-UCV-08)
+export { createHeadingIdsPlugin, slugify } from './plugins/rehypeHeadingIds';
+// Sanitization utilities (PU3-02 / PU3-03)
+export { sanitizeWithRehype, sanitizeWithDOMPurify, warmDOMPurifyCache, ARTICLE_VIEWER_SCHEMA } from './sanitize';
+// Format detection utility (PU3-01) — also re-exported from ArticleViewer
+export { detectFormat } from './ArticleViewer';
+// Variant utilities (PU2-05)
+export { VARIANT_CLASSES, getVariantTokenNames, variantClass } from './variants';
+//# sourceMappingURL=index.js.map

package/dist/components/content-viewer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/content-viewer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAElE,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjG,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,0DAA0D;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpF,+FAA+F;AAC/F,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,wCAAwC;AACxC,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE7E,2CAA2C;AAC3C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAElH,0EAA0E;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/content-viewer/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export { default as remarkCallouts, CALLOUT_TYPES } from './remarkCallouts';
+export { rehypeExternalLinks, isExternalHref } from './rehypeExternalLinks';
+export { createHighlightPlugin, warmHighlightCache, _resetHighlightCache } from './rehypeCodeHighlight';
+export { createHeadingIdsPlugin, slugify } from './rehypeHeadingIds';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/content-viewer/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/content-viewer/plugins/index.js

@@ -0,0 +1,5 @@
+export { default as remarkCallouts, CALLOUT_TYPES } from './remarkCallouts';
+export { rehypeExternalLinks, isExternalHref } from './rehypeExternalLinks';
+export { createHighlightPlugin, warmHighlightCache, _resetHighlightCache } from './rehypeCodeHighlight';
+export { createHeadingIdsPlugin, slugify } from './rehypeHeadingIds';
+//# sourceMappingURL=index.js.map

package/dist/components/content-viewer/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/content-viewer/plugins/lowlightLoader.d.ts

@@ -0,0 +1,63 @@
+/**
+ * lowlightLoader — shared, dependency-light lowlight loader for code highlighting.
+ *
+ * This module owns the single lowlight instance + load state used by BOTH:
+ *  - `rehypeCodeHighlight.ts` (markdown fenced-code highlighting via a rehype plugin), and
+ *  - `ContentPane`'s `HighlightedDisplay` (raw code-file highlighting, via `highlightCodeToHast`).
+ *
+ * It is intentionally free of `unist-util-visit` (and any other static ESM-only
+ * dependency) so that importing it from a Client Component (ContentPane) does NOT
+ * drag the rehype/unist graph into that module's bundle — or into Jest's module
+ * loader (which does not transform `unist-util-visit`'s ESM).
+ *
+ * `lowlight` itself remains an optional peer dep: it is loaded via dynamic
+ * `import()` and the loader degrades gracefully to plain text when it is absent.
+ * Consumers that want highlighting install lowlight separately (`npm install lowlight`).
+ *
+ * @module lowlightLoader
+ */
+import type { Root } from 'hast';
+/**
+ * Minimal lowlight API surface we rely on.
+ * Defined locally to avoid needing @types/lowlight installed.
+ */
+export interface LowlightAPI {
+    highlight(language: string, code: string): {
+        children: unknown[];
+    };
+    highlightAuto(code: string): {
+        children: unknown[];
+    };
+    listLanguages(): string[];
+}
+/**
+ * Return the currently-cached lowlight instance synchronously (or null).
+ * Used by the rehype plugin's synchronous transformer, which reads from the
+ * already-populated cache. Call {@link warmHighlightCache} first to populate it.
+ */
+export declare function getLowlightInstance(): LowlightAPI | null;
+/** Exposed for testing — resets the module-level load state */
+export declare function _resetHighlightCache(): void;
+/**
+ * Warm the lowlight cache by loading it asynchronously.
+ * Call at app startup when `codeHighlight=true` to ensure the cache is populated
+ * before the first render cycle, preventing the cold-cache plain-text fallback.
+ *
+ * This is a no-op when lowlight is not installed.
+ */
+export declare function warmHighlightCache(): Promise<void>;
+/**
+ * Highlight raw code to a hast Root using lowlight, or null if unavailable/unknown lang.
+ *
+ * Used by ContentPane's HighlightedDisplay to perform on-demand highlighting
+ * for non-markdown code files (e.g. .ts, .py, .json).
+ *
+ * - Returns null when lowlight is not installed (graceful degrade to plain text).
+ * - Returns null when languageName is null or not registered in the lowlight instance.
+ * - Never throws.
+ *
+ * @param code - Raw source code string to highlight.
+ * @param languageName - highlight.js language identifier (e.g. "typescript"), or null.
+ */
+export declare function highlightCodeToHast(code: string, languageName: string | null): Promise<Root | null>;
+//# sourceMappingURL=lowlightLoader.d.ts.map

package/dist/components/content-viewer/plugins/lowlightLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowlightLoader.d.ts","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/lowlightLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAMjC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACnE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACrD,aAAa,IAAI,MAAM,EAAE,CAAC;CAC3B;AA0DD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAExD;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAExD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAWtB"}

package/dist/components/content-viewer/plugins/lowlightLoader.js

@@ -0,0 +1,120 @@
+/**
+ * lowlightLoader — shared, dependency-light lowlight loader for code highlighting.
+ *
+ * This module owns the single lowlight instance + load state used by BOTH:
+ *  - `rehypeCodeHighlight.ts` (markdown fenced-code highlighting via a rehype plugin), and
+ *  - `ContentPane`'s `HighlightedDisplay` (raw code-file highlighting, via `highlightCodeToHast`).
+ *
+ * It is intentionally free of `unist-util-visit` (and any other static ESM-only
+ * dependency) so that importing it from a Client Component (ContentPane) does NOT
+ * drag the rehype/unist graph into that module's bundle — or into Jest's module
+ * loader (which does not transform `unist-util-visit`'s ESM).
+ *
+ * `lowlight` itself remains an optional peer dep: it is loaded via dynamic
+ * `import()` and the loader degrades gracefully to plain text when it is absent.
+ * Consumers that want highlighting install lowlight separately (`npm install lowlight`).
+ *
+ * @module lowlightLoader
+ */
+// ---------------------------------------------------------------------------
+// Lazy lowlight loader — one attempt per session
+// ---------------------------------------------------------------------------
+let lowlightInstance = null;
+let lowlightLoadAttempted = false;
+/**
+ * Attempt to load lowlight via dynamic import().
+ *
+ * lowlight is an optional peer dep — consumers must install it separately.
+ * Using dynamic import() keeps it out of the base chunk while remaining
+ * compatible with ESM environments (no require() needed).
+ *
+ * Supports both lowlight v2 (preconfigured `lowlight` instance) and lowlight v3
+ * (`createLowlight(common)` factory). Returns the instance or null if unavailable.
+ */
+async function tryLoadLowlight() {
+    if (lowlightLoadAttempted)
+        return lowlightInstance;
+    lowlightLoadAttempted = true;
+    try {
+        // lowlight is an optional peer dep with no guaranteed types at build time.
+        // @ts-expect-error — optional package; consumers install it separately
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(/* webpackIgnore: true */ 'lowlight');
+        // v2 shape: mod.lowlight or mod.default or mod (has .highlight function directly)
+        const ll = mod?.lowlight ?? mod?.default ?? mod;
+        if (ll !== null &&
+            typeof ll === 'object' &&
+            typeof ll['highlight'] === 'function') {
+            // lowlight v2 path — instance has highlight() directly
+            lowlightInstance = ll;
+        }
+        else if (typeof mod?.createLowlight === 'function' && mod?.common) {
+            // lowlight v3 path — factory style: createLowlight(common)
+            lowlightInstance = mod.createLowlight(mod.common);
+        }
+        else {
+            console.warn('[@miethe/ui] codeHighlight=true: lowlight loaded but has unexpected shape. ' +
+                'Code blocks will render as plain text. Install lowlight: npm install lowlight');
+        }
+    }
+    catch {
+        // Not installed — expected for consumers that don't opt in
+        console.warn('[@miethe/ui] codeHighlight=true: lowlight is not installed. ' +
+            'Code blocks will render as plain text. Install it: npm install lowlight');
+        lowlightInstance = null;
+    }
+    return lowlightInstance;
+}
+/**
+ * Return the currently-cached lowlight instance synchronously (or null).
+ * Used by the rehype plugin's synchronous transformer, which reads from the
+ * already-populated cache. Call {@link warmHighlightCache} first to populate it.
+ */
+export function getLowlightInstance() {
+    return lowlightInstance;
+}
+/** Exposed for testing — resets the module-level load state */
+export function _resetHighlightCache() {
+    lowlightInstance = null;
+    lowlightLoadAttempted = false;
+}
+/**
+ * Warm the lowlight cache by loading it asynchronously.
+ * Call at app startup when `codeHighlight=true` to ensure the cache is populated
+ * before the first render cycle, preventing the cold-cache plain-text fallback.
+ *
+ * This is a no-op when lowlight is not installed.
+ */
+export async function warmHighlightCache() {
+    await tryLoadLowlight();
+}
+/**
+ * Highlight raw code to a hast Root using lowlight, or null if unavailable/unknown lang.
+ *
+ * Used by ContentPane's HighlightedDisplay to perform on-demand highlighting
+ * for non-markdown code files (e.g. .ts, .py, .json).
+ *
+ * - Returns null when lowlight is not installed (graceful degrade to plain text).
+ * - Returns null when languageName is null or not registered in the lowlight instance.
+ * - Never throws.
+ *
+ * @param code - Raw source code string to highlight.
+ * @param languageName - highlight.js language identifier (e.g. "typescript"), or null.
+ */
+export async function highlightCodeToHast(code, languageName) {
+    try {
+        const ll = await tryLoadLowlight();
+        if (!ll)
+            return null;
+        if (!languageName)
+            return null;
+        const known = ll.listLanguages();
+        if (!known.includes(languageName))
+            return null;
+        return ll.highlight(languageName, code);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=lowlightLoader.js.map

package/dist/components/content-viewer/plugins/lowlightLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowlightLoader.js","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/lowlightLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkBH,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E,IAAI,gBAAgB,GAAuB,IAAI,CAAC;AAChD,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC;;;;;;;;;GASG;AACH,KAAK,UAAU,eAAe;IAC5B,IAAI,qBAAqB;QAAE,OAAO,gBAAgB,CAAC;IACnD,qBAAqB,GAAG,IAAI,CAAC;IAE7B,IAAI,CAAC;QACH,2EAA2E;QAC3E,uEAAuE;QACvE,8DAA8D;QAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QACpE,kFAAkF;QAClF,MAAM,EAAE,GAAY,GAAG,EAAE,QAAQ,IAAI,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC;QACzD,IACE,EAAE,KAAK,IAAI;YACX,OAAO,EAAE,KAAK,QAAQ;YACtB,OAAQ,EAA8B,CAAC,WAAW,CAAC,KAAK,UAAU,EAClE,CAAC;YACD,uDAAuD;YACvD,gBAAgB,GAAG,EAAiB,CAAC;QACvC,CAAC;aAAM,IAAI,OAAO,GAAG,EAAE,cAAc,KAAK,UAAU,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;YACpE,2DAA2D;YAC3D,gBAAgB,GAAG,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAgB,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CACV,6EAA6E;gBAC3E,+EAA+E,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;QAC3D,OAAO,CAAC,IAAI,CACV,8DAA8D;YAC5D,yEAAyE,CAC5E,CAAC;QACF,gBAAgB,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,oBAAoB;IAClC,gBAAgB,GAAG,IAAI,CAAC;IACxB,qBAAqB,GAAG,KAAK,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,eAAe,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,YAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAoB,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/components/content-viewer/plugins/rehypeCodeHighlight.d.ts

@@ -0,0 +1,44 @@
+/**
+ * rehypeCodeHighlight — opt-in code syntax highlighting via lowlight
+ *
+ * Design: zero-cost default path.
+ *
+ * When `codeHighlight=false` (default), this module is NOT imported by ArticleViewer.
+ * When `codeHighlight=true`, `createHighlightPlugin()` is called; it returns a
+ * rehype plugin that highlights `pre > code` blocks using lowlight.
+ *
+ * Bundle strategy:
+ * - `lowlight` is a small (~15KB gzip) WASM-free highlighter built on highlight.js.
+ * - It is NOT listed as a hard dep — it is an optional peer dep gated on codeHighlight.
+ * - We load it via dynamic `import()` in `tryLoadLowlight()`, so bundlers can split
+ *   it into a lazy chunk and ESM environments have no `require()` issues.
+ *   Consumers must install lowlight separately: npm install lowlight
+ * - The plugin gracefully degrades to plain-text when lowlight is not available.
+ *
+ * Supported class convention (react-markdown / remark default):
+ *   ```js              → <code class="language-js">
+ *   ```typescript      → <code class="language-typescript">
+ *   ``` (no lang)      → no class; rendered as plain text
+ *
+ * @module rehypeCodeHighlight
+ */
+import type { Root } from 'hast';
+export { _resetHighlightCache, warmHighlightCache, highlightCodeToHast, } from './lowlightLoader';
+export type { LowlightAPI } from './lowlightLoader';
+/**
+ * Create a rehype plugin that applies syntax highlighting to `pre > code` blocks.
+ *
+ * Returns a function compatible with ReactMarkdown's `rehypePlugins` array.
+ *
+ * The plugin loads lowlight on first call. If lowlight is not installed,
+ * code blocks degrade gracefully to unstyled monospace text.
+ *
+ * @example
+ * ```tsx
+ * import { createHighlightPlugin } from '@miethe/ui/content-viewer';
+ * // Then pass codeHighlight={true} to ArticleViewer — it handles this internally.
+ * <ArticleViewer content={markdown} codeHighlight />
+ * ```
+ */
+export declare function createHighlightPlugin(): () => (tree: Root) => void;
+//# sourceMappingURL=rehypeCodeHighlight.d.ts.map

package/dist/components/content-viewer/plugins/rehypeCodeHighlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeCodeHighlight.d.ts","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/rehypeCodeHighlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,MAAM,CAAC;AAShD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgEpD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAuBlE"}

package/dist/components/content-viewer/plugins/rehypeCodeHighlight.js

@@ -0,0 +1,122 @@
+/**
+ * rehypeCodeHighlight — opt-in code syntax highlighting via lowlight
+ *
+ * Design: zero-cost default path.
+ *
+ * When `codeHighlight=false` (default), this module is NOT imported by ArticleViewer.
+ * When `codeHighlight=true`, `createHighlightPlugin()` is called; it returns a
+ * rehype plugin that highlights `pre > code` blocks using lowlight.
+ *
+ * Bundle strategy:
+ * - `lowlight` is a small (~15KB gzip) WASM-free highlighter built on highlight.js.
+ * - It is NOT listed as a hard dep — it is an optional peer dep gated on codeHighlight.
+ * - We load it via dynamic `import()` in `tryLoadLowlight()`, so bundlers can split
+ *   it into a lazy chunk and ESM environments have no `require()` issues.
+ *   Consumers must install lowlight separately: npm install lowlight
+ * - The plugin gracefully degrades to plain-text when lowlight is not available.
+ *
+ * Supported class convention (react-markdown / remark default):
+ *   ```js              → <code class="language-js">
+ *   ```typescript      → <code class="language-typescript">
+ *   ``` (no lang)      → no class; rendered as plain text
+ *
+ * @module rehypeCodeHighlight
+ */
+import { visit } from 'unist-util-visit';
+import { getLowlightInstance } from './lowlightLoader';
+// The lowlight loader (instance cache, dynamic import, graceful degrade) lives in
+// `./lowlightLoader` so it can be imported by Client Components (ContentPane) without
+// pulling `unist-util-visit` into their module graph. Re-export the shared API here so
+// existing import sites (plugins/index.ts, content-viewer/index.ts) keep working.
+export { _resetHighlightCache, warmHighlightCache, highlightCodeToHast, } from './lowlightLoader';
+// ---------------------------------------------------------------------------
+// Language extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the language identifier from a code element's className.
+ * react-markdown generates `language-{lang}` class names for fenced code blocks.
+ * Returns null when no language class is present.
+ */
+function extractLanguage(node) {
+    const classNames = (node.properties?.className ?? []);
+    for (const cls of classNames) {
+        if (typeof cls === 'string' && cls.startsWith('language-')) {
+            return cls.slice('language-'.length);
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Synchronous highlight application
+// ---------------------------------------------------------------------------
+/**
+ * Apply lowlight highlighting to a `pre > code` element's text content.
+ * Mutates the code element's children in place.
+ * Returns false when lowlight is unavailable or the node has no text.
+ */
+function applyHighlight(codeNode, language, ll) {
+    const textNode = codeNode.children.find((child) => child.type === 'text');
+    const code = textNode?.value ?? '';
+    if (!code)
+        return false;
+    try {
+        const knownLangs = ll.listLanguages();
+        const result = language && knownLangs.includes(language)
+            ? ll.highlight(language, code)
+            : ll.highlightAuto(code);
+        // Replace children with highlighted hast nodes
+        codeNode.children = result.children;
+        // Add hljs class for theme CSS compatibility
+        const existingClasses = (codeNode.properties?.className ?? []);
+        codeNode.properties = {
+            ...codeNode.properties,
+            className: [...existingClasses, 'hljs'],
+        };
+        return true;
+    }
+    catch (err) {
+        // Per-block failure is non-fatal — leave children as plain text
+        console.warn('[ArticleViewer] Code highlighting failed for block:', err);
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a rehype plugin that applies syntax highlighting to `pre > code` blocks.
+ *
+ * Returns a function compatible with ReactMarkdown's `rehypePlugins` array.
+ *
+ * The plugin loads lowlight on first call. If lowlight is not installed,
+ * code blocks degrade gracefully to unstyled monospace text.
+ *
+ * @example
+ * ```tsx
+ * import { createHighlightPlugin } from '@miethe/ui/content-viewer';
+ * // Then pass codeHighlight={true} to ArticleViewer — it handles this internally.
+ * <ArticleViewer content={markdown} codeHighlight />
+ * ```
+ */
+export function createHighlightPlugin() {
+    return function rehypeCodeHighlightPlugin() {
+        return function transformer(tree) {
+            // Read from the already-populated cache (synchronous).
+            // Call warmHighlightCache() at startup to pre-populate before first render.
+            const ll = getLowlightInstance();
+            // Lowlight unavailable — silently degrade to plain text
+            if (!ll)
+                return;
+            visit(tree, 'element', (node, _index, parent) => {
+                if (node.tagName !== 'code' ||
+                    !parent ||
+                    parent.tagName !== 'pre') {
+                    return;
+                }
+                const lang = extractLanguage(node);
+                applyHighlight(node, lang, ll);
+            });
+        };
+    };
+}
+//# sourceMappingURL=rehypeCodeHighlight.js.map

package/dist/components/content-viewer/plugins/rehypeCodeHighlight.js.map

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

package/dist/components/content-viewer/plugins/rehypeExternalLinks.d.ts

@@ -0,0 +1,59 @@
+/**
+ * rehypeExternalLinks — shared rehype plugin for external link hardening (PU3-04)
+ *
+ * Adds `target="_blank"` and `rel="noopener noreferrer"` to every `<a>` element
+ * whose `href` is an absolute URL with an http, https, or mailto scheme.
+ *
+ * This plugin is intentionally written as a pure unified/rehype tree visitor so
+ * it works on both the markdown pipeline (via ReactMarkdown's `rehypePlugins`)
+ * and the HTML pipeline (unified + rehypeParse + this plugin + rehype-sanitize
+ * + rehypeStringify). A single implementation avoids per-component duplication.
+ *
+ * Scheme detection uses a strict allowlist: `http:`, `https:`, `mailto:`.
+ * Protocol-relative URLs (`//example.com`) are also treated as external.
+ *
+ * Note: The markdown path also uses the `components.a` override in
+ * `buildComponentMap()` for link hardening because ReactMarkdown does not
+ * thread rehype node attributes through to rendered anchors. The `components.a`
+ * override is kept for the markdown path; this plugin is the canonical
+ * implementation used for the HTML path and can be tested in isolation.
+ */
+import type { Plugin } from 'unified';
+interface HastProperties {
+    [key: string]: unknown;
+}
+interface HastElement {
+    type: 'element';
+    tagName: string;
+    properties?: HastProperties;
+    children: HastNode[];
+}
+interface HastRoot {
+    type: 'root';
+    children: HastNode[];
+}
+type HastNode = HastElement | HastRoot | {
+    type: string;
+};
+/**
+ * Returns true if `href` should be treated as an external link.
+ * Protocol-relative URLs (starting with `//`) are also considered external.
+ */
+export declare function isExternalHref(href: string): boolean;
+/**
+ * Unified/rehype plugin that adds `target="_blank"` and
+ * `rel="noopener noreferrer"` to external `<a>` elements.
+ *
+ * Usage (HTML pipeline):
+ * ```ts
+ * unified()
+ *   .use(rehypeParse, { fragment: true })
+ *   .use(rehypeExternalLinks)
+ *   .use(rehypeSanitize)   // sanitize AFTER link attrs are set (allowlist includes rel/target)
+ *   .use(rehypeStringify)
+ *   .process(htmlString);
+ * ```
+ */
+export declare const rehypeExternalLinks: Plugin<[], HastRoot>;
+export default rehypeExternalLinks;
+//# sourceMappingURL=rehypeExternalLinks.d.ts.map

package/dist/components/content-viewer/plugins/rehypeExternalLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeExternalLinks.d.ts","sourceRoot":"","sources":["../../../../src/components/content-viewer/plugins/rehypeExternalLinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,SAAS,CAAC;AAOnD,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,KAAK,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAU1D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASpD;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,CAgBpD,CAAC;AAEF,eAAe,mBAAmB,CAAC"}