@fuzdev/fuz_ui 0.206.7 → 0.206.9

package/dist/module.svelte.js

@@ -1,3 +1,4 @@
+import { EMPTY_ARRAY } from '@fuzdev/fuz_util/array.ts';
 import { Declaration } from './declaration.svelte.js';
 import { url_github_file } from '@fuzdev/fuz_util/package_helpers.ts';
 /**
@@ -20,8 +21,11 @@ const group_sorted = (entries, get_key) => {
 /**
  * Rich runtime representation of a module with computed properties.
  *
- * Wraps svelte-docinfo's `ModuleJson` with reactive derivations,
- * URL generation, and `Declaration` instances.
+ * Wraps svelte-docinfo's `ModuleJson` with computed properties, URL
+ * generation, and `Declaration` instances.
+ *
+ * Computed properties are plain getters rather than `$derived` — see
+ * `Library` for why.
  *
  * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
  * @see `declaration.svelte.ts` for the `Declaration` wrapper class
@@ -44,102 +48,151 @@ export class Module {
      * A leading `./` or a `.js` runtime extension will not match. Top-level
      * files match by bare filename; nested files require the full sub-path.
      */
-    path = $derived(this.module_json.path);
+    get path() {
+        return this.module_json.path;
+    }
     /**
      * Import-style path with ./ prefix.
      */
-    path_import = $derived('./' + this.path);
-    module_comment = $derived(this.module_json.moduleComment);
+    get path_import() {
+        return './' + this.path;
+    }
+    get module_comment() {
+        return this.module_json.moduleComment;
+    }
+    #declarations;
     /**
      * Array of `Declaration` instances. Filters out default exports.
      */
-    declarations = $derived((this.module_json.declarations ?? [])
-        .filter((declaration_json) => declaration_json.name !== 'default')
-        .map((declaration_json) => new Declaration(this, declaration_json)));
+    get declarations() {
+        return (this.#declarations ??= (this.module_json.declarations ?? [])
+            .filter((declaration_json) => declaration_json.name !== 'default')
+            .map((declaration_json) => new Declaration(this, declaration_json)));
+    }
     /**
      * API documentation URL for this module.
      */
-    url_api = $derived(`/docs/api${this.library.url_prefix}/${this.path}`);
+    get url_api() {
+        return `/docs/api${this.library.url_prefix}/${this.path}`;
+    }
     /**
      * Public documentation link (if `homepage_url` is available).
      *
      * Absolute URL into the library's own deployed docs, for rendering a
      * foreign library's modules on a different site (e.g. an aggregator).
      */
