@hoardodile/ui 0.1.5 → 0.1.7

package/dist/res-card-template/template.js

@@ -0,0 +1,333 @@
+import { parseTemplateFragments, parseTemplateExpression } from '@hoardodile/sdk-types/template';
+import prettyBytes from 'pretty-bytes';
+
+// src/res-card-template/template.ts
+function formatBytes(bytes) {
+  if (bytes === void 0) return "";
+  if (!Number.isFinite(bytes) || bytes <= 0) return "0 B";
+  return prettyBytes(bytes, { binary: true }).replaceAll("iB", "B");
+}
+function formatClockDuration(ms) {
+  if (!Number.isFinite(ms) || ms < 0) return "";
+  const totalSeconds = Math.floor(ms / 1e3);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  if (hours > 0) {
+    return `${hours}:${String(minutes).padStart(2, "0")}:${String(seconds).padStart(2, "0")}`;
+  }
+  return `${minutes}:${String(seconds).padStart(2, "0")}`;
+}
+
+// src/res-card-template/icon.ts
+var LEGACY_ICON_ALIASES = {
+  Files: "file",
+  Film: "video-frame",
+  Image: "gallery",
+  Info: "info-circle",
+  Music: "music-notes",
+  Search: "magnifier",
+  Sparkle: "star",
+  Video: "video-frame"
+};
+function normalizeSolarGlyphName(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  const aliased = LEGACY_ICON_ALIASES[trimmed];
+  if (aliased !== void 0) return aliased;
+  if (/^[a-z][a-z0-9-]*$/.test(trimmed)) return trimmed;
+  if (/^[A-Za-z][A-Za-z0-9]*$/.test(trimmed)) {
+    return trimmed.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+  }
+  return void 0;
+}
+function parseIconRef(raw, pluginId, buildAssetUrl) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed.startsWith("http://") || trimmed.startsWith("https://") || trimmed.startsWith("data:")) {
+    return void 0;
+  }
+  if (trimmed.includes(".") || trimmed.includes("/") || trimmed.includes("\\")) {
+    const rel = trimmed.replace(/^\.[\\/]/, "");
+    if (rel.length === 0 || rel.split("/").includes("..")) return void 0;
+    return { kind: "asset", url: buildAssetUrl(pluginId, rel) };
+  }
+  const name = normalizeSolarGlyphName(trimmed);
+  if (name === void 0) return void 0;
+  return { kind: "icon", name };
+}
+
+// src/res-card-template/template.ts
+function resolvePath(segments, scope) {
+  const [namespace, ...rest] = segments;
+  const root = namespace === "file" ? scope.file : namespace === "searchMeta" ? scope.searchMeta : namespace === "data" ? scope.data : namespace === "coverMeta" ? scope.coverMeta : scope.source;
+  if (root === void 0 || root === null) return void 0;
+  let current = root;
+  for (const key of rest) {
+    if (typeof current !== "object" || current === null) return void 0;
+    current = current[key];
+  }
+  return current;
+}
+function resolveLocaleString(value, locale) {
+  if (typeof value === "string") return value;
+  const exact = value[locale];
+  if (exact !== void 0) return exact;
+  const base = locale.split("-")[0] ?? locale;
+  const partial = value[base];
+  if (partial !== void 0) return partial;
+  const first = Object.values(value)[0];
+  return first ?? "";
+}
+function evaluateExpression(expr, scope, ctx) {
+  if (expr.kind === "path") {
+    const value = resolvePath(expr.segments, scope);
+    if (value === void 0 || value === null) return "";
+    return String(value);
+  }
+  return evaluateCall(expr.name, expr.args, scope, ctx);
+}
+function evaluateCall(name, args, scope, ctx) {
+  switch (name) {
+    case "bytes":
+      return callPipe(
+        args,
+        scope,
+        ctx,
+        (value) => typeof value === "number" ? formatBytes(value) : ""
+      );
+    case "duration":
+      return callPipe(
+        args,
+        scope,
+        ctx,
+        (value) => typeof value === "number" ? formatClockDuration(value) : ""
+      );
+    case "number":
+      return callPipe(
+        args,
+        scope,
+        ctx,
+        (value) => typeof value === "number" && Number.isFinite(value) ? value.toLocaleString() : ""
+      );
+    case "inc":
+      return callPipe(
+        args,
+        scope,
+        ctx,
+        (value) => typeof value === "number" && Number.isFinite(value) ? String(value + 1) : ""
+      );
+    case "eq":
+      return compareCall(args, scope, ctx, (a, b) => a === b);
+    case "ne":
+      return compareCall(args, scope, ctx, (a, b) => a !== b);
+    case "gt":
+      return compareCall(args, scope, ctx, (a, b) => {
+        if (typeof a !== "number" || typeof b !== "number") return false;
+        return a > b;
+      });
+    case "lt":
+      return compareCall(args, scope, ctx, (a, b) => {
+        if (typeof a !== "number" || typeof b !== "number") return false;
+        return a < b;
+      });
+    case "gte":
+      return compareCall(args, scope, ctx, (a, b) => {
+        if (typeof a !== "number" || typeof b !== "number") return false;
+        return a >= b;
+      });
+    case "lte":
+      return compareCall(args, scope, ctx, (a, b) => {
+        if (typeof a !== "number" || typeof b !== "number") return false;
+        return a <= b;
+      });
+    case "if":
+      return callIf(args, scope, ctx);
+    case "t":
+      return callT(args, ctx);
+    case "icon":
+      return callIcon(args, ctx);
+    case "asset":
+      return callAsset(args, ctx);
+    case "kind":
+      return callKind(args, scope, ctx);
+    case "searchKindIcons":
+      return callSearchKindIcons(scope, ctx);
+    case "join":
+      return callJoin(args, scope, ctx);
+    default:
+      return "";
+  }
+}
+function callPipe(args, scope, ctx, pipeFn) {
+  const value = evaluateArgAsPrimitive(args[0], scope, ctx);
+  return pipeFn(value);
+}
+function callT(args, ctx) {
+  const key = evaluateArgAsString(args[0]);
+  if (key.length === 0) return "";
+  const map = ctx.manifest.i18n;
+  if (map === void 0) return "";
+  const value = map[key];
+  if (value === void 0) return "";
+  return resolveLocaleString(value, ctx.locale);
+}
+function callIcon(args, ctx) {
+  const name = evaluateArgAsString(args[0]);
+  if (name.length === 0) return null;
+  return ctx.renderIcon({ kind: "icon", name }, ctx.iconClassName);
+}
+function callAsset(args, ctx) {
+  const path = evaluateArgAsString(args[0]);
+  if (path.length === 0) return null;
+  const ref = parseIconRef(path, ctx.pluginId, ctx.buildAssetUrl);
+  if (ref === void 0) return null;
+  return ctx.renderIcon(ref, ctx.iconClassName);
+}
+function callKind(args, scope, ctx) {
+  const key = evaluateArgAsString(args[0]);
+  if (key.length === 0) return null;
+  const kinds = ctx.manifest.ui?.search?.kinds;
+  if (kinds === void 0) return null;
+  const match = kinds.find((k) => k.key === key);
+  if (match === void 0 || match.icon === void 0) return null;
+  const rendered = renderCardTemplate(match.icon, scope, ctx);
+  if (rendered === null || rendered === void 0 || rendered === "")
+    return null;
+  return rendered;
+}
+function callSearchKindIcons(scope, ctx) {
+  if (scope.searchMeta === void 0 || scope.searchMeta === null || typeof scope.searchMeta !== "object")
+    return [];
+  const facets = scope.searchMeta.facets;
+  if (facets === void 0 || typeof facets !== "object" || facets === null)
+    return [];
+  const kinds = ctx.manifest.ui?.search?.kinds;
+  if (kinds === void 0) return [];
+  const results = [];
+  for (const kind of kinds) {
+    if (kind.icon === void 0) continue;
+    const active = facets[kind.key];
+    if (active !== true) continue;
+    const rendered = renderCardTemplate(kind.icon, scope, ctx);
+    if (rendered === null || rendered === void 0 || rendered === "") continue;
+    results.push(rendered);
+  }
+  return results;
+}
+function callJoin(args, scope, ctx) {
+  if (args.length === 0) return "";
+  const separator = evaluateArgAsString(args[0]);
+  const items = [];
+  for (let i = 1; i < args.length; i++) {
+    const val = evaluateArg(args[i], scope, ctx);
+    if (Array.isArray(val)) {
+      for (const item of val) {
+        if (item !== null && item !== void 0 && item !== "") {
+          items.push(item);
+        }
+      }
+      continue;
+    }
+    if (val !== null && val !== void 0 && val !== "") {
+      items.push(val);
+    }
+  }
+  if (items.length === 0) return "";
+  if (items.every((item) => typeof item === "string")) {
+    return items.join(separator);
+  }
+  if (separator.length === 0) return items;
+  const interleaved = [];
+  for (let i = 0; i < items.length; i++) {
+    if (i > 0) interleaved.push(separator);
+    interleaved.push(items[i]);
+  }
+  return interleaved;
+}
+function evaluateArgAsPrimitive(arg, scope, ctx) {
+  if (arg === void 0) return void 0;
+  if (arg.kind === "string") return arg.value;
+  if (arg.expr.kind === "path") {
+    const segments = arg.expr.segments;
+    if (segments.length === 1) {
+      const seg = segments[0];
+      const num = Number(seg);
+      if (!Number.isNaN(num)) return num;
+    }
+    return resolvePath(segments, scope);
+  }
+  if (arg.expr.kind === "call") {
+    const result = evaluateCall(arg.expr.name, arg.expr.args, scope, ctx);
+    if (typeof result === "string" || typeof result === "number") return result;
+    if (Array.isArray(result)) return result;
+    return void 0;
+  }
+  return void 0;
+}
+function evaluateArg(arg, scope, ctx) {
+  if (arg === void 0) return void 0;
+  if (arg.kind === "string") return arg.value;
+  return evaluateExpression(arg.expr, scope, ctx);
+}
+function compareCall(args, scope, ctx, cmp) {
+  const a = evaluateArgAsPrimitive(args[0], scope, ctx);
+  const b = evaluateArgAsPrimitive(args[1], scope, ctx);
+  return cmp(a, b) ? "true" : "";
+}
+function callIf(args, scope, ctx) {
+  const cond = evaluateArgAsPrimitive(args[0], scope, ctx);
+  const truthy = cond !== void 0 && cond !== null && cond !== "" && cond !== false && cond !== 0;
+  if (truthy) {
+    const raw = evaluateArgAsPrimitive(args[1], scope, ctx);
+    if (raw !== void 0) return raw;
+    return evaluateArg(args[1], scope, ctx);
+  }
+  if (args.length > 2) {
+    const raw = evaluateArgAsPrimitive(args[2], scope, ctx);
+    if (raw !== void 0) return raw;
+    return evaluateArg(args[2], scope, ctx);
+  }
+  return "";
+}
+function evaluateArgAsString(arg) {
+  if (arg === void 0) return "";
+  if (arg.kind === "string") return arg.value;
+  return "";
+}
+function renderCardTemplate(template, scope, ctx) {
+  if (template.length === 0) return "";
+  const fragments = parseTemplateFragments(template);
+  if (fragments.length === 0) return "";
+  const results = [];
+  for (const frag of fragments) {
+    if (frag.kind === "text") {
+      results.push(frag.value);
+      continue;
+    }
+    const expr = parseTemplateExpression(frag.source);
+    if (expr === void 0) {
+      continue;
+    }
+    const value = evaluateExpression(expr, scope, ctx);
+    if (value !== null && value !== void 0 && value !== "") {
+      results.push(value);
+    }
+  }
+  if (results.length === 0) return null;
+  if (results.length === 1) return results[0];
+  const allStrings = results.every((r) => typeof r === "string");
+  if (allStrings) return results.join("");
+  return results;
+}
+function renderSlotBadges(slotValues, scope, ctx) {
+  return slotValues.map((template) => renderCardTemplate(template, scope, ctx)).filter((n) => {
+    if (n === null || n === void 0 || n === "") return false;
+    if (Array.isArray(n) && n.length === 0) return false;
+    return true;
+  });
+}
+
+export { renderCardTemplate, renderSlotBadges, resolveLocaleString };
+//# sourceMappingURL=template.js.map
+//# sourceMappingURL=template.js.map

