@fuzdev/fuz_ui 0.195.1 → 0.197.0

package/dist/library.svelte.d.ts

@@ -91,82 +91,7 @@ export declare class Library {
         main?: string | undefined;
         exports?: string | Record<string, unknown> | null | undefined;
     };
-    readonly source_json: {
-        [x: string]: unknown;
-        name: string;
-        version: string;
-        modules?: {
-            [x: string]: unknown;
-            path: string;
-            declarations?: {
-                [x: string]: unknown;
-                name: string;
-                kind: "function" | "class" | "type" | "json" | "variable" | "constructor" | "component" | "css";
-                doc_comment?: string | undefined;
-                type_signature?: string | undefined;
-                modifiers?: string[] | undefined;
-                source_line?: number | undefined;
-                parameters?: {
-                    [x: string]: unknown;
-                    name: string;
-                    type: string;
-                    optional?: boolean | undefined;
-                    description?: string | undefined;
-                    default_value?: string | undefined;
-                }[] | undefined;
-                return_type?: string | undefined;
-                return_description?: string | undefined;
-                generic_params?: {
-                    [x: string]: unknown;
-                    name: string;
-                    constraint?: string | undefined;
-                    default_type?: string | undefined;
-                }[] | undefined;
-                examples?: string[] | undefined;
-                deprecated_message?: string | undefined;
-                see_also?: string[] | undefined;
-                throws?: {
-                    [x: string]: unknown;
-                    description: string;
-                    type?: string | undefined;
-                }[] | undefined;
-                since?: string | undefined;
-                mutates?: Record<string, string> | undefined;
-                extends?: string[] | undefined;
-                implements?: string[] | undefined;
-                members?: Record<string, unknown>[] | undefined;
-                properties?: Record<string, unknown>[] | undefined;
-                props?: {
-                    [x: string]: unknown;
-                    name: string;
-                    type: string;
-                    optional?: boolean | undefined;
-                    description?: string | undefined;
-                    default_value?: string | undefined;
-                    bindable?: boolean | undefined;
-                    examples?: string[] | undefined;
-                    deprecated_message?: string | undefined;
-                    see_also?: string[] | undefined;
-                    throws?: {
-                        [x: string]: unknown;
-                        description: string;
-                        type?: string | undefined;
-                    }[] | undefined;
-                    since?: string | undefined;
-                }[] | undefined;
-                also_exported_from?: string[] | undefined;
-                alias_of?: {
-                    module: string;
-                    name: string;
-                    kind: "function" | "class" | "type" | "json" | "variable" | "constructor" | "component" | "css";
-                } | undefined;
-            }[] | undefined;
-            module_comment?: string | undefined;
-            dependencies?: string[] | undefined;
-            dependents?: string[] | undefined;
-            star_exports?: string[] | undefined;
-        }[] | undefined;
-    };
+    readonly source_json: import("@fuzdev/fuz_util/library_json.js").SourceJson;
     readonly name: string;
     readonly repo_name: string;
     readonly repo_url: import("@fuzdev/fuz_util/url.js").Url;

package/dist/library.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAIlE,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,eAAO,MAAM,eAAe;;;;CAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA4C;IACjE,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA2C;IAE/D,QAAQ,CAAC,IAAI,SAAoC;IACjD,QAAQ,CAAC,SAAS,SAAyC;IAC3D,QAAQ,CAAC,QAAQ,wCAAwC;IACzD,QAAQ,CAAC,UAAU,gBAA0C;IAC7D,QAAQ,CAAC,YAAY,+CAA4C;IACjE,QAAQ,CAAC,QAAQ,+CAAwC;IACzD,QAAQ,CAAC,QAAQ,SAAwC;IACzD,QAAQ,CAAC,OAAO,+CAAuC;IACvD,QAAQ,CAAC,aAAa,+CAA6C;IACnE,QAAQ,CAAC,SAAS,UAAyC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAMd;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAKtD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}
+{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAIlE,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,eAAO,MAAM,eAAe;;;;CAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA4C;IACjE,QAAQ,CAAC,WAAW,wDAA2C;IAE/D,QAAQ,CAAC,IAAI,SAAoC;IACjD,QAAQ,CAAC,SAAS,SAAyC;IAC3D,QAAQ,CAAC,QAAQ,wCAAwC;IACzD,QAAQ,CAAC,UAAU,gBAA0C;IAC7D,QAAQ,CAAC,YAAY,+CAA4C;IACjE,QAAQ,CAAC,QAAQ,+CAAwC;IACzD,QAAQ,CAAC,QAAQ,SAAwC;IACzD,QAAQ,CAAC,OAAO,+CAAuC;IACvD,QAAQ,CAAC,aAAa,+CAA6C;IACnE,QAAQ,CAAC,SAAS,UAAyC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAMd;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAKtD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}