-    url_api_full = $derived(this.library.homepage_url
-        ? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.path}`
-        : undefined);
+    get url_api_full() {
+        const { homepage_url } = this.library;
+        return homepage_url ? `${homepage_url.replace(/\/$/, '')}/docs/api/${this.path}` : undefined;
+    }
     /**
      * GitHub source URL.
      */
-    url_github = $derived(this.library.repo_url
-        ? url_github_file(this.library.repo_url, `src/lib/${this.path}`)
-        : undefined);
+    get url_github() {
+        const { repo_url } = this.library;
+        return repo_url ? url_github_file(repo_url, `src/lib/${this.path}`) : undefined;
+    }
     /**
      * Whether the module has renderable declarations (after the default-export
      * filter in `declarations`).
      */
-    has_declarations = $derived(this.declarations.length > 0);
-    has_module_comment = $derived(!!this.module_comment);
+    get has_declarations() {
+        return this.declarations.length > 0;
+    }
+    get has_module_comment() {
+        return !!this.module_comment;
+    }
     /**
      * Modules this imports (paths relative to src/lib).
      */
-    dependencies = $derived(this.module_json.dependencies ?? []);
+    get dependencies() {
+        return this.module_json.dependencies ?? EMPTY_ARRAY;
+    }
     /**
      * Modules that import this (paths relative to src/lib).
      */
-    dependents = $derived(this.module_json.dependents ?? []);
-    has_dependencies = $derived(this.dependencies.length > 0);
-    has_dependents = $derived(this.dependents.length > 0);
+    get dependents() {
+        return this.module_json.dependents ?? EMPTY_ARRAY;
+    }
+    get has_dependencies() {
+        return this.dependencies.length > 0;
+    }
+    get has_dependents() {
+        return this.dependents.length > 0;
+    }
     /**
      * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
      * — the forward view of declarations' `alsoExportedFrom`, sorted by name
      * then module. Renamed re-exports appear as declarations with `aliasOf`
      * instead, and star exports in `star_exports`.
      */
-    re_exports = $derived(this.module_json.reExports ?? []);
-    has_re_exports = $derived(this.re_exports.length > 0);
+    get re_exports() {
+        return this.module_json.reExports ?? EMPTY_ARRAY;
+    }
+    get has_re_exports() {
+        return this.re_exports.length > 0;
+    }
     /**
      * Modules fully re-exported via `export * from './module'`
      * (`ModuleJson.starExports`), in source order. Star-projected symbols are
      * not materialized as declarations or `re_exports` edges — this is their
      * sole encoding.
      */
-    star_exports = $derived(this.module_json.starExports ?? []);
-    has_star_exports = $derived(this.star_exports.length > 0);
+    get star_exports() {
+        return this.module_json.starExports ?? EMPTY_ARRAY;
+    }
+    get has_star_exports() {
+        return this.star_exports.length > 0;
+    }
+    #re_exports_by_module;
     /**
      * Re-export edges grouped by canonical module path, groups sorted by path.
      * Entries within each group keep their name-sorted serialized order.
      */
-    re_exports_by_module = $derived(group_sorted(this.re_exports, (entry) => entry.module));
+    get re_exports_by_module() {
+        return (this.#re_exports_by_module ??= group_sorted(this.re_exports, (entry) => entry.module));
+    }
     /**
      * Re-exports whose immediate target is an external package
      * (`ModuleJson.externalReExports`) — `export {x} from 'pkg'` and
      * `export * as ns from 'pkg'` forms, sorted by name then specifier.
      */
-    external_re_exports = $derived(this.module_json.externalReExports ?? []);
-    has_external_re_exports = $derived(this.external_re_exports.length > 0);
+    get external_re_exports() {
+        return this.module_json.externalReExports ?? EMPTY_ARRAY;
+    }
+    get has_external_re_exports() {
+        return this.external_re_exports.length > 0;
+    }
+    #external_re_exports_by_specifier;
     /**
      * External re-exports grouped by package specifier, groups sorted by
      * specifier. Entries within each group keep their name-sorted serialized
      * order.
      */
-    external_re_exports_by_specifier = $derived(group_sorted(this.external_re_exports, (entry) => entry.specifier));
+    get external_re_exports_by_specifier() {
+        return (this.#external_re_exports_by_specifier ??= group_sorted(this.external_re_exports, (entry) => entry.specifier));
+    }
     /**
      * External packages fully re-exported via `export * from 'pkg'`
      * (`ModuleJson.externalStarExports`), in source order. The projected
      * names are unknown — the package isn't analyzed.
      */
-    external_star_exports = $derived(this.module_json.externalStarExports ?? []);
-    has_external_star_exports = $derived(this.external_star_exports.length > 0);
+    get external_star_exports() {
+        return this.module_json.externalStarExports ?? EMPTY_ARRAY;
+    }
+    get has_external_star_exports() {
+        return this.external_star_exports.length > 0;
+    }
     /**
      * Whether the module re-exports anything in any form — same-name edges,
      * star exports, or the external variants of both.
      */
-    has_any_re_exports = $derived(this.has_re_exports ||
-        this.has_star_exports ||
-        this.has_external_re_exports ||
-        this.has_external_star_exports);
+    get has_any_re_exports() {
+        return (this.has_re_exports ||
+            this.has_star_exports ||
+            this.has_external_re_exports ||
+            this.has_external_star_exports);
+    }
     constructor(library, module_json) {
         this.library = library;
         this.module_json = module_json;

package/dist/module_contextmenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module_contextmenu.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module_contextmenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAIrE,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,KAAG,KAAK,CAAC,iBAAiB,CAcjF,CAAC"}
+{"version":3,"file":"module_contextmenu.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module_contextmenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,KAAG,KAAK,CAAC,iBAAiB,CAcjF,CAAC"}

package/dist/module_contextmenu.js

@@ -6,8 +6,8 @@ export const create_module_contextmenu = (module) => {
         entries.push({
             snippet: 'link',
             props: {
-                href: module.url_github,
-            },
+                href: module.url_github
+            }
         });
     }
     return entries;

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