@fuzdev/fuz_ui 0.206.8 → 0.207.0

package/dist/TypeJsonView.svelte

@@ -0,0 +1,90 @@
+<!--
+@component
+
+Renders svelte-docinfo's structured `TypeJson` tree as inline code: `reference`
+nodes (and alias-carrying unions/intersections) link to API docs via
+`DeclarationLink` when the name resolves in the library — scoped to the token's
+declaring module when the analysis names one — terminal type text is
+syntax-highlighted via fuz_code's `Code`, and structural punctuation comes
+from svelte-docinfo's `typeJsonToTokens`, which owns spacing and
+parenthesization so rendering is whitespace-exact.
+
+The structured sibling of `TypeLink`, which renders flat type strings —
+`TypeLink` delegates here when given `type_info`, and svelte-docinfo omits the
+tree wherever the flat string is the whole story, so the two compose as
+"structured when it says something, flat otherwise". Pass `title` (typically
+the flat sibling string) to keep the expansion reachable on hover where the
+tree replaced it with a recovered name.
+-->
+<script lang="ts">
+	import Code from '@fuzdev/fuz_code/Code.svelte';
+	import type { TypeJson } from 'svelte-docinfo/types.js';
+	import { typeJsonToTokens } from 'svelte-docinfo/declaration-helpers.js';
+
+	import DeclarationLink from './DeclarationLink.svelte';
+	import { library_context } from './library.svelte.js';
+
+	const {
+		type_info,
+		title
+	}: {
+		type_info: TypeJson;
+		/** Hover text for the root element — pass the flat type string so the checker's expansion stays reachable. */
+		title?: string;
+	} = $props();
+
+	const get_library = library_context.get();
+	const library = $derived(get_library());
+
+	const tokens = $derived(typeJsonToTokens(type_info));
+
+	// a bare name renders without the code wrapper, matching the plain chip
+	// link `TypeLink` produces for whole-string matches
+	const bare_name_token = $derived(
+		tokens.length === 1 && tokens[0]!.kind === 'name' ? tokens[0]! : undefined
+	);
+
+	// the gate mirrors `DeclarationLink`'s resolution exactly — a moduled token
+	// (registry-recovered reference) is scoped to its declaring module with no
+	// by-name fallback, so the gate can't admit a name the link then fails on
+	const resolves = (name: string, module?: string): boolean =>
+		module === undefined
+			? library.declaration_by_name.has(name)
+			: library.module_by_path.get(module)?.get_declaration_by_name(name) !== undefined;
+</script>
+
+{#snippet name_view(name: string, module: string | undefined, root_title?: string)}
+	{#if resolves(name, module)}
+		<DeclarationLink {name} module_path={module} title={root_title} />
+	{:else}
+		<Code lang="ts" content={name} inline title={root_title} />
+	{/if}
+{/snippet}
+
+{#if bare_name_token}
+	{@render name_view(bare_name_token.name, bare_name_token.module, title)}
+{:else}
+	<!-- token adjacency survives the multi-line template: Svelte trims
+		block-boundary whitespace here, locked by the `TypeJsonView` render tests
+		(`textContent` equality would catch stray spaces) -->
+	<code class="type-json-view" {title}>
+		{#each tokens as token, i (i)}
+			{#if token.kind === 'text'}
+				{token.text}
+			{:else if token.kind === 'name'}
+				{@render name_view(token.name, token.module)}
+			{:else}
+				<Code lang="ts" content={token.text} inline />
+			{/if}
+		{/each}
+	</code>
+{/if}
+
+<style>
+	/* the outer element is the one code pill; inner `Code` fragments contribute
+	   syntax coloring only */
+	.type-json-view :global(code) {
+		background: transparent;
+		padding: 0;
+	}
+</style>

package/dist/TypeJsonView.svelte.d.ts

@@ -0,0 +1,26 @@
+import type { TypeJson } from 'svelte-docinfo/types.js';
+type $$ComponentProps = {
+    type_info: TypeJson;
+    /** Hover text for the root element — pass the flat type string so the checker's expansion stays reachable. */
+    title?: string;
+};
+/**
+ * Renders svelte-docinfo's structured `TypeJson` tree as inline code: `reference`
+ * nodes (and alias-carrying unions/intersections) link to API docs via
+ * `DeclarationLink` when the name resolves in the library — scoped to the token's
+ * declaring module when the analysis names one — terminal type text is
+ * syntax-highlighted via fuz_code's `Code`, and structural punctuation comes
+ * from svelte-docinfo's `typeJsonToTokens`, which owns spacing and
+ * parenthesization so rendering is whitespace-exact.
+ *
+ * The structured sibling of `TypeLink`, which renders flat type strings —
+ * `TypeLink` delegates here when given `type_info`, and svelte-docinfo omits the
+ * tree wherever the flat string is the whole story, so the two compose as
+ * "structured when it says something, flat otherwise". Pass `title` (typically
+ * the flat sibling string) to keep the expansion reachable on hover where the
+ * tree replaced it with a recovered name.
+ */
+declare const TypeJsonView: import("svelte").Component<$$ComponentProps, {}, "">;
+type TypeJsonView = ReturnType<typeof TypeJsonView>;
+export default TypeJsonView;
+//# sourceMappingURL=TypeJsonView.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeJsonView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TypeJsonView.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAMvD,KAAK,gBAAgB,GAAI;IACxB,SAAS,EAAE,QAAQ,CAAC;IACpB,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAgEH;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,YAAY,sDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/TypeLink.svelte

@@ -1,12 +1,15 @@
 <script lang="ts">
 	import Code from '@fuzdev/fuz_code/Code.svelte';
 	import type { HTMLAttributes, SvelteHTMLElements } from 'svelte/elements';
+	import type { TypeJson } from 'svelte-docinfo/types.js';
 
 	import DeclarationLink from './DeclarationLink.svelte';
+	import TypeJsonView from './TypeJsonView.svelte';
 	import { library_context } from './library.svelte.js';
 
 	const {
 		type,
+		type_info,
 		hash,
 		a_attrs,
 		code_attrs,
@@ -14,6 +17,15 @@
 	}: // generic element attrs, the common denominator of the rendered roots - // assignable to the anchor rest of `DeclarationLink` and the code rest of `Code`
 		HTMLAttributes<HTMLElement> & {
 			type: string;
+			/**
+			 * Structured type tree, when svelte-docinfo emitted one beside the flat
+			 * string — rendered via `TypeJsonView` (per-node linkification, with
+			 * `type` as hover text) instead of the whole-string match below. An
+			 * absent tree falls through to `type`, so call sites pass both fields
+			 * unconditionally. `hash` and the rest/`a_attrs`/`code_attrs`
+			 * attributes apply only to the flat branches, not the delegated tree.
+			 */
+			type_info?: TypeJson;
 			/** URL fragment to append, with or without the `#`. */
 			hash?: string;
 			/** Anchor attributes, applied only when the type resolves to a declaration link. */
@@ -28,7 +40,11 @@
 	// TODO maybe better name?
 </script>
 
-{#if library.declaration_by_name.has(type)}
+{#if type_info}
+	<!-- the flat string rides along as hover text so the checker's expansion
+		stays reachable where the tree replaced it with a recovered name -->
+	<TypeJsonView {type_info} title={type} />
+{:else if library.declaration_by_name.has(type)}
 	<DeclarationLink {...rest} {...a_attrs} name={type} {hash} />
 {:else}
 	<Code {...rest} {...code_attrs} lang="ts" content={type} inline />

package/dist/TypeLink.svelte.d.ts

@@ -1,7 +1,17 @@
 import type { HTMLAttributes, SvelteHTMLElements } from 'svelte/elements';
+import type { TypeJson } from 'svelte-docinfo/types.js';
 type $$ComponentProps = // generic element attrs, the common denominator of the rendered roots - // assignable to the anchor rest of `DeclarationLink` and the code rest of `Code`
 HTMLAttributes<HTMLElement> & {
     type: string;
+    /**
+     * Structured type tree, when svelte-docinfo emitted one beside the flat
+     * string — rendered via `TypeJsonView` (per-node linkification, with
+     * `type` as hover text) instead of the whole-string match below. An
+     * absent tree falls through to `type`, so call sites pass both fields
+     * unconditionally. `hash` and the rest/`a_attrs`/`code_attrs`
+     * attributes apply only to the flat branches, not the delegated tree.
+     */
+    type_info?: TypeJson;
     /** URL fragment to append, with or without the `#`. */
     hash?: string;
     /** Anchor attributes, applied only when the type resolves to a declaration link. */

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

@@ -1 +1 @@
-{"version":3,"file":"TypeLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TypeLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAKzE,KAAK,gBAAgB,GACpB,AADwB,0JAA0J;AAClL,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAClC,0FAA0F;IAC1F,UAAU,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AA8BJ,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"TypeLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TypeLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAMvD,KAAK,gBAAgB,GACpB,AADwB,0JAA0J;AAClL,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,OAAO,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAClC,0FAA0F;IAC1F,UAAU,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAoCJ,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/declaration.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { DeclarationJsonInput, MemberJsonInput, ParameterJsonInput, ComponentPropJsonInput, OverloadJsonInput, Reactivity } from 'svelte-docinfo/types.js';
+import type { DeclarationJsonInput, MemberJsonInput, ParameterJsonInput, ComponentPropJsonInput, OverloadJsonInput, Reactivity, TypeJson } from 'svelte-docinfo/types.js';
 import type { Module } from './module.svelte.js';
 /**
  * Rich runtime representation of an exported declaration.
@@ -45,14 +45,30 @@ export declare class Declaration {
      */
     get display_name(): string;
     get type_signature(): string | undefined;
+    /**
+     * Structured type tree beside `type_signature`, absent when the flat string
+     * is the whole story. Present on `variable` and `type` kinds only.
+     */
+    get type_info(): TypeJson | undefined;
+    /**
+     * Default value documented via `@default`; the authoritative initializer
+     * (when human-readable) is in `type_signature`. Present on `variable` kind
+     * only — parameters, props, and members carry their own.
+     */
+    get default_value(): string | undefined;
     get doc_comment(): string | undefined;
     get deprecated_message(): string | undefined;
     get parameters(): Array<ParameterJsonInput> | undefined;
     get props(): Array<ComponentPropJsonInput> | undefined;
     get return_type(): string | undefined;
+    /**
+     * Structured return type beside `return_type`, absent when the flat string
+     * is the whole story. Present on `function` kind only.
+     */
+    get return_type_info(): TypeJson | undefined;
     get return_description(): string | undefined;
     get generic_params(): NonNullable<DeclarationJsonInput['genericParams']>;
-    get extends_type(): string | Array<string> | undefined;
+    get extends_types(): Array<string> | undefined;
     get implements_types(): Array<string> | undefined;
     get throws(): NonNullable<DeclarationJsonInput['throws']>;
     get since(): string | undefined;
@@ -63,10 +79,14 @@ export declare class Declaration {
      */
     get members(): Array<MemberJsonInput> | undefined;
     /**
-     * Intersection types whose properties are external (filtered out of props/members).
-     * Present on `component` and `type` kinds.
+     * External types whose contributions are filtered out of props/members —
+     * the attribute bags a component forwards, however the author composed
+     * them (intersection, heritage clause, bare or indexed-access reference).
+     * On `interface`/`class` kinds it records the external reach of the
+     * heritage chain, whose contributions members (own-only) never enumerate.
+     * Present on `component`, `type`, `interface`, and `class` kinds.
      */
-    get intersects(): Array<string> | undefined;
+    get external_types(): Array<string> | 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

@@ -87,6 +87,21 @@ export class Declaration {
     get type_signature() {
         return this.declaration_json.typeSignature;
     }
+    /**
+     * Structured type tree beside `type_signature`, absent when the flat string
+     * is the whole story. Present on `variable` and `type` kinds only.
+     */
+    get type_info() {
+        return field(this.declaration_json, 'typeInfo');
+    }
+    /**
+     * Default value documented via `@default`; the authoritative initializer
+     * (when human-readable) is in `type_signature`. Present on `variable` kind
+     * only — parameters, props, and members carry their own.
+     */
+    get default_value() {
+        return field(this.declaration_json, 'defaultValue');
+    }
     get doc_comment() {
         return this.declaration_json.docComment;
     }
@@ -102,13 +117,20 @@ export class Declaration {
     get return_type() {
         return field(this.declaration_json, 'returnType');
     }
+    /**
+     * Structured return type beside `return_type`, absent when the flat string
+     * is the whole story. Present on `function` kind only.
+     */
+    get return_type_info() {
+        return field(this.declaration_json, 'returnTypeInfo');
+    }
     get return_description() {
         return field(this.declaration_json, 'returnDescription');
     }
     get generic_params() {
         return this.declaration_json.genericParams ?? EMPTY_ARRAY;
     }
-    get extends_type() {
+    get extends_types() {
         return field(this.declaration_json, 'extends');
     }
     get implements_types() {
@@ -133,11 +155,15 @@ export class Declaration {
         return field(this.declaration_json, 'members');
     }
     /**
-     * Intersection types whose properties are external (filtered out of props/members).
-     * Present on `component` and `type` kinds.
+     * External types whose contributions are filtered out of props/members —
+     * the attribute bags a component forwards, however the author composed
+     * them (intersection, heritage clause, bare or indexed-access reference).
+     * On `interface`/`class` kinds it records the external reach of the
+     * heritage chain, whose contributions members (own-only) never enumerate.
+     * Present on `component`, `type`, `interface`, and `class` kinds.
      */
-    get intersects() {
-        return field(this.declaration_json, 'intersects');
+    get external_types() {
+        return field(this.declaration_json, 'externalTypes');
     }
     /**
      * Whether a component accepts children via props or template usage.

package/dist/project_stats.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Types and pure helpers for project commit-activity stats.
+ *
+ * The committed dataset (`project_stats_data.ts`, written by the
+ * `project_stats_update` task) stores daily commit counts per project as the
+ * master granularity; coarser scopes like monthly are derived at runtime by
+ * rebucketing. All date handling is UTC — `YYYY-MM-DD` strings and "epoch
+ * days" (days since the Unix epoch) — so results are deterministic across
+ * machines.
+ *
+ * @module
+ */
+/**
+ * Daily commit counts for one project.
+ */
+export interface ProjectCommitStats {
+    /**
+     * Project name, matching `project_items`.
+     */
+    name: string;
+    /**
+     * UTC date (`YYYY-MM-DD`) of the first day bucket, the day of the first commit.
+     */
+    start_date: string;
+    /**
+     * Commits per UTC day from `start_date` through the snapshot's `end_date`, inclusive.
+     */
+    daily_counts: Array<number>;
+}
+/**
+ * A snapshot of commit stats across projects, sharing a single `end_date`.
+ */
+export interface ProjectStatsSnapshot {
+    /**
+     * ISO datetime when the snapshot was collected.
+     */
+    generated_at: string;
+    /**
+     * UTC date (`YYYY-MM-DD`) of the final day bucket, shared by every project.
+     */
+    end_date: string;
+    projects: Array<ProjectCommitStats>;
+}
+/**
+ * A derived series of bucketed counts for one project.
+ */
+export interface ProjectStatsSeries {
+    name: string;
+    counts: Array<number>;
+}
+/**
+ * Converts a UTC `YYYY-MM-DD` date to days since the Unix epoch.
+ */
+export declare const epoch_day_from_date: (date: string) => number;
+/**
+ * Converts days since the Unix epoch to a UTC `YYYY-MM-DD` date.
+ */
+export declare const date_from_epoch_day: (epoch_day: number) => string;
+/**
+ * Buckets commit timestamps into daily counts from the earliest commit's UTC
+ * day through `end_date`, inclusive.
+ *
+ * @param timestamps - commit times as Unix epoch seconds
+ * @param end_date - UTC date (`YYYY-MM-DD`) of the final bucket; later timestamps clamp into it
+ * @returns the start date and daily counts, or `null` if `timestamps` is empty
+ */
+export declare const daily_counts_from_timestamps: (timestamps: Array<number>, end_date: string) => {
+    start_date: string;
+    daily_counts: Array<number>;
+} | null;
+/**
+ * Pads `daily_counts` with leading zeros so the series starts at
+ * `padded_start_date` instead of `start_date`.
+ *
+ * Returns the input array unchanged when `padded_start_date` is not earlier
+ * than `start_date`.
+ */
+export declare const daily_counts_pad_start: (daily_counts: Array<number>, start_date: string, padded_start_date: string) => Array<number>;
+/**
+ * Rebuckets daily counts into calendar-month (UTC) counts.
+ *
+ * The first and last buckets may cover partial months.
+ */
+export declare const monthly_counts_from_daily: (daily_counts: Array<number>, start_date: string) => Array<number>;
+/**
+ * Rebuckets daily counts into 7-day counts, anchored at the end of the series
+ * so the newest bucket always covers a full 7 days.
+ *
+ * The first bucket may cover fewer days when the length isn't a multiple of 7.
+ */
+export declare const weekly_counts_from_daily: (daily_counts: Array<number>) => Array<number>;
+/**
+ * Derives aligned monthly series for every project in `snapshot`, sharing one
+ * time window and one scale.
+ *
+ * Each series spans from the earliest project's `start_date` through the
+ * snapshot's `end_date` (younger projects are zero-padded at the front), so
+ * all series have the same length and bucket boundaries. `max` is the largest
+ * monthly count across all projects, for rendering every series at the same
+ * vertical scale.
+ */
+export declare const project_stats_to_monthly_series: (snapshot: ProjectStatsSnapshot) => {
+    series: Array<ProjectStatsSeries>;
+    max: number;
+};
+/**
+ * Derives aligned weekly series for every project in `snapshot`, sharing one
+ * time window and one scale — the weekly sibling of
+ * `project_stats_to_monthly_series`.
+ */
+export declare const project_stats_to_weekly_series: (snapshot: ProjectStatsSnapshot) => {
+    series: Array<ProjectStatsSeries>;
+    max: number;
+};
+/**
+ * Formats a one-line human-readable summary of a project's commit stats,
+ * e.g. `"gro — 2,386 commits since August 7, 2019"`. Used for accessible
+ * labels and tooltips.
+ */
+export declare const project_stats_label: (project: ProjectCommitStats) => string;
+//# sourceMappingURL=project_stats.d.ts.map

package/dist/project_stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_stats.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/project_stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAGlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,MACA,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACxC,YAAY,KAAK,CAAC,MAAM,CAAC,EACzB,UAAU,MAAM,KACd;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,IAaxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAClC,cAAc,KAAK,CAAC,MAAM,CAAC,EAC3B,YAAY,MAAM,EAClB,mBAAmB,MAAM,KACvB,KAAK,CAAC,MAAM,CAId,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACrC,cAAc,KAAK,CAAC,MAAM,CAAC,EAC3B,YAAY,MAAM,KAChB,KAAK,CAAC,MAAM,CAcd,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,KAAK,CAAC,MAAM,CAAC,KAAG,KAAK,CAAC,MAAM,CAUlF,CAAC;AAuBF;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,GAC3C,UAAU,oBAAoB,KAC5B;IAAE,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CACI,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAC1C,UAAU,oBAAoB,KAC5B;IAAE,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CACG,CAAC;AASvD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,kBAAkB,KAAG,MAMjE,CAAC"}

package/dist/project_stats.js

@@ -0,0 +1,153 @@
+/**
+ * Types and pure helpers for project commit-activity stats.
+ *
+ * The committed dataset (`project_stats_data.ts`, written by the
+ * `project_stats_update` task) stores daily commit counts per project as the
+ * master granularity; coarser scopes like monthly are derived at runtime by
+ * rebucketing. All date handling is UTC — `YYYY-MM-DD` strings and "epoch
+ * days" (days since the Unix epoch) — so results are deterministic across
+ * machines.
+ *
+ * @module
+ */
+const DAY_MS = 86_400_000;
+/**
+ * Converts a UTC `YYYY-MM-DD` date to days since the Unix epoch.
+ */
+export const epoch_day_from_date = (date) => {
+    const [year, month, day] = date.split('-').map(Number);
+    return Date.UTC(year, month - 1, day) / DAY_MS;
+};
+/**
+ * Converts days since the Unix epoch to a UTC `YYYY-MM-DD` date.
+ */
+export const date_from_epoch_day = (epoch_day) => new Date(epoch_day * DAY_MS).toISOString().slice(0, 10);
+/**
+ * Buckets commit timestamps into daily counts from the earliest commit's UTC
+ * day through `end_date`, inclusive.
+ *
+ * @param timestamps - commit times as Unix epoch seconds
+ * @param end_date - UTC date (`YYYY-MM-DD`) of the final bucket; later timestamps clamp into it
+ * @returns the start date and daily counts, or `null` if `timestamps` is empty
+ */
+export const daily_counts_from_timestamps = (timestamps, end_date) => {
+    if (timestamps.length === 0)
+        return null;
+    const days = timestamps.map((t) => Math.floor((t * 1000) / DAY_MS));
+    const end_day = epoch_day_from_date(end_date);
+    let start_day = end_day;
+    for (const day of days) {
+        if (day < start_day)
+            start_day = day;
+    }
+    const daily_counts = new Array(end_day - start_day + 1).fill(0);
+    for (const day of days) {
+        daily_counts[Math.min(day, end_day) - start_day] += 1;
+    }
+    return { start_date: date_from_epoch_day(start_day), daily_counts };
+};
+/**
+ * Pads `daily_counts` with leading zeros so the series starts at
+ * `padded_start_date` instead of `start_date`.
+ *
+ * Returns the input array unchanged when `padded_start_date` is not earlier
+ * than `start_date`.
+ */
+export const daily_counts_pad_start = (daily_counts, start_date, padded_start_date) => {
+    const pad = epoch_day_from_date(start_date) - epoch_day_from_date(padded_start_date);
+    if (pad <= 0)
+        return daily_counts;
+    return new Array(pad).fill(0).concat(daily_counts);
+};
+/**
+ * Rebuckets daily counts into calendar-month (UTC) counts.
+ *
+ * The first and last buckets may cover partial months.
+ */
+export const monthly_counts_from_daily = (daily_counts, start_date) => {
+    const start_day = epoch_day_from_date(start_date);
+    const counts = [];
+    let current_month_key = null;
+    for (let i = 0; i < daily_counts.length; i++) {
+        const date = new Date((start_day + i) * DAY_MS);
+        const month_key = date.getUTCFullYear() * 12 + date.getUTCMonth();
+        if (month_key !== current_month_key) {
+            current_month_key = month_key;
+            counts.push(0);
+        }
+        counts[counts.length - 1] += daily_counts[i];
+    }
+    return counts;
+};
+/**
+ * Rebuckets daily counts into 7-day counts, anchored at the end of the series
+ * so the newest bucket always covers a full 7 days.
+ *
+ * The first bucket may cover fewer days when the length isn't a multiple of 7.
+ */
+export const weekly_counts_from_daily = (daily_counts) => {
+    const counts = [];
+    for (let end = daily_counts.length; end > 0; end -= 7) {
+        let sum = 0;
+        for (let i = Math.max(0, end - 7); i < end; i++) {
+            sum += daily_counts[i];
+        }
+        counts.push(sum);
+    }
+    return counts.reverse();
+};
+const to_aligned_series = (snapshot, rebucket) => {
+    if (snapshot.projects.length === 0)
+        return { series: [], max: 0 };
+    let shared_start = snapshot.projects[0].start_date;
+    for (const project of snapshot.projects) {
+        if (project.start_date < shared_start)
+            shared_start = project.start_date;
+    }
+    let max = 0;
+    const series = snapshot.projects.map((project) => {
+        const daily = daily_counts_pad_start(project.daily_counts, project.start_date, shared_start);
+        const counts = rebucket(daily, shared_start);
+        for (const count of counts) {
+            if (count > max)
+                max = count;
+        }
+        return { name: project.name, counts };
+    });
+    return { series, max };
+};
+/**
+ * Derives aligned monthly series for every project in `snapshot`, sharing one
+ * time window and one scale.
+ *
+ * Each series spans from the earliest project's `start_date` through the
+ * snapshot's `end_date` (younger projects are zero-padded at the front), so
+ * all series have the same length and bucket boundaries. `max` is the largest
+ * monthly count across all projects, for rendering every series at the same
+ * vertical scale.
+ */
+export const project_stats_to_monthly_series = (snapshot) => to_aligned_series(snapshot, monthly_counts_from_daily);
+/**
+ * Derives aligned weekly series for every project in `snapshot`, sharing one
+ * time window and one scale — the weekly sibling of
+ * `project_stats_to_monthly_series`.
+ */
+export const project_stats_to_weekly_series = (snapshot) => to_aligned_series(snapshot, weekly_counts_from_daily);
+const start_date_formatter = new Intl.DateTimeFormat('en-US', {
+    month: 'long',
+    day: 'numeric',
+    year: 'numeric',
+    timeZone: 'UTC'
+});
+/**
+ * Formats a one-line human-readable summary of a project's commit stats,
+ * e.g. `"gro — 2,386 commits since August 7, 2019"`. Used for accessible
+ * labels and tooltips.
+ */
+export const project_stats_label = (project) => {
+    let total = 0;
+    for (const count of project.daily_counts) {
+        total += count;
+    }
+    return `${project.name} — ${total.toLocaleString('en-US')} commits since ${start_date_formatter.format(new Date(project.start_date))}`;
+};

package/dist/project_stats_data.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectStatsSnapshot } from './project_stats.js';
+export declare const project_stats_data: ProjectStatsSnapshot;
+//# sourceMappingURL=project_stats_data.d.ts.map

package/dist/project_stats_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_stats_data.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/project_stats_data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAO,MAAM,kBAAkB,EAAE,oBAmdhC,CAAC"}