@m0saic/templates 0.2.0

package/dist/m0saic/alpine/contributor-table/v1/contributor-table.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ============================================================================
+ * @m0saic/alpine/contributor-table/v1 — Hero Contributor Table (Alpine primitive)
+ * ============================================================================
+ *
+ * A ranked, MULTI-COLUMN table: rank · avatar · name + N right-aligned value
+ * columns, under an icon + title + subtitle header. The Alpine-pack sibling of
+ * the leaderboard — alpine-light by default (the FFmpeg Weekly Pulse "Top
+ * Contributors" beat passes preset:"dark"), and GENERIC — value columns are
+ * arbitrary labels + per-row values, so it isn't tied to commits/additions/deletions.
+ *
+ * Built coarse + light (the primitive rule): proportional row/col splits (the
+ * alpine-card kit caps split bases) + rounded `makeColorTile`s, NO pixel-exact
+ * geometry — so the DSL stays small and renders crisp at any size. Top-N rows get
+ * a soft accent wash; value columns count up; avatars are colored-initial discs
+ * (real avatar_url media is a Phase-4 fetch). `anim.reduceMotion` → static.
+ * ============================================================================
+ */
+import type { MosaicColor, MosaicTemplate } from "@m0saic/types";
+import { type EaseName, type ThemeSourceConfig } from "@m0saic/template-utils";
+import { type AlpinePreset } from "../../_shared/alpine-theme";
+type ContribRow = {
+    rank?: number;
+    name: string;
+    avatar?: string;
+    values: Array<number | string>;
+};
+/** Reveal cost/quality dial. "premium" (default): rows cascade in via `overlay.alpha`
+ *  (a geq per faded source). "light": the same cascade via free enable-gate pops —
+ *  no geq, composable, cheap when nested. */
+type RenderMode = "premium" | "light";
+type AnimConfig = {
+    renderMode: RenderMode;
+    introFrac: number;
+    countUp: boolean;
+    easing: EaseName;
+    reduceMotion: boolean;
+};
+type ContributorTableProps = {
+    rows: ContribRow[];
+    /** Value-column headers (index-aligned to each row's `values`). */
+    columns: string[];
+    title?: string;
+    subtitle?: string;
+    /** Alpine theme variant (light default; "dark" = the night look the FFmpeg hero uses). */
+    preset?: AlpinePreset;
+    /** Show the icon + title + subtitle band (default true). Set false when composing
+     *  inside a chrome that already supplies the title — the table then fills with the
+     *  column header + rows. */
+    showHeader?: boolean;
+    /** Optional header glyph: an SVG path `d` (24×24), drawn as a mask on the icon chip. */
+    /** Friendly named header glyph (shared alpine catalog); a derived view of `iconPath`. */
+    icon?: string;
+    iconPath?: string;
+    accent?: MosaicColor;
+    backgroundColor?: MosaicColor;
+    /** How many top rows get the accent wash (default 3). */
+    topTint?: number;
+    /** Solid color the row washes blend against (default = backgroundColor if solid,
+     *  else the dark card). Set this when the surface is transparent ("black@0") but you
+     *  want the bands tuned to a specific panel color (e.g. a lighter chrome backdrop). */
+    washColor?: MosaicColor;
+    /** Per-column value color (index-aligned to `columns`). Used by the PORTRAIT
+     *  stacked-card layout to tint secondary metrics (e.g. additions green / deletions red). */
+    columnColors?: Array<MosaicColor | undefined>;
+    /** Per-column sign prefix (index-aligned to `columns`), e.g. "+" / "-". Portrait only. */
+    columnSigns?: string[];
+    anim?: AnimConfig;
+    /** Opt-in producer theming. Uses the shared alpine theme by default (light); a
+     *  producer's published tokens override it. Explicit color props still win. */
+    theme?: ThemeSourceConfig;
+    /** Dev-only layout contract: assert every row/card rendered the same size. */
+    debugLayout?: boolean;
+};
+export declare const AlpineContributorTable: MosaicTemplate<ContributorTableProps>;
+export {};