@latentic/live-markdown 0.3.1 → 0.4.0

package/dist/links/wikilink.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Wikilink (`[[target]]` / `[[target|label]]`) parsing + target resolution.
+ *
+ * The canonical rule lives in the `workspace-index` crate
+ * (`wikilink_target_and_label` / `resolve_document_target` / `path_stem_matches`
+ * / `slug_key`) — that's what builds the backlink graph. This is the
+ * **client-side mirror** used to navigate a *clicked* wikilink, so the editor
+ * and chat agree with the sidebar's backlinks. Keep the two in sync; if the
+ * crate's rule changes, change it here too.
+ *
+ * Difference from the crate: an unresolved target returns `null` (we only
+ * navigate to files that exist), whereas the crate keeps a would-be path for
+ * the graph edge.
+ */
+/** Split a wikilink body into its target and display label. */
+declare function parseWikilinkBody(body: string): {
+    target: string;
+    label: string;
+};
+/** Resolve a wikilink target to an existing workspace file path, or `null`. */
+declare function resolveWikilinkTarget(rawTarget: string, options: {
+    fromPath?: string;
+    knownPaths: ReadonlySet<string>;
+}): string | null;
+
+export { parseWikilinkBody, resolveWikilinkTarget };

package/dist/links/wikilink.js

@@ -0,0 +1,54 @@
+import "../chunk-V6TY7KAL.js";
+import { resolveWorkspaceLink } from "./workspaceLink.js";
+function parseWikilinkBody(body) {
+  const pipe = body.indexOf("|");
+  const target = (pipe === -1 ? body : body.slice(0, pipe)).trim();
+  const rawLabel = pipe === -1 ? target : body.slice(pipe + 1).trim();
+  return { target, label: rawLabel === "" ? target : rawLabel };
+}
+function resolveWikilinkTarget(rawTarget, options) {
+  const target = (rawTarget.split("#", 1)[0] ?? "").trim().replace(/\\/g, "/");
+  if (target === "") {
+    return null;
+  }
+  const withExtension = target.toLowerCase().endsWith(".md") ? target : `${target}.md`;
+  if (target.includes("/") || target.startsWith(".")) {
+    const relative = resolveWorkspaceLink(withExtension, options);
+    if (relative?.kind === "internal") {
+      return relative.path;
+    }
+    const fromRoot = resolveWorkspaceLink(withExtension, { knownPaths: options.knownPaths });
+    return fromRoot?.kind === "internal" ? fromRoot.path : null;
+  }
+  if (options.knownPaths.has(withExtension)) {
+    return withExtension;
+  }
+  for (const path of options.knownPaths) {
+    if (pathStemMatches(path, target)) {
+      return path;
+    }
+  }
+  return null;
+}
+function pathStemMatches(path, target) {
+  const withoutExtension = path.endsWith(".md") ? path.slice(0, -3) : path;
+  const basename = withoutExtension.split("/").pop() ?? withoutExtension;
+  const targetLower = target.toLowerCase();
+  return withoutExtension.toLowerCase() === targetLower || basename.toLowerCase() === targetLower || slugKey(withoutExtension) === slugKey(target) || slugKey(basename) === slugKey(target);
+}
+function slugKey(value) {
+  let raw = "";
+  for (const ch of value) {
+    if (/[\p{L}\p{N}]/u.test(ch)) {
+      raw += ch.toLowerCase();
+    } else if (ch === " " || ch === "-" || ch === "_" || ch === "/") {
+      raw += "-";
+    }
+  }
+  return raw.split("-").filter(Boolean).join("-");
+}
+export {
+  parseWikilinkBody,
+  resolveWikilinkTarget
+};
+//# sourceMappingURL=wikilink.js.map

