@dirwell/theme-ledger 0.0.1-alpha.1 → 0.0.2

package/dist/source/component.d.mts

@@ -1,4 +1,4 @@
 import type {Component, Snippet} from 'svelte';
 import type {ThemePage, RowContext} from '../model.mjs';
-export interface LedgerProps {readonly model: ThemePage; readonly header?: Snippet<[{model: ThemePage}]>; readonly row?: Snippet<[RowContext]>; readonly footer?: Snippet<[{model: ThemePage}]>;}
+export interface LedgerProps {readonly model: ThemePage; readonly header?: Snippet<[{model: ThemePage}]>; readonly row?: Snippet<[RowContext]>; readonly actions?: Snippet<[RowContext]>; readonly footer?: Snippet<[{model: ThemePage}]>;}
 declare const Ledger: Component<LedgerProps>; export default Ledger;

package/dist/source/shared/customization.mjs

@@ -0,0 +1,255 @@
+// ../shared-theme/src/customization.ts
+var defaultLabels = {
+  other: "other",
+  crosswaveKeyboardHelp: "Arrow keys navigate \xB7 Enter confirms \xB7 Backspace returns",
+  brokenLink: "broken link",
+  unavailableLink: "unavailable link",
+  cycleLink: "cycle link",
+  azure: "azure",
+  violet: "violet",
+  amber: "amber",
+  rose: "rose",
+  jade: "jade",
+  graphite: "graphite",
+  allFiles: "All files",
+  categoryFolders: "Folders",
+  categoryPhotos: "Photos",
+  categoryMusic: "Music",
+  categoryVideos: "Videos",
+  categoryDocuments: "Documents",
+  categoryOther: "Other",
+  indexOf: "Index of {path}",
+  home: "Home",
+  breadcrumb: "Breadcrumb",
+  archive: "File archive",
+  searchDirectory: "Search this directory",
+  searchFiles: "Search files",
+  search: "Search",
+  types: "Types",
+  directory: "directory",
+  file: "file",
+  link: "link",
+  folder: "Folder",
+  sort: "Sort",
+  name: "Name",
+  size: "Size",
+  modified: "Modified",
+  names: "Names",
+  natural: "Natural",
+  locale: "Locale",
+  unicode: "Unicode",
+  order: "Order",
+  ascending: "Ascending",
+  descending: "Descending",
+  directoriesFirst: "Folders first",
+  appearance: "Appearance",
+  system: "System",
+  light: "Light",
+  dark: "Dark",
+  searchArchive: "Search archive",
+  archiveSearchInput: "Search archive files",
+  entries: "{count} entries",
+  pageEntries: "{total} entries \xB7 {count} on this page",
+  loading: "Loading\u2026",
+  noMatches: "No matching entries.",
+  empty: "This directory is empty.",
+  pagination: "Pagination",
+  previous: "Previous",
+  next: "Next",
+  page: "Page {page} of {pages}",
+  keyboardHelp: "Arrow keys select files \xB7 Home / End jump \xB7 / searches \xB7 Backspace opens parent",
+  modifiedTime: "Modified time",
+  close: "Close",
+  unknown: "Unknown",
+  unavailable: "Target unavailable",
+  beginArchive: "Enter a search to begin.",
+  searchingArchive: "Searching archive\u2026",
+  archiveResults: "{count} results",
+  truncatedResults: "Showing {shown} of {count} results",
+  archiveError: "Could not load archive search. Try again.",
+  listingError: "Could not load complete directory data. Native page links remain available.",
+  folderError: "Could not open the folder. Its native link remains available.",
+  updatesError: "Live updates disconnected. Refresh to retry.",
+  retry: "Retry",
+  openNative: "Open folder directly",
+  categories: "File categories",
+  items: "{count} items",
+  filesIn: "Files in {path}",
+  controller: "Controller \xB7 Confirm / Back",
+  color: "Color",
+  pauseMotion: "Pause motion",
+  resumeMotion: "Resume motion",
+  copyLink: "Copy link",
+  copyPath: "Copy path",
+  download: "Download",
+  copied: "Copied.",
+  copyError: "Could not copy. Use the native link or select the path.",
+  repository: "Repository",
+  author: "by",
+  target: "Target",
+  newTab: "opens in a new tab"
+};
+function resolveCustomization(options = {}) {
+  const language = options.language === void 0 ? "en" : options.language, locale = options.locale === void 0 ? "en-US" : options.locale, timeZone = options.timeZone === void 0 ? "UTC" : options.timeZone;
+  for (const [key, value] of Object.entries({ language, locale, timeZone }))
+    if (typeof value !== "string" || !value)
+      throw new TypeError(`${key} must be a non-empty string`);
+  new Intl.DateTimeFormat(locale, { timeZone });
+  const direction = options.direction ?? "ltr";
+  if (direction !== "ltr" && direction !== "rtl")
+    throw new TypeError("direction must be ltr or rtl");
+  const labels = { ...defaultLabels };
+  if (options.labels !== void 0) {
+    if (typeof options.labels !== "object" || options.labels === null || Array.isArray(options.labels))
+      throw new TypeError("labels must be an object");
+    for (const [key, value] of Object.entries(options.labels)) {
+      if (!Object.hasOwn(labels, key) || typeof value !== "string")
+        throw new TypeError(`Unsupported label or value: ${key}`);
+      Object.assign(labels, { [key]: value });
+    }
+  }
+  const brand = options.brand ?? {};
+  if (typeof brand !== "object" || brand === null || Array.isArray(brand))
+    throw new TypeError("brand must be an object");
+  for (const [key, value] of Object.entries(brand)) {
+    if (!["name", "logoUrl", "logoAlt", "footerText", "footerUrl", "faviconUrl"].includes(key) || typeof value !== "string")
+      throw new TypeError(`Unsupported brand option or value: ${key}`);
+    if (key.endsWith("Url") && !/^https?:\/\//i.test(value) && !(value.startsWith("/") && !value.startsWith("//")))
+      throw new TypeError(`brand.${key} must be an HTTP(S) or root-relative URL`);
+  }
+  const columns = options.columns ?? ["name", "size", "modified"];
+  if (!Array.isArray(columns) || !columns.includes("name"))
+    throw new TypeError("columns must contain name and unique supported columns");
+  const columnIds = /* @__PURE__ */ new Set();
+  for (const column of columns) {
+    let id;
+    if (typeof column === "string") {
+      if (!["name", "size", "modified"].includes(column)) throw new TypeError("Unsupported column");
+      id = column;
+    } else {
+      if (typeof column !== "object" || column === null || Object.keys(column).some((key) => !["dataKey", "label"].includes(key)) || typeof column.dataKey !== "string" || !column.dataKey || typeof column.label !== "string" || !column.label)
+        throw new TypeError("Data columns require dataKey and label");
+      id = "data:" + column.dataKey;
+    }
+    if (columnIds.has(id)) throw new TypeError("columns must contain unique supported columns");
+    columnIds.add(id);
+  }
+  const actions = options.actions ?? [];
+  if (!Array.isArray(actions) || new Set(actions).size !== actions.length || actions.some((key) => !["copy-link", "copy-path", "download"].includes(key)))
+    throw new TypeError("actions must contain unique supported actions");
+  const cssVariables = options.cssVariables ?? {};
+  if (typeof cssVariables !== "object" || cssVariables === null || Array.isArray(cssVariables))
+    throw new TypeError("cssVariables must be an object");
+  for (const [key, value] of Object.entries(cssVariables))
+    if (!/^--[a-zA-Z][a-zA-Z0-9_-]*$/.test(key) || typeof value !== "string" || /[{};<>]/.test(value))
+      throw new TypeError(`Invalid CSS variable: ${key}`);
+  return {
+    language,
+    dateOptions: {
+      ...options.locale === void 0 ? {} : { locale: options.locale },
+      ...options.timeZone === void 0 ? {} : { timeZone: options.timeZone }
+    },
+    direction,
+    locale,
+    timeZone,
+    labels,
+    brand: { ...brand },
+    columns: columns.map((column) => typeof column === "string" ? column : { ...column }),
+    actions: [...actions],
+    cssVariables: { ...cssVariables }
+  };
+}
+var defaultCustomization = resolveCustomization();
+function label(ui, key, values = {}) {
+  return ui.labels[key].replace(
+    /\{([a-zA-Z]+)\}/g,
+    (match, name) => Object.hasOwn(values, name) ? String(values[name]) : match
+  );
+}
+var dateFormats = /* @__PURE__ */ new Map();
+function formattedDate(value, ui, local = false) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return ui.labels.unknown;
+  if (ui.dateOptions.locale === void 0 && ui.dateOptions.timeZone === void 0)
+    return local ? date.toLocaleString(void 0, { dateStyle: "short", timeStyle: "short" }) : date.toISOString().slice(0, 16).replace("T", " ") + " UTC";
+  const locale = ui.dateOptions.locale, timeZone = ui.dateOptions.timeZone ?? (local ? void 0 : "UTC");
+  const key = String(locale) + "\0" + String(timeZone);
+  let formatter = dateFormats.get(key);
+  if (formatter === void 0) {
+    formatter = new Intl.DateTimeFormat(locale, {
+      timeZone,
+      dateStyle: "short",
+      timeStyle: "short"
+    });
+    if (dateFormats.size >= 32) dateFormats.delete(dateFormats.keys().next().value);
+    dateFormats.set(key, formatter);
+  }
+  return formatter.format(date);
+}
+function customizationCss(ui) {
+  const declarations = Object.entries(ui.cssVariables).map(([key, value]) => `${key}:${value}`).join(";");
+  return declarations ? `:root:root{${declarations}}${ui.cssVariables["--dw-font-family"] ? "body{font-family:var(--dw-font-family)}" : ""}` : "";
+}
+async function copyEntryAction(action, entry) {
+  const value = action === "copy-link" && entry.href ? new URL(entry.href, document.baseURI).href : entry.id;
+  if (!navigator.clipboard?.writeText) throw new Error("Clipboard unavailable");
+  await navigator.clipboard.writeText(value);
+}
+function pickCustomization(options) {
+  const result = {};
+  for (const key of [
+    "language",
+    "direction",
+    "locale",
+    "timeZone",
+    "labels",
+    "brand",
+    "columns",
+    "actions",
+    "cssVariables"
+  ])
+    if (options[key] !== void 0) {
+      const value = options[key];
+      Object.assign(result, {
+        [key]: Array.isArray(value) ? value.map((item) => typeof item === "object" ? { ...item } : item) : typeof value === "object" && value !== null ? { ...value } : value
+      });
+    }
+  return Object.keys(result).length ? result : void 0;
+}
+function assertThemeOptions(value, extraKeys) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new TypeError("Theme options must be an object");
+  const allowed = [
+    "language",
+    "direction",
+    "locale",
+    "timeZone",
+    "labels",
+    "brand",
+    "columns",
+    "actions",
+    "cssVariables",
+    ...extraKeys
+  ];
+  for (const key of Object.keys(value))
+    if (!allowed.includes(key)) throw new TypeError(`Unsupported theme option: ${key}`);
+}
+function columnLabel(column, ui) {
+  return typeof column === "string" ? ui.labels[column] : column.label;
+}
+function publicDataValue(value) {
+  return value === void 0 || value === null ? "" : typeof value === "object" ? JSON.stringify(value) : String(value);
+}
+export {
+  assertThemeOptions,
+  columnLabel,
+  copyEntryAction,
+  customizationCss,
+  defaultCustomization,
+  defaultLabels,
+  formattedDate,
+  label,
+  pickCustomization,
+  publicDataValue,
+  resolveCustomization
+};

