@backmatter/studio 0.0.17 → 0.0.18

package/dist/chunks/{dashboard-Dsaeud2x.js → dashboard-B4FITg6c.js}

@@ -3,7 +3,7 @@ var Xe = (e, t, n) => t in e ? Ke(e, t, { enumerable: !0, configurable: !0, writ
 var D = (e, t, n) => Xe(e, typeof t != "symbol" ? t + "" : t, n);
 import { jsxs as k, jsx as o, Fragment as ge } from "react/jsx-runtime";
 import { useRef as Ye, useCallback as Qe, useSyncExternalStore as Ze, useState as w, useEffect as V, lazy as et, Suspense as tt } from "react";
-import { U as nt, aj as ve, ak as rt, P as _, al as st, p as it, am as at, an as Ne, ao as Ce, ap as Ie, aq as ot, ar as lt, N as qe, as as ct, at as ie, ad as J, W as ze, au as ut, av as Fe, ae as dt, ag as re, a7 as Q, a8 as Z, V as ae, aw as ft, Q as z, ax as ht, G as be, ay as ee, af as pt, az as gt, aA as mt, aB as xt, f as yt, aC as vt, a3 as bt, aD as wt, aE as kt, w as St, B as Et, F as Rt, aF as _t, aG as Ot, aH as Tt, H as Pt, aI as jt, R as Lt, I as At, J as Ut, K as Nt, L as F, M as Ct, O as It } from "./WorkspaceRoutes-DH1LD-2Q.js";
+import { U as nt, aj as ve, ak as rt, P as _, al as st, p as it, am as at, an as Ne, ao as Ce, ap as Ie, aq as ot, ar as lt, N as qe, as as ct, at as ie, ad as J, W as ze, au as ut, av as Fe, ae as dt, ag as re, a7 as Q, a8 as Z, V as ae, aw as ft, Q as z, ax as ht, G as be, ay as ee, af as pt, az as gt, aA as mt, aB as xt, f as yt, aC as vt, a3 as bt, aD as wt, aE as kt, w as St, B as Et, F as Rt, aF as _t, aG as Ot, aH as Tt, H as Pt, aI as jt, R as Lt, I as At, J as Ut, K as Nt, L as F, M as Ct, O as It } from "./WorkspaceRoutes-DVvb3N-V.js";
 const te = /* @__PURE__ */ Object.create(null), W = (e) => {
   var t, n;
   return ((t = globalThis.process) == null ? void 0 : t.env) || ((n = globalThis.Deno) == null ? void 0 : n.env.toObject()) || globalThis.__env__ || (e ? te : globalThis);
@@ -1702,7 +1702,7 @@ function kr(e) {
   const t = e.replace(/\/$/, "") || "/";
   return t === "/__ui" || /^\/__ui\/[^/]+$/.test(t);
 }
-const Sr = et(() => import("./UiKitApp-D7vllRQE.js").then((e) => ({
+const Sr = et(() => import("./UiKitApp-DkuQBiQZ.js").then((e) => ({
   default: e.UiKitApp
 })));
 function Pr() {

package/dist/chunks/{index-CGMqw2NH.js → index-CegtXnEI.js}

@@ -1,7 +1,7 @@
 var Rs = Object.defineProperty;
 var Es = (r, e, t) => e in r ? Rs(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
 var M = (r, e, t) => Es(r, typeof e != "symbol" ? e + "" : e, t);
-import { aJ as Bt, aK as Bs, aL as a0, aM as ct, aN as xt, aO as ea, aP as Gn, aQ as Is, aR as Ls, aS as Ds, aT as La, aU as Ps, aV as Os, aW as Le, aX as qs } from "./WorkspaceRoutes-DH1LD-2Q.js";
+import { aJ as Bt, aK as Bs, aL as a0, aM as ct, aN as xt, aO as ea, aP as Gn, aQ as Is, aR as Ls, aS as Ds, aT as La, aU as Ps, aV as Os, aW as Le, aX as qs } from "./WorkspaceRoutes-DVvb3N-V.js";
 function Fs() {
   return {
     enter: {

package/dist/dashboard.js

@@ -1,5 +1,5 @@
-import { A as a, i as s } from "./chunks/dashboard-Dsaeud2x.js";
-import { z as t, A as f } from "./chunks/WorkspaceRoutes-DH1LD-2Q.js";
+import { A as a, i as s } from "./chunks/dashboard-B4FITg6c.js";
+import { z as t, A as f } from "./chunks/WorkspaceRoutes-DVvb3N-V.js";
 export {
   a as DashboardApp,
   t as configureStudio,

package/dist/index.js

@@ -1,7 +1,7 @@
 import { jsx as t, jsxs as u } from "react/jsx-runtime";
 import { useLayoutEffect as ae, useEffect as f, useRef as Q, useState as h, useMemo as se } from "react";
-import { i as X, T as ce, E as le, C as ue, a as de, b as xe, u as me, D as _, c as Y, d as I, e as fe, f as Z, g as G, h as pe, p as E, j as C, k as he, l as ge, m as S, r as we, n as be, s as ye, o as ve, q as ke, t as qe, v as ze, w as Ee, B as Ce, x as Ne, S as Se, y as Re, z as ee, A as U, F as Pe, G as Le, H as Ue, R as je, I as Te, J as Me, K as $e, L as R, N as K, M as De, O as Fe, P as H, Q as Oe } from "./chunks/WorkspaceRoutes-DH1LD-2Q.js";
-import { U as lt } from "./chunks/WorkspaceRoutes-DH1LD-2Q.js";
+import { i as X, T as ce, E as le, C as ue, a as de, b as xe, u as me, D as _, c as Y, d as I, e as fe, f as Z, g as G, h as pe, p as E, j as C, k as he, l as ge, m as S, r as we, n as be, s as ye, o as ve, q as ke, t as qe, v as ze, w as Ee, B as Ce, x as Ne, S as Se, y as Re, z as ee, A as U, F as Pe, G as Le, H as Ue, R as je, I as Te, J as Me, K as $e, L as R, N as K, M as De, O as Fe, P as H, Q as Oe } from "./chunks/WorkspaceRoutes-DVvb3N-V.js";
+import { U as lt } from "./chunks/WorkspaceRoutes-DVvb3N-V.js";
 import { u as Ae, S as Be } from "./chunks/define-studio-DlYjgrwr.js";
 import { d as dt } from "./chunks/define-studio-DlYjgrwr.js";
 const P = {

package/dist/studio.css

@@ -537,10 +537,6 @@
     animation-duration: .2s;
   }
 
-  .xof6966 {
-    animation-duration: .7s;
-  }
-
   .xemfg65 {
     animation-duration: .8s;
   }
@@ -561,10 +557,6 @@
     animation-name: x18re5ia-B;
   }
 
-  .xpedhrg {
-    animation-name: x1fy8ia8-B;
-  }
-
   .x1bzz7ut {
     animation-name: x1tbvpe3-B;
   }
@@ -1125,6 +1117,10 @@
     grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
+  .xbqmlv7 {
+    grid-template-columns: repeat(4, 48px);
+  }
+
   .x1sipb5g {
     grid-template-columns: repeat(4, minmax(0, 1fr));
   }
@@ -1974,6 +1970,10 @@
     bottom: var(--xvc7yhn);
   }
 
+  .xmll18r {
+    height: 1.25rem;
+  }
+
   .x5yr21d {
     height: 100%;
   }
@@ -2638,6 +2638,10 @@
     top: var(--x1y1rrep);
   }
 
+  .xwqq7k2 {
+    width: 1.25rem;
+  }
+
   .xh8yej3 {
     width: 100%;
   }
@@ -2738,6 +2742,10 @@
     width: 4.5rem;
   }
 
+  .x100vrsf {
+    width: 40px;
+  }
+
   .x187nhsf {
     width: 44px;
   }
@@ -2778,6 +2786,10 @@
     width: calc(min(360px, 38vw) - 48px);
   }
 
+  .xeq5yr9 {
+    width: fit-content;
+  }
+
   .x3bfboh {
     width: min(360px, 38vw);
   }
@@ -3022,12 +3034,6 @@
   }
 }
 
-@keyframes x1fy8ia8-B {
-  to {
-    transform: rotate(360deg);
-  }
-}
-
 @keyframes x1wc8ddo-B {
   from {
     transform: rotate(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backmatter/studio",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "The Backmatter editing surface: document editor, AI chat, publish. Mounted on your site or hosted on the dashboard.",
   "type": "module",
   "publishConfig": {
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@ai-sdk/react": "^4.0.100",
-    "@backmatter/core": "^0.0.34",
+    "@backmatter/core": "^0.0.35",
     "@base-ui/react": "^1.6.0",
     "@central-icons-react/round-outlined-radius-2-stroke-1.5": "1.2.15",
     "@dnd-kit/abstract": "^0.5.0",

package/src/api.ts

@@ -350,8 +350,11 @@ export function unbindGithub(workspaceId: string) {
 
 export type SchemaField = {
   kind: string;
+  multiple?: boolean;
   required?: boolean;
   relationTo?: string;
+  to?: "internal" | "external";
+  models?: string[];
   object?: string;
   fields?: Record<string, SchemaField>;
   /** Studio input name from `field.text({ input })`; see `defineStudio`. */

package/src/{pages/code-session-routes.ts → content-routes.ts}

@@ -1,4 +1,4 @@
-// packages/studio/src/pages/code-session-routes.ts
+// packages/studio/src/content-routes.ts
 import {
   isRoutable,
   isTemplateSlug,
@@ -7,15 +7,15 @@ import {
   type RouteModel,
 } from "@backmatter/core";
 
-export type ContentRouteModel = RouteModel & {
+type ContentFileModel = RouteModel & {
   path: string;
   external?: boolean;
   template?: string;
 };
 
-/** Public routes for the content files in a code session checkout. */
-export function contentRoutes(
-  models: readonly ContentRouteModel[],
+/** Public routes for content files. A file that is not a routable document is skipped. */
+export function routesForContentFiles(
+  models: readonly ContentFileModel[],
   files: readonly string[],
 ): string[] {
   const routes = new Set<string>();
@@ -35,7 +35,7 @@ export function contentRoutes(
 }
 
 /** Routes whose path contains the address query. A blank query keeps the full list. */
-export function matchingRoutes(routes: readonly string[], query: string): string[] {
+export function routesMatching(routes: readonly string[], query: string): string[] {
   const needle = query.trim().toLowerCase();
   if (!needle) return [...routes];
   return routes.filter((route) => route.toLowerCase().includes(needle));

package/src/fields/FieldControl.tsx

@@ -8,6 +8,7 @@ import { colors, radius, space, type } from "../styles/tokens.stylex";
 import { Input, Select, Textarea } from "../ui/Input";
 import { MediaFieldInput } from "../pages/MediaFieldInput";
 import { chooseFieldInput } from "./choose-field-input";
+import { LinkFieldInput } from "./LinkFieldInput";
 import { nestedStartsCollapsed, resolveObjectFields } from "./resolve-object-fields";
 
 function clamp(n: number, min: number, max: number): number {
@@ -88,7 +89,13 @@ export function JsonField({
   );
 }
 
-type ModelRef = { type: string; external?: boolean; fields?: Record<string, SchemaField> };
+type ModelRef = {
+  type: string;
+  external?: boolean;
+  route?: string | false;
+  indexSlug?: string;
+  fields?: Record<string, SchemaField>;
+};
 type RelationDocument = { slug: string; frontmatter: Record<string, unknown> };
 type RelationDocumentLists = Record<string, RelationDocument[]>;
 
@@ -542,7 +549,9 @@ export function FieldControl({
   }
 
   if (kind === "media") {
-    return <MediaFieldInput name={name} value={value} readOnly={readOnly} onChange={onChange} />;
+    return (
+      <MediaFieldInput name={name} field={field} value={value} readOnly={readOnly} onChange={onChange} />
+    );
   }
 
   if (kind === "relation") {
@@ -559,6 +568,20 @@ export function FieldControl({
     );
   }
 
+  if (kind === "link") {
+    return (
+      <LinkFieldInput
+        name={name}
+        field={field}
+        value={value}
+        models={models}
+        documentLists={documentLists}
+        readOnly={readOnly}
+        onChange={onChange}
+      />
+    );
+  }
+
   if (kind === "boolean") {
     return (
       <input

package/src/fields/LinkFieldInput.tsx

@@ -0,0 +1,315 @@
+// packages/studio/src/fields/LinkFieldInput.tsx
+import { useRef, useState } from "react";
+import * as stylex from "@stylexjs/stylex";
+import {
+  documentLabel,
+  internalSuffixError,
+  joinInternalLink,
+  linkSide,
+  matchesWhere,
+  routeFor,
+  splitInternalLink,
+} from "@backmatter/core";
+import type { SchemaField } from "../api";
+import { colors, radius, space, type } from "../styles/tokens.stylex";
+import { Input, Select } from "../ui/Input";
+
+type ModelRef = {
+  type: string;
+  external?: boolean;
+  route?: string | false;
+  indexSlug?: string;
+  fields?: Record<string, SchemaField>;
+};
+type RelationDocument = { slug: string; frontmatter: Record<string, unknown> };
+type RelationDocumentLists = Record<string, RelationDocument[]>;
+
+function routableTypes(field: SchemaField, models: ModelRef[]): ModelRef[] {
+  if (field.models && field.models.length > 0) {
+    return field.models
+      .map((type) => models.find((model) => model.type === type))
+      .filter((model): model is ModelRef => Boolean(model && !model.external && model.route !== false));
+  }
+  return models.filter((model) => !model.external && model.route !== false);
+}
+
+function suffixPresent(value: string): { query: boolean; anchor: boolean } {
+  const hashIndex = value.indexOf("#");
+  const preHash = hashIndex === -1 ? value : value.slice(0, hashIndex);
+  return { query: preHash.includes("?"), anchor: hashIndex !== -1 };
+}
+
+function internalSuffixState(value: string): {
+  parts: ReturnType<typeof splitInternalLink>;
+  showSuffix: boolean;
+  selectValue: string;
+} {
+  const parts = splitInternalLink(value);
+  const side = linkSide(value);
+  if (side !== "internal") {
+    return { parts, showSuffix: false, selectValue: value };
+  }
+  const present = suffixPresent(value);
+  const suffixErr = internalSuffixError(
+    { query: parts.query, anchor: parts.anchor },
+    present,
+  );
+  if (suffixErr !== null) {
+    return { parts, showSuffix: false, selectValue: value };
+  }
+  return { parts, showSuffix: true, selectValue: parts.path };
+}
+
+function buildRouteOptions(
+  field: SchemaField,
+  models: ModelRef[],
+  documentLists: RelationDocumentLists | undefined,
+): Array<{ value: string; label: string }> {
+  if (!documentLists) return [];
+  const options: Array<{ value: string; label: string }> = [];
+  for (const model of routableTypes(field, models)) {
+    const docs = documentLists[model.type] ?? [];
+    for (const doc of docs) {
+      if (!matchesWhere({ slug: doc.slug, frontmatter: doc.frontmatter }, field.where)) {
+        continue;
+      }
+      const route = routeFor(model, doc.slug);
+      if (route === "") continue;
+      const label = documentLabel(doc.frontmatter, model);
+      options.push({
+        value: route,
+        label: label ? `${label} ${route}` : route,
+      });
+    }
+  }
+  options.sort((a, b) => a.label.localeCompare(b.label));
+  return options;
+}
+
+function SideToggle({
+  internalPressed,
+  readOnly,
+  onPick,
+}: {
+  internalPressed: boolean;
+  readOnly?: boolean;
+  onPick: (side: "internal" | "external") => void;
+}) {
+  return (
+    <div {...stylex.props(styles.sideRow)}>
+      <button
+        type="button"
+        aria-pressed={internalPressed}
+        disabled={readOnly}
+        {...stylex.props(styles.sideButton, internalPressed && styles.sideButtonPressed)}
+        onClick={() => {
+          if (readOnly || internalPressed) return;
+          onPick("internal");
+        }}
+      >
+        Internal
+      </button>
+      <button
+        type="button"
+        aria-pressed={!internalPressed}
+        disabled={readOnly}
+        {...stylex.props(styles.sideButton, !internalPressed && styles.sideButtonPressed)}
+        onClick={() => {
+          if (readOnly || !internalPressed) return;
+          onPick("external");
+        }}
+      >
+        External
+      </button>
+    </div>
+  );
+}
+
+export function LinkFieldInput({
+  name,
+  field,
+  value,
+  models,
+  documentLists,
+  readOnly,
+  onChange,
+}: {
+  name: string;
+  field: SchemaField;
+  value: unknown;
+  models: ModelRef[];
+  documentLists?: RelationDocumentLists;
+  readOnly?: boolean;
+  onChange: (value: unknown) => void;
+}) {
+  const raw = value == null || value === "" ? "" : String(value);
+  const sideToggle = field.to === undefined;
+  const lastEmittedRawRef = useRef<string | null>(null);
+  const emitChange = (next: unknown) => {
+    lastEmittedRawRef.current = next == null || next === "" ? "" : String(next);
+    onChange(next);
+  };
+  const [editorSide, setEditorSide] = useState<"internal" | "external">(() =>
+    linkSide(raw) === "external" ? "external" : "internal",
+  );
+  const [pendingClearOf, setPendingClearOf] = useState<string | null>(null);
+  const [lastSyncedRaw, setLastSyncedRaw] = useState(raw);
+  if (raw !== lastSyncedRaw) {
+    setLastSyncedRaw(raw);
+    if (raw !== lastEmittedRawRef.current) {
+      lastEmittedRawRef.current = null;
+      if (raw !== "") {
+        setEditorSide(linkSide(raw) === "external" ? "external" : "internal");
+      }
+    }
+    if (pendingClearOf !== null && raw !== pendingClearOf) {
+      setPendingClearOf(null);
+    }
+  }
+
+  if (field.to === "external") {
+    return (
+      <Input
+        value={raw}
+        readOnly={readOnly}
+        onChange={(event) => {
+          if (readOnly) return;
+          const next = event.target.value;
+          emitChange(next === "" ? undefined : next);
+        }}
+      />
+    );
+  }
+
+  const forceInternal = field.to === "internal";
+  const internalUi = forceInternal || editorSide !== "external";
+  const staleInternalOnExternalSide =
+    editorSide === "external" && raw !== "" && raw === pendingClearOf;
+  const externalInputValue = staleInternalOnExternalSide ? "" : raw;
+
+  if (!internalUi) {
+    return (
+      <div {...stylex.props(styles.stack)}>
+        {sideToggle ? (
+          <SideToggle
+            internalPressed={false}
+            readOnly={readOnly}
+            onPick={(picked) => {
+              if (readOnly) return;
+              setEditorSide(picked);
+              if (raw !== "") {
+                setPendingClearOf(raw);
+                emitChange(undefined);
+              }
+            }}
+          />
+        ) : null}
+        <Input
+          value={externalInputValue}
+          readOnly={readOnly}
+          onChange={(event) => {
+            if (readOnly) return;
+            const next = event.target.value;
+            emitChange(next === "" ? undefined : next);
+          }}
+        />
+      </div>
+    );
+  }
+
+  const { parts, showSuffix, selectValue } = raw === "" ? {
+    parts: { path: "", query: "", anchor: "" },
+    showSuffix: false,
+    selectValue: "",
+  } : internalSuffixState(raw);
+
+  const options = buildRouteOptions(field, models, documentLists);
+  if (selectValue && !options.some((option) => option.value === selectValue)) {
+    options.unshift({ value: selectValue, label: selectValue });
+  }
+
+  const internalPressed = editorSide !== "external";
+
+  return (
+    <div {...stylex.props(styles.stack)}>
+      {sideToggle ? (
+        <SideToggle
+          internalPressed={internalPressed}
+          readOnly={readOnly}
+          onPick={(picked) => {
+            if (readOnly) return;
+            setEditorSide(picked);
+            if (raw !== "") {
+              setPendingClearOf(raw);
+              emitChange(undefined);
+            }
+          }}
+        />
+      ) : null}
+      <Select
+        name={name}
+        chip
+        searchable
+        clearable={!field.required}
+        placeholder="Select a value"
+        options={options}
+        value={selectValue || null}
+        disabled={readOnly}
+        onValueChange={(next) => {
+          if (readOnly) return;
+          if (next == null) {
+            emitChange(undefined);
+            return;
+          }
+          emitChange(joinInternalLink(next, showSuffix ? parts.query : "", showSuffix ? parts.anchor : ""));
+        }}
+      />
+      <Input
+        aria-label="Query"
+        value={showSuffix ? parts.query : ""}
+        readOnly={readOnly || !showSuffix}
+        onChange={(event) => {
+          if (readOnly || !showSuffix) return;
+          emitChange(joinInternalLink(parts.path, event.target.value, parts.anchor));
+        }}
+      />
+      <Input
+        aria-label="Anchor"
+        value={showSuffix ? parts.anchor : ""}
+        readOnly={readOnly || !showSuffix}
+        onChange={(event) => {
+          if (readOnly || !showSuffix) return;
+          emitChange(joinInternalLink(parts.path, parts.query, event.target.value));
+        }}
+      />
+    </div>
+  );
+}
+
+const styles = stylex.create({
+  stack: {
+    display: "flex",
+    flexDirection: "column",
+    gap: space.sm,
+  },
+  sideRow: {
+    display: "flex",
+    gap: space.xs,
+  },
+  sideButton: {
+    paddingInline: space.md,
+    paddingBlock: space.xs,
+    borderRadius: radius.md,
+    borderWidth: 1,
+    borderStyle: "solid",
+    borderColor: colors.border,
+    backgroundColor: colors.bgInput,
+    color: colors.text,
+    fontSize: type.sm,
+    cursor: "pointer",
+  },
+  sideButtonPressed: {
+    borderColor: colors.text,
+    fontWeight: 600,
+  },
+});

package/src/fields/choose-field-input.ts

@@ -14,6 +14,7 @@ export type FieldInputKind =
   | "boolean"
   | "number"
   | "blocks"
+  | "link"
   | "text";
 
 export function chooseFieldInput(
@@ -48,6 +49,10 @@ export function chooseFieldInput(
     return "text";
   }
 
+  if (field.kind === "link") {
+    return "link";
+  }
+
   if (field.kind === "object") {
     return "object";
   }

package/src/fields/link-targets.ts

@@ -0,0 +1,60 @@
+// packages/studio/src/fields/link-targets.ts
+import type { SchemaField } from "../api";
+import { resolveObjectFields } from "./resolve-object-fields";
+
+type ModelRef = { type: string; external?: boolean; route?: string | false };
+type ObjectDef = { name: string; fields: Record<string, SchemaField> };
+
+function modelTypeLoadable(type: string, models: ModelRef[]): boolean {
+  const model = models.find((item) => item.type === type);
+  return Boolean(model && !model.external && model.route !== false);
+}
+
+function collectFromFields(
+  fields: Record<string, SchemaField>,
+  models: ModelRef[],
+  objects: ObjectDef[],
+  visiting: Set<string>,
+  targets: Set<string>,
+): void {
+  for (const field of Object.values(fields)) {
+    if (field.kind === "link") {
+      if (field.to === "external") {
+        // external-only links do not load documents
+      } else if (field.models && field.models.length > 0) {
+        for (const type of field.models) {
+          if (modelTypeLoadable(type, models)) {
+            targets.add(type);
+          }
+        }
+      } else {
+        for (const model of models) {
+          if (!model.external && model.route !== false) {
+            targets.add(model.type);
+          }
+        }
+      }
+    }
+
+    const nested = resolveObjectFields(field, objects);
+    if (!nested) continue;
+
+    let nextVisiting = visiting;
+    if (field.object && (field.kind === "object" || field.kind === "array")) {
+      if (visiting.has(field.object)) continue;
+      nextVisiting = new Set(visiting).add(field.object);
+    }
+
+    collectFromFields(nested, models, objects, nextVisiting, targets);
+  }
+}
+
+export function linkDocumentTypes(
+  fields: Record<string, SchemaField>,
+  models: ModelRef[],
+  objects: ObjectDef[],
+): string[] {
+  const targets = new Set<string>();
+  collectFromFields(fields, models, objects, new Set<string>(), targets);
+  return [...targets].sort();
+}

package/src/host-path.ts

@@ -0,0 +1,13 @@
+// packages/studio/src/host-path.ts
+
+/** A typed or pasted address, as a path on the host. */
+export function hostPath(input: string): string {
+  const trimmed = input.trim();
+  if (!trimmed) return "/";
+  try {
+    const url = new URL(trimmed);
+    return `${url.pathname}${url.search}${url.hash}` || "/";
+  } catch {
+    return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  }
+}