package/dist/links/wikilink.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/links/wikilink.ts"],"sourcesContent":["import { resolveWorkspaceLink } from \"./workspaceLink\";\n\n/**\n * Wikilink (`[[target]]` / `[[target|label]]`) parsing + target resolution.\n *\n * The canonical rule lives in the `workspace-index` crate\n * (`wikilink_target_and_label` / `resolve_document_target` / `path_stem_matches`\n * / `slug_key`) — that's what builds the backlink graph. This is the\n * **client-side mirror** used to navigate a *clicked* wikilink, so the editor\n * and chat agree with the sidebar's backlinks. Keep the two in sync; if the\n * crate's rule changes, change it here too.\n *\n * Difference from the crate: an unresolved target returns `null` (we only\n * navigate to files that exist), whereas the crate keeps a would-be path for\n * the graph edge.\n */\n\n/** Split a wikilink body into its target and display label. */\nexport function parseWikilinkBody(body: string): { target: string; label: string } {\n  const pipe = body.indexOf(\"|\");\n  const target = (pipe === -1 ? body : body.slice(0, pipe)).trim();\n  const rawLabel = pipe === -1 ? target : body.slice(pipe + 1).trim();\n  return { target, label: rawLabel === \"\" ? target : rawLabel };\n}\n\n/** Resolve a wikilink target to an existing workspace file path, or `null`. */\nexport function resolveWikilinkTarget(\n  rawTarget: string,\n  options: { fromPath?: string; knownPaths: ReadonlySet<string> },\n): string | null {\n  const target = (rawTarget.split(\"#\", 1)[0] ?? \"\").trim().replace(/\\\\/g, \"/\");\n  if (target === \"\") {\n    return null;\n  }\n  const withExtension = target.toLowerCase().endsWith(\".md\") ? target : `${target}.md`;\n\n  // Path-like target (`sub/note`, `./note`, `../note`): resolve like a relative\n  // link — against the source file's dir first, then the vault root.\n  if (target.includes(\"/\") || target.startsWith(\".\")) {\n    const relative = resolveWorkspaceLink(withExtension, options);\n    if (relative?.kind === \"internal\") {\n      return relative.path;\n    }\n    const fromRoot = resolveWorkspaceLink(withExtension, { knownPaths: options.knownPaths });\n    return fromRoot?.kind === \"internal\" ? fromRoot.path : null;\n  }\n\n  // Bare name: a root-level `<target>.md`, else any file whose stem matches.\n  if (options.knownPaths.has(withExtension)) {\n    return withExtension;\n  }\n  for (const path of options.knownPaths) {\n    if (pathStemMatches(path, target)) {\n      return path;\n    }\n  }\n  return null;\n}\n\nfunction pathStemMatches(path: string, target: string): boolean {\n  const withoutExtension = path.endsWith(\".md\") ? path.slice(0, -3) : path;\n  const basename = withoutExtension.split(\"/\").pop() ?? withoutExtension;\n  const targetLower = target.toLowerCase();\n  return (\n    withoutExtension.toLowerCase() === targetLower ||\n    basename.toLowerCase() === targetLower ||\n    slugKey(withoutExtension) === slugKey(target) ||\n    slugKey(basename) === slugKey(target)\n  );\n}\n\n/** Mirror of the crate's `slug_key`: lowercase alphanumerics, collapse\n * ` -_/` to single dashes, drop other punctuation. */\nfunction slugKey(value: string): string {\n  let raw = \"\";\n  for (const ch of value) {\n    if (/[\\p{L}\\p{N}]/u.test(ch)) {\n      raw += ch.toLowerCase();\n    } else if (ch === \" \" || ch === \"-\" || ch === \"_\" || ch === \"/\") {\n      raw += \"-\";\n    }\n  }\n  return raw.split(\"-\").filter(Boolean).join(\"-\");\n}\n"],"mappings":";AAAA,SAAS,4BAA4B;AAkB9B,SAAS,kBAAkB,MAAiD;AACjF,QAAM,OAAO,KAAK,QAAQ,GAAG;AAC7B,QAAM,UAAU,SAAS,KAAK,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,KAAK;AAC/D,QAAM,WAAW,SAAS,KAAK,SAAS,KAAK,MAAM,OAAO,CAAC,EAAE,KAAK;AAClE,SAAO,EAAE,QAAQ,OAAO,aAAa,KAAK,SAAS,SAAS;AAC9D;AAGO,SAAS,sBACd,WACA,SACe;AACf,QAAM,UAAU,UAAU,MAAM,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,KAAK,EAAE,QAAQ,OAAO,GAAG;AAC3E,MAAI,WAAW,IAAI;AACjB,WAAO;AAAA,EACT;AACA,QAAM,gBAAgB,OAAO,YAAY,EAAE,SAAS,KAAK,IAAI,SAAS,GAAG,MAAM;AAI/E,MAAI,OAAO,SAAS,GAAG,KAAK,OAAO,WAAW,GAAG,GAAG;AAClD,UAAM,WAAW,qBAAqB,eAAe,OAAO;AAC5D,QAAI,UAAU,SAAS,YAAY;AACjC,aAAO,SAAS;AAAA,IAClB;AACA,UAAM,WAAW,qBAAqB,eAAe,EAAE,YAAY,QAAQ,WAAW,CAAC;AACvF,WAAO,UAAU,SAAS,aAAa,SAAS,OAAO;AAAA,EACzD;AAGA,MAAI,QAAQ,WAAW,IAAI,aAAa,GAAG;AACzC,WAAO;AAAA,EACT;AACA,aAAW,QAAQ,QAAQ,YAAY;AACrC,QAAI,gBAAgB,MAAM,MAAM,GAAG;AACjC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,MAAc,QAAyB;AAC9D,QAAM,mBAAmB,KAAK,SAAS,KAAK,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AACpE,QAAM,WAAW,iBAAiB,MAAM,GAAG,EAAE,IAAI,KAAK;AACtD,QAAM,cAAc,OAAO,YAAY;AACvC,SACE,iBAAiB,YAAY,MAAM,eACnC,SAAS,YAAY,MAAM,eAC3B,QAAQ,gBAAgB,MAAM,QAAQ,MAAM,KAC5C,QAAQ,QAAQ,MAAM,QAAQ,MAAM;AAExC;AAIA,SAAS,QAAQ,OAAuB;AACtC,MAAI,MAAM;AACV,aAAW,MAAM,OAAO;AACtB,QAAI,gBAAgB,KAAK,EAAE,GAAG;AAC5B,aAAO,GAAG,YAAY;AAAA,IACxB,WAAW,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK;AAC/D,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,IAAI,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAChD;","names":[]}

