@fuzdev/fuz_ui 0.207.0 → 0.209.0

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

@@ -1 +1 @@
-{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"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"}

package/dist/declaration.svelte.js

@@ -20,7 +20,7 @@ const field = (decl, key) => decl[key];
  * Computed properties are plain getters rather than `$derived` — see
  * `Library` for why.
  *
- * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+ * @see {@link https://github.com/fuzdev/svelte-docinfo svelte-docinfo} for the analysis library
  * @see `DeclarationDetail.svelte` for the rendering component
  */
 export class Declaration {
@@ -60,8 +60,9 @@ export class Declaration {
      * Generated TypeScript import statement.
      */
     get import_statement() {
-        // `generateImport` reads only `name`/`kind`/path, none of the defaulted
-        // arrays, so asserting the parsed shape here is sound.
+        // `generateImport` reads only `name`/`kind`/`mergedValue`/path, none of
+        // the defaulted arrays, and treats an absent `mergedValue` as the stripped
+        // `false`, so asserting the parsed shape here is sound.
         return (this.#import_statement ??= generateImport(this.declaration_json, this.module_path, this.library.pkg_json.name));
     }
     /**
@@ -94,6 +95,24 @@ export class Declaration {
     get type_info() {
         return field(this.declaration_json, 'typeInfo');
     }
+    /**
+     * `type_info` prepared for rendering at the declaration itself. A type
+     * alias's tree carries the alias's own name at the root
+     * (`type A = 'a' | 'b'` → `{kind: 'union', alias: 'A', members: [...]}`),
+     * which `typeJsonToTokens` collapses to the bare name — right where `A` is
+     * composed into another type, circular at `A`'s own declaration. Strips
+     * that self-alias so the root expands into its members; every other tree
+     * passes through unchanged.
+     */
+    get type_info_expanded() {
+        const type_info = this.type_info;
+        if (type_info &&
+            (type_info.kind === 'union' || type_info.kind === 'intersection') &&
+            type_info.alias === this.name) {
+            return { ...type_info, alias: undefined };
+        }
+        return type_info;
+    }
     /**
      * Default value documented via `@default`; the authoritative initializer
      * (when human-readable) is in `type_signature`. Present on `variable` kind
@@ -165,6 +184,15 @@ export class Declaration {
     get external_types() {
         return field(this.declaration_json, 'externalTypes');
     }
+    /**
+     * Whether the exported name also carries a value meaning — a merged
+     * value+type symbol like `const Foo = z.strictObject({...})` beside
+     * `type Foo = z.infer<typeof Foo>`, where the type wins the declaration slot.
+     * Present on `type` and `interface` kinds.
+     */
+    get merged_value() {
+        return field(this.declaration_json, 'mergedValue');
+    }
     /**
      * Whether a component accepts children via props or template usage.
      * Present on `component` kind only.
@@ -199,6 +227,14 @@ export class Declaration {
     get mutates() {
         return this.declaration_json.mutates;
     }
+    /**
+     * Internal-API marker from the `@internal` tag. Presence means the tag was
+     * written; an empty string is a bare tag with no trailing prose. A marker,
+     * not an exclusion — the declaration stays documented.
+     */
+    get internal_message() {
+        return this.declaration_json.internalMessage;
+    }
     /**
      * Svelte reactivity flavor (`$state`, `$state.raw`, `$derived`, `$derived.by`)
      * when this variable is initialized with a value-producing rune.
@@ -214,6 +250,10 @@ export class Declaration {
     get is_deprecated() {
         return this.deprecated_message !== undefined;
     }
+    // presence, not truthiness — a bare `@internal` (no message text) arrives as `''`
+    get is_internal() {
+        return this.internal_message !== undefined;
+    }
     get has_documentation() {
         return !!this.doc_comment;
     }

package/dist/logos.d.ts

@@ -55,7 +55,7 @@ export declare const logo_fuz_mastodon: {
         d: string;
     }[];
 };
-export declare const logo_fuz_gitops: {
+export declare const logo_fuz_repos: {
     label: string;
     fill: string;
     paths: {

package/dist/logos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,mBAAmB;;;;;;CAQb,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}
+{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,cAAc;;;;;;CAIR,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,mBAAmB;;;;;;CAQb,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}

package/dist/logos.js

@@ -88,7 +88,7 @@ export const logo_fuz_mastodon = {
     fill: '#8866cc',
     paths: logo_fuz.paths
 };
-export const logo_fuz_gitops = {
+export const logo_fuz_repos = {
     label: 'a friendly blue spider facing you',
     fill: '#6199d1',
     paths: logo_fuz.paths

package/dist/projects.d.ts

@@ -1,9 +1,6 @@
 import type { SvgData } from './svg.js';
 /**
  * Metadata for a project in the fuz.dev ecosystem, rendered by `ProjectLinks`.
- *
- * `name` doubles as the project's repo directory name, so the
- * `project_stats_update` task can locate each repo as a sibling directory.
  */
 export interface ProjectItem {
     name: string;

package/dist/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAkBxC;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,WAAW,CAa5C,CAAC"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAkBxC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,WAAW,CAa5C,CAAC"}

package/dist/projects.js

@@ -1,8 +1,8 @@
 import { 
 // TODO when fuz.dev is ready
 // logo_fuz,
-logo_fuz_ui, logo_fuz_code, logo_fuz_blog, logo_fuz_mastodon, logo_fuz_gitops, logo_fuz_template, logo_fuz_css, logo_fuz_util, logo_gro, logo_svelte_docinfo, logo_fuz_app, logo_tsv } from './logos.js';
-// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_gitops to this repo is heavy
+logo_fuz_ui, logo_fuz_code, logo_fuz_blog, logo_fuz_mastodon, logo_fuz_repos, logo_fuz_template, logo_fuz_css, logo_fuz_util, logo_gro, logo_svelte_docinfo, logo_fuz_app, logo_tsv } from './logos.js';
+// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_repos to this repo is heavy
 // prettier-ignore
 export const project_items = [
     { name: 'fuz_app', url: 'https://app.fuz.dev/', logo: logo_fuz_app, description: '[pre-alpha] fullstack app library', glyph: '🗝', color_class: 'color_j_50' },
@@ -12,7 +12,7 @@ export const project_items = [
     { name: 'fuz_blog', url: 'https://blog.fuz.dev/', logo: logo_fuz_blog, description: 'blog software from scratch with SvelteKit', glyph: '🖊️', color_class: 'color_e_50' },
     { name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, Markdown, and more', glyph: '🎨', color_class: 'color_g_50' },
     { name: 'fuz_mastodon', url: 'https://mastodon.fuz.dev/', logo: logo_fuz_mastodon, description: 'Mastodon components and helpers for Svelte, SvelteKit, and Fuz', glyph: '🦣', color_class: 'color_d_50' },
-    { name: 'fuz_gitops', url: 'https://gitops.fuz.dev/', logo: logo_fuz_gitops, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50' },
+    { name: 'fuz_repos', url: 'https://repos.fuz.dev/', logo: logo_fuz_repos, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50' },
     { name: 'svelte-docinfo', url: 'https://svelte-docinfo.fuz.dev/', logo: logo_svelte_docinfo, description: 'static analysis for TypeScript and Svelte', glyph: '📜', color_class: 'color_i_50' },
     { name: 'fuz_util', url: 'https://util.fuz.dev/', logo: logo_fuz_util, description: 'utility belt for JS', glyph: '🦕', color_class: 'color_f_50' },
     { name: 'gro', url: 'https://github.com/fuzdev/gro', logo: logo_gro, description: 'task runner and toolkit extending SvelteKit', glyph: '🌰', color_class: 'color_f_50' },

package/dist/sparkline.d.ts

@@ -1,5 +1,5 @@
 /**
- * Pure geometry helpers behind `Sparkline` and `ProjectActivityChart`.
+ * Pure geometry helpers behind `Sparkline`.
  *
  * Computes polyline points, alpha-fade gradient stops, and the end-dot
  * position for a series of values, so components stay thin and the math is

package/dist/sparkline.js

@@ -1,5 +1,5 @@
 /**
- * Pure geometry helpers behind `Sparkline` and `ProjectActivityChart`.
+ * Pure geometry helpers behind `Sparkline`.
  *
  * Computes polyline points, alpha-fade gradient stops, and the end-dot
  * position for a series of values, so components stay thin and the math is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.207.0",
+  "version": "0.209.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -62,11 +62,11 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/blake3_wasm": "^0.1.1",
+    "@fuzdev/blake3-wasm": "^0.2.0",
     "@fuzdev/fuz_code": "^0.48.0",
-    "@fuzdev/fuz_css": "^0.63.2",
-    "@fuzdev/fuz_util": "^0.65.2",
-    "@fuzdev/gro": "^0.209.0",
+    "@fuzdev/fuz_css": "^0.64.0",
+    "@fuzdev/fuz_util": "^0.69.0",
+    "@fuzdev/gro": "^0.212.0",
     "@fuzdev/mdz": "^0.3.0",
     "@ryanatkn/eslint-config": "^0.12.2",
     "@sveltejs/adapter-static": "^3.0.10",
@@ -81,12 +81,12 @@
     "jsdom": "^29.1.1",
     "svelte": "^5.56.4",
     "svelte-check": "^4.7.2",
-    "svelte-docinfo": "^0.6.0",
+    "svelte-docinfo": "^0.7.0",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.60.0",
     "vite": "^7.3.6",
-    "vitest": "^4.0.15",
+    "vitest": "^5.0.0",
     "zod": "^4.3.6"
   },
   "sideEffects": [

package/src/lib/api_search.svelte.ts

@@ -2,94 +2,57 @@ import type { Declaration } from './declaration.svelte.ts';
 import type { Library } from './library.svelte.ts';
 import type { Module } from './module.svelte.ts';
 
-export interface DeclarationSearchState {
-	query: string;
-	all: Array<Declaration>;
-	filtered: Array<Declaration>;
-}
-
-export interface ApiSearchState {
-	query: string;
-	modules: {
-		all: Array<Module>;
-		filtered: Array<Module>;
-	};
-	declarations: {
-		all: Array<Declaration>;
-		filtered: Array<Declaration>;
-	};
-}
-
 /**
- * Creates unified search state for the API index page (modules and declarations).
+ * Unified search state for the API index page (modules and declarations).
  */
-export const create_api_search = (library: Library): ApiSearchState => {
-	let query = $state.raw('');
+export class ApiSearchState {
+	readonly library: Library;
+
+	query: string = $state('');
 
-	// Module filtering
-	const all_modules = $derived(library.modules_sorted);
-	const filtered_modules = $derived.by(() => {
-		if (!query.trim()) return all_modules;
-		const terms = query.trim().toLowerCase().split(/\s+/);
-		return all_modules.filter((m) => {
+	readonly modules: Array<Module> = $derived.by(() => this.library.modules_sorted);
+
+	readonly modules_filtered: Array<Module> = $derived.by(() => {
+		if (!this.query.trim()) return this.modules;
+		const terms = this.query.trim().toLowerCase().split(/\s+/);
+		return this.modules.filter((m) => {
 			const path_lower = m.path.toLowerCase();
 			const comment_lower = m.module_comment?.toLowerCase() ?? '';
 			return terms.every((term) => path_lower.includes(term) || comment_lower.includes(term));
 		});
 	});
 
-	// Declaration filtering
-	const all_declarations = $derived(library.declarations);
-	const filtered_declarations = $derived.by(() => {
-		const items = query.trim() ? library.search_declarations(query) : all_declarations;
+	readonly declarations: Array<Declaration> = $derived.by(() => this.library.declarations);
+
+	readonly declarations_filtered: Array<Declaration> = $derived.by(() => {
+		const items = this.query.trim()
+			? this.library.search_declarations(this.query)
+			: this.declarations;
 		// spread before sort — `items` may be the shared source array
 		return [...items].sort((a, b) => a.name.localeCompare(b.name));
 	});
 
-	return {
-		get query() {
-			return query;
-		},
-		set query(v: string) {
-			query = v;
-		},
-		modules: {
-			get all() {
-				return all_modules;
-			},
-			get filtered() {
-				return filtered_modules;
-			}
-		},
-		declarations: {
-			get all() {
-				return all_declarations;
-			},
-			get filtered() {
-				return filtered_declarations;
-			}
-		}
-	};
-};
+	constructor(library: Library) {
+		this.library = library;
+	}
+}
 
 /**
- * Creates search state for module-specific declaration lists.
+ * Search state for a module-specific declaration list.
  */
-export const create_module_declaration_search = (
-	declarations: Array<Declaration>
-): DeclarationSearchState => {
-	let query = $state.raw('');
+export class DeclarationSearchState {
+	readonly declarations: Array<Declaration>;
 
-	const all = $derived(declarations);
+	query: string = $state('');
 
-	const filtered = $derived.by(() => {
-		const trimmed_query = query.trim();
-		// spread before sort — `all` is the shared source array
-		if (!trimmed_query) return [...all].sort((a, b) => a.name.localeCompare(b.name));
+	readonly filtered: Array<Declaration> = $derived.by(() => {
+		const trimmed_query = this.query.trim();
+		// spread before sort — `declarations` is the shared source array
+		if (!trimmed_query) return [...this.declarations].sort((a, b) => a.name.localeCompare(b.name));
 
 		const terms = trimmed_query.toLowerCase().split(/\s+/);
 
-		const items = all.filter((d) => {
+		const items = this.declarations.filter((d) => {
 			const name_lower = d.name.toLowerCase();
 			const kind_lower = d.kind.toLowerCase();
 			const module_path_lower = d.module_path.toLowerCase();
@@ -103,18 +66,7 @@ export const create_module_declaration_search = (
 		return items.sort((a, b) => a.name.localeCompare(b.name));
 	});
 
-	return {
-		get query() {
-			return query;
-		},
-		set query(v: string) {
-			query = v;
-		},
-		get all() {
-			return all;
-		},
-		get filtered() {
-			return filtered;
-		}
-	};
-};
+	constructor(declarations: Array<Declaration>) {
+		this.declarations = declarations;
+	}
+}

package/src/lib/csp.ts

@@ -254,7 +254,33 @@ const for_each_directive = <V>(
 	}
 };
 
-export const COLOR_SCHEME_SCRIPT_HASH = 'sha256-QOxqn7EUzb3ydF9SALJoJGWSvywW9R0AfTDSenB83Z8=';
+/**
+ * The exact body of the color-scheme loader `<script>` in `app.html`, the inline script
+ * `COLOR_SCHEME_SCRIPT_HASH` admits.
+ *
+ * The loader has to run before first paint to avoid a flash of the wrong scheme, so it is inline
+ * rather than a render-blocking `src`, and CSP admits it by hash. That makes its bytes
+ * load-bearing: whitespace, quoting, and trailing commas all move the hash, so a formatter that
+ * reflows `app.html` breaks the theme on every cold load with nothing but a console violation to
+ * show for it. Consumers can guard their own `app.html` against this constant.
+ */
+export const COLOR_SCHEME_SCRIPT = `
+			document.documentElement.classList.add(
+				((c) =>
+					c === 'dark' || (c !== 'light' && matchMedia('(prefers-color-scheme:dark)').matches)
+						? 'dark'
+						: 'light')(localStorage.getItem('fuz:color-scheme'))
+			);
+		`;
+
+/**
+ * The `sha256-` CSP source for `COLOR_SCHEME_SCRIPT`, carried by the `script-src` and
+ * `script-src-elem` defaults so the loader runs under the library CSP.
+ *
+ * Regenerate after any edit to `COLOR_SCHEME_SCRIPT` — `src/test/csp.color_scheme.test.ts`
+ * reports the expected value when the two disagree.
+ */
+export const COLOR_SCHEME_SCRIPT_HASH = 'sha256-CkhymyixntvSTuePGizI3BFtnRFlWWg95YBmBOCFxfY=';
 
 /**
  * The library CSP directive defaults — directives enabled out of the box.

package/src/lib/declaration.svelte.ts

@@ -35,7 +35,7 @@ const field = <T>(decl: DeclarationJsonInput, key: string): T | undefined =>
  * Computed properties are plain getters rather than `$derived` — see
  * `Library` for why.
  *
- * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+ * @see {@link https://github.com/fuzdev/svelte-docinfo svelte-docinfo} for the analysis library
  * @see `DeclarationDetail.svelte` for the rendering component
  */
 export class Declaration {
@@ -87,8 +87,9 @@ export class Declaration {
 	 * Generated TypeScript import statement.
 	 */
 	get import_statement(): string {
-		// `generateImport` reads only `name`/`kind`/path, none of the defaulted
-		// arrays, so asserting the parsed shape here is sound.
+		// `generateImport` reads only `name`/`kind`/`mergedValue`/path, none of
+		// the defaulted arrays, and treats an absent `mergedValue` as the stripped
+		// `false`, so asserting the parsed shape here is sound.
 		return (this.#import_statement ??= generateImport(
 			this.declaration_json as DeclarationJson,
 			this.module_path,
@@ -131,6 +132,27 @@ export class Declaration {
 		return field<TypeJson>(this.declaration_json, 'typeInfo');
 	}
 
+	/**
+	 * `type_info` prepared for rendering at the declaration itself. A type
+	 * alias's tree carries the alias's own name at the root
+	 * (`type A = 'a' | 'b'` → `{kind: 'union', alias: 'A', members: [...]}`),
+	 * which `typeJsonToTokens` collapses to the bare name — right where `A` is
+	 * composed into another type, circular at `A`'s own declaration. Strips
+	 * that self-alias so the root expands into its members; every other tree
+	 * passes through unchanged.
+	 */
+	get type_info_expanded(): TypeJson | undefined {
+		const type_info = this.type_info;
+		if (
+			type_info &&
+			(type_info.kind === 'union' || type_info.kind === 'intersection') &&
+			type_info.alias === this.name
+		) {
+			return { ...type_info, alias: undefined };
+		}
+		return type_info;
+	}
+
 	/**
 	 * Default value documented via `@default`; the authoritative initializer
 	 * (when human-readable) is in `type_signature`. Present on `variable` kind
@@ -219,6 +241,16 @@ export class Declaration {
 		return field<Array<string>>(this.declaration_json, 'externalTypes');
 	}
 
+	/**
+	 * Whether the exported name also carries a value meaning — a merged
+	 * value+type symbol like `const Foo = z.strictObject({...})` beside
+	 * `type Foo = z.infer<typeof Foo>`, where the type wins the declaration slot.
+	 * Present on `type` and `interface` kinds.
+	 */
+	get merged_value(): boolean | undefined {
+		return field<boolean>(this.declaration_json, 'mergedValue');
+	}
+
 	/**
 	 * Whether a component accepts children via props or template usage.
 	 * Present on `component` kind only.
@@ -258,6 +290,15 @@ export class Declaration {
 		return this.declaration_json.mutates;
 	}
 
+	/**
+	 * Internal-API marker from the `@internal` tag. Presence means the tag was
+	 * written; an empty string is a bare tag with no trailing prose. A marker,
+	 * not an exclusion — the declaration stays documented.
+	 */
+	get internal_message(): string | undefined {
+		return this.declaration_json.internalMessage;
+	}
+
 	/**
 	 * Svelte reactivity flavor (`$state`, `$state.raw`, `$derived`, `$derived.by`)
 	 * when this variable is initialized with a value-producing rune.
@@ -276,6 +317,11 @@ export class Declaration {
 		return this.deprecated_message !== undefined;
 	}
 
+	// presence, not truthiness — a bare `@internal` (no message text) arrives as `''`
+	get is_internal(): boolean {
+		return this.internal_message !== undefined;
+	}
+
 	get has_documentation(): boolean {
 		return !!this.doc_comment;
 	}

package/src/lib/logos.ts

@@ -100,7 +100,7 @@ export const logo_fuz_mastodon = {
 	paths: logo_fuz.paths
 } satisfies SvgData;
 
-export const logo_fuz_gitops = {
+export const logo_fuz_repos = {
 	label: 'a friendly blue spider facing you',
 	fill: '#6199d1',
 	paths: logo_fuz.paths

package/src/lib/projects.ts

@@ -6,7 +6,7 @@ import {
 	logo_fuz_code,
 	logo_fuz_blog,
 	logo_fuz_mastodon,
-	logo_fuz_gitops,
+	logo_fuz_repos,
 	logo_fuz_template,
 	logo_fuz_css,
 	logo_fuz_util,
@@ -18,9 +18,6 @@ import {
 
 /**
  * Metadata for a project in the fuz.dev ecosystem, rendered by `ProjectLinks`.
- *
- * `name` doubles as the project's repo directory name, so the
- * `project_stats_update` task can locate each repo as a sibling directory.
  */
 export interface ProjectItem {
 	name: string;
@@ -31,7 +28,7 @@ export interface ProjectItem {
 	color_class: string;
 }
 
-// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_gitops to this repo is heavy
+// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_repos to this repo is heavy
 // prettier-ignore
 export const project_items: Array<ProjectItem> = [
 	{name: 'fuz_app', url: 'https://app.fuz.dev/', logo: logo_fuz_app, description: '[pre-alpha] fullstack app library', glyph: '🗝', color_class: 'color_j_50'},
@@ -41,7 +38,7 @@ export const project_items: Array<ProjectItem> = [
 	{name: 'fuz_blog', url: 'https://blog.fuz.dev/', logo: logo_fuz_blog, description: 'blog software from scratch with SvelteKit', glyph: '🖊️', color_class: 'color_e_50'},
 	{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, Markdown, and more', glyph: '🎨', color_class: 'color_g_50'},
 	{name: 'fuz_mastodon', url: 'https://mastodon.fuz.dev/', logo: logo_fuz_mastodon, description: 'Mastodon components and helpers for Svelte, SvelteKit, and Fuz', glyph: '🦣', color_class: 'color_d_50'},
-	{name: 'fuz_gitops', url: 'https://gitops.fuz.dev/', logo: logo_fuz_gitops, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50'},
+	{name: 'fuz_repos', url: 'https://repos.fuz.dev/', logo: logo_fuz_repos, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50'},
 	{name: 'svelte-docinfo', url: 'https://svelte-docinfo.fuz.dev/', logo: logo_svelte_docinfo, description: 'static analysis for TypeScript and Svelte', glyph: '📜', color_class: 'color_i_50'},
 	{name: 'fuz_util', url: 'https://util.fuz.dev/', logo: logo_fuz_util, description: 'utility belt for JS', glyph: '🦕', color_class: 'color_f_50'},
 	{name: 'gro', url: 'https://github.com/fuzdev/gro', logo: logo_gro, description: 'task runner and toolkit extending SvelteKit', glyph: '🌰', color_class: 'color_f_50'},

package/src/lib/sparkline.ts

@@ -1,5 +1,5 @@
 /**
- * Pure geometry helpers behind `Sparkline` and `ProjectActivityChart`.
+ * Pure geometry helpers behind `Sparkline`.
  *
  * Computes polyline points, alpha-fade gradient stops, and the end-dot
  * position for a series of values, so components stay thin and the math is