@fuzdev/fuz_ui 0.218.0 → 0.220.0

package/dist/ApiModule.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import Code from '@fuzdev/fuz_code/Code.svelte';
 	import Mdz from '@fuzdev/mdz/Mdz.svelte';
+	import { mdz_from_tsdoc } from '@fuzdev/mdz/tsdoc_mdz.ts';
 	import {
 		mdz_code_context,
 		mdz_codeblock_context,
@@ -8,6 +9,7 @@
 	} from '@fuzdev/mdz/mdz_contexts.ts';
 
 	import { set_library_context_with_fallback, type Library } from './library.svelte.js';
+	import type { Module } from './module.svelte.js';
 	import { tome_get_by_slug, type Tome } from './tome.js';
 	import TomeContent from './TomeContent.svelte';
 	import TomeSection from './TomeSection.svelte';
@@ -70,6 +72,20 @@
 	const source_url = $derived(module?.url_github);
 </script>
 
+<!-- Marker chips from the module comment, shared by the module page and directory listings. -->
+{#snippet doc_chips(m: Module)}
+	{#if m.is_deprecated || m.is_internal}
+		<p class="row gap_md flex-wrap:wrap">
+			{#if m.is_deprecated}
+				<span class="chip">⚠️ deprecated</span>
+			{/if}
+			{#if m.is_internal}
+				<span class="chip">internal</span>
+			{/if}
+		</p>
+	{/if}
+{/snippet}
+
 <svelte:head>
 	<title>{module_name} - API docs - {library.pkg_json.name}</title>
 </svelte:head>
@@ -92,6 +108,7 @@
 					{#each directory_modules as child_module (child_module.path)}
 						<li>
 							<h3><ModuleLink module_path={child_module.path} /></h3>
+							{@render doc_chips(child_module)}
 							{#if child_module.module_comment}
 								<Mdz content={child_module.module_comment} />
 							{/if}
@@ -101,9 +118,33 @@
 			</section>
 		{/if}
 	{:else}
-		{#if module.module_comment}
+		<!-- module comment: mirrors the compact `doc_extras` form in `DeclarationDetail` -->
+		{#if module.has_module_doc}
 			<section>
-				<Mdz content={module.module_comment} />
+				{@render doc_chips(module)}
+				{#if module.deprecated_message}
+					<p>{module.deprecated_message}</p>
+				{/if}
+				{#if module.internal_message}
+					<p>{module.internal_message}</p>
+				{/if}
+				{#if module.module_comment}
+					<Mdz content={module.module_comment} />
+				{/if}
+				{#if module.since}
+					<p><strong>since</strong> {module.since}</p>
+				{/if}
+				{#each module.examples as example (example)}
+					<Mdz content={example} />
+				{/each}
+				{#if module.see_also.length}
+					<p><strong>see also</strong></p>
+					<ul>
+						{#each module.see_also as ref (ref)}
+							<li><Mdz content={mdz_from_tsdoc(ref)} /></li>
+						{/each}
+					</ul>
+				{/if}
 			</section>
 		{/if}
 		{#if source_url}

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

@@ -1 +1 @@
-{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAWA,OAAO,EAAqC,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAWvD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAgMH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAYA,OAAO,EAAqC,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAWvD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAyOH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/Card.svelte

@@ -1,3 +1,10 @@
+<!--
+@component
+
+@cssprop --card_width - width of the card
+@cssprop --border_radius - corner radius of the card
+@cssprop --shadow - box shadow of a linked card in every state, replacing its default inset shadows
+-->
 <script lang="ts">
 	import { page } from '$app/state';
 	import { DEV } from 'esm-env';

package/dist/Card.svelte.d.ts

@@ -25,6 +25,11 @@ HTMLAttributes<HTMLElement> & {
     a_attrs?: SvelteHTMLElements['a'];
     children: Snippet;
 };
+/**
+ * @cssprop --card_width - width of the card
+ * @cssprop --border_radius - corner radius of the card
+ * @cssprop --shadow - box shadow of a linked card in every state, replacing its default inset shadows
+ */
 declare const Card: import("svelte").Component<$$ComponentProps, {}, "">;
 type Card = ReturnType<typeof Card>;
 export default Card;

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

@@ -1 +1 @@
-{"version":3,"file":"Card.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Card.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAIzE,KAAK,gBAAgB,GAEpB,AAFwB,uEAAuE;AAE/F,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,qBAAqB,GAAG,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/B,gFAAgF;IAChF,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AAsEJ,QAAA,MAAM,IAAI,sDAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Card.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Card.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAIzE,KAAK,gBAAgB,GAEpB,AAFwB,uEAAuE;AAE/F,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,qBAAqB,GAAG,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/B,gFAAgF;IAChF,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AAuEJ;;;;GAIG;AACH,QAAA,MAAM,IAAI,sDAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/ContextmenuMenu.svelte

@@ -1,3 +1,19 @@
+<!--
+@component
+
+The menu surface shared by `ContextmenuRoot.svelte` and
+`ContextmenuRootForSafariCompatibility.svelte`. Owns everything that happens while
+the menu is open - positioning, keyboard navigation, dismissal on outside presses,
+popover top-layer promotion, and entry rendering - while the roots own gesture
+detection, i.e. how the menu opens. Holds no gesture state of its own; the
+`open_guard` it consults is owned and armed by the root.
+
+@cssprop --contextmenu_z_index - stacking order of the menu in browsers without the Popover API
+@cssprop --contextmenu_border_width - width of the menu's border
+@cssprop --contextmenu_border_style - style of the menu's border
+@cssprop --contextmenu_border_color - color of the menu's border
+@cssprop --contextmenu_border_radius - corner radius of the menu
+-->
 <script module lang="ts">
 	// The default entry snippets are shared by `ContextmenuRoot.svelte`
 	// and `ContextmenuRootForSafariCompatibility.svelte`.
@@ -5,14 +21,6 @@
 </script>
 
 <script lang="ts">
-	/**
-	 * The menu surface shared by `ContextmenuRoot.svelte` and
-	 * `ContextmenuRootForSafariCompatibility.svelte`. Owns everything that happens
-	 * while the menu is open - positioning, keyboard navigation, dismissal on
-	 * outside presses, popover top-layer promotion, and entry rendering - while
-	 * the roots own gesture detection, i.e. how the menu opens. Holds no gesture
-	 * state of its own; the `open_guard` it consults is owned and armed by the root.
-	 */
 	import { swallow } from '@fuzdev/fuz_util/dom.ts';
 	import type { ComponentProps, Snippet } from 'svelte';
 

package/dist/ContextmenuMenu.svelte.d.ts

@@ -35,6 +35,20 @@ type $$ComponentProps = {
 declare const link_entry_default: (props: ComponentProps<typeof ContextmenuLinkEntry>) => ReturnType<import("svelte").Snippet>;
 declare const text_entry_default: (props: ComponentProps<typeof ContextmenuTextEntry>) => ReturnType<import("svelte").Snippet>;
 declare const separator_entry_default: (props: ComponentProps<typeof ContextmenuSeparator>) => ReturnType<import("svelte").Snippet>;
+/**
+ * The menu surface shared by `ContextmenuRoot.svelte` and
+ * `ContextmenuRootForSafariCompatibility.svelte`. Owns everything that happens while
+ * the menu is open - positioning, keyboard navigation, dismissal on outside presses,
+ * popover top-layer promotion, and entry rendering - while the roots own gesture
+ * detection, i.e. how the menu opens. Holds no gesture state of its own; the
+ * `open_guard` it consults is owned and armed by the root.
+ *
+ * @cssprop --contextmenu_z_index - stacking order of the menu in browsers without the Popover API
+ * @cssprop --contextmenu_border_width - width of the menu's border
+ * @cssprop --contextmenu_border_style - style of the menu's border
+ * @cssprop --contextmenu_border_color - color of the menu's border
+ * @cssprop --contextmenu_border_radius - corner radius of the menu
+ */
 declare const ContextmenuMenu: import("svelte").Component<$$ComponentProps, {}, "el">;
 type ContextmenuMenu = ReturnType<typeof ContextmenuMenu>;
 export default ContextmenuMenu;

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

@@ -1 +1 @@
-{"version":3,"file":"ContextmenuMenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ContextmenuMenu.svelte"],"names":[],"mappings":"AAKC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAY5E,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,EAEL,KAAK,gBAAgB,EACrB,MAAM,+BAA+B,CAAC;AACxC,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAOL,KAAK,oBAAoB,EACzB,MAAM,0BAA0B,CAAC;AAElC,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAC9B;;;OAGG;IACH,UAAU,EAAE,oBAAoB,CAAC;IACjC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/E;;OAEG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CACjB,CAAC;AAAC,QAAA,MAAM,kBAAkB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAElI,CAAC;AAAC,QAAA,MAAM,kBAAkB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAE7J,CAAC;AAAC,QAAA,MAAM,uBAAuB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAElK,CAAC;AAuF9B,QAAA,MAAM,eAAe,wDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ContextmenuMenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ContextmenuMenu.svelte"],"names":[],"mappings":"AAKC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;AAI5E,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,EAEL,KAAK,gBAAgB,EACrB,MAAM,+BAA+B,CAAC;AACxC,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAOL,KAAK,oBAAoB,EACzB,MAAM,0BAA0B,CAAC;AAElC,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAC9B;;;OAGG;IACH,UAAU,EAAE,oBAAoB,CAAC;IACjC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/E;;OAEG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;CACjB,CAAC;AAAC,QAAA,MAAM,kBAAkB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAElI,CAAC;AAAC,QAAA,MAAM,kBAAkB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAE7J,CAAC;AAAC,QAAA,MAAM,uBAAuB,GAAyB,OAAO,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAqB,UAAU,CAAC,OAAO,QAAQ,EAAE,OAAO,CAElK,CAAC;AAuF9B;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,eAAe,wDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/DeclarationDetail.svelte

@@ -4,7 +4,8 @@
 Renders the full detail view for an exported declaration.
 Handles all svelte-docinfo declaration kinds (function, class, interface,
 type, variable, enum, component, snippet) and their kind-specific fields
-including parameters, props, members, overloads, external types, and more.
+including parameters, props, CSS custom properties, members, overloads,
+external types, and more.
 
 @see `declaration.svelte.ts` for the `Declaration` wrapper class
 @see {@link https://github.com/fuzdev/svelte-docinfo svelte-docinfo} for the analysis library
@@ -25,6 +26,7 @@ including parameters, props, members, overloads, external types, and more.
 	import TypeJsonView from './TypeJsonView.svelte';
 	import ModuleLink from './ModuleLink.svelte';
 	import DocsLink from './DocsLink.svelte';
+	import { dedent_css_fallback } from './helpers.js';
 
 	const { declaration }: { declaration: Declaration } = $props();
 
@@ -40,6 +42,14 @@ including parameters, props, members, overloads, external types, and more.
 		return filtered.length ? filtered : undefined;
 	});
 
+	// the "inferred" chip marks entries found by a `var()` fallback, which only
+	// distinguishes anything when the list also has `@cssprop`-documented ones
+	const css_property_chips_shown = $derived.by(() => {
+		const css_properties = declaration.css_custom_properties;
+		if (!css_properties) return false;
+		return css_properties.some((p) => p.documented) && css_properties.some((p) => !p.documented);
+	});
+
 	// render mdz inline `code` as API-linking `DocsLink` and fenced blocks as syntax-highlighted
 	// `Code`, matching the rest of the docs — the injection mdz core leaves open
 	mdz_set_context_with_fallback(mdz_code_context, () => DocsLink);
@@ -318,6 +328,52 @@ including parameters, props, members, overloads, external types, and more.
 	</section>
 {/if}
 
+<!-- CSS custom properties (for Svelte components): the styling API a
+	consumer sets on the component or an ancestor; `documented` entries come
+	from `@cssprop` tags and arrive first, the rest are inferred from `var()`
+	fallbacks in the component's styles, marked only when the list mixes both -->
+{#if declaration.css_custom_properties?.length}
+	<section>
+		<h4>CSS custom properties</h4>
+		{#if css_property_chips_shown}
+			<p>
+				Properties marked <span class="chip">inferred</span> are found by their <code>var()</code>
+				fallback, not documented with <code>@cssprop</code>.
+			</p>
+		{/if}
+		{#each declaration.css_custom_properties as css_property (css_property.name)}
+			<section>
+				<div class="row gap_md">
+					<h5><code>{css_property.name}</code></h5>
+					{#if css_property_chips_shown && !css_property.documented}
+						<span class="chip">inferred</span>
+					{/if}
+				</div>
+				{#if css_property.description}
+					<Mdz content={css_property.description} />
+				{/if}
+				{#if css_property.syntax}
+					<div class="row gap_md mb_sm">
+						<strong>syntax</strong>
+						<code>{css_property.syntax}</code>
+					</div>
+				{/if}
+				{#if css_property.fallback !== undefined}
+					<div class="row gap_md">
+						<strong>fallback</strong>
+						{#if css_property.fallback}
+							<Code lang="css" content={dedent_css_fallback(css_property.fallback)} wrap />
+						{:else}
+							<!-- `var(--a,)`, a fallback of nothing -->
+							<span>empty</span>
+						{/if}
+					</div>
+				{/if}
+			</section>
+		{/each}
+	</section>
+{/if}
+
 <!-- overloads -->
 {#if declaration.overloads?.length}
 	<section>

package/dist/DeclarationDetail.svelte.d.ts

@@ -6,7 +6,8 @@ type $$ComponentProps = {
  * Renders the full detail view for an exported declaration.
  * Handles all svelte-docinfo declaration kinds (function, class, interface,
  * type, variable, enum, component, snippet) and their kind-specific fields
- * including parameters, props, members, overloads, external types, and more.
+ * including parameters, props, CSS custom properties, members, overloads,
+ * external types, and more.
  *
  * @see `declaration.svelte.ts` for the `Declaration` wrapper class
  * @see {@link https://github.com/fuzdev/svelte-docinfo svelte-docinfo} for the analysis library

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

@@ -1 +1 @@
-{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAmB1D,KAAK,gBAAgB,GAAI;IAAE,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC;AA6gBvD;;;;;;;;GAQG;AACH,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAoB1D,KAAK,gBAAgB,GAAI;IAAE,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC;AAikBvD;;;;;;;;;GASG;AACH,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/Dialog.svelte

@@ -1,3 +1,19 @@
+<!--
+@component
+
+Renders a native `<dialog>` opened with `showModal()`, which puts it in the top
+layer. The top layer escapes ancestor stacking/overflow contexts (so no `Teleport`
+is needed), traps focus, makes the rest of the page inert, closes on Escape, and
+restores focus to the previously focused element on close -- all natively. The dim
+background is the native `::backdrop`.
+
+We render a full-viewport overlay inside the dialog rather than a content-sized
+box, to preserve the scrolling and `align="top"` behaviors. The content surface
+itself is the consumer's -- pair this with `DialogContent` for the default `.pane`
+card and gutter, or render your own surface in `children`.
+
+@cssprop --backdrop_color - color of the overlay behind the dialog's content, fuz_css's global token by default
+-->
 <script lang="ts">
 	import type { Snippet } from 'svelte';
 	import type { SvelteHTMLElements } from 'svelte/elements';
@@ -6,21 +22,6 @@
 
 	import { dialog_context, type DialogContext, type DialogAlign } from './dialog.js';
 
-	/**
-	 * This component renders a native `<dialog>` opened with `showModal()`, which
-	 * puts it in the top layer. The top layer escapes ancestor stacking/overflow
-	 * contexts (so no `Teleport` is needed), traps focus, makes the rest of the page
-	 * inert, closes on Escape, and restores focus to the previously focused element
-	 * on close -- all natively. The dim background is the native `::backdrop`.
-	 *
-	 * We render a full-viewport overlay inside the dialog rather than a content-sized
-	 * box, to preserve the scrolling and `align="top"` behaviors. The content
-	 * surface itself is the consumer's -- pair this with `DialogContent` for the
-	 * default `.pane` card and gutter, or render your own surface in `children`.
-	 *
-	 * @module
-	 */
-
 	const {
 		show = true,
 		align = 'center',

package/dist/Dialog.svelte.d.ts

@@ -55,6 +55,20 @@ type $$ComponentProps = Omit<SvelteHTMLElements['dialog'], 'children' | 'onclose
      */
     children: Snippet<[dialog: DialogContext]>;
 };
+/**
+ * Renders a native `<dialog>` opened with `showModal()`, which puts it in the top
+ * layer. The top layer escapes ancestor stacking/overflow contexts (so no `Teleport`
+ * is needed), traps focus, makes the rest of the page inert, closes on Escape, and
+ * restores focus to the previously focused element on close -- all natively. The dim
+ * background is the native `::backdrop`.
+ *
+ * We render a full-viewport overlay inside the dialog rather than a content-sized
+ * box, to preserve the scrolling and `align="top"` behaviors. The content surface
+ * itself is the consumer's -- pair this with `DialogContent` for the default `.pane`
+ * card and gutter, or render your own surface in `children`.
+ *
+ * @cssprop --backdrop_color - color of the overlay behind the dialog's content, fuz_css's global token by default
+ */
 declare const Dialog: import("svelte").Component<$$ComponentProps, {}, "">;
 type Dialog = ReturnType<typeof Dialog>;
 export default Dialog;

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

@@ -1 +1 @@
-{"version":3,"file":"Dialog.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Dialog.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAElF,KAAK,gBAAgB,GAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG;IACrF;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3C,CAAC;AAsHH,QAAA,MAAM,MAAM,sDAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Dialog.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Dialog.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAElF,KAAK,gBAAgB,GAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG;IACrF;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3C,CAAC;AAwGH;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,MAAM,sDAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/LibraryDetail.svelte

@@ -6,6 +6,7 @@ with file-type coloring. Uses svelte-docinfo's file type predicates for module c
 
 @see `library.svelte.ts` for the `Library` wrapper class
 @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+@cssprop --max_width - maximum width of the detail
 -->
 <script lang="ts">
 	import { page } from '$app/state';

package/dist/LibraryDetail.svelte.d.ts

@@ -23,6 +23,7 @@ type $$ComponentProps = OmitStrict<SvelteHTMLElements['div'], 'children'> & {
  *
  * @see `library.svelte.ts` for the `Library` wrapper class
  * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+ * @cssprop --max_width - maximum width of the detail
  */
 declare const LibraryDetail: import("svelte").Component<$$ComponentProps, {}, "">;
 type LibraryDetail = ReturnType<typeof LibraryDetail>;

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

@@ -1 +1 @@
-{"version":3,"file":"LibraryDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibraryDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAOnE,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC,CAAC;AAgLH;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"LibraryDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibraryDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAOnE,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC,CAAC;AAgLH;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/LibrarySummary.svelte

@@ -1,3 +1,8 @@
+<!--
+@component
+
+@cssprop --max_width - maximum width of the summary
+-->
 <script lang="ts">
 	import { page } from '$app/state';
 	import type { Snippet } from 'svelte';

package/dist/LibrarySummary.svelte.d.ts

@@ -11,6 +11,7 @@ type $$ComponentProps = SvelteHTMLElements['div'] & {
     homepage_url?: Snippet<[homepage_url: string]>;
     children?: Snippet;
 };
+/** @cssprop --max_width - maximum width of the summary */
 declare const LibrarySummary: import("svelte").Component<$$ComponentProps, {}, "">;
 type LibrarySummary = ReturnType<typeof LibrarySummary>;
 export default LibrarySummary;

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

@@ -1 +1 @@
-{"version":3,"file":"LibrarySummary.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibrarySummary.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGlD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA+GH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"LibrarySummary.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibrarySummary.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGlD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAgHH,0DAA0D;AAC1D,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/PendingAnimation.svelte

@@ -1,3 +1,12 @@
+<!--
+@component
+
+@cssprop --font_size - size of the dots, inherited by default
+@cssprop --scale_x - horizontal scale of a dot at rest, growing to 1 mid-cycle
+@cssprop --scale_y - vertical scale of a dot at rest, growing to 1 mid-cycle
+@cssprop --scale_z - depth scale of a dot at rest, growing to 1 mid-cycle
+@cssprop --animation_duration - length of one animation cycle
+-->
 <script lang="ts">
 	import type { OmitStrict } from '@fuzdev/fuz_util/types.ts';
 	import type { Snippet } from 'svelte';

package/dist/PendingAnimation.svelte.d.ts

@@ -7,6 +7,13 @@ type $$ComponentProps = OmitStrict<SvelteHTMLElements['span'], 'children'> & {
     item_attrs?: SvelteHTMLElements['span'];
     children?: Snippet<[index: number]>;
 };
+/**
+ * @cssprop --font_size - size of the dots, inherited by default
+ * @cssprop --scale_x - horizontal scale of a dot at rest, growing to 1 mid-cycle
+ * @cssprop --scale_y - vertical scale of a dot at rest, growing to 1 mid-cycle
+ * @cssprop --scale_z - depth scale of a dot at rest, growing to 1 mid-cycle
+ * @cssprop --animation_duration - length of one animation cycle
+ */
 declare const PendingAnimation: import("svelte").Component<$$ComponentProps, {}, "">;
 type PendingAnimation = ReturnType<typeof PendingAnimation>;
 export default PendingAnimation;

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

@@ -1 +1 @@
-{"version":3,"file":"PendingAnimation.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/PendingAnimation.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC,CAAC;AAoCH,QAAA,MAAM,gBAAgB,sDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"PendingAnimation.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/PendingAnimation.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC,CAAC;AAqCH;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,sDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/Sparkline.svelte

@@ -1,30 +1,26 @@
+<!--
+@component
+
+Renders values as a small inline SVG line graph.
+
+Designed for comparable small multiples: pass a shared `max` so a set of
+sparklines renders at the same vertical scale instead of each stretching to fit.
+The stroke uses `currentColor`, so color it by setting `color` on the component or
+a parent (e.g. a fuz_css `color_*` class). Each point's stroke alpha scales with
+its value, from `alpha_floor` at 0 up to 1 at `max`, de-emphasizing quiet stretches.
+
+`scale` controls only the geometry: the nonlinear options compress the top of the
+range so small values stay legible under a large shared `max`, while the alpha
+fade keeps tracking the linear ratio so it still encodes true magnitude.
+
+@cssprop --sparkline_bg - background behind the line, a light wash of `currentColor` by default
+-->
 <script lang="ts">
 	import type { OmitStrict } from '@fuzdev/fuz_util/types.ts';
 	import type { SvelteHTMLElements } from 'svelte/elements';
 
 	import { sparkline_geometry, type SparklineScale } from './sparkline.js';
 
-	/**
-	 * Renders values as a small inline SVG line graph.
-	 *
-	 * Designed for comparable small multiples: pass a shared `max` so a set of
-	 * sparklines renders at the same vertical scale instead of each stretching
-	 * to fit. The stroke uses `currentColor`, so color it by setting `color` on
-	 * the component or a parent (e.g. a fuz_css `color_*` class). Each point's
-	 * stroke alpha scales with its value, from `alpha_floor` at 0 up to 1 at
-	 * `max`, de-emphasizing quiet stretches.
-	 *
-	 * `scale` controls only the geometry: the nonlinear options compress the
-	 * top of the range so small values stay legible under a large shared
-	 * `max`, while the alpha fade keeps tracking the linear ratio so it still
-	 * encodes true magnitude.
-	 *
-	 * The background is a light wash of `currentColor`, overridable with the
-	 * `--sparkline_bg` custom property.
-	 *
-	 * @module
-	 */
-
 	const {
 		values,
 		max,

package/dist/Sparkline.svelte.d.ts

@@ -36,6 +36,21 @@ type $$ComponentProps = OmitStrict<SvelteHTMLElements['svg'], 'values' | 'width'
      */
     label?: string;
 };
+/**
+ * Renders values as a small inline SVG line graph.
+ *
+ * Designed for comparable small multiples: pass a shared `max` so a set of
+ * sparklines renders at the same vertical scale instead of each stretching to fit.
+ * The stroke uses `currentColor`, so color it by setting `color` on the component or
+ * a parent (e.g. a fuz_css `color_*` class). Each point's stroke alpha scales with
+ * its value, from `alpha_floor` at 0 up to 1 at `max`, de-emphasizing quiet stretches.
+ *
+ * `scale` controls only the geometry: the nonlinear options compress the top of the
+ * range so small values stay legible under a large shared `max`, while the alpha
+ * fade keeps tracking the linear ratio so it still encodes true magnitude.
+ *
+ * @cssprop --sparkline_bg - background behind the line, a light wash of `currentColor` by default
+ */
 declare const Sparkline: import("svelte").Component<$$ComponentProps, {}, "">;
 type Sparkline = ReturnType<typeof Sparkline>;
 export default Sparkline;

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

@@ -1 +1 @@
-{"version":3,"file":"Sparkline.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Sparkline.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG;IACzG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAoEH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Sparkline.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Sparkline.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG;IACzG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAgDH;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/declaration.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { DeclarationJsonInput, MemberJsonInput, ParameterJsonInput, ComponentPropJsonInput, OverloadJsonInput, Reactivity, TypeJson } from 'svelte-docinfo/types.js';
+import type { DeclarationJsonInput, MemberJsonInput, ParameterJsonInput, ComponentPropJsonInput, ComponentCssPropertyJsonInput, OverloadJsonInput, Reactivity, TypeJson } from 'svelte-docinfo/types.js';
 import type { Module } from './module.svelte.js';
 /**
  * Rich runtime representation of an exported declaration.
@@ -104,6 +104,13 @@ export declare class Declaration {
      * Present on `type` and `interface` kinds.
      */
     get merged_value(): boolean | undefined;
+    /**
+     * The component's styling API: CSS custom properties its styles read with
+     * a `var()` fallback, plus any its doc comment documents with `@cssprop`
+     * tags (`documented`), the documented ones first.
+     * Present on `component` kind only.
+     */
+    get css_custom_properties(): Array<ComponentCssPropertyJsonInput> | undefined;
     /**
      * Whether a component accepts children via props or template usage.
      * Present on `component` kind only.

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

@@ -193,6 +193,15 @@ export class Declaration {
     get merged_value() {
         return field(this.declaration_json, 'mergedValue');
     }
+    /**
+     * The component's styling API: CSS custom properties its styles read with
+     * a `var()` fallback, plus any its doc comment documents with `@cssprop`
+     * tags (`documented`), the documented ones first.
+     * Present on `component` kind only.
+     */
+    get css_custom_properties() {
+        return field(this.declaration_json, 'cssCustomProperties');
+    }
     /**
      * Whether a component accepts children via props or template usage.
      * Present on `component` kind only.

package/dist/helpers.d.ts

@@ -1,2 +1,12 @@
 export declare const render_value_to_string: (value: unknown) => string;
+/**
+ * Strips the whitespace prefix that a CSS custom property's multi-line
+ * `fallback` shares across its continuation lines, so a value broken over
+ * several stylesheet lines renders without the stylesheet's indentation.
+ * Line endings normalize to `\n`, and whitespace-only lines become empty.
+ *
+ * @param fallback - the verbatim fallback source text
+ * @returns the fallback with its continuation lines dedented
+ */
+export declare const dedent_css_fallback: (fallback: string) => string;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/helpers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,MASvD,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/helpers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,MASvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,MAoBtD,CAAC"}

package/dist/helpers.js

@@ -14,3 +14,37 @@ export const render_value_to_string = (value) => {
         return JSON.stringify(value);
     return value + ''; // eslint-disable-line @typescript-eslint/no-base-to-string
 };
+/**
+ * Strips the whitespace prefix that a CSS custom property's multi-line
+ * `fallback` shares across its continuation lines, so a value broken over
+ * several stylesheet lines renders without the stylesheet's indentation.
+ * Line endings normalize to `\n`, and whitespace-only lines become empty.
+ *
+ * @param fallback - the verbatim fallback source text
+ * @returns the fallback with its continuation lines dedented
+ */
+export const dedent_css_fallback = (fallback) => {
+    const lines = fallback.split(/\r?\n/);
+    if (lines.length === 1)
+        return fallback;
+    // svelte-docinfo trims the fallback, so the first line's original column is
+    // lost — it stays as-is, and only the continuation lines are compared
+    let prefix;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        const leading = /^[ \t]*/.exec(line)[0];
+        if (prefix === undefined) {
+            prefix = leading;
+        }
+        else {
+            let j = 0;
+            while (j < prefix.length && j < leading.length && prefix[j] === leading[j])
+                j++;
+            prefix = prefix.slice(0, j);
+        }
+    }
+    const width = prefix?.length ?? 0;
+    return lines.map((line, i) => (i === 0 ? line : line.trim() ? line.slice(width) : '')).join('\n');
+};

package/dist/module.svelte.d.ts

@@ -33,7 +33,22 @@ export declare class Module {
      * Import-style path with ./ prefix.
      */
     get path_import(): string;
+    /**
+     * Prose of the `@module` comment, tag lines removed. Absent for a tag-only
+     * comment, whose tags still populate the doc fields below.
+     */
     get module_comment(): string | undefined;
+    get deprecated_message(): string | undefined;
+    /**
+     * Internal-API marker from the module comment's `@internal` tag. Presence
+     * means the tag was written; an empty string is a bare tag.
+     */
+    get internal_message(): string | undefined;
+    get since(): string | undefined;
+    get examples(): NonNullable<ModuleJsonInput['examples']>;
+    get see_also(): NonNullable<ModuleJsonInput['seeAlso']>;
+    get is_deprecated(): boolean;
+    get is_internal(): boolean;
     /**
      * Array of `Declaration` instances. Filters out default exports.
      */
@@ -58,7 +73,12 @@ export declare class Module {
      * filter in `declarations`).
      */
     get has_declarations(): boolean;
-    get has_module_comment(): boolean;
+    /**
+     * Whether the module comment documents anything — prose or any doc field.
+     * A tag-only comment (just `@see`, say) has no `module_comment` but still
+     * counts.
+     */
+    get has_module_doc(): boolean;
     /**
      * Modules this imports (paths relative to src/lib).
      */

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,EACX,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAwBnD;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAID;;OAEG;IACH,IAAI,YAAY,IAAI,KAAK,CAAC,WAAW,CAAC,CAIrC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAGrC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAE/D;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAE3D;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAE1D;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAE9D;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAID;;;OAGG;IACH,IAAI,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAEhE;IAED;;;;OAIG;IACH,IAAI,mBAAmB,IAAI,WAAW,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAE3E;IAED,IAAI,uBAAuB,IAAI,OAAO,CAErC;IAID;;;;OAIG;IACH,IAAI,gCAAgC,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAKpF;IAED;;;;OAIG;IACH,IAAI,qBAAqB,IAAI,WAAW,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAE/E;IAED,IAAI,yBAAyB,IAAI,OAAO,CAEvC;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAOhC;gBAEW,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,EACX,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAwBnD;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,QAAQ,IAAI,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAEvD;IAED,IAAI,QAAQ,IAAI,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAEtD;IAGD,IAAI,aAAa,IAAI,OAAO,CAE3B;IAGD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID;;OAEG;IACH,IAAI,YAAY,IAAI,KAAK,CAAC,WAAW,CAAC,CAIrC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAGrC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;;;OAIG;IACH,IAAI,cAAc,IAAI,OAAO,CAS5B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAE/D;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAE3D;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAE1D;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAE9D;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAID;;;OAGG;IACH,IAAI,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAEhE;IAED;;;;OAIG;IACH,IAAI,mBAAmB,IAAI,WAAW,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAE3E;IAED,IAAI,uBAAuB,IAAI,OAAO,CAErC;IAID;;;;OAIG;IACH,IAAI,gCAAgC,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAKpF;IAED;;;;OAIG;IACH,IAAI,qBAAqB,IAAI,WAAW,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAE/E;IAED,IAAI,yBAAyB,IAAI,OAAO,CAEvC;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAOhC;gBAEW,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

@@ -57,9 +57,40 @@ export class Module {
     get path_import() {
         return './' + this.path;
     }
+    /**
+     * Prose of the `@module` comment, tag lines removed. Absent for a tag-only
+     * comment, whose tags still populate the doc fields below.
+     */
     get module_comment() {
         return this.module_json.moduleComment;
     }
+    get deprecated_message() {
+        return this.module_json.deprecatedMessage;
+    }
+    /**
+     * Internal-API marker from the module comment's `@internal` tag. Presence
+     * means the tag was written; an empty string is a bare tag.
+     */
+    get internal_message() {
+        return this.module_json.internalMessage;
+    }
+    get since() {
+        return this.module_json.since;
+    }
+    get examples() {
+        return this.module_json.examples ?? EMPTY_ARRAY;
+    }
+    get see_also() {
+        return this.module_json.seeAlso ?? EMPTY_ARRAY;
+    }
+    // presence, not truthiness — a bare `@deprecated` (no message text) arrives as `''`
+    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;
+    }
     #declarations;
     /**
      * Array of `Declaration` instances. Filters out default exports.
@@ -99,8 +130,18 @@ export class Module {
     get has_declarations() {
         return this.declarations.length > 0;
     }
-    get has_module_comment() {
-        return !!this.module_comment;
+    /**
+     * Whether the module comment documents anything — prose or any doc field.
+     * A tag-only comment (just `@see`, say) has no `module_comment` but still
+     * counts.
+     */
+    get has_module_doc() {
+        return (!!this.module_comment ||
+            this.is_deprecated ||
+            this.is_internal ||
+            !!this.since ||
+            this.examples.length > 0 ||
+            this.see_also.length > 0);
     }
     /**
      * Modules this imports (paths relative to src/lib).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.218.0",
+  "version": "0.220.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -64,7 +64,7 @@
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/blake3-wasm": "^0.2.0",
     "@fuzdev/fuz_code": "^0.54.0",
-    "@fuzdev/fuz_css": "^0.70.0",
+    "@fuzdev/fuz_css": "^0.71.0",
     "@fuzdev/fuz_schema": "^0.5.0",
     "@fuzdev/fuz_util": "^0.77.0",
     "@fuzdev/gro": "^0.220.0",
@@ -82,7 +82,7 @@
     "jsdom": "^29.1.1",
     "svelte": "^5.57.2",
     "svelte-check": "^4.7.6",
-    "svelte-docinfo": "^0.13.0",
+    "svelte-docinfo": "^0.16.0",
     "tslib": "^2.8.1",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.71.1",

package/src/lib/declaration.svelte.ts

@@ -4,6 +4,7 @@ import type {
 	MemberJsonInput,
 	ParameterJsonInput,
 	ComponentPropJsonInput,
+	ComponentCssPropertyJsonInput,
 	OverloadJsonInput,
 	Reactivity,
 	TypeJson
@@ -251,6 +252,19 @@ export class Declaration {
 		return field<boolean>(this.declaration_json, 'mergedValue');
 	}
 
+	/**
+	 * The component's styling API: CSS custom properties its styles read with
+	 * a `var()` fallback, plus any its doc comment documents with `@cssprop`
+	 * tags (`documented`), the documented ones first.
+	 * Present on `component` kind only.
+	 */
+	get css_custom_properties(): Array<ComponentCssPropertyJsonInput> | undefined {
+		return field<Array<ComponentCssPropertyJsonInput>>(
+			this.declaration_json,
+			'cssCustomProperties'
+		);
+	}
+
 	/**
 	 * Whether a component accepts children via props or template usage.
 	 * Present on `component` kind only.

package/src/lib/helpers.ts

@@ -8,3 +8,34 @@ export const render_value_to_string = (value: unknown): string => {
 	if (type === 'object') return JSON.stringify(value);
 	return value + ''; // eslint-disable-line @typescript-eslint/no-base-to-string
 };
+
+/**
+ * Strips the whitespace prefix that a CSS custom property's multi-line
+ * `fallback` shares across its continuation lines, so a value broken over
+ * several stylesheet lines renders without the stylesheet's indentation.
+ * Line endings normalize to `\n`, and whitespace-only lines become empty.
+ *
+ * @param fallback - the verbatim fallback source text
+ * @returns the fallback with its continuation lines dedented
+ */
+export const dedent_css_fallback = (fallback: string): string => {
+	const lines = fallback.split(/\r?\n/);
+	if (lines.length === 1) return fallback;
+	// svelte-docinfo trims the fallback, so the first line's original column is
+	// lost — it stays as-is, and only the continuation lines are compared
+	let prefix: string | undefined;
+	for (let i = 1; i < lines.length; i++) {
+		const line = lines[i]!;
+		if (!line.trim()) continue;
+		const leading = /^[ \t]*/.exec(line)![0];
+		if (prefix === undefined) {
+			prefix = leading;
+		} else {
+			let j = 0;
+			while (j < prefix.length && j < leading.length && prefix[j] === leading[j]) j++;
+			prefix = prefix.slice(0, j);
+		}
+	}
+	const width = prefix?.length ?? 0;
+	return lines.map((line, i) => (i === 0 ? line : line.trim() ? line.slice(width) : '')).join('\n');
+};

package/src/lib/module.svelte.ts

@@ -72,10 +72,48 @@ export class Module {
 		return './' + this.path;
 	}
 
+	/**
+	 * Prose of the `@module` comment, tag lines removed. Absent for a tag-only
+	 * comment, whose tags still populate the doc fields below.
+	 */
 	get module_comment(): string | undefined {
 		return this.module_json.moduleComment;
 	}
 
+	get deprecated_message(): string | undefined {
+		return this.module_json.deprecatedMessage;
+	}
+
+	/**
+	 * Internal-API marker from the module comment's `@internal` tag. Presence
+	 * means the tag was written; an empty string is a bare tag.
+	 */
+	get internal_message(): string | undefined {
+		return this.module_json.internalMessage;
+	}
+
+	get since(): string | undefined {
+		return this.module_json.since;
+	}
+
+	get examples(): NonNullable<ModuleJsonInput['examples']> {
+		return this.module_json.examples ?? EMPTY_ARRAY;
+	}
+
+	get see_also(): NonNullable<ModuleJsonInput['seeAlso']> {
+		return this.module_json.seeAlso ?? EMPTY_ARRAY;
+	}
+
+	// presence, not truthiness — a bare `@deprecated` (no message text) arrives as `''`
+	get is_deprecated(): boolean {
+		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;
+	}
+
 	#declarations: Array<Declaration> | undefined;
 
 	/**
@@ -121,8 +159,20 @@ export class Module {
 		return this.declarations.length > 0;
 	}
 
-	get has_module_comment(): boolean {
-		return !!this.module_comment;
+	/**
+	 * Whether the module comment documents anything — prose or any doc field.
+	 * A tag-only comment (just `@see`, say) has no `module_comment` but still
+	 * counts.
+	 */
+	get has_module_doc(): boolean {
+		return (
+			!!this.module_comment ||
+			this.is_deprecated ||
+			this.is_internal ||
+			!!this.since ||
+			this.examples.length > 0 ||
+			this.see_also.length > 0
+		);
 	}
 
 	/**