@caseparts-org/caseblocks 0.0.200 → 0.0.202

package/dist/molecules/Markdown/Markdown.d.ts

@@ -4,9 +4,10 @@ export type MarkdownProps = {
     children?: string | null;
     className?: string;
     components?: Components;
-    url?: LinkTarget;
+    partUrl?: LinkTarget;
+    relativePathUrl?: LinkTarget;
     validate?: ValidateToken;
     batchValidate?: BatchValidateTokens;
     debug?: boolean;
 };
-export declare function Markdown({ children, className, components, url, validate, batchValidate, debug, }: MarkdownProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Markdown({ children, className, components, partUrl, relativePathUrl, validate, batchValidate, debug, }: MarkdownProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/molecules/Markdown/Markdown.js

@@ -8679,28 +8679,30 @@ function zf({
   children: e,
   className: t,
   components: n,
-  url: r,
-  validate: i,
-  batchValidate: o,
-  debug: l = !1
+  partUrl: r,
+  relativePathUrl: i,
+  validate: o,
+  batchValidate: l,
+  debug: a = !1
 }) {
-  const a = e ?? "", { output: u } = Ti(
-    a,
+  const u = e ?? "", { output: s } = Ti(
+    u,
     r,
     i,
-    l,
-    o
+    o,
+    a,
+    l
   );
-  if (!a) return null;
-  const s = r ? {
-    a: ({ node: p, ...h }) => /* @__PURE__ */ je("a", { ...h, target: "_blank", rel: "noopener noreferrer" })
-  } : {}, f = t ? `${or.markdown} ${t}` : or.markdown, c = { ...Ef, ...s, ...n };
-  return /* @__PURE__ */ je("div", { className: f, children: /* @__PURE__ */ je(
+  if (!u) return null;
+  const f = r || i ? {
+    a: ({ node: h, ...d }) => /* @__PURE__ */ je("a", { ...d, target: "_blank", rel: "noopener noreferrer" })
+  } : {}, c = t ? `${or.markdown} ${t}` : or.markdown, p = { ...Ef, ...f, ...n };
+  return /* @__PURE__ */ je("div", { className: c, children: /* @__PURE__ */ je(
     os,
     {
       remarkPlugins: [xf, Sf, Ii],
-      components: c,
-      children: u
+      components: p,
+      children: s
     }
   ) });
 }

package/dist/molecules/Markdown/Markdown.stories.js

@@ -1,9 +1,9 @@
-import { jsx as n, jsxs as c } from "react/jsx-runtime";
+import { jsx as a, jsxs as c } from "react/jsx-runtime";
 import { useState as m, useEffect as p } from "react";
-import { Markdown as s } from "./Markdown.js";
-const f = {
+import { Markdown as l } from "./Markdown.js";
+const w = {
   title: "Case Parts/Molecules/Markdown",
-  component: s,
+  component: l,
   parameters: { layout: "padded" },
   tags: ["autodocs"]
 }, r = `Kason 171 Latch
@@ -12,50 +12,51 @@ const f = {
 Fits only selected revisions.
 :::
 
-This fits part [171] and an invalid token [bad].
+This fits part [171], an invalid token [bad], and a help page at [FAQ](/faq).
 Already linked should remain: [171](https://example.com/should-stay).
 `;
-function u(e) {
-  const [o, i] = m(e.children ?? r);
+function h(e) {
+  const [i, o] = m(e.children ?? r);
   return p(() => {
-    i(e.children ?? r);
+    o(e.children ?? r);
   }, [e.children]), /* @__PURE__ */ c("div", { style: { display: "grid", gap: 12 }, children: [
-    /* @__PURE__ */ n("label", { style: { fontWeight: 600 }, children: "Edit Markdown (preprocess + admonitions live):" }),
-    /* @__PURE__ */ n(
+    /* @__PURE__ */ a("label", { style: { fontWeight: 600 }, children: "Edit Markdown (preprocess + admonitions live):" }),
+    /* @__PURE__ */ a(
       "textarea",
       {
-        value: o,
-        onChange: (t) => i(t.target.value),
+        value: i,
+        onChange: (t) => o(t.target.value),
         rows: 14,
         style: { width: "100%", fontFamily: "monospace" }
       }
     ),
-    /* @__PURE__ */ n(
-      s,
+    /* @__PURE__ */ a(
+      l,
       {
         ...e,
-        url: (t) => `https://example.com/parts/${encodeURIComponent(t)}`,
+        partUrl: (t) => `https://example.com/parts/${encodeURIComponent(t)}`,
+        relativePathUrl: "https://example.com",
         validate: async (t) => {
-          if (await new Promise((a) => setTimeout(a, 50)), /^\d+$/.test(t)) return !0;
+          if (await new Promise((n) => setTimeout(n, 50)), /^\d+$/.test(t)) return !0;
           throw new Error("invalid");
         },
         debug: !0,
-        children: o
+        children: i
       }
     )
   ] });
 }
-const y = {
+const v = {
   name: "Live Playground",
   args: {
     children: r
   },
-  render: (e) => /* @__PURE__ */ n(u, { ...e })
-}, v = {
+  render: (e) => /* @__PURE__ */ a(h, { ...e })
+}, y = {
   args: {
     children: `# Heading 1
 
-Paragraph with a [link](https://example.com).
+Paragraph with a [link](https://example.com) and a relative help path [FAQ](/faq).
 
 ## Heading 2
 
@@ -86,25 +87,27 @@ export default greet;
 
 | Col A | Col B |
 |------:|:------|
-|  123  | text  |`
+|  123  | text  |`,
+    relativePathUrl: "https://example.com"
   }
 }, x = {
   name: "Item Description Variant",
-  render: (e) => /* @__PURE__ */ n(({ text: l }) => /* @__PURE__ */ n(
-    s,
+  render: (e) => /* @__PURE__ */ a(({ text: s }) => /* @__PURE__ */ a(
+    l,
     {
       ...e,
-      url: (a) => `https://example.com/parts/${encodeURIComponent(a)}`,
-      validate: async (a) => {
-        if (await new Promise((d) => setTimeout(d, 50)), /^\d+$/.test(a)) return !0;
+      partUrl: (n) => `https://example.com/parts/${encodeURIComponent(n)}`,
+      relativePathUrl: "https://example.com",
+      validate: async (n) => {
+        if (await new Promise((d) => setTimeout(d, 50)), /^\d+$/.test(n)) return !0;
         throw new Error("invalid");
       },
       debug: !0,
-      children: l
+      children: s
     }
   ), { text: `Kason 171 Latch
 
-This fits part [171] and an invalid token [bad]. Already linked should remain: [171](https://example.com/should-stay).
+This fits part [171], an invalid token [bad], and the installation guide at [FAQ](/faq). Already linked should remain: [171](https://example.com/should-stay).
 
 Another valid numeric: [172].` })
 }, b = {
@@ -141,8 +144,8 @@ This block should not be transformed.
 };
 export {
   b as Admonitions,
-  v as Basic,
+  y as Basic,
   x as ItemDescription,
-  y as Playground,
-  f as default
+  v as Playground,
+  w as default
 };

package/dist/molecules/Markdown/usePreprocessedMarkdown.d.ts

@@ -7,7 +7,7 @@ export type PreprocessedMarkdownResult = {
     tokens: string[];
 };
 /**
- * Extracts bracketed tokens not already followed by parentheses, validates them, and
- * returns the input with validated tokens converted to markdown links.
+ * Validates bare bracketed part tokens and rewrites relative markdown links using
+ * the configured URL targets.
  */
-export declare function usePreprocessedMarkdown(input: string | null | undefined, url?: LinkTarget, validate?: ValidateToken, debug?: boolean, batchValidate?: BatchValidateTokens): PreprocessedMarkdownResult;
+export declare function usePreprocessedMarkdown(input: string | null | undefined, partUrl?: LinkTarget, relativePathUrl?: LinkTarget, validate?: ValidateToken, debug?: boolean, batchValidate?: BatchValidateTokens): PreprocessedMarkdownResult;

package/dist/molecules/Markdown/usePreprocessedMarkdown.js

@@ -1,86 +1,95 @@
-import { useState as q, useRef as E, useEffect as v, useMemo as H } from "react";
-const x = (e, s) => {
-  const u = e.lastIndexOf(`
-`, Math.max(0, s - 1)) + 1, h = e.indexOf(`
-`, s), d = h === -1 ? e.length : h;
-  return e.slice(u, d).trimStart().startsWith(":::");
+import { useState as N, useRef as L, useEffect as I, useMemo as x } from "react";
+const H = /\[(.+?)\](?!\()/g, p = /\[([^\]]+?)\]\((\/[^)\s]*)\)/g, W = (e, n) => typeof e == "function" ? e(n) : e, X = (e, n) => typeof e == "function" ? e(n) : `${e}${n}`, E = (e, n) => {
+  const a = e.lastIndexOf(`
+`, Math.max(0, n - 1)) + 1, l = e.indexOf(`
+`, n), w = l === -1 ? e.length : l;
+  return e.slice(a, w).trimStart().startsWith(":::");
 };
-function N(e, s, u, h = !1, d) {
-  const [A, w] = q(e ?? ""), [L, m] = q(!1), c = E(/* @__PURE__ */ new Map()), M = E(u), O = E(
-    d
+function j(e, n, a, l, w = !1, y) {
+  const [q, S] = N(e ?? ""), [v, m] = N(!1), o = L(/* @__PURE__ */ new Map()), O = L(l), M = L(
+    y
   );
-  v(() => {
-    M.current = u, O.current = d;
-  }, [u, d]);
-  const S = H(() => /\[(.+?)\](?!\()/g, []), l = H(() => {
-    if (!e || !s) return [];
-    const f = Array.from(e.matchAll(S)).filter(
-      (a) => typeof a.index == "number" ? !x(e, a.index) : !0
-    ).map((a) => a[1]);
+  I(() => {
+    O.current = l, M.current = y;
+  }, [l, y]);
+  const d = x(() => H, []), h = x(() => {
+    if (!e || !n) return [];
+    const f = Array.from(e.matchAll(d)).filter(
+      (u) => typeof u.index == "number" ? !E(e, u.index) : !0
+    ).map((u) => u[1]);
     return Array.from(new Set(f));
-  }, [e, S, s]), R = (f) => {
-    const r = f.split(/\r?\n/);
-    if (r.length === 0) return f;
-    const a = r[0];
-    return /^\s*#\s/.test(a) || (r[0] = `# ${a.trim()}`), r.join(`
+  }, [e, d, n]), T = x(() => {
+    if (!e || !a) return [];
+    const f = Array.from(e.matchAll(p)).filter(
+      (t) => typeof t.index == "number" ? !E(e, t.index) : !0
+    ).map((t) => t[0]);
+    return Array.from(new Set(f));
+  }, [e, a]), _ = (f) => {
+    const t = f.split(/\r?\n/);
+    if (t.length === 0) return f;
+    const u = t[0];
+    return /^\s*#\s/.test(u) || (t[0] = `# ${u.trim()}`), t.join(`
 `);
   };
-  return v(() => {
+  return I(() => {
     if (!e) {
-      w(""), m(!1);
+      S(""), m(!1);
       return;
     }
-    if (!s) {
-      w(e), m(!1);
+    if (!n && !a) {
+      S(e), m(!1);
       return;
     }
-    if (!l.length) {
-      w(R(e)), m(!1);
+    if (!h.length && !T.length) {
+      S(_(e)), m(!1);
       return;
     }
     let f = !1;
     m(!0);
-    const r = l.filter((y) => !c.current.has(y));
+    const t = h.filter((g) => !o.current.has(g));
     return (async () => {
-      if (r.length) {
-        const t = O.current, o = M.current;
-        if (t)
+      if (t.length) {
+        const r = M.current, c = O.current;
+        if (r)
           try {
-            const n = await t(r), i = n instanceof Set ? n : new Set(n);
-            r.forEach((g) => {
-              c.current.set(g, i.has(g));
+            const s = await r(t), i = s instanceof Set ? s : new Set(s);
+            t.forEach((R) => {
+              o.current.set(R, i.has(R));
             });
           } catch {
-            r.forEach((n) => {
-              c.current.set(n, !1);
+            t.forEach((s) => {
+              o.current.set(s, !1);
             });
           }
-        else o ? (await Promise.allSettled(
-          r.map(async (i) => {
+        else c ? (await Promise.allSettled(
+          t.map(async (i) => {
             try {
-              await o(i), c.current.set(i, !0);
+              await c(i), o.current.set(i, !0);
             } catch {
-              c.current.set(i, !1);
+              o.current.set(i, !1);
             }
           })
-        )).forEach((i, g) => {
-          const $ = r[g];
-          c.current.has($) || c.current.set($, i.status === "fulfilled");
-        }) : r.forEach((n) => {
-          c.current.set(n, !0);
+        )).forEach((i, R) => {
+          const K = t[R];
+          o.current.has(K) || o.current.set(K, i.status === "fulfilled");
+        }) : t.forEach((s) => {
+          o.current.set(s, !0);
         });
       }
-      const y = new Set(
-        l.filter((t) => c.current.get(t) === !0)
-      ), P = new Set(
-        l.filter((t) => c.current.get(t) === !1)
-      ), j = (t) => typeof s == "function" ? s(t) : s, p = e.replace(S, (t, o, n) => x(e, n) ? t : y.has(o) ? `**[${o}](${j(o)})**` : t), C = h ? p.replace(S, (t, o, n) => x(p, n) ? t : P.has(o) ? `[${o}]⚠️` : t) : p, F = R(C);
-      f || (w(F), m(!1));
+      const g = new Set(
+        h.filter((r) => o.current.get(r) === !0)
+      ), C = new Set(
+        h.filter((r) => o.current.get(r) === !1)
+      ), A = e.replace(d, (r, c, s) => E(e, s) ? r : g.has(c) && n ? `**[${c}](${W(n, c)})**` : r), $ = a ? A.replace(
+        p,
+        (r, c, s, i) => E(A, i) ? r : `[${c}](${X(a, s)})`
+      ) : A, D = w ? $.replace(d, (r, c, s) => E($, s) ? r : C.has(c) ? `[${c}]⚠️` : r) : $, G = _(D);
+      f || (S(G), m(!1));
     })(), () => {
       f = !0;
     };
-  }, [e, l, h, s, S]), { output: A, loading: L, tokens: l };
+  }, [e, h, T, w, n, a, d]), { output: q, loading: v, tokens: h };
 }
 export {
-  N as usePreprocessedMarkdown
+  j as usePreprocessedMarkdown
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@caseparts-org/caseblocks",
   "private": false,
-  "version": "0.0.200",
+  "version": "0.0.202",
   "type": "module",
   "module": "dist/main.js",
   "types": "dist/main.d.ts",