@kamod-ch/preactpress 1.0.0 → 1.0.3

package/src/shared/pageMeta.ts

@@ -1,136 +1,136 @@
-import type { Feature, Hero, PageAside, PageOutlineConfig } from './pageChrome.js'
+import type { Feature, Hero, PageAside, PageOutlineConfig } from "./pageChrome.js";
 
-export const META_DESCRIPTION_MAX = 155
-export const PAGE_LAYOUTS = ['doc', 'home', 'page'] as const
-export type PageLayout = (typeof PAGE_LAYOUTS)[number]
+export const META_DESCRIPTION_MAX = 155;
+export const PAGE_LAYOUTS = ["doc", "home", "page"] as const;
+export type PageLayout = (typeof PAGE_LAYOUTS)[number];
 
-export const DEFAULT_TITLE_TEMPLATE = ':title | :siteTitle'
+export const DEFAULT_TITLE_TEMPLATE = ":title | :siteTitle";
 
 /** Frontmatter and page metadata fields supported by PreactPress pages. */
 export interface PageMetaInput {
-  meta?: Record<string, unknown>
-  title?: string
-  titleTemplate?: string | false
-  description?: string
-  tags?: string[]
-  image?: string
-  pageType?: 'website' | 'article'
-  layout?: PageLayout
-  navbar?: boolean
-  sidebar?: boolean
-  aside?: PageAside
-  outline?: PageOutlineConfig
-  footer?: boolean
-  editLink?: boolean
-  lastUpdated?: boolean
-  pageClass?: string
-  isHome?: boolean
-  markdownStyles?: boolean
-  hero?: Hero
-  features?: Feature[]
-  kind?: 'markdown' | 'mdx'
-  html?: string
+  meta?: Record<string, unknown>;
+  title?: string;
+  titleTemplate?: string | false;
+  description?: string;
+  tags?: string[];
+  image?: string;
+  pageType?: "website" | "article";
+  layout?: PageLayout;
+  navbar?: boolean;
+  sidebar?: boolean;
+  aside?: PageAside;
+  outline?: PageOutlineConfig;
+  footer?: boolean;
+  editLink?: boolean;
+  lastUpdated?: boolean;
+  pageClass?: string;
+  isHome?: boolean;
+  markdownStyles?: boolean;
+  hero?: Hero;
+  features?: Feature[];
+  kind?: "markdown" | "mdx";
+  html?: string;
 }
 
 /** Alias for {@link PageMetaInput} — use in themes, hooks, and custom frontmatter helpers. */
-export type PageFrontmatter = PageMetaInput
+export type PageFrontmatter = PageMetaInput;
 
 export interface SiteMetaInput {
-  title: string
-  description: string
-  titleTemplate?: string | false
+  title: string;
+  description: string;
+  titleTemplate?: string | false;
 }
 
 export function formatTitleTemplate(
   template: string | false | undefined,
-  params: { title?: string; siteTitle: string }
+  params: { title?: string; siteTitle: string },
 ): string {
   if (template === false) {
-    return params.title?.trim() || params.siteTitle
+    return params.title?.trim() || params.siteTitle;
   }
-  const pattern = template?.trim() || DEFAULT_TITLE_TEMPLATE
-  if (!params.title?.trim()) return params.siteTitle
-  return pattern
-    .replace(/:title/g, params.title.trim())
-    .replace(/:siteTitle/g, params.siteTitle)
+  const pattern = template?.trim() || DEFAULT_TITLE_TEMPLATE;
+  if (!params.title?.trim()) return params.siteTitle;
+  return pattern.replace(/:title/g, params.title.trim()).replace(/:siteTitle/g, params.siteTitle);
 }
 