package/dist/module.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAI1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;gBAE7C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}
+{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;gBAE7C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}

package/dist/module.svelte.js

@@ -11,9 +11,10 @@ import { url_github_file } from './package_helpers.js';
  */
 export class Module {
     library = $state.raw();
-    // `library.json` is compacted (svelte-docinfo's `compactReplacer` strips empty
-    // default arrays), so the on-disk data is the `*Input` shape. Typing it as
-    // input makes TypeScript force guards on defaulted-array reads.
+    // The `virtual:svelte-docinfo` module is compacted (svelte-docinfo's
+    // `compactReplacer` strips empty default arrays), so the runtime data is the
+    // `*Input` shape. Typing it as input makes TypeScript force guards on
+    // defaulted-array reads.
     module_json = $state.raw();
     /**
      * Canonical module path — `src/lib/`-relative, with source extension

package/dist/package_helpers.d.ts

@@ -8,7 +8,6 @@
  * - `url_github_file` - GitHub file permalink
  * - `url_github_org` - GitHub organization page
  * - `url_npm_package` - npm package page
- * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
  * - `repo_url_parse` - extract repo URL from `package.json` repository field
@@ -148,18 +147,4 @@ export declare const repo_name_parse: (name: string) => string;
  * ```
  */
 export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
-/**
- * Build .well-known URL for package metadata files.
- *
- * @param homepage_url - package homepage URL
- * @param filename - filename in .well-known directory
- * @returns full URL to the .well-known file
- *
- * @example
- * ```ts
- * url_well_known('https://fuz.dev', 'package.json')
- * // => 'https://fuz.dev/.well-known/package.json'
- * ```
- */
-export declare const url_well_known: (homepage_url: string, filename: string) => string;
 //# sourceMappingURL=package_helpers.d.ts.map

package/dist/package_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}
+{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC"}

package/dist/package_helpers.js

@@ -8,7 +8,6 @@
  * - `url_github_file` - GitHub file permalink
  * - `url_github_org` - GitHub organization page
  * - `url_npm_package` - npm package page
- * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
  * - `repo_url_parse` - extract repo URL from `package.json` repository field
@@ -20,7 +19,7 @@
  *
  * @module
  */
-import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
+import { strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
 /**
  * Build GitHub file URL for a repository.
  *
@@ -178,19 +177,3 @@ export const repo_url_parse = (repository) => {
         return null;
     return strip_end(strip_start(strip_end(url, '.git'), 'git+'), '/');
 };
-/**
- * Build .well-known URL for package metadata files.
- *
- * @param homepage_url - package homepage URL
- * @param filename - filename in .well-known directory
- * @returns full URL to the .well-known file
- *
- * @example
- * ```ts
- * url_well_known('https://fuz.dev', 'package.json')
- * // => 'https://fuz.dev/.well-known/package.json'
- * ```
- */
-export const url_well_known = (homepage_url, filename) => {
-    return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;
-};

package/dist/site.svelte.d.ts

@@ -0,0 +1,34 @@
+import type { Url } from '@fuzdev/fuz_util/url.js';
+import type { SvgData } from './svg.js';
+export interface SiteStateOptions {
+    /**
+     * The site's icon, e.g. a logo from `logos.ts`.
+     */
+    icon?: SvgData | null;
+    /**
+     * The site's glyph, a single unicode character identifying the project.
+     */
+    glyph?: string | null;
+    /**
+     * The site's source repository url, e.g. for `DocsFooter` links.
+     */
+    repo_url?: Url | null;
+}
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export declare class SiteState {
+    icon: SvgData | null;
+    glyph: string | null;
+    repo_url: Url | null;
+    constructor(options?: SiteStateOptions);
+}
+export declare const site_context: {
+    get: (error_message?: string) => SiteState;
+    get_maybe: () => SiteState | undefined;
+    set: (value: SiteState) => SiteState;
+};
+//# sourceMappingURL=site.svelte.d.ts.map

package/dist/site.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/site.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACrB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAoB;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAoB;IACxC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAoB;gBAE5B,OAAO,GAAE,gBAAqB;CAK1C;AAED,eAAO,MAAM,YAAY;;;;CAA8B,CAAC"}

package/dist/site.svelte.js

@@ -0,0 +1,18 @@
+import { create_context } from './context_helpers.js';
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export class SiteState {
+    icon = $state.raw(null);
+    glyph = $state.raw(null);
+    repo_url = $state.raw(null);
+    constructor(options = {}) {
+        this.icon = options.icon ?? null;
+        this.glyph = options.glyph ?? null;
+        this.repo_url = options.repo_url ?? null;
+    }
+}
+export const site_context = create_context();

package/dist/svg.d.ts

@@ -0,0 +1,25 @@
+import type { SvelteHTMLElements } from 'svelte/elements';
+export interface SvgData {
+    /**
+     * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
+     * This is an escape hatch for non-`path` markup -
+     * generally, you should instead use the `paths` property to avoid security/CSP implications.
+     */
+    raw?: string | null;
+    /**
+     * List of svg `path` attribute objects. The `d` attribute is required.
+     */
+    paths?: Array<{
+        d: string;
+    } & SvelteHTMLElements['path']> | null;
+    attrs?: SvelteHTMLElements['svg'] | null;
+    fill?: string | null;
+    width?: string | null;
+    height?: string | null;
+    label?: string | null;
+    /**
+     * Defaults to `"0 0 100 100"`.
+     */
+    viewBox?: string | null;
+}
+//# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}

package/dist/svg.js

@@ -0,0 +1 @@
+export {};

package/dist/tsdoc_mdz.d.ts

@@ -37,8 +37,8 @@
  * tsdoc_see_to_mdz('[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library')
  * // → '[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library'
  *
- * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
- * // → '`library_gen.ts` for Gro-specific integration'
+ * tsdoc_see_to_mdz('tome.ts for the documentation system')
+ * // → '`tome.ts` for the documentation system'
  * ```
  */
 export declare const tsdoc_see_to_mdz: (content: string) => string;

package/dist/tsdoc_mdz.js

@@ -40,8 +40,8 @@ const format_reference = (ref) => (mdz_is_url(ref) ? ref : `\`${ref}\``);
  * tsdoc_see_to_mdz('[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library')
  * // → '[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library'
  *
- * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
- * // → '`library_gen.ts` for Gro-specific integration'
+ * tsdoc_see_to_mdz('tome.ts for the documentation system')
+ * // → '`tome.ts` for the documentation system'
  * ```
  */
 export const tsdoc_see_to_mdz = (content) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.195.1",
+  "version": "0.197.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -80,11 +80,11 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/blake3_wasm": "^0.1.0",
+    "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.60.0",
-    "@fuzdev/fuz_util": "^0.61.1",
-    "@fuzdev/gro": "^0.199.1",
+    "@fuzdev/fuz_css": "^0.61.1",
+    "@fuzdev/fuz_util": "^0.63.0",
+    "@fuzdev/gro": "^0.200.0",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.12.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
@@ -95,20 +95,20 @@
     "@types/estree": "^1.0.8",
     "@types/node": "^24.10.1",
     "@webref/css": "^8.2.0",
-    "eslint": "^9.39.1",
-    "eslint-plugin-svelte": "^3.13.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-svelte": "^3.19.0",
     "esm-env": "^1.2.2",
     "jsdom": "^27.2.0",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.5.1",
-    "svelte": "^5.55.10",
+    "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
-    "svelte-docinfo": "^0.1.0",
+    "svelte-docinfo": "^0.2.0",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1",
+    "typescript-eslint": "^8.60.0",
     "vite": "^7.3.1",
     "vitest": "^4.0.15",
     "zimmerframe": "^1.1.4",

package/src/lib/constants.ts

@@ -1,3 +1,8 @@
 // TODO the 60px is a hack, need `--docs_primary_nav_height` exported or :root values from Fuz -- the --space_lg also needs to be kept in sync
 // see also the same issue in fuz_css
 export const MAIN_HEADER_MARGIN_TOP = 'calc(60px + var(--space_lg))';
+
+/**
+ * The Fuz ecosystem home url, e.g. for `DocsFooter`'s `root_url`.
+ */
+export const FUZ_DEV_URL = 'https://www.fuz.dev/';

package/src/lib/declaration.svelte.ts

@@ -11,10 +11,11 @@ import {generateImport, getDisplayName} from 'svelte-docinfo/declaration-helpers
 import type {Module} from './module.svelte.js';
 import {url_github_file} from './package_helpers.js';
 
-// `library.json` is serialized with svelte-docinfo's `compactReplacer`, which
-// strips empty default arrays — so the on-disk data is the `*Input` shape
-// (defaulted arrays optional), not the parsed `*Json` shape. Typing it as
-// input makes TypeScript force a guard on every defaulted-array read.
+// The `virtual:svelte-docinfo` module is serialized with svelte-docinfo's
+// `compactReplacer`, which strips empty default arrays — so the runtime data
+// is the `*Input` shape (defaulted arrays optional), not the parsed `*Json`
+// shape. Typing it as input makes TypeScript force a guard on every
+// defaulted-array read.
 //
 // Helper to access kind-specific fields on the discriminated union.
 // At runtime the field is present or undefined; TypeScript needs the cast.

package/src/lib/logos.ts

@@ -1,4 +1,4 @@
-import type {SvgData} from './Svg.svelte';
+import type {SvgData} from './svg.js';
 
 // TODO these can be optimized during builds, helpers and gen files?
 

package/src/lib/mdz_lexer.ts

@@ -603,7 +603,7 @@ export class MdzLexer {
 		const open_type = kind === 'italic' ? 'italic_open' : 'strikethrough_open';
 		const close_type = kind === 'italic' ? 'italic_close' : 'strikethrough_close';
 		const open_token_index = this.#tokens.length;
-		this.#tokens.push({type: open_type, start, end: this.#index} as MdzToken);
+		this.#tokens.push({type: open_type, start, end: this.#index});
 
 		// Set search boundary for nested parsers
 		const saved_max = this.#max_search_index;
@@ -634,7 +634,7 @@ export class MdzLexer {
 				type: close_type,
 				start: close_index,
 				end: close_index + 1,
-			} as MdzToken);
+			});
 			this.#index = close_index + 1;
 		} else {
 			// Convert opening to text

package/src/lib/mdz_token_parser.ts

@@ -443,7 +443,7 @@ class MdzTokenParser {
 						end: node.end,
 					};
 				} else {
-					pending_text = {...node} as MdzTextNode;
+					pending_text = {...node};
 				}
 			} else {
 				if (pending_text) {

package/src/lib/module.svelte.ts

@@ -15,9 +15,10 @@ import {url_github_file} from './package_helpers.js';
  */
 export class Module {
 	readonly library: Library = $state.raw()!;
-	// `library.json` is compacted (svelte-docinfo's `compactReplacer` strips empty
-	// default arrays), so the on-disk data is the `*Input` shape. Typing it as
-	// input makes TypeScript force guards on defaulted-array reads.
+	// The `virtual:svelte-docinfo` module is compacted (svelte-docinfo's
+	// `compactReplacer` strips empty default arrays), so the runtime data is the
+	// `*Input` shape. Typing it as input makes TypeScript force guards on
+	// defaulted-array reads.
 	readonly module_json: ModuleJsonInput = $state.raw()!;
 
 	/**

package/src/lib/package_helpers.ts

@@ -8,7 +8,6 @@
  * - `url_github_file` - GitHub file permalink
  * - `url_github_org` - GitHub organization page
  * - `url_npm_package` - npm package page
- * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
  * - `repo_url_parse` - extract repo URL from `package.json` repository field
@@ -21,7 +20,7 @@
  * @module
  */
 
-import {ensure_end, strip_end, strip_start} from '@fuzdev/fuz_util/string.js';
+import {strip_end, strip_start} from '@fuzdev/fuz_util/string.js';
 import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
 
 /**
@@ -185,20 +184,3 @@ export const repo_url_parse = (repository: PackageJson['repository']): string |
 	if (!url) return null;
 	return strip_end(strip_start(strip_end(url, '.git'), 'git+'), '/');
 };
-
-/**
- * Build .well-known URL for package metadata files.
- *
- * @param homepage_url - package homepage URL
- * @param filename - filename in .well-known directory
- * @returns full URL to the .well-known file
- *
- * @example
- * ```ts
- * url_well_known('https://fuz.dev', 'package.json')
- * // => 'https://fuz.dev/.well-known/package.json'
- * ```
- */
-export const url_well_known = (homepage_url: string, filename: string): string => {
-	return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;
-};

package/src/lib/site.svelte.ts

@@ -0,0 +1,39 @@
+import type {Url} from '@fuzdev/fuz_util/url.js';
+
+import {create_context} from './context_helpers.js';
+import type {SvgData} from './svg.js';
+
+export interface SiteStateOptions {
+	/**
+	 * The site's icon, e.g. a logo from `logos.ts`.
+	 */
+	icon?: SvgData | null;
+	/**
+	 * The site's glyph, a single unicode character identifying the project.
+	 */
+	glyph?: string | null;
+	/**
+	 * The site's source repository url, e.g. for `DocsFooter` links.
+	 */
+	repo_url?: Url | null;
+}
+
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export class SiteState {
+	icon: SvgData | null = $state.raw(null);
+	glyph: string | null = $state.raw(null);
+	repo_url: Url | null = $state.raw(null);
+
+	constructor(options: SiteStateOptions = {}) {
+		this.icon = options.icon ?? null;
+		this.glyph = options.glyph ?? null;
+		this.repo_url = options.repo_url ?? null;
+	}
+}
+
+export const site_context = create_context<SiteState>();

package/src/lib/storage.ts

@@ -41,7 +41,7 @@ export const load_from_storage = <T>(
 			return parse_fn(value);
 		}
 
-		return value as unknown as T;
+		return value;
 	} catch (_) {
 		return null;
 	}

package/src/lib/svg.ts

@@ -0,0 +1,23 @@
+import type {SvelteHTMLElements} from 'svelte/elements';
+
+export interface SvgData {
+	/**
+	 * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
+	 * This is an escape hatch for non-`path` markup -
+	 * generally, you should instead use the `paths` property to avoid security/CSP implications.
+	 */
+	raw?: string | null;
+	/**
+	 * List of svg `path` attribute objects. The `d` attribute is required.
+	 */
+	paths?: Array<{d: string} & SvelteHTMLElements['path']> | null;
+	attrs?: SvelteHTMLElements['svg'] | null;
+	fill?: string | null;
+	width?: string | null;
+	height?: string | null;
+	label?: string | null;
+	/**
+	 * Defaults to `"0 0 100 100"`.
+	 */
+	viewBox?: string | null;
+}

package/src/lib/tsdoc_mdz.ts

@@ -43,8 +43,8 @@ const format_reference = (ref: string): string => (mdz_is_url(ref) ? ref : `\`${
  * tsdoc_see_to_mdz('[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library')
  * // → '[svelte-docinfo](https://github.com/ryanatkn/svelte-docinfo) for the analysis library'
  *
- * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
- * // → '`library_gen.ts` for Gro-specific integration'
+ * tsdoc_see_to_mdz('tome.ts for the documentation system')
+ * // → '`tome.ts` for the documentation system'
  * ```
  */
 export const tsdoc_see_to_mdz = (content: string): string => {