package/dist/source/shared/live-search.mjs

@@ -0,0 +1,28 @@
+// ../shared-theme/src/live-search.ts
+async function queryLiveArchive(href, query, signal) {
+  const url = new URL(href, document.baseURI);
+  if (url.origin !== location.origin) throw new Error("Unsafe search endpoint");
+  url.searchParams.set("q", query);
+  const response = await fetch(url, { signal, cache: "no-store" });
+  if (!response.ok) throw new Error("Archive search unavailable");
+  const data = await response.json();
+  if (typeof data !== "object" || data === null || !("version" in data) || data.version !== 1 || !("results" in data) || !Array.isArray(data.results) || data.results.length > 1e4 || !("truncated" in data) || typeof data.truncated !== "boolean")
+    throw new Error("Invalid archive results");
+  const records = data.results.map((entry) => {
+    if (typeof entry !== "object" || entry === null || !("name" in entry) || typeof entry.name !== "string" || !("path" in entry) || typeof entry.path !== "string" || !("kind" in entry) || !["file", "directory"].includes(String(entry.kind)) || !("href" in entry) || entry.href !== null && typeof entry.href !== "string")
+      throw new Error("Invalid archive record");
+    const target = entry.href === null ? null : new URL(entry.href, url);
+    if (target && !["http:", "https:"].includes(target.protocol))
+      throw new Error("Unsafe archive link");
+    return {
+      name: entry.name,
+      path: entry.path,
+      href: target?.href ?? null,
+      exitsExplorer: entry.kind !== "directory"
+    };
+  });
+  return { records, truncated: data.truncated };
+}
+export {
+  queryLiveArchive
+};