package/dist/links/workspaceLink.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Resolve a markdown link href to a navigation target.
+ *
+ * A link in a document (or an agent's chat reply) is either:
+ *   - **external** — anything with a URI scheme (`https:`, `mailto:`, …) or a
+ *     protocol-relative `//host`; opened in the browser, and
+ *   - **internal** — a workspace-relative path that resolves to a file the
+ *     workspace actually contains; opened in a tab.
+ *
+ * This is pure path resolution (normalize `.`/`..`, reject escaping the vault
+ * root, membership-check against the known files) — it is **not** the index's
+ * link parser. The index already resolves links into `graphEdges`; this just
+ * decides where a *clicked* href points so the UI can navigate. An href that
+ * looks internal but matches no known file returns `null` (a broken link, not
+ * something to navigate to).
+ */
+type ResolvedWorkspaceLink = {
+    kind: "internal";
+    path: string;
+} | {
+    kind: "external";
+    href: string;
+};
+interface ResolveWorkspaceLinkOptions {
+    /** Workspace-relative path of the document the link lives in. Relative hrefs
+     * resolve against this file's directory. Omitted ⇒ resolve from the vault
+     * root (used for agent chat replies, which emit root-relative paths). */
+    fromPath?: string;
+    /** Every workspace-relative file path, for membership checks. */
+    knownPaths: ReadonlySet<string>;
+}
+declare function resolveWorkspaceLink(href: string, options: ResolveWorkspaceLinkOptions): ResolvedWorkspaceLink | null;
+
+export { type ResolveWorkspaceLinkOptions, type ResolvedWorkspaceLink, resolveWorkspaceLink };

package/dist/links/workspaceLink.js

@@ -0,0 +1,60 @@
+import "../chunk-V6TY7KAL.js";
+const URI_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const HAS_EXTENSION = /\.[a-z0-9]+$/i;
+function resolveWorkspaceLink(href, options) {
+  const raw = href.trim();
+  if (raw === "" || raw.startsWith("#")) {
+    return null;
+  }
+  if (URI_SCHEME.test(raw) || raw.startsWith("//")) {
+    return { kind: "external", href: raw };
+  }
+  const pathPart = decodeSegment(raw.split(/[?#]/, 1)[0] ?? "");
+  if (pathPart === "") {
+    return null;
+  }
+  const base = pathPart.startsWith("/") || !options.fromPath ? "" : dirOf(options.fromPath);
+  const normalized = normalizeWorkspacePath(base, pathPart);
+  if (normalized === null) {
+    return null;
+  }
+  if (options.knownPaths.has(normalized)) {
+    return { kind: "internal", path: normalized };
+  }
+  if (!HAS_EXTENSION.test(normalized) && options.knownPaths.has(`${normalized}.md`)) {
+    return { kind: "internal", path: `${normalized}.md` };
+  }
+  return null;
+}
+function dirOf(path) {
+  const slash = path.lastIndexOf("/");
+  return slash === -1 ? "" : path.slice(0, slash);
+}
+function decodeSegment(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function normalizeWorkspacePath(base, rel) {
+  const parts = base ? base.split("/") : [];
+  for (const segment of rel.split("/")) {
+    if (segment === "" || segment === ".") {
+      continue;
+    }
+    if (segment === "..") {
+      if (parts.length === 0) {
+        return null;
+      }
+      parts.pop();
+      continue;
+    }
+    parts.push(segment);
+  }
+  return parts.join("/");
+}
+export {
+  resolveWorkspaceLink
+};
+//# sourceMappingURL=workspaceLink.js.map

package/dist/links/workspaceLink.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/links/workspaceLink.ts"],"sourcesContent":["/**\n * Resolve a markdown link href to a navigation target.\n *\n * A link in a document (or an agent's chat reply) is either:\n *   - **external** — anything with a URI scheme (`https:`, `mailto:`, …) or a\n *     protocol-relative `//host`; opened in the browser, and\n *   - **internal** — a workspace-relative path that resolves to a file the\n *     workspace actually contains; opened in a tab.\n *\n * This is pure path resolution (normalize `.`/`..`, reject escaping the vault\n * root, membership-check against the known files) — it is **not** the index's\n * link parser. The index already resolves links into `graphEdges`; this just\n * decides where a *clicked* href points so the UI can navigate. An href that\n * looks internal but matches no known file returns `null` (a broken link, not\n * something to navigate to).\n */\n\nexport type ResolvedWorkspaceLink =\n  | { kind: \"internal\"; path: string }\n  | { kind: \"external\"; href: string };\n\n// A URI scheme (`https:`, `mailto:`, `tel:`, `data:`, …). A workspace-relative\n// path never has one.\nconst URI_SCHEME = /^[a-z][a-z0-9+.-]*:/i;\nconst HAS_EXTENSION = /\\.[a-z0-9]+$/i;\n\nexport interface ResolveWorkspaceLinkOptions {\n  /** Workspace-relative path of the document the link lives in. Relative hrefs\n   * resolve against this file's directory. Omitted ⇒ resolve from the vault\n   * root (used for agent chat replies, which emit root-relative paths). */\n  fromPath?: string;\n  /** Every workspace-relative file path, for membership checks. */\n  knownPaths: ReadonlySet<string>;\n}\n\nexport function resolveWorkspaceLink(\n  href: string,\n  options: ResolveWorkspaceLinkOptions,\n): ResolvedWorkspaceLink | null {\n  const raw = href.trim();\n  if (raw === \"\" || raw.startsWith(\"#\")) {\n    // Empty, or an in-page anchor — not a cross-file link.\n    return null;\n  }\n  if (URI_SCHEME.test(raw) || raw.startsWith(\"//\")) {\n    return { kind: \"external\", href: raw };\n  }\n\n  // Workspace path. Drop any ?query / #fragment, then percent-decode.\n  const pathPart = decodeSegment(raw.split(/[?#]/, 1)[0] ?? \"\");\n  if (pathPart === \"\") {\n    return null;\n  }\n  // A leading \"/\" means \"from the vault root\", not the filesystem root.\n  const base = pathPart.startsWith(\"/\") || !options.fromPath ? \"\" : dirOf(options.fromPath);\n  const normalized = normalizeWorkspacePath(base, pathPart);\n  if (normalized === null) {\n    // `..` escaped the vault root — never navigate outside it.\n    return null;\n  }\n  if (options.knownPaths.has(normalized)) {\n    return { kind: \"internal\", path: normalized };\n  }\n  // Tolerate an extensionless link to a markdown note (`notes/plan` → `.md`).\n  if (!HAS_EXTENSION.test(normalized) && options.knownPaths.has(`${normalized}.md`)) {\n    return { kind: \"internal\", path: `${normalized}.md` };\n  }\n  return null;\n}\n\nfunction dirOf(path: string): string {\n  const slash = path.lastIndexOf(\"/\");\n  return slash === -1 ? \"\" : path.slice(0, slash);\n}\n\nfunction decodeSegment(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\n/**\n * Join `base` + `rel`, resolving `.`/`..` segments. Returns `null` if `..`\n * walks above the vault root.\n */\nfunction normalizeWorkspacePath(base: string, rel: string): string | null {\n  const parts = base ? base.split(\"/\") : [];\n  for (const segment of rel.split(\"/\")) {\n    if (segment === \"\" || segment === \".\") {\n      continue;\n    }\n    if (segment === \"..\") {\n      if (parts.length === 0) {\n        return null;\n      }\n      parts.pop();\n      continue;\n    }\n    parts.push(segment);\n  }\n  return parts.join(\"/\");\n}\n"],"mappings":";AAuBA,MAAM,aAAa;AACnB,MAAM,gBAAgB;AAWf,SAAS,qBACd,MACA,SAC8B;AAC9B,QAAM,MAAM,KAAK,KAAK;AACtB,MAAI,QAAQ,MAAM,IAAI,WAAW,GAAG,GAAG;AAErC,WAAO;AAAA,EACT;AACA,MAAI,WAAW,KAAK,GAAG,KAAK,IAAI,WAAW,IAAI,GAAG;AAChD,WAAO,EAAE,MAAM,YAAY,MAAM,IAAI;AAAA,EACvC;AAGA,QAAM,WAAW,cAAc,IAAI,MAAM,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;AAC5D,MAAI,aAAa,IAAI;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,SAAS,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,KAAK,MAAM,QAAQ,QAAQ;AACxF,QAAM,aAAa,uBAAuB,MAAM,QAAQ;AACxD,MAAI,eAAe,MAAM;AAEvB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,WAAW,IAAI,UAAU,GAAG;AACtC,WAAO,EAAE,MAAM,YAAY,MAAM,WAAW;AAAA,EAC9C;AAEA,MAAI,CAAC,cAAc,KAAK,UAAU,KAAK,QAAQ,WAAW,IAAI,GAAG,UAAU,KAAK,GAAG;AACjF,WAAO,EAAE,MAAM,YAAY,MAAM,GAAG,UAAU,MAAM;AAAA,EACtD;AACA,SAAO;AACT;AAEA,SAAS,MAAM,MAAsB;AACnC,QAAM,QAAQ,KAAK,YAAY,GAAG;AAClC,SAAO,UAAU,KAAK,KAAK,KAAK,MAAM,GAAG,KAAK;AAChD;AAEA,SAAS,cAAc,OAAuB;AAC5C,MAAI;AACF,WAAO,mBAAmB,KAAK;AAAA,EACjC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,SAAS,uBAAuB,MAAc,KAA4B;AACxE,QAAM,QAAQ,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;AACxC,aAAW,WAAW,IAAI,MAAM,GAAG,GAAG;AACpC,QAAI,YAAY,MAAM,YAAY,KAAK;AACrC;AAAA,IACF;AACA,QAAI,YAAY,MAAM;AACpB,UAAI,MAAM,WAAW,GAAG;AACtB,eAAO;AAAA,MACT;AACA,YAAM,IAAI;AACV;AAAA,IACF;AACA,UAAM,KAAK,OAAO;AAAA,EACpB;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Core value types for the editor's public surface.
+ *
+ * `SourceRange` is a half-open byte range into the document; `DocumentTextChange`
+ * describes one edit. They are structurally identical to the host app's own
+ * range/change types, so a host can pass its `onChange` straight through without
+ * adapting — structural typing makes them interchangeable.
+ */
+/** A half-open range into the document, in UTF-8 byte offsets. */
+interface SourceRange {
+    start: number;
+    end: number;
+}
+/** One text edit: the replaced byte range and the text inserted in its place. */
+interface DocumentTextChange {
+    range: SourceRange;
+    text: string;
+}
+
+export type { DocumentTextChange, SourceRange };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latentic/live-markdown",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "license": "MIT",
   "description": "WYSIWYG markdown editor for React, built on CodeMirror 6. Headings, tables, LaTeX math and Mermaid diagrams render inline as you type \u2014 no preview pane and no AST: value in and onChange out is the same markdown string, frontmatter included.",
@@ -54,7 +54,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./styles.css": "./dist/styles.css"
+    "./styles.css": "./dist/styles.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
   },
   "files": [
     "dist",
@@ -69,7 +73,7 @@
     "*.css"
   ],
   "scripts": {
-    "build": "tsup && cp src/styles.css dist/styles.css",
+    "build": "tsup && node scripts/specifier-extensions.mjs && cp src/styles.css dist/styles.css",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:browser": "vitest run --config vitest.browser.config.ts",