-export function titleTemplateFromMeta(meta: Record<string, unknown> | undefined): string | false | undefined {
-  const value = meta?.titleTemplate
-  if (value === false) return false
-  return typeof value === 'string' ? value : undefined
+export function titleTemplateFromMeta(
+  meta: Record<string, unknown> | undefined,
+): string | false | undefined {
+  const value = meta?.titleTemplate;
+  if (value === false) return false;
+  return typeof value === "string" ? value : undefined;
 }
 
 export function excerptFromHtml(html: string, maxLen = META_DESCRIPTION_MAX): string {
   const text = html
-    .replace(/<[^>]+>/g, ' ')
-    .replace(/&[a-z0-9#]+;/gi, ' ')
-    .replace(/\s+/g, ' ')
-    .trim()
-  if (!text) return ''
-  if (text.length <= maxLen) return text
-  const cut = text.slice(0, maxLen)
-  const lastSpace = cut.lastIndexOf(' ')
-  const trimmed = (lastSpace > 40 ? cut.slice(0, lastSpace) : cut).trim()
-  return `${trimmed}…`
+    .replace(/<[^>]+>/g, " ")
+    .replace(/&[a-z0-9#]+;/gi, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+  if (!text) return "";
+  if (text.length <= maxLen) return text;
+  const cut = text.slice(0, maxLen);
+  const lastSpace = cut.lastIndexOf(" ");
+  const trimmed = (lastSpace > 40 ? cut.slice(0, lastSpace) : cut).trim();
+  return `${trimmed}…`;
 }
 
 export function resolvePageMeta(
   page: PageMetaInput | undefined,
-  site: SiteMetaInput
+  site: SiteMetaInput,
 ): { title: string; description: string } {
-  const { title, description } = resolvePageHeadMeta(page, site)
-  return { title, description }
+  const { title, description } = resolvePageHeadMeta(page, site);
+  return { title, description };
 }
 
 export function resolvePageHeadMeta(
   page: PageMetaInput | undefined,
-  site: SiteMetaInput
+  site: SiteMetaInput,
 ): {
-  title: string
-  description: string
-  tags: string[]
-  image?: string
-  pageType: 'website' | 'article'
+  title: string;
+  description: string;
+  tags: string[];
+  image?: string;
+  pageType: "website" | "article";
 } {
-  const template = page?.titleTemplate ?? site.titleTemplate
+  const template = page?.titleTemplate ?? site.titleTemplate;
   const title = formatTitleTemplate(template, {
     title: page?.title,
-    siteTitle: site.title
-  })
+    siteTitle: site.title,
+  });
 
   let description =
-    (page?.description && String(page.description).trim()) || site.description.trim()
+    (page?.description && String(page.description).trim()) || site.description.trim();
 
-  if (!description && page?.kind === 'markdown' && page.html) {
-    description = excerptFromHtml(page.html)
+  if (!description && page?.kind === "markdown" && page.html) {
+    description = excerptFromHtml(page.html);
   }
 
-  const tags = page?.tags?.filter((tag) => tag.trim()).map((tag) => tag.trim()) ?? []
-  const image = page?.image?.trim() || undefined
-  const pageType = page?.pageType === 'article' ? 'article' : 'website'
+  const tags = page?.tags?.filter((tag) => tag.trim()).map((tag) => tag.trim()) ?? [];
+  const image = page?.image?.trim() || undefined;
+  const pageType = page?.pageType === "article" ? "article" : "website";
 
-  return { title, description, tags, image, pageType }
+  return { title, description, tags, image, pageType };
 }
 
 export function pageImageFromMeta(meta: Record<string, unknown>): string | undefined {
-  const value = meta.ogImage ?? meta.image
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined
+  const value = meta.ogImage ?? meta.image;
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
 
-export function pageTypeFromMeta(meta: Record<string, unknown>): 'website' | 'article' {
-  return meta.type === 'article' ? 'article' : 'website'
+export function pageTypeFromMeta(meta: Record<string, unknown>): "website" | "article" {
+  return meta.type === "article" ? "article" : "website";
 }
 
 export function pageLayoutFromMeta(meta: Record<string, unknown> | undefined): PageLayout {
-  const value = meta?.layout
-  return PAGE_LAYOUTS.includes(value as PageLayout) ? (value as PageLayout) : 'doc'
+  const value = meta?.layout;
+  return PAGE_LAYOUTS.includes(value as PageLayout) ? (value as PageLayout) : "doc";
 }
 
 export function isPageLayout(value: unknown): value is PageLayout {
-  return PAGE_LAYOUTS.includes(value as PageLayout)
+  return PAGE_LAYOUTS.includes(value as PageLayout);
 }
 
 export function isDraftPage(meta: Record<string, unknown>): boolean {
-  return meta.draft === true
+  return meta.draft === true;
 }

package/src/shared/rewrites.ts

@@ -1,35 +1,33 @@
-import type { ContentFile } from '../node/content.js'
-import { normalizeRoute } from './route.js'
+import type { ContentFile } from "../node/content.js";
+import { normalizeRoute } from "./route.js";
 
-export type RouteRewrites = Record<string, string>
+export type RouteRewrites = Record<string, string>;
 
 export function normalizeRewriteRoute(route: string): string {
-  return normalizeRoute(route)
+  return normalizeRoute(route);
 }
 
 export function applyRouteRewrites(
   routeToFile: Map<string, ContentFile>,
-  rewrites: RouteRewrites
+  rewrites: RouteRewrites,
 ): void {
   for (const [aliasRaw, sourceRaw] of Object.entries(rewrites)) {
-    const alias = normalizeRewriteRoute(aliasRaw)
-    const source = normalizeRewriteRoute(sourceRaw)
-    const sourceFile = routeToFile.get(source)
+    const alias = normalizeRewriteRoute(aliasRaw);
+    const source = normalizeRewriteRoute(sourceRaw);
+    const sourceFile = routeToFile.get(source);
     if (!sourceFile) {
-      throw new Error(
-        `preactpress: rewrite source route not found: ${sourceRaw} (${source})`
-      )
+      throw new Error(`preactpress: rewrite source route not found: ${sourceRaw} (${source})`);
     }
-    const existing = routeToFile.get(alias)
+    const existing = routeToFile.get(alias);
     if (existing && existing.file !== sourceFile.file) {
       throw new Error(
-        `preactpress: rewrite collision for ${alias}: ${pathLabel(existing)} and ${pathLabel(sourceFile)}`
-      )
+        `preactpress: rewrite collision for ${alias}: ${pathLabel(existing)} and ${pathLabel(sourceFile)}`,
+      );
     }
-    routeToFile.set(alias, { ...sourceFile, route: alias })
+    routeToFile.set(alias, { ...sourceFile, route: alias });
   }
 }
 
 function pathLabel(file: ContentFile): string {
-  return file.route === '/' ? '/' : file.route
+  return file.route === "/" ? "/" : file.route;
 }

package/src/shared/route.ts

@@ -1,14 +1,14 @@
 /** Normalize a path or route to a site route (no query/hash, leading slash, no trailing slash except `/`). */
 export function normalizeRoute(route: string): string {
-  const clean = route.split(/[?#]/, 1)[0] || '/'
-  const prefixed = clean.startsWith('/') ? clean : `/${clean}`
-  return prefixed.replace(/\/$/, '') || '/'
+  const clean = route.split(/[?#]/, 1)[0] || "/";
+  const prefixed = clean.startsWith("/") ? clean : `/${clean}`;
+  return prefixed.replace(/\/$/, "") || "/";
 }
 
 /** Map a request pathname to a site route using the configured base. */
 export function routeFromPathname(pathname: string, base: string): string {
-  const basePath = base === '/' ? '' : base.replace(/\/$/, '')
-  let p = pathname
-  if (basePath && p.startsWith(basePath)) p = p.slice(basePath.length) || '/'
-  return normalizeRoute(p)
+  const basePath = base === "/" ? "" : base.replace(/\/$/, "");
+  let p = pathname;
+  if (basePath && p.startsWith(basePath)) p = p.slice(basePath.length) || "/";
+  return normalizeRoute(p);
 }

package/src/shared/scrollRestoration.ts

@@ -0,0 +1,70 @@
+export const SCROLL_STATE_KEY = "ppScrollY";
+
+let skipScrollRestoreOnce = false;
+
+export function setupScrollRestoration(): () => void {
+  if (typeof window === "undefined") return () => {};
+
+  if ("scrollRestoration" in window.history) {
+    window.history.scrollRestoration = "manual";
+  }
+
+  let timeout: ReturnType<typeof setTimeout> | undefined;
+  const onScroll = () => {
+    clearTimeout(timeout);
+    timeout = setTimeout(persistScrollPosition, 150);
+  };
+  window.addEventListener("scroll", onScroll, { passive: true });
+  return () => {
+    window.removeEventListener("scroll", onScroll);
+    clearTimeout(timeout);
+  };
+}
+
+export function persistScrollPosition(): void {
+  if (typeof window === "undefined") return;
+  const scrollY = window.scrollY;
+  const state = window.history.state ?? {};
+  if (state[SCROLL_STATE_KEY] === scrollY) return;
+  window.history.replaceState({ ...state, [SCROLL_STATE_KEY]: scrollY }, "");
+}
+
+export function saveScrollPositionBeforeNavigation(): void {
+  persistScrollPosition();
+}
+
+export function readScrollPositionFromHistory(): number {
+  if (typeof window === "undefined") return 0;
+  const scrollY = window.history.state?.[SCROLL_STATE_KEY];
+  return typeof scrollY === "number" && Number.isFinite(scrollY) ? scrollY : 0;
+}
+
+export function restoreScrollPosition(): void {
+  if (typeof window === "undefined") return;
+  window.scrollTo({ top: readScrollPositionFromHistory(), left: 0, behavior: "auto" });
+}
+
+export function restoreScrollPositionAfterLayout(): void {
+  if (typeof window === "undefined") return;
+  requestAnimationFrame(() => {
+    requestAnimationFrame(() => {
+      const html = document.documentElement;
+      const previous = html.style.scrollBehavior;
+      html.style.scrollBehavior = "auto";
+      restoreScrollPosition();
+      html.style.scrollBehavior = previous;
+    });
+  });
+}
+
+export function skipNextScrollRestore(): void {
+  skipScrollRestoreOnce = true;
+}
+
+export function consumeScrollRestoreOnPopstate(): boolean {
+  if (skipScrollRestoreOnce) {
+    skipScrollRestoreOnce = false;
+    return false;
+  }
+  return true;
+}

package/src/shared/search.ts

@@ -1,105 +1,109 @@
-export type SearchProvider = 'local' | 'algolia'
+import { saveScrollPositionBeforeNavigation, skipNextScrollRestore } from "./scrollRestoration.js";
+
+export type SearchProvider = "local" | "algolia";
 
 export interface LocalSearchConfig {
-  provider: 'local'
+  provider: "local";
 }
 
 export interface AlgoliaSearchOptions {
-  appId?: string
-  apiKey?: string
-  indexName?: string
-  placeholder?: string
-  maxResultsPerGroup?: number
-  disableUserPersonalization?: boolean
-  initialQuery?: string
-  recentSearchesLimit?: number
-  recentSearchesWithFavoritesLimit?: number
-  insights?: boolean
-  searchParameters?: Record<string, unknown>
+  appId?: string;
+  apiKey?: string;
+  indexName?: string;
+  placeholder?: string;
+  maxResultsPerGroup?: number;
+  disableUserPersonalization?: boolean;
+  initialQuery?: string;
+  recentSearchesLimit?: number;
+  recentSearchesWithFavoritesLimit?: number;
+  insights?: boolean;
+  searchParameters?: Record<string, unknown>;
   /** Locale-specific overrides (merged with root options). */
-  locales?: Record<string, Partial<AlgoliaSearchOptions>>
+  locales?: Record<string, Partial<AlgoliaSearchOptions>>;
 }
 
 export interface AlgoliaSearchConfig {
-  provider: 'algolia'
-  options: AlgoliaSearchOptions
+  provider: "algolia";
+  options: AlgoliaSearchOptions;
 }
 
 /** `true` keeps local sidebar search; use `{ provider }` for explicit providers. */
-export type SearchConfig = boolean | LocalSearchConfig | AlgoliaSearchConfig
+export type SearchConfig = boolean | LocalSearchConfig | AlgoliaSearchConfig;
 
 export function resolveSearchProvider(search?: SearchConfig): SearchProvider | false {
-  if (search === true) return 'local'
-  if (search === false || search == null) return false
-  return search.provider
+  if (search === true) return "local";
+  if (search === false || search == null) return false;
+  return search.provider;
 }
 
 export function isLocalSearchEnabled(search?: SearchConfig): boolean {
-  return resolveSearchProvider(search) === 'local'
+  return resolveSearchProvider(search) === "local";
 }
 
 export function isAlgoliaSearchEnabled(search?: SearchConfig): boolean {
-  return resolveSearchProvider(search) === 'algolia'
+  return resolveSearchProvider(search) === "algolia";
 }
 
 export function algoliaOptionsFromSearch(search?: SearchConfig): AlgoliaSearchOptions | undefined {
-  if (typeof search === 'object' && search.provider === 'algolia') return search.options
-  return undefined
+  if (typeof search === "object" && search.provider === "algolia") return search.options;
+  return undefined;
 }
 
 export function resolveAlgoliaOptions(
   options: AlgoliaSearchOptions,
-  localeKey?: string
+  localeKey?: string,
 ): AlgoliaSearchOptions {
-  const { locales, ...root } = options
-  const override = localeKey && locales?.[localeKey] ? locales[localeKey] : {}
+  const { locales, ...root } = options;
+  const override = localeKey && locales?.[localeKey] ? locales[localeKey] : {};
   return {
     ...root,
     ...override,
-    searchParameters: override.searchParameters ?? root.searchParameters
-  }
+    searchParameters: override.searchParameters ?? root.searchParameters,
+  };
 }
 
 export function validateAlgoliaCredentials(options: AlgoliaSearchOptions): {
-  valid: boolean
-  appId?: string
-  apiKey?: string
-  indexName?: string
+  valid: boolean;
+  appId?: string;
+  apiKey?: string;
+  indexName?: string;
 } {
-  const appId = options.appId?.trim()
-  const apiKey = options.apiKey?.trim()
-  const indexName = options.indexName?.trim()
+  const appId = options.appId?.trim();
+  const apiKey = options.apiKey?.trim();
+  const indexName = options.indexName?.trim();
   return {
     valid: Boolean(appId && apiKey && indexName),
     appId,
     apiKey,
-    indexName
-  }
+    indexName,
+  };
 }
 
 export function getRelativeDocSearchUrl(url: string, base: string, cleanUrls = true): string {
-  const { pathname, hash } = new URL(url, 'http://preactpress.local')
-  const normalizedBase = base === '/' ? '' : base.replace(/\/$/, '')
-  let path = pathname
+  const { pathname, hash } = new URL(url, "http://preactpress.local");
+  const normalizedBase = base === "/" ? "" : base.replace(/\/$/, "");
+  let path = pathname;
   if (normalizedBase && path.startsWith(normalizedBase)) {
-    path = path.slice(normalizedBase.length) || '/'
+    path = path.slice(normalizedBase.length) || "/";
   }
-  const route = cleanUrls ? path.replace(/\.html$/, '').replace(/\/index$/, '/') || '/' : path
-  return `${route}${hash}`
+  const route = cleanUrls ? path.replace(/\.html$/, "").replace(/\/index$/, "/") || "/" : path;
+  return `${route}${hash}`;
 }
 
 export function navigateDocSearchResult(itemUrl: string, base: string): void {
-  const url = new URL(itemUrl, window.location.origin)
-  const normalizedBase = base === '/' ? '' : base.replace(/\/$/, '')
+  const url = new URL(itemUrl, window.location.origin);
+  const normalizedBase = base === "/" ? "" : base.replace(/\/$/, "");
   const href =
     normalizedBase && !url.pathname.startsWith(normalizedBase)
       ? itemUrl
-      : `${normalizedBase}${url.pathname.replace(normalizedBase, '') || '/'}${url.search}${url.hash}`
+      : `${normalizedBase}${url.pathname.replace(normalizedBase, "") || "/"}${url.search}${url.hash}`;
   if (url.origin !== window.location.origin) {
-    window.location.assign(href)
-    return
+    window.location.assign(href);
+    return;
   }
-  window.history.pushState({}, '', href)
-  window.dispatchEvent(new PopStateEvent('popstate'))
-  window.scrollTo({ top: 0 })
+  saveScrollPositionBeforeNavigation();
+  window.history.pushState({}, "", href);
+  skipNextScrollRestore();
+  window.dispatchEvent(new PopStateEvent("popstate"));
+  window.scrollTo({ top: 0, behavior: "auto" });
 }

package/src/shared/sidebar.ts

@@ -1,67 +1,67 @@
-import type { NavItem, ResolvedI18n, SidebarGroup, SidebarItem } from '../node/siteConfig.js'
-import { routePathKey } from './locale.js'
-import { normalizeRoute } from './route.js'
+import type { NavItem, ResolvedI18n, SidebarGroup, SidebarItem } from "../node/siteConfig.js";
+import { routePathKey } from "./locale.js";
+import { normalizeRoute } from "./route.js";
 
-export type SidebarConfig = SidebarGroup[] | Record<string, SidebarGroup[]>
+export type SidebarConfig = SidebarGroup[] | Record<string, SidebarGroup[]>;
 
 export function isPathSidebarConfig(
-  sidebar: SidebarConfig | undefined
+  sidebar: SidebarConfig | undefined,
 ): sidebar is Record<string, SidebarGroup[]> {
-  return Boolean(sidebar && !Array.isArray(sidebar))
+  return Boolean(sidebar && !Array.isArray(sidebar));
 }
 
 export function resolveSidebarForRoute(
   sidebar: SidebarConfig | undefined,
   route: string,
-  i18n?: ResolvedI18n
+  i18n?: ResolvedI18n,
 ): SidebarGroup[] {
-  if (!sidebar) return []
-  if (Array.isArray(sidebar)) return sidebar
+  if (!sidebar) return [];
+  if (Array.isArray(sidebar)) return sidebar;
 
-  const pathKey = routePathKey(route, i18n)
+  const pathKey = routePathKey(route, i18n);
   const entries = Object.entries(sidebar)
     .map(([prefix, groups]) => ({ prefix: normalizeRoute(prefix), groups }))
-    .filter(({ prefix }) => prefix !== '/')
-    .sort((a, b) => b.prefix.length - a.prefix.length)
+    .filter(({ prefix }) => prefix !== "/")
+    .sort((a, b) => b.prefix.length - a.prefix.length);
 
   for (const { prefix, groups } of entries) {
     if (pathKey === prefix || pathKey.startsWith(`${prefix}/`)) {
-      return groups
+      return groups;
     }
   }
 
-  return sidebar['/'] ?? sidebar[''] ?? []
+  return sidebar["/"] ?? sidebar[""] ?? [];
 }
 
 export function flattenSidebarLeafItems(
-  items: SidebarItem[]
+  items: SidebarItem[],
 ): Array<{ text: string; link: string }> {
-  const out: Array<{ text: string; link: string }> = []
+  const out: Array<{ text: string; link: string }> = [];
   for (const item of items) {
-    if (item.link) out.push({ text: item.text, link: item.link })
-    if (item.items?.length) out.push(...flattenSidebarLeafItems(item.items))
+    if (item.link) out.push({ text: item.text, link: item.link });
+    if (item.items?.length) out.push(...flattenSidebarLeafItems(item.items));
   }
-  return out
+  return out;
 }
 
 export function flattenSidebarItems(
-  sidebar: SidebarConfig | undefined
+  sidebar: SidebarConfig | undefined,
 ): Array<{ text: string; link: string }> {
-  return allSidebarGroups(sidebar).flatMap((group) => flattenSidebarLeafItems(group.items))
+  return allSidebarGroups(sidebar).flatMap((group) => flattenSidebarLeafItems(group.items));
 }
 
 export function flattenNavLeafItems(
-  items: NavItem[] | undefined
+  items: NavItem[] | undefined,
 ): Array<{ text: string; link: string }> {
-  const out: Array<{ text: string; link: string }> = []
+  const out: Array<{ text: string; link: string }> = [];
   for (const item of items ?? []) {
-    if (item.link) out.push({ text: item.text, link: item.link })
-    if (item.items?.length) out.push(...flattenNavLeafItems(item.items))
+    if (item.link) out.push({ text: item.text, link: item.link });
+    if (item.items?.length) out.push(...flattenNavLeafItems(item.items));
   }
-  return out
+  return out;
 }
 
 export function allSidebarGroups(sidebar: SidebarConfig | undefined): SidebarGroup[] {
-  if (!sidebar) return []
-  return Array.isArray(sidebar) ? sidebar : Object.values(sidebar).flat()
+  if (!sidebar) return [];
+  return Array.isArray(sidebar) ? sidebar : Object.values(sidebar).flat();
 }

package/src/shared/slug.ts

@@ -1,23 +1,23 @@
-import type { OutlineItem } from '../node/siteConfig.js'
+import type { OutlineItem } from "../node/siteConfig.js";
 
-export function slugifySegment(text: string, fallback = 'section'): string {
+export function slugifySegment(text: string, fallback = "section"): string {
   const slug = text
     .toLowerCase()
     .trim()
-    .replace(/<[^>]+>/g, '')
-    .replace(/&[a-z0-9#]+;/gi, '')
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-  return slug || fallback
+    .replace(/<[^>]+>/g, "")
+    .replace(/&[a-z0-9#]+;/gi, "")
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  return slug || fallback;
 }
 
 export function uniqueSlug(base: string, existing: OutlineItem[]): string {
-  let id = base
-  let i = 1
-  const used = new Set(existing.map((h) => h.id))
+  let id = base;
+  let i = 1;
+  const used = new Set(existing.map((h) => h.id));
   while (used.has(id)) {
-    i += 1
-    id = `${base}-${i}`
+    i += 1;
+    id = `${base}-${i}`;
   }
-  return id
+  return id;
 }