package/dist/source/shared/navigation.mjs

@@ -72,6 +72,7 @@ function entry(value, base) {
     };
   }
   return {
+    ...value.data === void 0 ? {} : { data: copyJsonObject(value.data) },
     ...value.presentation === void 0 ? {} : { presentation: copyJsonObject(value.presentation) },
     id: string(value.id, "id"),
     name: string(value.name, "name"),
@@ -175,6 +176,169 @@ function parseListingEntries(value, baseHref, maxEntries = 1e5) {
   return result;
 }
 
+// ../shared-theme/src/customization.ts
+var defaultLabels = {
+  other: "other",
+  crosswaveKeyboardHelp: "Arrow keys navigate \xB7 Enter confirms \xB7 Backspace returns",
+  brokenLink: "broken link",
+  unavailableLink: "unavailable link",
+  cycleLink: "cycle link",
+  azure: "azure",
+  violet: "violet",
+  amber: "amber",
+  rose: "rose",
+  jade: "jade",
+  graphite: "graphite",
+  allFiles: "All files",
+  categoryFolders: "Folders",
+  categoryPhotos: "Photos",
+  categoryMusic: "Music",
+  categoryVideos: "Videos",
+  categoryDocuments: "Documents",
+  categoryOther: "Other",
+  indexOf: "Index of {path}",
+  home: "Home",
+  breadcrumb: "Breadcrumb",
+  archive: "File archive",
+  searchDirectory: "Search this directory",
+  searchFiles: "Search files",
+  search: "Search",
+  types: "Types",
+  directory: "directory",
+  file: "file",
+  link: "link",
+  folder: "Folder",
+  sort: "Sort",
+  name: "Name",
+  size: "Size",
+  modified: "Modified",
+  names: "Names",
+  natural: "Natural",
+  locale: "Locale",
+  unicode: "Unicode",
+  order: "Order",
+  ascending: "Ascending",
+  descending: "Descending",
+  directoriesFirst: "Folders first",
+  appearance: "Appearance",
+  system: "System",
+  light: "Light",
+  dark: "Dark",
+  searchArchive: "Search archive",
+  archiveSearchInput: "Search archive files",
+  entries: "{count} entries",
+  pageEntries: "{total} entries \xB7 {count} on this page",
+  loading: "Loading\u2026",
+  noMatches: "No matching entries.",
+  empty: "This directory is empty.",
+  pagination: "Pagination",
+  previous: "Previous",
+  next: "Next",
+  page: "Page {page} of {pages}",
+  keyboardHelp: "Arrow keys select files \xB7 Home / End jump \xB7 / searches \xB7 Backspace opens parent",
+  modifiedTime: "Modified time",
+  close: "Close",
+  unknown: "Unknown",
+  unavailable: "Target unavailable",
+  beginArchive: "Enter a search to begin.",
+  searchingArchive: "Searching archive\u2026",
+  archiveResults: "{count} results",
+  truncatedResults: "Showing {shown} of {count} results",
+  archiveError: "Could not load archive search. Try again.",
+  listingError: "Could not load complete directory data. Native page links remain available.",
+  folderError: "Could not open the folder. Its native link remains available.",
+  updatesError: "Live updates disconnected. Refresh to retry.",
+  retry: "Retry",
+  openNative: "Open folder directly",
+  categories: "File categories",
+  items: "{count} items",
+  filesIn: "Files in {path}",
+  controller: "Controller \xB7 Confirm / Back",
+  color: "Color",
+  pauseMotion: "Pause motion",
+  resumeMotion: "Resume motion",
+  copyLink: "Copy link",
+  copyPath: "Copy path",
+  download: "Download",
+  copied: "Copied.",
+  copyError: "Could not copy. Use the native link or select the path.",
+  repository: "Repository",
+  author: "by",
+  target: "Target",
+  newTab: "opens in a new tab"
+};
+function resolveCustomization(options = {}) {
+  const language = options.language === void 0 ? "en" : options.language, locale = options.locale === void 0 ? "en-US" : options.locale, timeZone = options.timeZone === void 0 ? "UTC" : options.timeZone;
+  for (const [key, value] of Object.entries({ language, locale, timeZone }))
+    if (typeof value !== "string" || !value)
+      throw new TypeError(`${key} must be a non-empty string`);
+  new Intl.DateTimeFormat(locale, { timeZone });
+  const direction = options.direction ?? "ltr";
+  if (direction !== "ltr" && direction !== "rtl")
+    throw new TypeError("direction must be ltr or rtl");
+  const labels = { ...defaultLabels };
+  if (options.labels !== void 0) {
+    if (typeof options.labels !== "object" || options.labels === null || Array.isArray(options.labels))
+      throw new TypeError("labels must be an object");
+    for (const [key, value] of Object.entries(options.labels)) {
+      if (!Object.hasOwn(labels, key) || typeof value !== "string")
+        throw new TypeError(`Unsupported label or value: ${key}`);
+      Object.assign(labels, { [key]: value });
+    }
+  }
+  const brand = options.brand ?? {};
+  if (typeof brand !== "object" || brand === null || Array.isArray(brand))
+    throw new TypeError("brand must be an object");
+  for (const [key, value] of Object.entries(brand)) {
+    if (!["name", "logoUrl", "logoAlt", "footerText", "footerUrl", "faviconUrl"].includes(key) || typeof value !== "string")
+      throw new TypeError(`Unsupported brand option or value: ${key}`);
+    if (key.endsWith("Url") && !/^https?:\/\//i.test(value) && !(value.startsWith("/") && !value.startsWith("//")))
+      throw new TypeError(`brand.${key} must be an HTTP(S) or root-relative URL`);
+  }
+  const columns = options.columns ?? ["name", "size", "modified"];
+  if (!Array.isArray(columns) || !columns.includes("name"))
+    throw new TypeError("columns must contain name and unique supported columns");
+  const columnIds = /* @__PURE__ */ new Set();
+  for (const column of columns) {
+    let id;
+    if (typeof column === "string") {
+      if (!["name", "size", "modified"].includes(column)) throw new TypeError("Unsupported column");
+      id = column;
+    } else {
+      if (typeof column !== "object" || column === null || Object.keys(column).some((key) => !["dataKey", "label"].includes(key)) || typeof column.dataKey !== "string" || !column.dataKey || typeof column.label !== "string" || !column.label)
+        throw new TypeError("Data columns require dataKey and label");
+      id = "data:" + column.dataKey;
+    }
+    if (columnIds.has(id)) throw new TypeError("columns must contain unique supported columns");
+    columnIds.add(id);
+  }
+  const actions = options.actions ?? [];
+  if (!Array.isArray(actions) || new Set(actions).size !== actions.length || actions.some((key) => !["copy-link", "copy-path", "download"].includes(key)))
+    throw new TypeError("actions must contain unique supported actions");
+  const cssVariables = options.cssVariables ?? {};
+  if (typeof cssVariables !== "object" || cssVariables === null || Array.isArray(cssVariables))
+    throw new TypeError("cssVariables must be an object");
+  for (const [key, value] of Object.entries(cssVariables))
+    if (!/^--[a-zA-Z][a-zA-Z0-9_-]*$/.test(key) || typeof value !== "string" || /[{};<>]/.test(value))
+      throw new TypeError(`Invalid CSS variable: ${key}`);
+  return {
+    language,
+    dateOptions: {
+      ...options.locale === void 0 ? {} : { locale: options.locale },
+      ...options.timeZone === void 0 ? {} : { timeZone: options.timeZone }
+    },
+    direction,
+    locale,
+    timeZone,
+    labels,
+    brand: { ...brand },
+    columns: columns.map((column) => typeof column === "string" ? column : { ...column }),
+    actions: [...actions],
+    cssVariables: { ...cssVariables }
+  };
+}
+var defaultCustomization = resolveCustomization();
+
 // ../shared-theme/src/navigation.ts
 async function fetchThemePage(dataHref, pageHref, theme, signal, fresh = false, attempt = 0) {
   const source = new URL(dataHref, document.baseURI);
@@ -190,6 +354,20 @@ async function fetchThemePage(dataHref, pageHref, theme, signal, fresh = false,
     throw new ListingDataError("Unsupported folder snapshot");
   if (data.metadataHead !== void 0 && typeof data.metadataHead !== "string")
     throw new ListingDataError("Invalid folder metadata");
+  const sort = data.sort;
+  if (!sort || typeof sort !== "object" || !["name", "size", "modified"].includes(String(sort.field)) || !["asc", "desc"].includes(String(sort.direction)) || !["natural", "locale", "unicode"].includes(String(sort.nameMode)) || typeof sort.directoriesFirst !== "boolean")
+    throw new ListingDataError("Invalid folder order");
+  if (theme === "crosswave") {
+    const categories = data.categories;
+    const ids = /* @__PURE__ */ new Set();
+    if (!Array.isArray(categories) || categories.length === 0 || categories.some((category) => {
+      if (typeof category !== "object" || category === null || typeof category.id !== "string" || !category.id || ids.has(category.id) || typeof category.label !== "string" || typeof category.svg !== "string")
+        return true;
+      ids.add(category.id);
+      return false;
+    }))
+      throw new ListingDataError("Invalid folder categories");
+  }
   const base = document.querySelector("base")?.href ?? pageHref;
   const link = (raw) => {
     if (raw === null) return null;
@@ -209,8 +387,22 @@ async function fetchThemePage(dataHref, pageHref, theme, signal, fresh = false,
     } : {}
   }));
   if (entries.length > Number(data.total)) throw new ListingDataError("Invalid folder count");
+  if (data.page !== null) {
+    const page = data.page;
+    if (!page || typeof page !== "object" || !Number.isSafeInteger(page.number) || Number(page.number) < 1 || !Number.isSafeInteger(page.count) || Number(page.count) < Number(page.number) || !Number.isSafeInteger(page.offset) || Number(page.offset) < 0 || Number(page.offset) > Number(data.total) || page.total !== data.total)
+      throw new ListingDataError("Invalid folder pagination");
+    data.page = {
+      ...page,
+      href: link(page.href),
+      previousHref: link(page.previousHref),
+      nextHref: link(page.nextHref)
+    };
+  }
+  if (data.ui !== void 0)
+    resolveCustomization(data.ui);
   const result = {
     ...data,
+    searchQueryHref: link(data.searchQueryHref ?? null),
     updatesHref: link(data.updatesHref ?? null),
     entries,
     dataHref: source.href,
@@ -225,8 +417,11 @@ async function fetchThemePage(dataHref, pageHref, theme, signal, fresh = false,
       return { name: raw.name, href: link(raw.href), dataHref: link(raw.dataHref) };
     })
   };
-  if (fresh && result.manifestHref) {
-    const loaded = await loadListing(result.manifestHref, { signal, cache: "no-store" });
+  if (result.manifestHref) {
+    const loaded = await loadListing(result.manifestHref, {
+      signal,
+      cache: fresh ? "no-store" : "default"
+    });
     if (loaded.manifest.total !== data.total || data.listingRevision !== void 0 && loaded.manifest.revision !== data.listingRevision) {
       if (attempt < 2) return fetchThemePage(dataHref, pageHref, theme, signal, true, attempt + 1);
       throw new ListingDataError("Folder changed while refreshing");

package/dist/source/shared/view-state.mjs

@@ -0,0 +1,128 @@
+// ../shared-theme/src/view-state.ts
+var supportedTypes = ["directory", "file", "link"];
+function validSort(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const sort = value;
+  return ["name", "size", "modified"].includes(String(sort.field)) && ["asc", "desc"].includes(String(sort.direction)) && ["natural", "locale", "unicode"].includes(String(sort.nameMode)) && typeof sort.directoriesFirst === "boolean";
+}
+function position(value) {
+  return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.min(value, 1e9)) : 0;
+}
+function readView(href, theme, path, defaults, categories = [], historyState = null) {
+  const params = new URL(href).searchParams;
+  const result = {
+    ...defaults,
+    query: (params.get("dw.q") ?? "").slice(0, 4096),
+    selected: null,
+    windowY: 0,
+    listTop: 0
+  };
+  if (theme === "ledger") {
+    const parts = params.get("dw.sort")?.split(":");
+    if (parts?.length === 4) {
+      const sort = {
+        field: parts[0],
+        direction: parts[1],
+        nameMode: parts[2],
+        directoriesFirst: parts[3] === "folders"
+      };
+      if (["folders", "mixed"].includes(parts[3]) && validSort(sort)) result.sort = sort;
+    }
+    if (params.has("dw.types")) {
+      const types = params.get("dw.types").split(",").filter(Boolean);
+      if (types.every((type) => supportedTypes.includes(type))) result.types = [...new Set(types)];
+    }
+  } else {
+    const category = params.get("dw.category");
+    if (category !== null && categories.includes(category)) result.category = category;
+  }
+  if (typeof historyState === "object" && historyState !== null && "dirwell" in historyState) {
+    const state = historyState.dirwell;
+    if (typeof state === "object" && state !== null && "version" in state && state.version === 1 && "theme" in state && state.theme === theme && "path" in state && state.path === path && "view" in state && typeof state.view === "object" && state.view !== null) {
+      const view = state.view;
+      result.selected = typeof view.selected === "string" && view.selected.length <= 4096 ? view.selected : null;
+      result.windowY = position(view.windowY);
+      result.listTop = position(view.listTop);
+    }
+  }
+  return result;
+}
+function viewHref(href, theme, view, defaults) {
+  const url = new URL(href);
+  for (const key of ["dw.q", "dw.sort", "dw.types", "dw.category"]) url.searchParams.delete(key);
+  if (view.query) url.searchParams.set("dw.q", view.query.slice(0, 4096));
+  if (theme === "ledger") {
+    if (view.sort && ["field", "direction", "nameMode", "directoriesFirst"].some(
+      (key) => view.sort[key] !== defaults.sort?.[key]
+    )) {
+      const sort = view.sort;
+      url.searchParams.set(
+        "dw.sort",
+        `${sort.field}:${sort.direction}:${sort.nameMode}:${sort.directoriesFirst ? "folders" : "mixed"}`
+      );
+    }
+    if (view.types && supportedTypes.some(
+      (type) => view.types.includes(type) !== (defaults.types ?? supportedTypes).includes(type)
+    ))
+      url.searchParams.set("dw.types", view.types.join(","));
+  } else if (view.category && view.category !== defaults.category)
+    url.searchParams.set("dw.category", view.category);
+  return url.href;
+}
+function createViewHistory(theme) {
+  let committedHref = location.href;
+  let committedState = history.state;
+  const stateFor = (dataHref, path, view) => ({
+    ...typeof history.state === "object" && history.state !== null ? history.state : {},
+    dataHref,
+    dirwell: {
+      version: 1,
+      theme,
+      path,
+      ...view === void 0 ? {} : {
+        view: {
+          query: view.query,
+          ...view.sort === void 0 ? {} : { sort: { ...view.sort } },
+          ...view.types === void 0 ? {} : { types: [...view.types] },
+          category: view.category ?? null,
+          selected: view.selected ?? null,
+          windowY: view.windowY ?? 0,
+          listTop: view.listTop ?? 0
+        }
+      }
+    }
+  });
+  return {
+    save(dataHref, path, view, defaults) {
+      if (location.href !== committedHref) return;
+      const href = viewHref(committedHref, theme, view, defaults);
+      const state = stateFor(dataHref, path, view);
+      try {
+        history.replaceState(state, "", href);
+        committedHref = href;
+        committedState = state;
+      } catch {
+      }
+    },
+    commit(dataHref, path, href, push) {
+      const state = stateFor(dataHref, path);
+      if (push) history.pushState(state, "", href);
+      else history.replaceState(state, "", href);
+      committedHref = href;
+      committedState = state;
+    },
+    rollback() {
+      if (location.href !== committedHref) {
+        try {
+          history.replaceState(committedState, "", committedHref);
+        } catch {
+        }
+      }
+    }
+  };
+}
+export {
+  createViewHistory,
+  readView,
+  viewHref
+};

package/dist/styles.css

@@ -1,4 +1,9 @@
 
+.entry-data{min-width:0;overflow-wrap:anywhere}
+
+[data-dirwell-actions] button,[data-dirwell-actions] a{min-height:44px;padding:8px 12px;border:1px solid var(--rule);border-radius:4px;background:var(--control);color:var(--ink)}
+@media(max-width:720px){.entry[data-custom-columns=true]{grid-template-columns:minmax(0,1fr)!important}.entry-head[data-custom-columns=true]{display:none}.entry[data-custom-columns=true]>.kind,.entry[data-custom-columns=true]>.timestamp-button{display:block!important}}
+
 :root {
   color-scheme: light dark;
   --dw-control-height: 2.75rem;
@@ -634,6 +639,7 @@ summary:focus-visible {
   background: var(--accent);
   color: var(--surface);
 }
+.brand-footer { padding: 0.7rem 1.4rem; overflow-wrap: anywhere; }
 footer {
   display: flex;
   align-items: center;