package/dist/res-card-template/template.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/res-card-template/format.ts","../../src/res-card-template/icon.ts","../../src/res-card-template/template.ts"],"names":[],"mappings":";;;;AAaO,SAAS,YAAY,KAAA,EAAmC;AAC9D,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,EAAA;AAChC,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,IAAS,GAAG,OAAO,KAAA;AAClD,EAAA,OAAO,WAAA,CAAY,OAAO,EAAE,MAAA,EAAQ,MAAM,CAAA,CAAE,UAAA,CAAW,IAAA,EAAM,GAAG,CAAA;AACjE;AAQO,SAAS,oBAAoB,EAAA,EAAoB;AACvD,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,EAAE,CAAA,IAAK,EAAA,GAAK,GAAG,OAAO,EAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,GAAI,CAAA;AACzC,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,YAAA,GAAe,IAAI,CAAA;AAC5C,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAO,YAAA,GAAe,OAAQ,EAAE,CAAA;AACrD,EAAA,MAAM,UAAU,YAAA,GAAe,EAAA;AAC/B,EAAA,IAAI,QAAQ,CAAA,EAAG;AACd,IAAA,OAAO,GAAG,KAAK,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,IAAI,MAAA,CAAO,OAAO,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,EACxF;AACA,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AACtD;;;ACrBA,IAAM,mBAAA,GAAwD;AAAA,EAC7D,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM,aAAA;AAAA,EACN,KAAA,EAAO,SAAA;AAAA,EACP,IAAA,EAAM,aAAA;AAAA,EACN,KAAA,EAAO,aAAA;AAAA,EACP,MAAA,EAAQ,WAAA;AAAA,EACR,OAAA,EAAS,MAAA;AAAA,EACT,KAAA,EAAO;AACR,CAAA;AAQO,SAAS,wBAAwB,GAAA,EAAiC;AACxE,EAAA,MAAM,OAAA,GAAU,IAAI,IAAA,EAAK;AACzB,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,MAAA;AACjC,EAAA,MAAM,OAAA,GAAU,oBAAoB,OAAO,CAAA;AAC3C,EAAA,IAAI,OAAA,KAAY,QAAW,OAAO,OAAA;AAClC,EAAA,IAAI,mBAAA,CAAoB,IAAA,CAAK,OAAO,CAAA,EAAG,OAAO,OAAA;AAC9C,EAAA,IAAI,wBAAA,CAAyB,IAAA,CAAK,OAAO,CAAA,EAAG;AAC3C,IAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,oBAAA,EAAsB,OAAO,EAAE,WAAA,EAAY;AAAA,EACnE;AACA,EAAA,OAAO,MAAA;AACR;AAeO,SAAS,YAAA,CACf,GAAA,EACA,QAAA,EACA,aAAA,EACsB;AACtB,EAAA,MAAM,OAAA,GAAU,IAAI,IAAA,EAAK;AACzB,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,MAAA;AACjC,EAAA,IACC,OAAA,CAAQ,UAAA,CAAW,SAAS,CAAA,IAC5B,OAAA,CAAQ,UAAA,CAAW,UAAU,CAAA,IAC7B,OAAA,CAAQ,UAAA,CAAW,OAAO,CAAA,EACzB;AACD,IAAA,OAAO,MAAA;AAAA,EACR;AACA,EAAA,IACC,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,IACpB,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,IACpB,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EACpB;AACD,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAA;AAC1C,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,CAAA,IAAK,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,QAAA,CAAS,IAAI,CAAA,EAAG,OAAO,MAAA;AAC9D,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,KAAK,aAAA,CAAc,QAAA,EAAU,GAAG,CAAA,EAAE;AAAA,EAC3D;AACA,EAAA,MAAM,IAAA,GAAO,wBAAwB,OAAO,CAAA;AAC5C,EAAA,IAAI,IAAA,KAAS,QAAW,OAAO,MAAA;AAC/B,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAK;AAC7B;;;AC9BA,SAAS,WAAA,CACR,UACA,KAAA,EACU;AACV,EAAA,MAAM,CAAC,SAAA,EAAW,GAAG,IAAI,CAAA,GAAI,QAAA;AAC7B,EAAA,MAAM,OACL,SAAA,KAAc,MAAA,GACX,KAAA,CAAM,IAAA,GACN,cAAc,YAAA,GACb,KAAA,CAAM,UAAA,GACN,SAAA,KAAc,SACb,KAAA,CAAM,IAAA,GACN,cAAc,WAAA,GACb,KAAA,CAAM,YACN,KAAA,CAAM,MAAA;AACb,EAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,EAAM,OAAO,MAAA;AAChD,EAAA,IAAI,OAAA,GAAmB,IAAA;AACvB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACvB,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,MAAM,OAAO,MAAA;AAC5D,IAAA,OAAA,GAAW,QAAoC,GAAG,CAAA;AAAA,EACnD;AACA,EAAA,OAAO,OAAA;AACR;AAUO,SAAS,mBAAA,CACf,OACA,MAAA,EACS;AACT,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,KAAA;AACtC,EAAA,MAAM,KAAA,GAAQ,MAAM,MAAM,CAAA;AAC1B,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,KAAA;AAChC,EAAA,MAAM,OAAO,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,MAAA;AACrC,EAAA,MAAM,OAAA,GAAU,MAAM,IAAI,CAAA;AAC1B,EAAA,IAAI,OAAA,KAAY,QAAW,OAAO,OAAA;AAClC,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,MAAA,CAAO,KAAK,EAAE,CAAC,CAAA;AACpC,EAAA,OAAO,KAAA,IAAS,EAAA;AACjB;AAIA,SAAS,kBAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACzB,IAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA;AAC9C,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM,OAAO,EAAA;AAClD,IAAA,OAAO,OAAO,KAAK,CAAA;AAAA,EACpB;AACA,EAAA,OAAO,aAAa,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,OAAO,GAAG,CAAA;AACrD;AAEA,SAAS,YAAA,CACR,IAAA,EACA,IAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,QAAQ,IAAA;AAAM,IACb,KAAK,OAAA;AACJ,MAAA,OAAO,QAAA;AAAA,QAAS,IAAA;AAAA,QAAM,KAAA;AAAA,QAAO,GAAA;AAAA,QAAK,CAAC,KAAA,KAClC,OAAO,UAAU,QAAA,GAAW,WAAA,CAAY,KAAK,CAAA,GAAI;AAAA,OAClD;AAAA,IACD,KAAK,UAAA;AACJ,MAAA,OAAO,QAAA;AAAA,QAAS,IAAA;AAAA,QAAM,KAAA;AAAA,QAAO,GAAA;AAAA,QAAK,CAAC,KAAA,KAClC,OAAO,UAAU,QAAA,GAAW,mBAAA,CAAoB,KAAK,CAAA,GAAI;AAAA,OAC1D;AAAA,IACD,KAAK,QAAA;AACJ,MAAA,OAAO,QAAA;AAAA,QAAS,IAAA;AAAA,QAAM,KAAA;AAAA,QAAO,GAAA;AAAA,QAAK,CAAC,KAAA,KAClC,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GAC/C,KAAA,CAAM,cAAA,EAAe,GACrB;AAAA,OACJ;AAAA,IACD,KAAK,KAAA;AACJ,MAAA,OAAO,QAAA;AAAA,QAAS,IAAA;AAAA,QAAM,KAAA;AAAA,QAAO,GAAA;AAAA,QAAK,CAAC,KAAA,KAClC,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GAC/C,MAAA,CAAO,KAAA,GAAQ,CAAC,CAAA,GAChB;AAAA,OACJ;AAAA,IACD,KAAK,IAAA;AACJ,MAAA,OAAO,WAAA,CAAY,MAAM,KAAA,EAAO,GAAA,EAAK,CAAC,CAAA,EAAG,CAAA,KAAM,MAAM,CAAC,CAAA;AAAA,IACvD,KAAK,IAAA;AACJ,MAAA,OAAO,WAAA,CAAY,MAAM,KAAA,EAAO,GAAA,EAAK,CAAC,CAAA,EAAG,CAAA,KAAM,MAAM,CAAC,CAAA;AAAA,IACvD,KAAK,IAAA;AACJ,MAAA,OAAO,YAAY,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,CAAC,GAAG,CAAA,KAAM;AAC9C,QAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,UAAU,OAAO,KAAA;AAC3D,QAAA,OAAO,CAAA,GAAI,CAAA;AAAA,MACZ,CAAC,CAAA;AAAA,IACF,KAAK,IAAA;AACJ,MAAA,OAAO,YAAY,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,CAAC,GAAG,CAAA,KAAM;AAC9C,QAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,UAAU,OAAO,KAAA;AAC3D,QAAA,OAAO,CAAA,GAAI,CAAA;AAAA,MACZ,CAAC,CAAA;AAAA,IACF,KAAK,KAAA;AACJ,MAAA,OAAO,YAAY,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,CAAC,GAAG,CAAA,KAAM;AAC9C,QAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,UAAU,OAAO,KAAA;AAC3D,QAAA,OAAO,CAAA,IAAK,CAAA;AAAA,MACb,CAAC,CAAA;AAAA,IACF,KAAK,KAAA;AACJ,MAAA,OAAO,YAAY,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,CAAC,GAAG,CAAA,KAAM;AAC9C,QAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,UAAU,OAAO,KAAA;AAC3D,QAAA,OAAO,CAAA,IAAK,CAAA;AAAA,MACb,CAAC,CAAA;AAAA,IACF,KAAK,IAAA;AACJ,MAAA,OAAO,MAAA,CAAO,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AAAA,IAC/B,KAAK,GAAA;AACJ,MAAA,OAAO,KAAA,CAAM,MAAM,GAAG,CAAA;AAAA,IACvB,KAAK,MAAA;AACJ,MAAA,OAAO,QAAA,CAAS,MAAM,GAAG,CAAA;AAAA,IAC1B,KAAK,OAAA;AACJ,MAAA,OAAO,SAAA,CAAU,MAAM,GAAG,CAAA;AAAA,IAC3B,KAAK,MAAA;AACJ,MAAA,OAAO,QAAA,CAAS,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AAAA,IACjC,KAAK,iBAAA;AACJ,MAAA,OAAO,mBAAA,CAAoB,OAAO,GAAG,CAAA;AAAA,IACtC,KAAK,MAAA;AACJ,MAAA,OAAO,QAAA,CAAS,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AAAA,IACjC;AACC,MAAA,OAAO,EAAA;AAAA;AAEV;AAEA,SAAS,QAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACA,MAAA,EACS;AACT,EAAA,MAAM,QAAQ,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACxD,EAAA,OAAO,OAAO,KAAK,CAAA;AACpB;AAEA,SAAS,KAAA,CAAM,MAAsB,GAAA,EAA8B;AAClE,EAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,IAAA,CAAK,CAAC,CAAC,CAAA;AACvC,EAAA,IAAI,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAC7B,EAAA,MAAM,GAAA,GAAM,IAAI,QAAA,CAAS,IAAA;AACzB,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,EAAA;AAC9B,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAG,CAAA;AACrB,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,EAAA;AAChC,EAAA,OAAO,mBAAA,CAAoB,KAAA,EAAO,GAAA,CAAI,MAAM,CAAA;AAC7C;AAEA,SAAS,QAAA,CAAS,MAAsB,GAAA,EAAiC;AACxE,EAAA,MAAM,IAAA,GAAO,mBAAA,CAAoB,IAAA,CAAK,CAAC,CAAC,CAAA;AACxC,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,IAAA;AAC9B,EAAA,OAAO,GAAA,CAAI,WAAW,EAAE,IAAA,EAAM,QAAQ,IAAA,EAAK,EAAG,IAAI,aAAa,CAAA;AAChE;AAEA,SAAS,SAAA,CAAU,MAAsB,GAAA,EAAiC;AACzE,EAAA,MAAM,IAAA,GAAO,mBAAA,CAAoB,IAAA,CAAK,CAAC,CAAC,CAAA;AACxC,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,IAAA;AAC9B,EAAA,MAAM,MAAM,YAAA,CAAa,IAAA,EAAM,GAAA,CAAI,QAAA,EAAU,IAAI,aAAa,CAAA;AAC9D,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,IAAA;AAC9B,EAAA,OAAO,GAAA,CAAI,UAAA,CAAW,GAAA,EAAK,GAAA,CAAI,aAAa,CAAA;AAC7C;AAEA,SAAS,QAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,IAAA,CAAK,CAAC,CAAC,CAAA;AACvC,EAAA,IAAI,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG,OAAO,IAAA;AAC7B,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,QAAA,CAAS,EAAA,EAAI,MAAA,EAAQ,KAAA;AACvC,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,IAAA;AAChC,EAAA,MAAM,QAAQ,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,QAAQ,GAAG,CAAA;AAC7C,EAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,CAAM,IAAA,KAAS,QAAW,OAAO,IAAA;AAC5D,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,KAAA,CAAM,IAAA,EAAM,OAAO,GAAG,CAAA;AAC1D,EAAA,IAAI,QAAA,KAAa,IAAA,IAAQ,QAAA,KAAa,MAAA,IAAa,QAAA,KAAa,EAAA;AAC/D,IAAA,OAAO,IAAA;AACR,EAAA,OAAO,QAAA;AACR;AAEA,SAAS,mBAAA,CACR,OACA,GAAA,EACuB;AACvB,EAAA,IACC,KAAA,CAAM,eAAe,MAAA,IACrB,KAAA,CAAM,eAAe,IAAA,IACrB,OAAO,MAAM,UAAA,KAAe,QAAA;AAE5B,IAAA,OAAO,EAAC;AACT,EAAA,MAAM,MAAA,GAAU,MAAM,UAAA,CAAuC,MAAA;AAC7D,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,OAAO,MAAA,KAAW,YAAY,MAAA,KAAW,IAAA;AACpE,IAAA,OAAO,EAAC;AACT,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,QAAA,CAAS,EAAA,EAAI,MAAA,EAAQ,KAAA;AACvC,EAAA,IAAI,KAAA,KAAU,MAAA,EAAW,OAAO,EAAC;AACjC,EAAA,MAAM,UAAuB,EAAC;AAC9B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACzB,IAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAW;AAC7B,IAAA,MAAM,MAAA,GAAU,MAAA,CAAmC,IAAA,CAAK,GAAG,CAAA;AAC3D,IAAA,IAAI,WAAW,IAAA,EAAM;AACrB,IAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAA,CAAK,IAAA,EAAM,OAAO,GAAG,CAAA;AACzD,IAAA,IAAI,QAAA,KAAa,IAAA,IAAQ,QAAA,KAAa,MAAA,IAAa,aAAa,EAAA,EAAI;AACpE,IAAA,OAAA,CAAQ,KAAK,QAAQ,CAAA;AAAA,EACtB;AACA,EAAA,OAAO,OAAA;AACR;AAEA,SAAS,QAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACgC;AAChC,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAE9B,EAAA,MAAM,SAAA,GAAY,mBAAA,CAAoB,IAAA,CAAK,CAAC,CAAC,CAAA;AAC7C,EAAA,MAAM,QAAqB,EAAC;AAC5B,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,MAAM,MAAM,WAAA,CAAY,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AAC3C,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACvB,MAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACvB,QAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,MAAA,IAAa,SAAS,EAAA,EAAI;AACvD,UAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,QAChB;AAAA,MACD;AACA,MAAA;AAAA,IACD;AACA,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,GAAA,KAAQ,MAAA,IAAa,QAAQ,EAAA,EAAI;AACpD,MAAA,KAAA,CAAM,KAAK,GAAG,CAAA;AAAA,IACf;AAAA,EACD;AACA,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAC/B,EAAA,IAAI,MAAM,KAAA,CAAM,CAAC,SAAS,OAAO,IAAA,KAAS,QAAQ,CAAA,EAAG;AACpD,IAAA,OAAQ,KAAA,CAA4B,KAAK,SAAS,CAAA;AAAA,EACnD;AACA,EAAA,IAAI,SAAA,CAAU,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AACnC,EAAA,MAAM,cAA2B,EAAC;AAClC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACtC,IAAA,IAAI,CAAA,GAAI,CAAA,EAAG,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA;AACrC,IAAA,WAAA,CAAY,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,EAC1B;AACA,EAAA,OAAO,WAAA;AACR;AAIA,SAAS,sBAAA,CACR,GAAA,EACA,KAAA,EACA,GAAA,EACU;AACV,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,MAAA;AAC9B,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,EAAU,OAAO,GAAA,CAAI,KAAA;AACtC,EAAA,IAAI,GAAA,CAAI,IAAA,CAAK,IAAA,KAAS,MAAA,EAAQ;AAC7B,IAAA,MAAM,QAAA,GAAW,IAAI,IAAA,CAAK,QAAA;AAC1B,IAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AAC1B,MAAA,MAAM,GAAA,GAAM,SAAS,CAAC,CAAA;AACtB,MAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,MAAA,IAAI,CAAC,MAAA,CAAO,KAAA,CAAM,GAAG,GAAG,OAAO,GAAA;AAAA,IAChC;AACA,IAAA,OAAO,WAAA,CAAY,UAAU,KAAK,CAAA;AAAA,EACnC;AACA,EAAA,IAAI,GAAA,CAAI,IAAA,CAAK,IAAA,KAAS,MAAA,EAAQ;AAC7B,IAAA,MAAM,MAAA,GAAS,aAAa,GAAA,CAAI,IAAA,CAAK,MAAM,GAAA,CAAI,IAAA,CAAK,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AACpE,IAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,OAAO,MAAA,KAAW,UAAU,OAAO,MAAA;AACrE,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,MAAA;AAClC,IAAA,OAAO,MAAA;AAAA,EACR;AACA,EAAA,OAAO,MAAA;AACR;AAEA,SAAS,WAAA,CACR,GAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,MAAA;AAC9B,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,EAAU,OAAO,GAAA,CAAI,KAAA;AACtC,EAAA,OAAO,kBAAA,CAAmB,GAAA,CAAI,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AAC/C;AAEA,SAAS,WAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACA,GAAA,EACS;AACT,EAAA,MAAM,IAAI,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACpD,EAAA,MAAM,IAAI,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACpD,EAAA,OAAO,GAAA,CAAI,CAAA,EAAG,CAAC,CAAA,GAAI,MAAA,GAAS,EAAA;AAC7B;AAEA,SAAS,MAAA,CACR,IAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,MAAM,OAAO,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACvD,EAAA,MAAM,MAAA,GACL,SAAS,MAAA,IACT,IAAA,KAAS,QACT,IAAA,KAAS,EAAA,IACT,IAAA,KAAS,KAAA,IACT,IAAA,KAAS,CAAA;AACV,EAAA,IAAI,MAAA,EAAQ;AACX,IAAA,MAAM,MAAM,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACtD,IAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,GAAA;AAC9B,IAAA,OAAO,WAAA,CAAY,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AAAA,EACvC;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AACpB,IAAA,MAAM,MAAM,sBAAA,CAAuB,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AACtD,IAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,GAAA;AAC9B,IAAA,OAAO,WAAA,CAAY,IAAA,CAAK,CAAC,CAAA,EAAG,OAAO,GAAG,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,EAAA;AACR;AAEA,SAAS,oBAAoB,GAAA,EAA8B;AAC1D,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,EAAA;AAC9B,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,EAAU,OAAO,GAAA,CAAI,KAAA;AACtC,EAAA,OAAO,EAAA;AACR;AASO,SAAS,kBAAA,CACf,QAAA,EACA,KAAA,EACA,GAAA,EACY;AACZ,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAClC,EAAA,MAAM,SAAA,GAAY,uBAAuB,QAAQ,CAAA;AACjD,EAAA,IAAI,SAAA,CAAU,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAEnC,EAAA,MAAM,UAAuB,EAAC;AAC9B,EAAA,KAAA,MAAW,QAAQ,SAAA,EAAW;AAC7B,IAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACzB,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAK,KAAK,CAAA;AACvB,MAAA;AAAA,IACD;AACA,IAAA,MAAM,IAAA,GAAO,uBAAA,CAAwB,IAAA,CAAK,MAAM,CAAA;AAChD,IAAA,IAAI,SAAS,MAAA,EAAW;AACvB,MAAA;AAAA,IACD;AACA,IAAA,MAAM,KAAA,GAAQ,kBAAA,CAAmB,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA;AACjD,IAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,KAAA,KAAU,MAAA,IAAa,UAAU,EAAA,EAAI;AAC1D,MAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,EACD;AAEA,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,IAAA;AACjC,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,QAAQ,CAAC,CAAA;AAC1C,EAAA,MAAM,aAAa,OAAA,CAAQ,KAAA,CAAM,CAAC,CAAA,KAAM,OAAO,MAAM,QAAQ,CAAA;AAC7D,EAAA,IAAI,UAAA,EAAY,OAAO,OAAA,CAAQ,IAAA,CAAK,EAAE,CAAA;AACtC,EAAA,OAAO,OAAA;AACR;AAGO,SAAS,gBAAA,CACf,UAAA,EACA,KAAA,EACA,GAAA,EACuB;AACvB,EAAA,OAAO,UAAA,CACL,GAAA,CAAI,CAAC,QAAA,KAAa,kBAAA,CAAmB,QAAA,EAAU,KAAA,EAAO,GAAG,CAAC,CAAA,CAC1D,MAAA,CAAO,CAAC,CAAA,KAAqD;AAC7D,IAAA,IAAI,MAAM,IAAA,IAAQ,CAAA,KAAM,MAAA,IAAa,CAAA,KAAM,IAAI,OAAO,KAAA;AACtD,IAAA,IAAI,MAAM,OAAA,CAAQ,CAAC,KAAK,CAAA,CAAE,MAAA,KAAW,GAAG,OAAO,KAAA;AAC/C,IAAA,OAAO,IAAA;AAAA,EACR,CAAC,CAAA;AACH","file":"template.js","sourcesContent":["import prettyBytes from \"pretty-bytes\"\n\n/**\n * Format a non-negative byte count as a short human-readable string\n * via {@link prettyBytes} with binary conversion (base 1024) and JEDEC\n * labels (`4.5 KB`, `1.2 MB`, `930 GB`) — IEC `KiB`/`MiB`/`GiB` mapped\n * to `KB`/`MB`/`GB`. Matches how Windows and most disk tools report\n * sizes, without switching to decimal (base 1000) units.\n *\n * Returns the empty string for `undefined` so callers can splat the value\n * into a template without conditional checks. Negative or non-finite\n * inputs are clamped to `0 B`.\n */\nexport function formatBytes(bytes: number | undefined): string {\n\tif (bytes === undefined) return \"\"\n\tif (!Number.isFinite(bytes) || bytes <= 0) return \"0 B\"\n\treturn prettyBytes(bytes, { binary: true }).replaceAll(\"iB\", \"B\")\n}\n\n/**\n * Format a duration in milliseconds as a media clock — `m:ss`, or\n * `h:mm:ss` past the hour. Used by the plugin card templates\n * (`{{duration(...)}}`) and the card's inline audio player, so both\n * read the same way.\n */\nexport function formatClockDuration(ms: number): string {\n\tif (!Number.isFinite(ms) || ms < 0) return \"\"\n\tconst totalSeconds = Math.floor(ms / 1000)\n\tconst hours = Math.floor(totalSeconds / 3600)\n\tconst minutes = Math.floor((totalSeconds % 3600) / 60)\n\tconst seconds = totalSeconds % 60\n\tif (hours > 0) {\n\t\treturn `${hours}:${String(minutes).padStart(2, \"0\")}:${String(seconds).padStart(2, \"0\")}`\n\t}\n\treturn `${minutes}:${String(seconds).padStart(2, \"0\")}`\n}\n","import type { ReactNode } from \"react\"\n\n/**\n * A resolved template-icon reference: a Solar glyph name, or an\n * asset image URL derived from a manifest-relative path.\n */\nexport type IconRef =\n\t| { readonly kind: \"icon\"; readonly name: string }\n\t| { readonly kind: \"asset\"; readonly url: string }\n\n/**\n * Legacy whitelist name → Solar kebab glyph. Derived names are handled by\n * the PascalCase conversion; only these diverge.\n */\nconst LEGACY_ICON_ALIASES: Readonly<Record<string, string>> = {\n\tFiles: \"file\",\n\tFilm: \"video-frame\",\n\tImage: \"gallery\",\n\tInfo: \"info-circle\",\n\tMusic: \"music-notes\",\n\tSearch: \"magnifier\",\n\tSparkle: \"star\",\n\tVideo: \"video-frame\",\n}\n\n/**\n * Normalize a raw icon name to Solar kebab-case, or `undefined` when the\n * string cannot name a glyph at all (schemes, separators, punctuation).\n * This is syntax only — membership in the Solar glyph index is left to\n * the renderer that consumes the name.\n */\nexport function normalizeSolarGlyphName(raw: string): string | undefined {\n\tconst trimmed = raw.trim()\n\tif (trimmed.length === 0) return undefined\n\tconst aliased = LEGACY_ICON_ALIASES[trimmed]\n\tif (aliased !== undefined) return aliased\n\tif (/^[a-z][a-z0-9-]*$/.test(trimmed)) return trimmed\n\tif (/^[A-Za-z][A-Za-z0-9]*$/.test(trimmed)) {\n\t\treturn trimmed.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").toLowerCase()\n\t}\n\treturn undefined\n}\n\n/**\n * Parse a manifest-level icon string into a render-ready ref.\n *\n *   `<SolarGlyph>`       — Solar glyph name (manifest/template icons are\n *                          Solar-only; PascalCase and the legacy whitelist\n *                          names normalize to the kebab glyph)\n *   `<relative/path>`    — resolved through `buildAssetUrl(pluginId, path)`\n *                          (leading `./` stripped)\n *\n * Empty inputs, schemes (`http(s)`, `data:`), `..`-shaped paths and any\n * string that cannot name a glyph return `undefined`. The renderer treats\n * that as \"nothing\" — icon resolution never throws.\n */\nexport function parseIconRef(\n\traw: string,\n\tpluginId: string,\n\tbuildAssetUrl: (pluginId: string, path: string) => string,\n): IconRef | undefined {\n\tconst trimmed = raw.trim()\n\tif (trimmed.length === 0) return undefined\n\tif (\n\t\ttrimmed.startsWith(\"http://\") ||\n\t\ttrimmed.startsWith(\"https://\") ||\n\t\ttrimmed.startsWith(\"data:\")\n\t) {\n\t\treturn undefined\n\t}\n\tif (\n\t\ttrimmed.includes(\".\") ||\n\t\ttrimmed.includes(\"/\") ||\n\t\ttrimmed.includes(\"\\\\\")\n\t) {\n\t\tconst rel = trimmed.replace(/^\\.[\\\\/]/, \"\")\n\t\tif (rel.length === 0 || rel.split(\"/\").includes(\"..\")) return undefined\n\t\treturn { kind: \"asset\", url: buildAssetUrl(pluginId, rel) }\n\t}\n\tconst name = normalizeSolarGlyphName(trimmed)\n\tif (name === undefined) return undefined\n\treturn { kind: \"icon\", name }\n}\n\n/** How a parsed {@link IconRef} is drawn inside a rendered badge/template. */\nexport type RenderIcon = (ref: IconRef, className?: string) => ReactNode\n","import {\n\ttype TemplateArg as Arg,\n\ttype TemplateExpr as Expr,\n\tparseTemplateExpression,\n\tparseTemplateFragments,\n} from \"@hoardodile/sdk-types/template\"\nimport type { ReactNode } from \"react\"\nimport { formatBytes, formatClockDuration } from \"./format.ts\"\nimport { parseIconRef, type RenderIcon } from \"./icon.ts\"\n\n// The template grammar (fragment splitting, tokenising, parsing) lives\n// in @hoardodile/sdk-types/template — shared verbatim with the CLI's\n// build-time template lint so the two can never drift. This module only\n// evaluates the AST. The parser is lenient: unparseable expressions\n// render as the empty string.\n\n// ── Evaluation context ───────────────────────────────────────────────────────\n\n/** How a referenced icon is drawn; the caller owns the SVG/image resolution. */\nexport type TemplateContext = {\n\treadonly locale: string\n\treadonly pluginId: string\n\treadonly manifest: {\n\t\treadonly i18n?: Record<string, string | Record<string, string>>\n\t\treadonly ui?: {\n\t\t\treadonly search?: {\n\t\t\t\treadonly kinds?: readonly {\n\t\t\t\t\treadonly key: string\n\t\t\t\t\treadonly icon?: string\n\t\t\t\t}[]\n\t\t\t}\n\t\t}\n\t}\n\treadonly iconClassName?: string\n\t/** Renders a parsed {@link IconRef} (glyph or asset) inside the template. */\n\treadonly renderIcon: RenderIcon\n\t/** Resolves a manifest-relative `asset('path')` reference to a URL. */\n\treadonly buildAssetUrl: (pluginId: string, path: string) => string\n}\n\ntype EvalValue = string | ReactNode\n\ntype TemplateScope = {\n\treadonly file: unknown\n\treadonly source: unknown\n\treadonly searchMeta?: unknown\n\treadonly data?: unknown\n\treadonly coverMeta?: unknown\n}\n\n// ── Scope resolution (paths) ─────────────────────────────────────────────────\n\nfunction resolvePath(\n\tsegments: readonly string[],\n\tscope: TemplateScope,\n): unknown {\n\tconst [namespace, ...rest] = segments\n\tconst root =\n\t\tnamespace === \"file\"\n\t\t\t? scope.file\n\t\t\t: namespace === \"searchMeta\"\n\t\t\t\t? scope.searchMeta\n\t\t\t\t: namespace === \"data\"\n\t\t\t\t\t? scope.data\n\t\t\t\t\t: namespace === \"coverMeta\"\n\t\t\t\t\t\t? scope.coverMeta\n\t\t\t\t\t\t: scope.source\n\tif (root === undefined || root === null) return undefined\n\tlet current: unknown = root\n\tfor (const key of rest) {\n\t\tif (typeof current !== \"object\" || current === null) return undefined\n\t\tcurrent = (current as Record<string, unknown>)[key]\n\t}\n\treturn current\n}\n\n// ── Locale resolution ────────────────────────────────────────────────────────\n\n/**\n * Resolve a locale-aware template value: if the value is a plain string,\n * return it directly; if it is a `Record<locale, string>`, pick the best\n * match for the current language. Falls back to the first available key\n * when nothing matches.\n */\nexport function resolveLocaleString(\n\tvalue: string | Record<string, string>,\n\tlocale: string,\n): string {\n\tif (typeof value === \"string\") return value\n\tconst exact = value[locale]\n\tif (exact !== undefined) return exact\n\tconst base = locale.split(\"-\")[0] ?? locale\n\tconst partial = value[base]\n\tif (partial !== undefined) return partial\n\tconst first = Object.values(value)[0]\n\treturn first ?? \"\"\n}\n\n// ── Expression evaluation ────────────────────────────────────────────────────\n\nfunction evaluateExpression(\n\texpr: Expr,\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): EvalValue {\n\tif (expr.kind === \"path\") {\n\t\tconst value = resolvePath(expr.segments, scope)\n\t\tif (value === undefined || value === null) return \"\"\n\t\treturn String(value)\n\t}\n\treturn evaluateCall(expr.name, expr.args, scope, ctx)\n}\n\nfunction evaluateCall(\n\tname: string,\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): EvalValue {\n\tswitch (name) {\n\t\tcase \"bytes\":\n\t\t\treturn callPipe(args, scope, ctx, (value) =>\n\t\t\t\ttypeof value === \"number\" ? formatBytes(value) : \"\",\n\t\t\t)\n\t\tcase \"duration\":\n\t\t\treturn callPipe(args, scope, ctx, (value) =>\n\t\t\t\ttypeof value === \"number\" ? formatClockDuration(value) : \"\",\n\t\t\t)\n\t\tcase \"number\":\n\t\t\treturn callPipe(args, scope, ctx, (value) =>\n\t\t\t\ttypeof value === \"number\" && Number.isFinite(value)\n\t\t\t\t\t? value.toLocaleString()\n\t\t\t\t\t: \"\",\n\t\t\t)\n\t\tcase \"inc\":\n\t\t\treturn callPipe(args, scope, ctx, (value) =>\n\t\t\t\ttypeof value === \"number\" && Number.isFinite(value)\n\t\t\t\t\t? String(value + 1)\n\t\t\t\t\t: \"\",\n\t\t\t)\n\t\tcase \"eq\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => a === b)\n\t\tcase \"ne\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => a !== b)\n\t\tcase \"gt\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => {\n\t\t\t\tif (typeof a !== \"number\" || typeof b !== \"number\") return false\n\t\t\t\treturn a > b\n\t\t\t})\n\t\tcase \"lt\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => {\n\t\t\t\tif (typeof a !== \"number\" || typeof b !== \"number\") return false\n\t\t\t\treturn a < b\n\t\t\t})\n\t\tcase \"gte\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => {\n\t\t\t\tif (typeof a !== \"number\" || typeof b !== \"number\") return false\n\t\t\t\treturn a >= b\n\t\t\t})\n\t\tcase \"lte\":\n\t\t\treturn compareCall(args, scope, ctx, (a, b) => {\n\t\t\t\tif (typeof a !== \"number\" || typeof b !== \"number\") return false\n\t\t\t\treturn a <= b\n\t\t\t})\n\t\tcase \"if\":\n\t\t\treturn callIf(args, scope, ctx)\n\t\tcase \"t\":\n\t\t\treturn callT(args, ctx)\n\t\tcase \"icon\":\n\t\t\treturn callIcon(args, ctx)\n\t\tcase \"asset\":\n\t\t\treturn callAsset(args, ctx)\n\t\tcase \"kind\":\n\t\t\treturn callKind(args, scope, ctx)\n\t\tcase \"searchKindIcons\":\n\t\t\treturn callSearchKindIcons(scope, ctx)\n\t\tcase \"join\":\n\t\t\treturn callJoin(args, scope, ctx)\n\t\tdefault:\n\t\t\treturn \"\"\n\t}\n}\n\nfunction callPipe(\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n\tpipeFn: (value: unknown) => string,\n): string {\n\tconst value = evaluateArgAsPrimitive(args[0], scope, ctx)\n\treturn pipeFn(value)\n}\n\nfunction callT(args: readonly Arg[], ctx: TemplateContext): string {\n\tconst key = evaluateArgAsString(args[0])\n\tif (key.length === 0) return \"\"\n\tconst map = ctx.manifest.i18n\n\tif (map === undefined) return \"\"\n\tconst value = map[key]\n\tif (value === undefined) return \"\"\n\treturn resolveLocaleString(value, ctx.locale)\n}\n\nfunction callIcon(args: readonly Arg[], ctx: TemplateContext): ReactNode {\n\tconst name = evaluateArgAsString(args[0])\n\tif (name.length === 0) return null\n\treturn ctx.renderIcon({ kind: \"icon\", name }, ctx.iconClassName)\n}\n\nfunction callAsset(args: readonly Arg[], ctx: TemplateContext): ReactNode {\n\tconst path = evaluateArgAsString(args[0])\n\tif (path.length === 0) return null\n\tconst ref = parseIconRef(path, ctx.pluginId, ctx.buildAssetUrl)\n\tif (ref === undefined) return null\n\treturn ctx.renderIcon(ref, ctx.iconClassName)\n}\n\nfunction callKind(\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): ReactNode {\n\tconst key = evaluateArgAsString(args[0])\n\tif (key.length === 0) return null\n\tconst kinds = ctx.manifest.ui?.search?.kinds\n\tif (kinds === undefined) return null\n\tconst match = kinds.find((k) => k.key === key)\n\tif (match === undefined || match.icon === undefined) return null\n\tconst rendered = renderCardTemplate(match.icon, scope, ctx)\n\tif (rendered === null || rendered === undefined || rendered === \"\")\n\t\treturn null\n\treturn rendered\n}\n\nfunction callSearchKindIcons(\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): readonly ReactNode[] {\n\tif (\n\t\tscope.searchMeta === undefined ||\n\t\tscope.searchMeta === null ||\n\t\ttypeof scope.searchMeta !== \"object\"\n\t)\n\t\treturn []\n\tconst facets = (scope.searchMeta as Record<string, unknown>).facets\n\tif (facets === undefined || typeof facets !== \"object\" || facets === null)\n\t\treturn []\n\tconst kinds = ctx.manifest.ui?.search?.kinds\n\tif (kinds === undefined) return []\n\tconst results: ReactNode[] = []\n\tfor (const kind of kinds) {\n\t\tif (kind.icon === undefined) continue\n\t\tconst active = (facets as Record<string, boolean>)[kind.key]\n\t\tif (active !== true) continue\n\t\tconst rendered = renderCardTemplate(kind.icon, scope, ctx)\n\t\tif (rendered === null || rendered === undefined || rendered === \"\") continue\n\t\tresults.push(rendered)\n\t}\n\treturn results\n}\n\nfunction callJoin(\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): string | readonly ReactNode[] {\n\tif (args.length === 0) return \"\"\n\n\tconst separator = evaluateArgAsString(args[0])\n\tconst items: ReactNode[] = []\n\tfor (let i = 1; i < args.length; i++) {\n\t\tconst val = evaluateArg(args[i], scope, ctx)\n\t\tif (Array.isArray(val)) {\n\t\t\tfor (const item of val) {\n\t\t\t\tif (item !== null && item !== undefined && item !== \"\") {\n\t\t\t\t\titems.push(item)\n\t\t\t\t}\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif (val !== null && val !== undefined && val !== \"\") {\n\t\t\titems.push(val)\n\t\t}\n\t}\n\tif (items.length === 0) return \"\"\n\tif (items.every((item) => typeof item === \"string\")) {\n\t\treturn (items as readonly string[]).join(separator)\n\t}\n\tif (separator.length === 0) return items\n\tconst interleaved: ReactNode[] = []\n\tfor (let i = 0; i < items.length; i++) {\n\t\tif (i > 0) interleaved.push(separator)\n\t\tinterleaved.push(items[i])\n\t}\n\treturn interleaved\n}\n\n// ── Argument helpers ─────────────────────────────────────────────────────────\n\nfunction evaluateArgAsPrimitive(\n\targ: Arg | undefined,\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): unknown {\n\tif (arg === undefined) return undefined\n\tif (arg.kind === \"string\") return arg.value\n\tif (arg.expr.kind === \"path\") {\n\t\tconst segments = arg.expr.segments\n\t\tif (segments.length === 1) {\n\t\t\tconst seg = segments[0]!\n\t\t\tconst num = Number(seg)\n\t\t\tif (!Number.isNaN(num)) return num\n\t\t}\n\t\treturn resolvePath(segments, scope)\n\t}\n\tif (arg.expr.kind === \"call\") {\n\t\tconst result = evaluateCall(arg.expr.name, arg.expr.args, scope, ctx)\n\t\tif (typeof result === \"string\" || typeof result === \"number\") return result\n\t\tif (Array.isArray(result)) return result\n\t\treturn undefined\n\t}\n\treturn undefined\n}\n\nfunction evaluateArg(\n\targ: Arg | undefined,\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): EvalValue {\n\tif (arg === undefined) return undefined\n\tif (arg.kind === \"string\") return arg.value\n\treturn evaluateExpression(arg.expr, scope, ctx)\n}\n\nfunction compareCall(\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n\tcmp: (a: unknown, b: unknown) => boolean,\n): string {\n\tconst a = evaluateArgAsPrimitive(args[0], scope, ctx)\n\tconst b = evaluateArgAsPrimitive(args[1], scope, ctx)\n\treturn cmp(a, b) ? \"true\" : \"\"\n}\n\nfunction callIf(\n\targs: readonly Arg[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): EvalValue {\n\tconst cond = evaluateArgAsPrimitive(args[0], scope, ctx)\n\tconst truthy =\n\t\tcond !== undefined &&\n\t\tcond !== null &&\n\t\tcond !== \"\" &&\n\t\tcond !== false &&\n\t\tcond !== 0\n\tif (truthy) {\n\t\tconst raw = evaluateArgAsPrimitive(args[1], scope, ctx)\n\t\tif (raw !== undefined) return raw as EvalValue\n\t\treturn evaluateArg(args[1], scope, ctx)\n\t}\n\tif (args.length > 2) {\n\t\tconst raw = evaluateArgAsPrimitive(args[2], scope, ctx)\n\t\tif (raw !== undefined) return raw as EvalValue\n\t\treturn evaluateArg(args[2], scope, ctx)\n\t}\n\treturn \"\"\n}\n\nfunction evaluateArgAsString(arg: Arg | undefined): string {\n\tif (arg === undefined) return \"\"\n\tif (arg.kind === \"string\") return arg.value\n\treturn \"\"\n}\n\n// ── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Render one res-card template string. Returns a ReactNode so that\n * icon-producing functions (`icon`, `asset`, `kind`) can inject\n * components inline with text.\n */\nexport function renderCardTemplate(\n\ttemplate: string,\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): ReactNode {\n\tif (template.length === 0) return \"\"\n\tconst fragments = parseTemplateFragments(template)\n\tif (fragments.length === 0) return \"\"\n\n\tconst results: ReactNode[] = []\n\tfor (const frag of fragments) {\n\t\tif (frag.kind === \"text\") {\n\t\t\tresults.push(frag.value)\n\t\t\tcontinue\n\t\t}\n\t\tconst expr = parseTemplateExpression(frag.source)\n\t\tif (expr === undefined) {\n\t\t\tcontinue\n\t\t}\n\t\tconst value = evaluateExpression(expr, scope, ctx)\n\t\tif (value !== null && value !== undefined && value !== \"\") {\n\t\t\tresults.push(value)\n\t\t}\n\t}\n\n\tif (results.length === 0) return null\n\tif (results.length === 1) return results[0]\n\tconst allStrings = results.every((r) => typeof r === \"string\")\n\tif (allStrings) return results.join(\"\")\n\treturn results\n}\n\n/** Render every badge in a {@link CoverKindUi} slot array. */\nexport function renderSlotBadges(\n\tslotValues: readonly string[],\n\tscope: TemplateScope,\n\tctx: TemplateContext,\n): readonly ReactNode[] {\n\treturn slotValues\n\t\t.map((template) => renderCardTemplate(template, scope, ctx))\n\t\t.filter((n): n is Exclude<typeof n, null | undefined | \"\"> => {\n\t\t\tif (n === null || n === undefined || n === \"\") return false\n\t\t\tif (Array.isArray(n) && n.length === 0) return false\n\t\t\treturn true\n\t\t})\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoardodile/ui",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "license": "MIT",
   "description": "shadcn/ui component library for hoardodile plugin iframes.",
   "keywords": [
@@ -46,6 +46,11 @@
       "development": "./src/hooks/*",
       "default": "./dist/hooks/*.js"
     },
+    "./res-card-template": {
+      "types": "./dist/res-card-template/index.d.ts",
+      "development": "./src/res-card-template/index.ts",
+      "default": "./dist/res-card-template/index.js"
+    },
     "./viewport": {
       "types": "./dist/viewport.d.ts",
       "development": "./src/viewport.ts",
@@ -72,12 +77,14 @@
     "@dnd-kit/utilities": "^3.2.2",
     "@solar-icons/react": "^2.1.0",
     "class-variance-authority": "^0.7.1",
+    "pretty-bytes": "^7.1.1",
     "clsx": "^2.1.1",
     "react-hook-form": "^7.86.0",
     "react-image-crop": "^11.1.2",
     "react-use": "^17.6.1",
     "tailwind-merge": "^3.6.0",
-    "@hoardodile/i18n": "0.1.5"
+    "@hoardodile/i18n": "0.1.7",
+    "@hoardodile/sdk-types": "0.1.7"
   },
   "peerDependencies": {
     "i18next": "^26.4.0",

package/src/icons/registry.ts

@@ -170,6 +170,7 @@ import { UserPlusIcon as UserPlusBoldWeight } from "@solar-icons/react/bold/user
 import { UsersGroupRoundedIcon as UsersGroupRoundedBoldWeight } from "@solar-icons/react/bold/users-group-rounded"
 import { UsersGroupTwoRoundedIcon as UsersGroupTwoRoundedBoldWeight } from "@solar-icons/react/bold/users-group-two-rounded"
 import { VideoFrameIcon as VideoFrameBoldWeight } from "@solar-icons/react/bold/video-frame"
+import { VideoFramePlayHorizontalIcon as VideoFramePlayHorizontalBoldWeight } from "@solar-icons/react/bold/video-frame-play-horizontal"
 import { Widget2Icon as Widget2BoldWeight } from "@solar-icons/react/bold/widget-2"
 import { Widget5Icon as Widget5BoldWeight } from "@solar-icons/react/bold/widget-5"
 import { WindowFrameIcon as WindowFrameBoldWeight } from "@solar-icons/react/bold/window-frame"
@@ -312,6 +313,7 @@ import { UserPlusIcon as UserPlusBoldDuotone } from "@solar-icons/react/bold-duo
 import { UsersGroupRoundedIcon as UsersGroupRoundedBoldDuotone } from "@solar-icons/react/bold-duotone/users-group-rounded"
 import { UsersGroupTwoRoundedIcon as UsersGroupTwoRoundedBoldDuotone } from "@solar-icons/react/bold-duotone/users-group-two-rounded"
 import { VideoFrameIcon as VideoFrameBoldDuotone } from "@solar-icons/react/bold-duotone/video-frame"
+import { VideoFramePlayHorizontalIcon as VideoFramePlayHorizontalBoldDuotone } from "@solar-icons/react/bold-duotone/video-frame-play-horizontal"
 import { Widget2Icon as Widget2BoldDuotone } from "@solar-icons/react/bold-duotone/widget-2"
 import { Widget5Icon as Widget5BoldDuotone } from "@solar-icons/react/bold-duotone/widget-5"
 import { WindowFrameIcon as WindowFrameBoldDuotone } from "@solar-icons/react/bold-duotone/window-frame"
@@ -453,6 +455,7 @@ import { UserPlusIcon as UserPlusLinear } from "@solar-icons/react/linear/user-p
 import { UsersGroupRoundedIcon as UsersGroupRoundedLinear } from "@solar-icons/react/linear/users-group-rounded"
 import { UsersGroupTwoRoundedIcon as UsersGroupTwoRoundedLinear } from "@solar-icons/react/linear/users-group-two-rounded"
 import { VideoFrameIcon as VideoFrameLinear } from "@solar-icons/react/linear/video-frame"
+import { VideoFramePlayHorizontalIcon as VideoFramePlayHorizontalLinear } from "@solar-icons/react/linear/video-frame-play-horizontal"
 import { Widget2Icon as Widget2Linear } from "@solar-icons/react/linear/widget-2"
 import { Widget5Icon as Widget5Linear } from "@solar-icons/react/linear/widget-5"
 import { WindowFrameIcon as WindowFrameLinear } from "@solar-icons/react/linear/window-frame"
@@ -1154,6 +1157,11 @@ export const VideoFrame = createIcon({
 	boldDuotone: VideoFrameBoldDuotone,
 	linear: VideoFrameLinear,
 })
+export const VideoFramePlayHorizontal = createIcon({
+	bold: VideoFramePlayHorizontalBoldWeight,
+	boldDuotone: VideoFramePlayHorizontalBoldDuotone,
+	linear: VideoFramePlayHorizontalLinear,
+})
 export const Widget2 = createIcon({
 	bold: Widget2BoldWeight,
 	boldDuotone: Widget2BoldDuotone,

package/src/res-card-template/format.test.ts

@@ -0,0 +1,45 @@
+/**
+ * @vitest-environment node
+ */
+
+import { describe, expect, test } from "vitest"
+import { formatBytes, formatClockDuration } from "./index.ts"
+
+describe("formatBytes", () => {
+	test("returns empty for undefined", () => {
+		expect(formatBytes(undefined)).toBe("")
+	})
+
+	test("clamps zero, negative and non-finite to 0 B", () => {
+		expect(formatBytes(0)).toBe("0 B")
+		expect(formatBytes(-1)).toBe("0 B")
+		expect(formatBytes(Number.NaN)).toBe("0 B")
+		expect(formatBytes(Number.POSITIVE_INFINITY)).toBe("0 B")
+	})
+
+	test("formats kibibytes with JEDEC labels", () => {
+		expect(formatBytes(1024)).toBe("1 KB")
+		expect(formatBytes(1536)).toBe("1.5 KB")
+	})
+
+	test("formats megabytes and gigabytes", () => {
+		expect(formatBytes(1024 ** 2)).toBe("1 MB")
+		expect(formatBytes(1024 ** 3)).toBe("1 GB")
+	})
+})
+
+describe("formatClockDuration", () => {
+	test("formats sub-hour as m:ss", () => {
+		expect(formatClockDuration(0)).toBe("0:00")
+		expect(formatClockDuration(125_000)).toBe("2:05")
+	})
+
+	test("formats past the hour as h:mm:ss", () => {
+		expect(formatClockDuration(3_661_000)).toBe("1:01:01")
+	})
+
+	test("returns empty for negative or non-finite input", () => {
+		expect(formatClockDuration(-1)).toBe("")
+		expect(formatClockDuration(Number.NaN)).toBe("")
+	})
+})

package/src/res-card-template/format.ts

@@ -0,0 +1,36 @@
+import prettyBytes from "pretty-bytes"
+
+/**
+ * Format a non-negative byte count as a short human-readable string
+ * via {@link prettyBytes} with binary conversion (base 1024) and JEDEC
+ * labels (`4.5 KB`, `1.2 MB`, `930 GB`) — IEC `KiB`/`MiB`/`GiB` mapped
+ * to `KB`/`MB`/`GB`. Matches how Windows and most disk tools report
+ * sizes, without switching to decimal (base 1000) units.
+ *
+ * Returns the empty string for `undefined` so callers can splat the value
+ * into a template without conditional checks. Negative or non-finite
+ * inputs are clamped to `0 B`.
+ */
+export function formatBytes(bytes: number | undefined): string {
+	if (bytes === undefined) return ""
+	if (!Number.isFinite(bytes) || bytes <= 0) return "0 B"
+	return prettyBytes(bytes, { binary: true }).replaceAll("iB", "B")
+}
+
+/**
+ * Format a duration in milliseconds as a media clock — `m:ss`, or
+ * `h:mm:ss` past the hour. Used by the plugin card templates
+ * (`{{duration(...)}}`) and the card's inline audio player, so both
+ * read the same way.
+ */
+export function formatClockDuration(ms: number): string {
+	if (!Number.isFinite(ms) || ms < 0) return ""
+	const totalSeconds = Math.floor(ms / 1000)
+	const hours = Math.floor(totalSeconds / 3600)
+	const minutes = Math.floor((totalSeconds % 3600) / 60)
+	const seconds = totalSeconds % 60
+	if (hours > 0) {
+		return `${hours}:${String(minutes).padStart(2, "0")}:${String(seconds).padStart(2, "0")}`
+	}
+	return `${minutes}:${String(seconds).padStart(2, "0")}`
+}

package/src/res-card-template/icon.test.ts

@@ -0,0 +1,100 @@
+/**
+ * @vitest-environment node
+ */
+
+import { describe, expect, test } from "vitest"
+import { normalizeSolarGlyphName, parseIconRef } from "./index.ts"
+
+const buildAssetUrl = (pluginId: string, path: string) =>
+	`/api/plugins/${pluginId}/${path}`
+
+describe("normalizeSolarGlyphName", () => {
+	test("passes kebab through", () => {
+		expect(normalizeSolarGlyphName("video-frame")).toBe("video-frame")
+	})
+
+	test("converts PascalCase to kebab", () => {
+		expect(normalizeSolarGlyphName("Heart")).toBe("heart")
+		expect(normalizeSolarGlyphName("VideoFrame")).toBe("video-frame")
+	})
+
+	test("maps legacy whitelist aliases", () => {
+		expect(normalizeSolarGlyphName("Image")).toBe("gallery")
+		expect(normalizeSolarGlyphName("FileText")).toBe("file-text")
+		expect(normalizeSolarGlyphName("Film")).toBe("video-frame")
+	})
+
+	test("returns undefined for empty, whitespace and prefixed input", () => {
+		expect(normalizeSolarGlyphName("")).toBeUndefined()
+		expect(normalizeSolarGlyphName("   ")).toBeUndefined()
+		expect(normalizeSolarGlyphName("icon:Heart")).toBeUndefined()
+	})
+})
+
+describe("parseIconRef", () => {
+	test("plain name → normalized Solar glyph name", () => {
+		expect(parseIconRef("Heart", "pid", buildAssetUrl)).toEqual({
+			kind: "icon",
+			name: "heart",
+		})
+	})
+
+	test("trims whitespace", () => {
+		expect(parseIconRef("  Heart  ", "pid", buildAssetUrl)).toEqual({
+			kind: "icon",
+			name: "heart",
+		})
+	})
+
+	test("legacy whitelist names normalize to their Solar glyph", () => {
+		expect(parseIconRef("Image", "pid", buildAssetUrl)).toEqual({
+			kind: "icon",
+			name: "gallery",
+		})
+		expect(parseIconRef("FileText", "pid", buildAssetUrl)).toEqual({
+			kind: "icon",
+			name: "file-text",
+		})
+	})
+
+	test("the name: prefix is rejected outright", () => {
+		expect(parseIconRef("icon:Heart", "pid", buildAssetUrl)).toBeUndefined()
+	})
+
+	test("parses a relative asset path through the URL builder", () => {
+		expect(parseIconRef("icons/heart.gif", "pid", buildAssetUrl)).toEqual({
+			kind: "asset",
+			url: "/api/plugins/pid/icons/heart.gif",
+		})
+	})
+
+	test("strips leading ./ from asset path", () => {
+		expect(parseIconRef("./icons/heart.gif", "pid", buildAssetUrl)).toEqual({
+			kind: "asset",
+			url: "/api/plugins/pid/icons/heart.gif",
+		})
+	})
+
+	test("returns undefined for empty and dot asset paths", () => {
+		expect(parseIconRef("./", "pid", buildAssetUrl)).toBeUndefined()
+		expect(parseIconRef("", "pid", buildAssetUrl)).toBeUndefined()
+		expect(parseIconRef("   ", "pid", buildAssetUrl)).toBeUndefined()
+	})
+
+	test("returns undefined for .. asset paths", () => {
+		expect(parseIconRef("../x.svg", "pid", buildAssetUrl)).toBeUndefined()
+		expect(parseIconRef("icons/../x.svg", "pid", buildAssetUrl)).toBeUndefined()
+	})
+
+	test("returns undefined for http/https/data schemes", () => {
+		expect(
+			parseIconRef("http://example.com/icon.png", "pid", buildAssetUrl),
+		).toBeUndefined()
+		expect(
+			parseIconRef("https://example.com/icon.png", "pid", buildAssetUrl),
+		).toBeUndefined()
+		expect(
+			parseIconRef("data:image/png;base64,abc", "pid", buildAssetUrl),
+		).toBeUndefined()
+	})
+})