@immediately-run/sdk 0.23.0 → 0.24.0

package/dist/components/WikiLink.cjs

@@ -22,20 +22,65 @@ __export(WikiLink_exports, {
 });
 module.exports = __toCommonJS(WikiLink_exports);
 var import_jsx_runtime = require("react/jsx-runtime");
+var import_react = require("react");
 var import_Link = require("./Link");
+var import_Include = require("./Include");
+var import_TinkerableContext = require("../TinkerableContext");
 const labelFromTarget = (target) => {
   const base = target.split(/[\\/]/).pop() ?? target;
   return base.replace(/\.mdx?$/i, "") || target;
 };
+const normalize = (path) => {
+  const out = [];
+  for (const seg of path.split("/")) {
+    if (seg === "" || seg === ".") continue;
+    if (seg === "..") out.pop();
+    else out.push(seg);
+  }
+  return "/" + out.join("/");
+};
+const resolveWikiTarget = (target, currentFile) => {
+  if (target.startsWith("/")) return normalize(target);
+  if (!currentFile) return void 0;
+  const dir = currentFile.slice(0, currentFile.lastIndexOf("/"));
+  return normalize(`${dir}/${target}`);
+};
 const WikiLink = ({
   target,
   label,
   children,
   ...rest
 }) => {
-  const href = target ?? "";
-  const text = children ?? label ?? labelFromTarget(href);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Link.Link, { href, className: "ir-wikilink", ...rest, children: text });
+  const { filesMetadata } = (0, import_react.use)(import_TinkerableContext.TinkerableContext);
+  const renderContext = (0, import_react.use)(import_Include.RenderExportedComponentContext);
+  const currentFile = renderContext?.evaluationContext?.evaluation?.module?.filepath;
+  const rawTarget = target ?? "";
+  const text = children ?? label ?? (rawTarget ? labelFromTarget(rawTarget) : "");
+  if (!rawTarget) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "ir-wikilink", ...rest, children: text });
+  }
+  const resolved = resolveWikiTarget(rawTarget, currentFile);
+  const files = filesMetadata ?? {};
+  const loaded = Object.keys(files).length > 0;
+  if (resolved !== void 0) {
+    if (currentFile && resolved === currentFile) {
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "ir-wikilink ir-wikilink-self", "data-state": "self", ...rest, children: text });
+    }
+    const exists = !loaded || resolved in files;
+    if (!exists) {
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        "span",
+        {
+          className: "ir-wikilink ir-wikilink-broken",
+          "data-state": "broken",
+          title: `No file at ${resolved}`,
+          ...rest,
+          children: text
+        }
+      );
+    }
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Link.Link, { href: rawTarget, className: "ir-wikilink", "data-state": "resolved", ...rest, children: text });
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/components/WikiLink.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/WikiLink.tsx"],"sourcesContent":["import { ReactNode } from 'react';\nimport { Link } from './Link';\n\n/** Derive a human label from a target path: basename without the extension. */\nconst labelFromTarget = (target: string): string => {\n  const base = target.split(/[\\\\/]/).pop() ?? target;\n  return base.replace(/\\.mdx?$/i, '') || target;\n};\n\n/**\n * Default MDX `WikiLink` component — the render target for the `[[target]]` /\n * `[[label|target]]` wiki-link syntax (the transpiler remark plugin, R3-153,\n * compiles that syntax to `<WikiLink target=\"…\" label=\"…\">`, carrying the raw\n * target verbatim; resolution lives here in the component, MARKDOWN_SYNTAX_SPEC\n * §13.2).\n *\n * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a\n * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —\n * relative (resolved against the current file by the router) or absolute — with\n * **no implicit search path** (§13.3, a deliberate departure from Obsidian).\n * Routes through {@link Link}, so a same-app path navigates in-app and an\n * external href renders as a plain `<a>`.\n *\n * Honesty note (R3-151): this default is the routing baseline. The\n * existence-driven resolved/broken/self visual states (§13.3) are layered on by\n * R3-153; today a link to a missing path simply routes as a normal in-app link.\n * An app overrides this component to add its own states/styling (the headline\n * late-binding capability, §11.1).\n */\nexport const WikiLink = ({\n  target,\n  label,\n  children,\n  ...rest\n}: {\n  target?: string;\n  label?: ReactNode;\n  children?: ReactNode;\n} & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>): ReactNode => {\n  const href = target ?? '';\n  const text = children ?? label ?? labelFromTarget(href);\n  return (\n    <Link href={href} className=\"ir-wikilink\" {...rest}>\n      {text}\n    </Link>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0CI;AAzCJ,kBAAqB;AAGrB,MAAM,kBAAkB,CAAC,WAA2B;AAClD,QAAM,OAAO,OAAO,MAAM,OAAO,EAAE,IAAI,KAAK;AAC5C,SAAO,KAAK,QAAQ,YAAY,EAAE,KAAK;AACzC;AAsBO,MAAM,WAAW,CAAC;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAI+E;AAC7E,QAAM,OAAO,UAAU;AACvB,QAAM,OAAO,YAAY,SAAS,gBAAgB,IAAI;AACtD,SACE,4CAAC,oBAAK,MAAY,WAAU,eAAe,GAAG,MAC3C,gBACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/components/WikiLink.tsx"],"sourcesContent":["import { ReactNode, use } from 'react';\nimport { Link } from './Link';\nimport { RenderExportedComponentContext } from './Include';\nimport { TinkerableContext } from '../TinkerableContext';\n\n/** Derive a human label from a target path: basename without the extension. */\nconst labelFromTarget = (target: string): string => {\n  const base = target.split(/[\\\\/]/).pop() ?? target;\n  return base.replace(/\\.mdx?$/i, '') || target;\n};\n\n/** Collapse `.`/`..`/empty segments into a clean absolute path. */\nconst normalize = (path: string): string => {\n  const out: string[] = [];\n  for (const seg of path.split('/')) {\n    if (seg === '' || seg === '.') continue;\n    if (seg === '..') out.pop();\n    else out.push(seg);\n  }\n  return '/' + out.join('/');\n};\n\n/**\n * Resolve a wiki-link target to an absolute sandbox path, or `undefined` when it\n * cannot be resolved (a relative target with no known current file). An\n * **absolute** target (`/…`) is taken verbatim; a **relative** target resolves\n * against the current file's directory. Pure path arithmetic (MARKDOWN_SYNTAX_SPEC\n * §13.2) — it never touches the filesystem or any other file.\n */\nconst resolveWikiTarget = (target: string, currentFile?: string): string | undefined => {\n  if (target.startsWith('/')) return normalize(target);\n  if (!currentFile) return undefined;\n  const dir = currentFile.slice(0, currentFile.lastIndexOf('/'));\n  return normalize(`${dir}/${target}`);\n};\n\n/**\n * Default MDX `WikiLink` component — the render target for the `[[target]]` /\n * `[[label|target]]` wiki-link syntax. The transpiler remark plugin (R3-153)\n * compiles that syntax to `<WikiLink target=\"…\" label=\"…\">`, carrying the raw\n * target/label verbatim; **resolution lives here** (MARKDOWN_SYNTAX_SPEC §13.2).\n *\n * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a\n * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —\n * relative (resolved against the current file's directory) or absolute — with\n * **no implicit search path** (§13.3, a deliberate departure from Obsidian).\n *\n * The **current file** — the one the link is *authored in* — is read from the\n * ambient `<Include>` render context. Every MDX file renders through `<Include>`\n * (`FileRouter` renders even the top-level file that way), and Include publishes\n * the rendered module's `EvaluationContext` to its subtree via\n * {@link RenderExportedComponentContext}; the nearest one's\n * `evaluation.module.filepath` is this file's own `/app/…` path. Because that\n * context nests with each `<Include>`, a relative target inside an included\n * fragment resolves against the **fragment**, not the top-level page in the URL.\n *\n * The resolved path is checked for **existence** against the live metadata store\n * (keyed by absolute `/app/…` paths) for the three states (§13.3):\n * - **self** — the resolved path is the current file: inert text, no link.\n * - **broken** — no file at the resolved path (and the store has loaded): rendered\n *   as marked text, **not** a throw.\n * - **resolved** — routed through {@link Link} (in-app navigation for a same-app\n *   href, a plain `<a>` otherwise).\n *\n * The check is **optimistic until the metadata store loads** (an empty store never\n * flashes \"broken\"), and a relative target with no ambient render context (MDX\n * rendered outside `<Include>`) routes optimistically. Such an app overrides this\n * component (§11) for precise resolution.\n */\nexport const WikiLink = ({\n  target,\n  label,\n  children,\n  ...rest\n}: {\n  target?: string;\n  label?: ReactNode;\n  children?: ReactNode;\n} & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>): ReactNode => {\n  const { filesMetadata } = use(TinkerableContext);\n  const renderContext = use(RenderExportedComponentContext);\n  const currentFile = renderContext?.evaluationContext?.evaluation?.module?.filepath;\n\n  const rawTarget = target ?? '';\n  const text = children ?? label ?? (rawTarget ? labelFromTarget(rawTarget) : '');\n\n  // Defensive: the kernel never emits an empty target, but a hand-written\n  // `<WikiLink>` might. Render inert text rather than a link to nowhere.\n  if (!rawTarget) {\n    return (\n      <span className=\"ir-wikilink\" {...rest}>\n        {text}\n      </span>\n    );\n  }\n\n  const resolved = resolveWikiTarget(rawTarget, currentFile);\n  const files = filesMetadata ?? {};\n  const loaded = Object.keys(files).length > 0;\n\n  // `resolved === undefined` ⇒ a relative target with no known current file: route\n  // it optimistically (can't check existence or self-ness generically).\n  if (resolved !== undefined) {\n    if (currentFile && resolved === currentFile) {\n      return (\n        <span className=\"ir-wikilink ir-wikilink-self\" data-state=\"self\" {...rest}>\n          {text}\n        </span>\n      );\n    }\n    const exists = !loaded || resolved in files; // optimistic until loaded\n    if (!exists) {\n      return (\n        <span\n          className=\"ir-wikilink ir-wikilink-broken\"\n          data-state=\"broken\"\n          title={`No file at ${resolved}`}\n          {...rest}\n        >\n          {text}\n        </span>\n      );\n    }\n  }\n  return (\n    <Link href={rawTarget} className=\"ir-wikilink\" data-state=\"resolved\" {...rest}>\n      {text}\n    </Link>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0FM;AA1FN,mBAA+B;AAC/B,kBAAqB;AACrB,qBAA+C;AAC/C,+BAAkC;AAGlC,MAAM,kBAAkB,CAAC,WAA2B;AAClD,QAAM,OAAO,OAAO,MAAM,OAAO,EAAE,IAAI,KAAK;AAC5C,SAAO,KAAK,QAAQ,YAAY,EAAE,KAAK;AACzC;AAGA,MAAM,YAAY,CAAC,SAAyB;AAC1C,QAAM,MAAgB,CAAC;AACvB,aAAW,OAAO,KAAK,MAAM,GAAG,GAAG;AACjC,QAAI,QAAQ,MAAM,QAAQ,IAAK;AAC/B,QAAI,QAAQ,KAAM,KAAI,IAAI;AAAA,QACrB,KAAI,KAAK,GAAG;AAAA,EACnB;AACA,SAAO,MAAM,IAAI,KAAK,GAAG;AAC3B;AASA,MAAM,oBAAoB,CAAC,QAAgB,gBAA6C;AACtF,MAAI,OAAO,WAAW,GAAG,EAAG,QAAO,UAAU,MAAM;AACnD,MAAI,CAAC,YAAa,QAAO;AACzB,QAAM,MAAM,YAAY,MAAM,GAAG,YAAY,YAAY,GAAG,CAAC;AAC7D,SAAO,UAAU,GAAG,GAAG,IAAI,MAAM,EAAE;AACrC;AAmCO,MAAM,WAAW,CAAC;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAI+E;AAC7E,QAAM,EAAE,cAAc,QAAI,kBAAI,0CAAiB;AAC/C,QAAM,oBAAgB,kBAAI,6CAA8B;AACxD,QAAM,cAAc,eAAe,mBAAmB,YAAY,QAAQ;AAE1E,QAAM,YAAY,UAAU;AAC5B,QAAM,OAAO,YAAY,UAAU,YAAY,gBAAgB,SAAS,IAAI;AAI5E,MAAI,CAAC,WAAW;AACd,WACE,4CAAC,UAAK,WAAU,eAAe,GAAG,MAC/B,gBACH;AAAA,EAEJ;AAEA,QAAM,WAAW,kBAAkB,WAAW,WAAW;AACzD,QAAM,QAAQ,iBAAiB,CAAC;AAChC,QAAM,SAAS,OAAO,KAAK,KAAK,EAAE,SAAS;AAI3C,MAAI,aAAa,QAAW;AAC1B,QAAI,eAAe,aAAa,aAAa;AAC3C,aACE,4CAAC,UAAK,WAAU,gCAA+B,cAAW,QAAQ,GAAG,MAClE,gBACH;AAAA,IAEJ;AACA,UAAM,SAAS,CAAC,UAAU,YAAY;AACtC,QAAI,CAAC,QAAQ;AACX,aACE;AAAA,QAAC;AAAA;AAAA,UACC,WAAU;AAAA,UACV,cAAW;AAAA,UACX,OAAO,cAAc,QAAQ;AAAA,UAC5B,GAAG;AAAA,UAEH;AAAA;AAAA,MACH;AAAA,IAEJ;AAAA,EACF;AACA,SACE,4CAAC,oBAAK,MAAM,WAAW,WAAU,eAAc,cAAW,YAAY,GAAG,MACtE,gBACH;AAEJ;","names":[]}

package/dist/components/WikiLink.d.cts

@@ -2,23 +2,36 @@ import { ReactNode } from 'react';
 
 /**
  * Default MDX `WikiLink` component — the render target for the `[[target]]` /
- * `[[label|target]]` wiki-link syntax (the transpiler remark plugin, R3-153,
+ * `[[label|target]]` wiki-link syntax. The transpiler remark plugin (R3-153)
  * compiles that syntax to `<WikiLink target="…" label="…">`, carrying the raw
- * target verbatim; resolution lives here in the component, MARKDOWN_SYNTAX_SPEC
- * §13.2).
+ * target/label verbatim; **resolution lives here** (MARKDOWN_SYNTAX_SPEC §13.2).
  *
  * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a
  * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —
- * relative (resolved against the current file by the router) or absolute — with
+ * relative (resolved against the current file's directory) or absolute — with
  * **no implicit search path** (§13.3, a deliberate departure from Obsidian).
- * Routes through {@link Link}, so a same-app path navigates in-app and an
- * external href renders as a plain `<a>`.
  *
- * Honesty note (R3-151): this default is the routing baseline. The
- * existence-driven resolved/broken/self visual states (§13.3) are layered on by
- * R3-153; today a link to a missing path simply routes as a normal in-app link.
- * An app overrides this component to add its own states/styling (the headline
- * late-binding capability, §11.1).
+ * The **current file** — the one the link is *authored in* — is read from the
+ * ambient `<Include>` render context. Every MDX file renders through `<Include>`
+ * (`FileRouter` renders even the top-level file that way), and Include publishes
+ * the rendered module's `EvaluationContext` to its subtree via
+ * {@link RenderExportedComponentContext}; the nearest one's
+ * `evaluation.module.filepath` is this file's own `/app/…` path. Because that
+ * context nests with each `<Include>`, a relative target inside an included
+ * fragment resolves against the **fragment**, not the top-level page in the URL.
+ *
+ * The resolved path is checked for **existence** against the live metadata store
+ * (keyed by absolute `/app/…` paths) for the three states (§13.3):
+ * - **self** — the resolved path is the current file: inert text, no link.
+ * - **broken** — no file at the resolved path (and the store has loaded): rendered
+ *   as marked text, **not** a throw.
+ * - **resolved** — routed through {@link Link} (in-app navigation for a same-app
+ *   href, a plain `<a>` otherwise).
+ *
+ * The check is **optimistic until the metadata store loads** (an empty store never
+ * flashes "broken"), and a relative target with no ambient render context (MDX
+ * rendered outside `<Include>`) routes optimistically. Such an app overrides this
+ * component (§11) for precise resolution.
  */
 declare const WikiLink: ({ target, label, children, ...rest }: {
     target?: string;

package/dist/components/WikiLink.d.ts

@@ -2,23 +2,36 @@ import { ReactNode } from 'react';
 
 /**
  * Default MDX `WikiLink` component — the render target for the `[[target]]` /
- * `[[label|target]]` wiki-link syntax (the transpiler remark plugin, R3-153,
+ * `[[label|target]]` wiki-link syntax. The transpiler remark plugin (R3-153)
  * compiles that syntax to `<WikiLink target="…" label="…">`, carrying the raw
- * target verbatim; resolution lives here in the component, MARKDOWN_SYNTAX_SPEC
- * §13.2).
+ * target/label verbatim; **resolution lives here** (MARKDOWN_SYNTAX_SPEC §13.2).
  *
  * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a
  * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —
- * relative (resolved against the current file by the router) or absolute — with
+ * relative (resolved against the current file's directory) or absolute — with
  * **no implicit search path** (§13.3, a deliberate departure from Obsidian).
- * Routes through {@link Link}, so a same-app path navigates in-app and an
- * external href renders as a plain `<a>`.
  *
- * Honesty note (R3-151): this default is the routing baseline. The
- * existence-driven resolved/broken/self visual states (§13.3) are layered on by
- * R3-153; today a link to a missing path simply routes as a normal in-app link.
- * An app overrides this component to add its own states/styling (the headline
- * late-binding capability, §11.1).
+ * The **current file** — the one the link is *authored in* — is read from the
+ * ambient `<Include>` render context. Every MDX file renders through `<Include>`
+ * (`FileRouter` renders even the top-level file that way), and Include publishes
+ * the rendered module's `EvaluationContext` to its subtree via
+ * {@link RenderExportedComponentContext}; the nearest one's
+ * `evaluation.module.filepath` is this file's own `/app/…` path. Because that
+ * context nests with each `<Include>`, a relative target inside an included
+ * fragment resolves against the **fragment**, not the top-level page in the URL.
+ *
+ * The resolved path is checked for **existence** against the live metadata store
+ * (keyed by absolute `/app/…` paths) for the three states (§13.3):
+ * - **self** — the resolved path is the current file: inert text, no link.
+ * - **broken** — no file at the resolved path (and the store has loaded): rendered
+ *   as marked text, **not** a throw.
+ * - **resolved** — routed through {@link Link} (in-app navigation for a same-app
+ *   href, a plain `<a>` otherwise).
+ *
+ * The check is **optimistic until the metadata store loads** (an empty store never
+ * flashes "broken"), and a relative target with no ambient render context (MDX
+ * rendered outside `<Include>`) routes optimistically. Such an app overrides this
+ * component (§11) for precise resolution.
  */
 declare const WikiLink: ({ target, label, children, ...rest }: {
     target?: string;

package/dist/components/WikiLink.js

@@ -1,18 +1,63 @@
 import { jsx } from "react/jsx-runtime";
+import { use } from "react";
 import { Link } from "./Link";
+import { RenderExportedComponentContext } from "./Include";
+import { TinkerableContext } from "../TinkerableContext";
 const labelFromTarget = (target) => {
   const base = target.split(/[\\/]/).pop() ?? target;
   return base.replace(/\.mdx?$/i, "") || target;
 };
+const normalize = (path) => {
+  const out = [];
+  for (const seg of path.split("/")) {
+    if (seg === "" || seg === ".") continue;
+    if (seg === "..") out.pop();
+    else out.push(seg);
+  }
+  return "/" + out.join("/");
+};
+const resolveWikiTarget = (target, currentFile) => {
+  if (target.startsWith("/")) return normalize(target);
+  if (!currentFile) return void 0;
+  const dir = currentFile.slice(0, currentFile.lastIndexOf("/"));
+  return normalize(`${dir}/${target}`);
+};
 const WikiLink = ({
   target,
   label,
   children,
   ...rest
 }) => {
-  const href = target ?? "";
-  const text = children ?? label ?? labelFromTarget(href);
-  return /* @__PURE__ */ jsx(Link, { href, className: "ir-wikilink", ...rest, children: text });
+  const { filesMetadata } = use(TinkerableContext);
+  const renderContext = use(RenderExportedComponentContext);
+  const currentFile = renderContext?.evaluationContext?.evaluation?.module?.filepath;
+  const rawTarget = target ?? "";
+  const text = children ?? label ?? (rawTarget ? labelFromTarget(rawTarget) : "");
+  if (!rawTarget) {
+    return /* @__PURE__ */ jsx("span", { className: "ir-wikilink", ...rest, children: text });
+  }
+  const resolved = resolveWikiTarget(rawTarget, currentFile);
+  const files = filesMetadata ?? {};
+  const loaded = Object.keys(files).length > 0;
+  if (resolved !== void 0) {
+    if (currentFile && resolved === currentFile) {
+      return /* @__PURE__ */ jsx("span", { className: "ir-wikilink ir-wikilink-self", "data-state": "self", ...rest, children: text });
+    }
+    const exists = !loaded || resolved in files;
+    if (!exists) {
+      return /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "ir-wikilink ir-wikilink-broken",
+          "data-state": "broken",
+          title: `No file at ${resolved}`,
+          ...rest,
+          children: text
+        }
+      );
+    }
+  }
+  return /* @__PURE__ */ jsx(Link, { href: rawTarget, className: "ir-wikilink", "data-state": "resolved", ...rest, children: text });
 };
 export {
   WikiLink

package/dist/components/WikiLink.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/WikiLink.tsx"],"sourcesContent":["import { ReactNode } from 'react';\nimport { Link } from './Link';\n\n/** Derive a human label from a target path: basename without the extension. */\nconst labelFromTarget = (target: string): string => {\n  const base = target.split(/[\\\\/]/).pop() ?? target;\n  return base.replace(/\\.mdx?$/i, '') || target;\n};\n\n/**\n * Default MDX `WikiLink` component — the render target for the `[[target]]` /\n * `[[label|target]]` wiki-link syntax (the transpiler remark plugin, R3-153,\n * compiles that syntax to `<WikiLink target=\"…\" label=\"…\">`, carrying the raw\n * target verbatim; resolution lives here in the component, MARKDOWN_SYNTAX_SPEC\n * §13.2).\n *\n * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a\n * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —\n * relative (resolved against the current file by the router) or absolute — with\n * **no implicit search path** (§13.3, a deliberate departure from Obsidian).\n * Routes through {@link Link}, so a same-app path navigates in-app and an\n * external href renders as a plain `<a>`.\n *\n * Honesty note (R3-151): this default is the routing baseline. The\n * existence-driven resolved/broken/self visual states (§13.3) are layered on by\n * R3-153; today a link to a missing path simply routes as a normal in-app link.\n * An app overrides this component to add its own states/styling (the headline\n * late-binding capability, §11.1).\n */\nexport const WikiLink = ({\n  target,\n  label,\n  children,\n  ...rest\n}: {\n  target?: string;\n  label?: ReactNode;\n  children?: ReactNode;\n} & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>): ReactNode => {\n  const href = target ?? '';\n  const text = children ?? label ?? labelFromTarget(href);\n  return (\n    <Link href={href} className=\"ir-wikilink\" {...rest}>\n      {text}\n    </Link>\n  );\n};\n"],"mappings":"AA0CI;AAzCJ,SAAS,YAAY;AAGrB,MAAM,kBAAkB,CAAC,WAA2B;AAClD,QAAM,OAAO,OAAO,MAAM,OAAO,EAAE,IAAI,KAAK;AAC5C,SAAO,KAAK,QAAQ,YAAY,EAAE,KAAK;AACzC;AAsBO,MAAM,WAAW,CAAC;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAI+E;AAC7E,QAAM,OAAO,UAAU;AACvB,QAAM,OAAO,YAAY,SAAS,gBAAgB,IAAI;AACtD,SACE,oBAAC,QAAK,MAAY,WAAU,eAAe,GAAG,MAC3C,gBACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/components/WikiLink.tsx"],"sourcesContent":["import { ReactNode, use } from 'react';\nimport { Link } from './Link';\nimport { RenderExportedComponentContext } from './Include';\nimport { TinkerableContext } from '../TinkerableContext';\n\n/** Derive a human label from a target path: basename without the extension. */\nconst labelFromTarget = (target: string): string => {\n  const base = target.split(/[\\\\/]/).pop() ?? target;\n  return base.replace(/\\.mdx?$/i, '') || target;\n};\n\n/** Collapse `.`/`..`/empty segments into a clean absolute path. */\nconst normalize = (path: string): string => {\n  const out: string[] = [];\n  for (const seg of path.split('/')) {\n    if (seg === '' || seg === '.') continue;\n    if (seg === '..') out.pop();\n    else out.push(seg);\n  }\n  return '/' + out.join('/');\n};\n\n/**\n * Resolve a wiki-link target to an absolute sandbox path, or `undefined` when it\n * cannot be resolved (a relative target with no known current file). An\n * **absolute** target (`/…`) is taken verbatim; a **relative** target resolves\n * against the current file's directory. Pure path arithmetic (MARKDOWN_SYNTAX_SPEC\n * §13.2) — it never touches the filesystem or any other file.\n */\nconst resolveWikiTarget = (target: string, currentFile?: string): string | undefined => {\n  if (target.startsWith('/')) return normalize(target);\n  if (!currentFile) return undefined;\n  const dir = currentFile.slice(0, currentFile.lastIndexOf('/'));\n  return normalize(`${dir}/${target}`);\n};\n\n/**\n * Default MDX `WikiLink` component — the render target for the `[[target]]` /\n * `[[label|target]]` wiki-link syntax. The transpiler remark plugin (R3-153)\n * compiles that syntax to `<WikiLink target=\"…\" label=\"…\">`, carrying the raw\n * target/label verbatim; **resolution lives here** (MARKDOWN_SYNTAX_SPEC §13.2).\n *\n * Registered in {@link DEFAULT_MDX_COMPONENTS} so wiki-links render even in a\n * plain-markdown repo (§11.2 phantom defaults). Targets are **paths only** —\n * relative (resolved against the current file's directory) or absolute — with\n * **no implicit search path** (§13.3, a deliberate departure from Obsidian).\n *\n * The **current file** — the one the link is *authored in* — is read from the\n * ambient `<Include>` render context. Every MDX file renders through `<Include>`\n * (`FileRouter` renders even the top-level file that way), and Include publishes\n * the rendered module's `EvaluationContext` to its subtree via\n * {@link RenderExportedComponentContext}; the nearest one's\n * `evaluation.module.filepath` is this file's own `/app/…` path. Because that\n * context nests with each `<Include>`, a relative target inside an included\n * fragment resolves against the **fragment**, not the top-level page in the URL.\n *\n * The resolved path is checked for **existence** against the live metadata store\n * (keyed by absolute `/app/…` paths) for the three states (§13.3):\n * - **self** — the resolved path is the current file: inert text, no link.\n * - **broken** — no file at the resolved path (and the store has loaded): rendered\n *   as marked text, **not** a throw.\n * - **resolved** — routed through {@link Link} (in-app navigation for a same-app\n *   href, a plain `<a>` otherwise).\n *\n * The check is **optimistic until the metadata store loads** (an empty store never\n * flashes \"broken\"), and a relative target with no ambient render context (MDX\n * rendered outside `<Include>`) routes optimistically. Such an app overrides this\n * component (§11) for precise resolution.\n */\nexport const WikiLink = ({\n  target,\n  label,\n  children,\n  ...rest\n}: {\n  target?: string;\n  label?: ReactNode;\n  children?: ReactNode;\n} & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>): ReactNode => {\n  const { filesMetadata } = use(TinkerableContext);\n  const renderContext = use(RenderExportedComponentContext);\n  const currentFile = renderContext?.evaluationContext?.evaluation?.module?.filepath;\n\n  const rawTarget = target ?? '';\n  const text = children ?? label ?? (rawTarget ? labelFromTarget(rawTarget) : '');\n\n  // Defensive: the kernel never emits an empty target, but a hand-written\n  // `<WikiLink>` might. Render inert text rather than a link to nowhere.\n  if (!rawTarget) {\n    return (\n      <span className=\"ir-wikilink\" {...rest}>\n        {text}\n      </span>\n    );\n  }\n\n  const resolved = resolveWikiTarget(rawTarget, currentFile);\n  const files = filesMetadata ?? {};\n  const loaded = Object.keys(files).length > 0;\n\n  // `resolved === undefined` ⇒ a relative target with no known current file: route\n  // it optimistically (can't check existence or self-ness generically).\n  if (resolved !== undefined) {\n    if (currentFile && resolved === currentFile) {\n      return (\n        <span className=\"ir-wikilink ir-wikilink-self\" data-state=\"self\" {...rest}>\n          {text}\n        </span>\n      );\n    }\n    const exists = !loaded || resolved in files; // optimistic until loaded\n    if (!exists) {\n      return (\n        <span\n          className=\"ir-wikilink ir-wikilink-broken\"\n          data-state=\"broken\"\n          title={`No file at ${resolved}`}\n          {...rest}\n        >\n          {text}\n        </span>\n      );\n    }\n  }\n  return (\n    <Link href={rawTarget} className=\"ir-wikilink\" data-state=\"resolved\" {...rest}>\n      {text}\n    </Link>\n  );\n};\n"],"mappings":"AA0FM;AA1FN,SAAoB,WAAW;AAC/B,SAAS,YAAY;AACrB,SAAS,sCAAsC;AAC/C,SAAS,yBAAyB;AAGlC,MAAM,kBAAkB,CAAC,WAA2B;AAClD,QAAM,OAAO,OAAO,MAAM,OAAO,EAAE,IAAI,KAAK;AAC5C,SAAO,KAAK,QAAQ,YAAY,EAAE,KAAK;AACzC;AAGA,MAAM,YAAY,CAAC,SAAyB;AAC1C,QAAM,MAAgB,CAAC;AACvB,aAAW,OAAO,KAAK,MAAM,GAAG,GAAG;AACjC,QAAI,QAAQ,MAAM,QAAQ,IAAK;AAC/B,QAAI,QAAQ,KAAM,KAAI,IAAI;AAAA,QACrB,KAAI,KAAK,GAAG;AAAA,EACnB;AACA,SAAO,MAAM,IAAI,KAAK,GAAG;AAC3B;AASA,MAAM,oBAAoB,CAAC,QAAgB,gBAA6C;AACtF,MAAI,OAAO,WAAW,GAAG,EAAG,QAAO,UAAU,MAAM;AACnD,MAAI,CAAC,YAAa,QAAO;AACzB,QAAM,MAAM,YAAY,MAAM,GAAG,YAAY,YAAY,GAAG,CAAC;AAC7D,SAAO,UAAU,GAAG,GAAG,IAAI,MAAM,EAAE;AACrC;AAmCO,MAAM,WAAW,CAAC;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAI+E;AAC7E,QAAM,EAAE,cAAc,IAAI,IAAI,iBAAiB;AAC/C,QAAM,gBAAgB,IAAI,8BAA8B;AACxD,QAAM,cAAc,eAAe,mBAAmB,YAAY,QAAQ;AAE1E,QAAM,YAAY,UAAU;AAC5B,QAAM,OAAO,YAAY,UAAU,YAAY,gBAAgB,SAAS,IAAI;AAI5E,MAAI,CAAC,WAAW;AACd,WACE,oBAAC,UAAK,WAAU,eAAe,GAAG,MAC/B,gBACH;AAAA,EAEJ;AAEA,QAAM,WAAW,kBAAkB,WAAW,WAAW;AACzD,QAAM,QAAQ,iBAAiB,CAAC;AAChC,QAAM,SAAS,OAAO,KAAK,KAAK,EAAE,SAAS;AAI3C,MAAI,aAAa,QAAW;AAC1B,QAAI,eAAe,aAAa,aAAa;AAC3C,aACE,oBAAC,UAAK,WAAU,gCAA+B,cAAW,QAAQ,GAAG,MAClE,gBACH;AAAA,IAEJ;AACA,UAAM,SAAS,CAAC,UAAU,YAAY;AACtC,QAAI,CAAC,QAAQ;AACX,aACE;AAAA,QAAC;AAAA;AAAA,UACC,WAAU;AAAA,UACV,cAAW;AAAA,UACX,OAAO,cAAc,QAAQ;AAAA,UAC5B,GAAG;AAAA,UAEH;AAAA;AAAA,MACH;AAAA,IAEJ;AAAA,EACF;AACA,SACE,oBAAC,QAAK,MAAM,WAAW,WAAU,eAAc,cAAW,YAAY,GAAG,MACtE,gBACH;AAEJ;","names":[]}

package/dist/version.cjs

@@ -21,7 +21,7 @@ __export(version_exports, {
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(version_exports);
-const SDK_VERSION = "0.23.0";
+const SDK_VERSION = "0.24.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SDK_VERSION

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.23.0';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.24.0';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAM,cAAc;","names":[]}

package/dist/version.d.cts

@@ -1,4 +1,4 @@
 /** This SDK's package version, baked from package.json at build (SP2-6). */
-declare const SDK_VERSION = "0.23.0";
+declare const SDK_VERSION = "0.24.0";
 
 export { SDK_VERSION };

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /** This SDK's package version, baked from package.json at build (SP2-6). */
-declare const SDK_VERSION = "0.23.0";
+declare const SDK_VERSION = "0.24.0";
 
 export { SDK_VERSION };

package/dist/version.js

@@ -1,4 +1,4 @@
-const SDK_VERSION = "0.23.0";
+const SDK_VERSION = "0.24.0";
 export {
   SDK_VERSION
 };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.23.0';\n"],"mappings":"AAIO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.24.0';\n"],"mappings":"AAIO,MAAM,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sdk",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
   "license": "MIT",
   "repository": "github:immediately-run/immediately-run-sdk",