@fuzdev/fuz_ui 0.206.8 → 0.206.9

package/dist/ProjectActivityChart.svelte

@@ -0,0 +1,137 @@
+<script lang="ts">
+	import type { OmitStrict } from '@fuzdev/fuz_util/types.ts';
+	import type { SvelteHTMLElements } from 'svelte/elements';
+
+	import { project_items } from './projects.js';
+	import { project_stats_data } from './project_stats_data.js';
+	import { project_stats_label, project_stats_to_weekly_series } from './project_stats.js';
+	import { sparkline_geometry, type SparklineScale } from './sparkline.js';
+
+	/**
+	 * A large line chart of weekly commit activity with every fuz.dev project
+	 * drawn over one another, sharing one time window and one scale.
+	 *
+	 * Each project's line uses its `color_class` from `project_items` (the
+	 * `ProjectLinks` grid doubles as the legend), with the same per-point alpha
+	 * fade and end dot as `Sparkline`. Hovering a line shows the project's
+	 * stats via a native `title`. The svg scales to its container's width.
+	 *
+	 * The background is a light wash of `currentColor` (the inherited text
+	 * color), overridable with the `--sparkline_bg` custom property.
+	 *
+	 * @module
+	 */
+
+	const {
+		width = 800,
+		height = 160,
+		scale = 1 / 3,
+		stroke_width = 2,
+		alpha_floor = 0.4,
+		label = 'weekly commit activity for all projects, drawn over one another at a shared scale',
+		...rest
+	}: OmitStrict<SvelteHTMLElements['svg'], 'width' | 'height' | 'scale'> & {
+		/**
+		 * Width of the svg's coordinate space in px; rendering stretches to the container.
+		 */
+		width?: number;
+		/**
+		 * Height of the svg's coordinate space in px.
+		 */
+		height?: number;
+		/**
+		 * Vertical scale for the lines' geometry — see `SparklineScale`.
+		 */
+		scale?: SparklineScale;
+		stroke_width?: number;
+		/**
+		 * Stroke alpha at a value of 0, scaling linearly to 1 at the shared max.
+		 */
+		alpha_floor?: number;
+		/**
+		 * Accessible label for the chart.
+		 */
+		label?: string;
+	} = $props();
+
+	const chart_id = $props.id();
+
+	const { series, max } = project_stats_to_weekly_series(project_stats_data);
+	const color_class_by_name = new Map(project_items.map((p) => [p.name, p.color_class]));
+	const label_by_name = new Map(
+		project_stats_data.projects.map((p) => [p.name, project_stats_label(p)])
+	);
+
+	const lines = $derived(
+		series.flatMap(({ name, counts }) => {
+			const geometry = sparkline_geometry(counts, {
+				width,
+				height,
+				max,
+				scale,
+				stroke_width,
+				alpha_floor,
+				end_dot: true
+			});
+			return geometry
+				? [
+						{
+							name,
+							geometry,
+							color_class: color_class_by_name.get(name),
+							title: label_by_name.get(name)
+						}
+					]
+				: [];
+		})
+	);
+</script>
+
+<svg {...rest} viewBox="0 0 {width} {height}" role="img" aria-label={label}>
+	<defs>
+		{#each lines as line, index (line.name)}
+			<linearGradient
+				id="{chart_id}-{index}"
+				class={line.color_class}
+				gradientUnits="userSpaceOnUse"
+				x1="0"
+				y1="0"
+				x2={width}
+				y2="0"
+			>
+				{#each line.geometry.stops as stop, stop_index (stop_index)}
+					<stop offset={stop.offset} stop-color="currentColor" stop-opacity={stop.opacity} />
+				{/each}
+			</linearGradient>
+		{/each}
+	</defs>
+	{#each lines as line, index (line.name)}
+		<g class={line.color_class}>
+			<title>{line.title}</title>
+			<polyline
+				points={line.geometry.points}
+				fill="none"
+				stroke="url(#{chart_id}-{index})"
+				stroke-width={stroke_width}
+				stroke-linejoin="round"
+				stroke-linecap="round"
+			/>
+			<circle
+				cx={line.geometry.end_x}
+				cy={line.geometry.end_y}
+				r={line.geometry.dot_radius}
+				fill="currentColor"
+				fill-opacity={line.geometry.end_alpha}
+			/>
+		</g>
+	{/each}
+</svg>
+
+<style>
+	svg {
+		width: 100%;
+		height: auto;
+		background: var(--sparkline_bg, color-mix(in hsl, currentColor 8%, transparent));
+		border-radius: var(--border_radius_xs);
+	}
+</style>

package/dist/ProjectActivityChart.svelte.d.ts

@@ -0,0 +1,30 @@
+import type { OmitStrict } from '@fuzdev/fuz_util/types.ts';
+import type { SvelteHTMLElements } from 'svelte/elements';
+import { type SparklineScale } from './sparkline.js';
+type $$ComponentProps = OmitStrict<SvelteHTMLElements['svg'], 'width' | 'height' | 'scale'> & {
+    /**
+     * Width of the svg's coordinate space in px; rendering stretches to the container.
+     */
+    width?: number;
+    /**
+     * Height of the svg's coordinate space in px.
+     */
+    height?: number;
+    /**
+     * Vertical scale for the lines' geometry — see `SparklineScale`.
+     */
+    scale?: SparklineScale;
+    stroke_width?: number;
+    /**
+     * Stroke alpha at a value of 0, scaling linearly to 1 at the shared max.
+     */
+    alpha_floor?: number;
+    /**
+     * Accessible label for the chart.
+     */
+    label?: string;
+};
+declare const ProjectActivityChart: import("svelte").Component<$$ComponentProps, {}, "">;
+type ProjectActivityChart = ReturnType<typeof ProjectActivityChart>;
+export default ProjectActivityChart;
+//# sourceMappingURL=ProjectActivityChart.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectActivityChart.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectActivityChart.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK1D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,KAAK,gBAAgB,GAAI,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG;IAC9F;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA2FH,QAAA,MAAM,oBAAoB,sDAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/ProjectLinks.svelte

@@ -1,49 +1,15 @@
 <script lang="ts">
 	import Svg from './Svg.svelte';
-	import type { SvgData } from './svg.js';
-	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';
+	import Sparkline from './Sparkline.svelte';
+	import { project_items, type ProjectItem } from './projects.js';
+	import { project_stats_data } from './project_stats_data.js';
+	import { project_stats_label, project_stats_to_monthly_series } from './project_stats.js';
 
-	// TODO refactor
-	interface ProjectItem {
-		name: string;
-		url: string;
-		logo: SvgData;
-		description: string;
-		glyph: string;
-		color_class: string;
-	}
-
-	// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_gitops to this repo is heavy
-	// prettier-ignore
-	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'},
-		{name: 'fuz_css', url: 'https://css.fuz.dev/', logo: logo_fuz_css, description: 'semantic-first CSS framework and design system', glyph: '🌿', color_class: 'color_b_50'},
-		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_50'},
-		{name: 'fuz_template', url: 'https://template.fuz.dev/', logo: logo_fuz_template, description: 'a static web app and Node library template with TypeScript, Svelte, SvelteKit, Vite, esbuild, Gro, and Fuz', glyph: '❄', color_class: 'color_h_50'},
-		{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: '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'},
-		{name: 'tsv', url: 'https://tsv.fuz.dev/', logo: logo_tsv, description: 'precise language tools for TypeScript/JS, CSS, and Svelte in Rust', glyph: '🪶', color_class: 'color_h_50'},
-	];
+	const { series, max } = project_stats_to_monthly_series(project_stats_data);
+	const series_by_name = new Map(series.map((s) => [s.name, s.counts]));
+	const label_by_name = new Map(
+		project_stats_data.projects.map((p) => [p.name, project_stats_label(p)])
+	);
 </script>
 
 <h2 class="mt_0 mb_xl2">Packages</h2>
@@ -52,13 +18,25 @@
 		{@render package_thumbnail(project_item)}
 	{/each}
 </menu>
+<small class="display:block text-align:right">
+	the charts show public commit activity<br />since Gro planted on August 7, 2019
+</small>
 
 {#snippet package_thumbnail(project_item: ProjectItem)}
+	{@const counts = series_by_name.get(project_item.name)}
 	<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
 	<a class="thumbnail row shade_00 px_md py_xs border_radius_sm mb_lg" href={project_item.url}>
 		<Svg shrink={false} data={project_item.logo} size="var(--icon_size_lg)" />
 		<div class="pl_lg width_atmost_sm">
-			<div class="thumbnail-name {project_item.color_class}">{project_item.name}</div>
+			<div class="thumbnail-name row align-items:start {project_item.color_class}">
+				{project_item.name}
+				{#if counts}
+					{@const stats_label = label_by_name.get(project_item.name)}
+					<div class="thumbnail-sparkline pl_md {project_item.color_class}" title={stats_label}>
+						<Sparkline values={counts} {max} scale={1 / 3} end_dot label={stats_label} />
+					</div>
+				{/if}
+			</div>
 			<div class="thumbnail-description font_size_md text_70 font-weight:500">
 				{project_item.description}
 				{project_item.glyph}
@@ -101,4 +79,7 @@
 				transparent
 			);
 	}
+	.thumbnail-sparkline {
+		margin-left: auto;
+	}
 </style>

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectLinks.svelte"],"names":[],"mappings":"AAgFA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,YAAY;;kBAA+E,CAAC;AAChF,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ProjectLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectLinks.svelte"],"names":[],"mappings":"AA4DA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,YAAY;;kBAA+E,CAAC;AAChF,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAe,YAAY,CAAC"}

package/dist/Sparkline.svelte

@@ -0,0 +1,131 @@
+<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,
+		scale = 'linear',
+		width = 100,
+		height = 24,
+		stroke_width = 2,
+		alpha_floor = 0.4,
+		end_dot = false,
+		label,
+		...rest
+	}: OmitStrict<SvelteHTMLElements['svg'], 'values' | 'width' | 'height' | 'scale'> & {
+		values: Array<number>;
+		/**
+		 * The value rendered at full height and full alpha.
+		 * Pass a shared max across sparklines for comparable scales.
+		 * Defaults to the local max of `values`.
+		 */
+		max?: number;
+		/**
+		 * Vertical scale for the line's geometry — see `SparklineScale`.
+		 * The alpha fade always tracks the linear ratio regardless of `scale`.
+		 */
+		scale?: SparklineScale;
+		/**
+		 * Width of the svg in px.
+		 */
+		width?: number;
+		/**
+		 * Height of the svg in px.
+		 */
+		height?: number;
+		stroke_width?: number;
+		/**
+		 * Stroke alpha at a value of 0, scaling linearly to 1 at `max`.
+		 */
+		alpha_floor?: number;
+		/**
+		 * Renders a dot at the final point, anchoring the "now" end of the line.
+		 */
+		end_dot?: boolean;
+		/**
+		 * Accessible label. When omitted the svg is `aria-hidden`.
+		 */
+		label?: string;
+	} = $props();
+
+	const gradient_id = $props.id();
+
+	const geometry = $derived(
+		sparkline_geometry(values, { width, height, max, scale, stroke_width, alpha_floor, end_dot })
+	);
+</script>
+
+<svg
+	{...rest}
+	{width}
+	{height}
+	viewBox="0 0 {width} {height}"
+	role={label ? 'img' : undefined}
+	aria-label={label}
+	aria-hidden={label ? undefined : true}
+>
+	{#if geometry}
+		<defs>
+			<linearGradient
+				id={gradient_id}
+				gradientUnits="userSpaceOnUse"
+				x1="0"
+				y1="0"
+				x2={width}
+				y2="0"
+			>
+				{#each geometry.stops as stop, index (index)}
+					<stop offset={stop.offset} stop-color="currentColor" stop-opacity={stop.opacity} />
+				{/each}
+			</linearGradient>
+		</defs>
+		<polyline
+			points={geometry.points}
+			fill="none"
+			stroke="url(#{gradient_id})"
+			stroke-width={stroke_width}
+			stroke-linejoin="round"
+			stroke-linecap="round"
+		/>
+		{#if end_dot}
+			<circle
+				cx={geometry.end_x}
+				cy={geometry.end_y}
+				r={geometry.dot_radius}
+				fill="currentColor"
+				fill-opacity={geometry.end_alpha}
+			/>
+		{/if}
+	{/if}
+</svg>
+
+<style>
+	svg {
+		background: var(--sparkline_bg, color-mix(in hsl, currentColor 8%, transparent));
+		border-radius: var(--border_radius_xs);
+	}
+</style>

package/dist/Sparkline.svelte.d.ts

@@ -0,0 +1,42 @@
+import type { OmitStrict } from '@fuzdev/fuz_util/types.ts';
+import type { SvelteHTMLElements } from 'svelte/elements';
+import { type SparklineScale } from './sparkline.js';
+type $$ComponentProps = OmitStrict<SvelteHTMLElements['svg'], 'values' | 'width' | 'height' | 'scale'> & {
+    values: Array<number>;
+    /**
+     * The value rendered at full height and full alpha.
+     * Pass a shared max across sparklines for comparable scales.
+     * Defaults to the local max of `values`.
+     */
+    max?: number;
+    /**
+     * Vertical scale for the line's geometry — see `SparklineScale`.
+     * The alpha fade always tracks the linear ratio regardless of `scale`.
+     */
+    scale?: SparklineScale;
+    /**
+     * Width of the svg in px.
+     */
+    width?: number;
+    /**
+     * Height of the svg in px.
+     */
+    height?: number;
+    stroke_width?: number;
+    /**
+     * Stroke alpha at a value of 0, scaling linearly to 1 at `max`.
+     */
+    alpha_floor?: number;
+    /**
+     * Renders a dot at the final point, anchoring the "now" end of the line.
+     */
+    end_dot?: boolean;
+    /**
+     * Accessible label. When omitted the svg is `aria-hidden`.
+     */
+    label?: string;
+};
+declare const Sparkline: import("svelte").Component<$$ComponentProps, {}, "">;
+type Sparkline = ReturnType<typeof Sparkline>;
+export default Sparkline;
+//# sourceMappingURL=Sparkline.svelte.d.ts.map

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

@@ -0,0 +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"}

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"}