@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/calendar/calendar-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-config.d.ts","sourceRoot":"","sources":["../../../src/families/calendar/calendar-config.ts"],"names":[],"mappings":"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"}

package/dist/families/calendar/calendar-config.js

@@ -0,0 +1,386 @@
+/**
+ * `calendar` family config schemas + deterministic demo generators — PURE
+ * module (zod, the shared config, the framework-light `calendar-lib` helpers
+ * and `calendar-types` types only; no React, no component code).
+ *
+ * WHY THIS EXISTS: `registry/index.ts` statically imports
+ * `calendar-track.definitions.ts`, so everything that module imports lands in
+ * the registry's EAGER graph. While the schemas + demo payloads lived in
+ * `CalendarMonth.tsx` / `DayAgenda.tsx` / `ScheduleMatrix.tsx` /
+ * `CapacityBoard.tsx`, the definitions had to reach into those component
+ * modules to name them — which pulled all four widgets and their @adminium/ui
+ * deps into the eager chunk and left the sibling
+ * `lazy(() => import('./calendar-track-components.js'))` refs buying nothing.
+ * Holding them here (the boards/domain/media `*-config` convention) lets the
+ * definitions import metadata only, so the components stay reachable
+ * exclusively through the lazy barrel (04 §2.3, acceptance #3; enforced by
+ * `qa/chunk-budget.test.ts`).
+ *
+ * The component files re-export these symbols, so the family barrel,
+ * stories and tests keep their existing import points.
+ */
+import { z } from 'zod';
+import { ANCHOR_TODAY, ANCHOR_YEAR, PERSONA_NAMES, addDays, mulberry32, pickFrom, resolvePreset, weekDays, } from './calendar-lib.js';
+import { widgetSharedConfigSchema } from '../../registry/shared-config.js';
+const toneEnum = z.enum(['neutral', 'accent', 'pos', 'warn', 'danger', 'info']);
+// ── calendar-month (annex §5) ──────────────────────────────────────────────
+export const calendarMonthConfigSchema = widgetSharedConfigSchema.extend({
+    /** Displayed year; inferred from the events (or the demo anchor) when unset. */
+    year: z.number().int().min(1970).max(3000).optional(),
+    /** Displayed month, 0-based (0 = January). */
+    month: z.number().int().min(0).max(11).optional(),
+    /** Force the first weekday (ISO 1 = Mon … 7 = Sun); else locale-derived. */
+    firstDayOfWeek: z.number().int().min(1).max(7).optional(),
+    /** Max event chips before the day cell collapses to "+N more". */
+    maxChipsPerDay: z.number().int().min(1).max(4).default(2),
+    /** Category name → tone override map. */
+    categoryColorMap: z.record(z.string(), toneEnum).optional(),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const EVENT_POOL = [
+    { title: 'Sprint planning', category: 'meeting', time: '09:00' },
+    { title: 'Design review', category: 'meeting', time: '11:30' },
+    { title: 'Release v2.4', category: 'release', time: '15:00' },
+    { title: 'Contract deadline', category: 'deadline', time: '17:00' },
+    { title: 'All-hands', category: 'meeting', time: '14:00' },
+    { title: 'Security audit', category: 'deadline' },
+    { title: 'Marketing launch', category: 'release', time: '10:00' },
+    { title: 'Team offsite', category: 'event' },
+    { title: '1:1 sync', category: 'meeting', time: '13:00' },
+    { title: 'Data migration', category: 'deadline', time: '22:00' },
+];
+/** Deterministic `calendar-events` payload anchored to the demo month (04 §7.7). */
+export function calendarMonthDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const events = [];
+    const count = 10 + Math.floor(random() * 8);
+    for (let i = 0; i < count; i += 1) {
+        const day = 1 + Math.floor(random() * 28);
+        const pick = pickFrom(random, EVENT_POOL);
+        events.push({
+            id: i + 1,
+            date: `${ANCHOR_YEAR}-07-${String(day).padStart(2, '0')}`,
+            title: pick.title,
+            category: pick.category,
+            ...(('time' in pick) ? { time: pick.time } : {}),
+        });
+    }
+    return { events };
+}
+// ── day-agenda (annex §5) ──────────────────────────────────────────────────
+export const dayAgendaConfigSchema = widgetSharedConfigSchema.extend({
+    /** Selected ISO day; inferred from the events (or the demo anchor) when unset. */
+    date: z.string().optional(),
+    /** Agenda span: a single day or the whole (locale-aligned) week. */
+    range: z.enum(['day', 'week']).default('day'),
+    /** Force the first weekday for week mode (ISO 1 = Mon … 7 = Sun). */
+    firstDayOfWeek: z.number().int().min(1).max(7).optional(),
+    showCount: z.boolean().default(true),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const AGENDA_POOL = [
+    { title: 'Standup', category: 'meeting', time: '09:00', end: '09:15' },
+    { title: 'Design critique', category: 'meeting', time: '10:30', end: '11:30' },
+    { title: 'Customer call', category: 'meeting', time: '13:00', end: '13:45' },
+    { title: 'Release cutoff', category: 'deadline', time: '17:00' },
+    { title: 'Roadmap review', category: 'meeting', time: '15:00', end: '16:00' },
+    { title: 'Deploy window', category: 'release', time: '22:00', end: '23:00' },
+    { title: 'Docs due', category: 'deadline' },
+    { title: 'Lunch & learn', category: 'event', time: '12:00', end: '13:00' },
+];
+/** Deterministic single-day `calendar-events` payload for the demo anchor day. */
+export function dayAgendaDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const count = 3 + Math.floor(random() * 4);
+    const events = [];
+    const used = new Set();
+    for (let i = 0; i < count; i += 1) {
+        let index = Math.floor(random() * AGENDA_POOL.length);
+        for (let guard = 0; guard < AGENDA_POOL.length && used.has(index); guard += 1) {
+            index = (index + 1) % AGENDA_POOL.length;
+        }
+        used.add(index);
+        const pick = AGENDA_POOL[index] ?? pickFrom(random, AGENDA_POOL);
+        events.push({
+            id: i + 1,
+            date: ANCHOR_TODAY,
+            title: pick.title,
+            category: pick.category,
+            ...(('time' in pick) ? { time: pick.time } : {}),
+            ...(('end' in pick) ? { end: pick.end } : {}),
+        });
+    }
+    return { events };
+}
+// ── schedule-matrix (annex §5) ─────────────────────────────────────────────
+export const scheduleMatrixConfigSchema = widgetSharedConfigSchema.extend({
+    /** Force the first weekday (ISO 1 = Mon … 7 = Sun); else locale-derived. */
+    weekStart: z.number().int().min(1).max(7).optional(),
+    /** Max shift chips before a day cell collapses to "+N". */
+    maxPerCell: z.number().int().min(1).max(3).default(2),
+    /** Target coverage per day used for the coverage micro-bars. */
+    targetCoverage: z.number().int().min(1).max(20).optional(),
+    showCoverage: z.boolean().default(true),
+    showLegend: z.boolean().default(true),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const SHIFT_TYPES = [
+    { id: 'morning', label: 'Morning', start: '06:00', end: '14:00', hours: 8, tone: 'accent' },
+    { id: 'day', label: 'Day', start: '09:00', end: '17:00', hours: 8, tone: 'info' },
+    { id: 'evening', label: 'Evening', start: '14:00', end: '22:00', hours: 8, tone: 'pos' },
+    { id: 'night', label: 'Night', start: '22:00', end: '06:00', hours: 8, tone: 'warn' },
+];
+/** Deterministic resource-schedule `record-list` payload for the demo week (04 §7.7). */
+export function scheduleMatrixDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const resources = PERSONA_NAMES.slice(0, 6).map((name, i) => ({
+        id: `r-${i + 1}`,
+        name,
+        role: ['Barista', 'Shift lead', 'Server', 'Cook', 'Host', 'Cashier'][i] ?? 'Staff',
+    }));
+    const week = weekDays(`${ANCHOR_YEAR}-07-13`, 0); // anchor week starting Sunday
+    const days = week.map((d) => d.key);
+    const assignments = [];
+    for (const resource of resources) {
+        for (const day of days) {
+            // ~65% chance of a shift; occasionally two on a day.
+            if (random() < 0.65) {
+                assignments.push({ resourceId: resource.id, date: day, typeId: SHIFT_TYPES[Math.floor(random() * SHIFT_TYPES.length)].id });
+                if (random() < 0.15) {
+                    assignments.push({ resourceId: resource.id, date: day, typeId: SHIFT_TYPES[Math.floor(random() * SHIFT_TYPES.length)].id });
+                }
+            }
+        }
+    }
+    return { rows: resources, total: resources.length, days, shiftTypes: SHIFT_TYPES, assignments };
+}
+// ── capacity-board (annex §5) ──────────────────────────────────────────────
+export const capacityBoardConfigSchema = widgetSharedConfigSchema.extend({
+    /** Hours of capacity per period (the 100% mark). */
+    capacity: z.number().int().min(1).max(400).default(40),
+    period: z.enum(['week', 'month']).default('week'),
+    /** Below this util % a member is "Available". */
+    availableBelow: z.number().int().min(1).max(100).default(75),
+    /** Above this util % a member is "Overloaded". */
+    overloadedAbove: z.number().int().min(1).max(300).default(100),
+    showLegend: z.boolean().default(true),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const PROJECTS = [
+    { name: 'Platform', tone: 'accent' },
+    { name: 'Mobile app', tone: 'info' },
+    { name: 'Data migration', tone: 'pos' },
+    { name: 'Infra', tone: 'warn' },
+    { name: 'Redesign', tone: 'danger' },
+];
+/** Deterministic member-capacity `record-list` payload (04 §7.7). */
+export function capacityBoardDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const rows = PERSONA_NAMES.slice(0, 6).map((name, i) => {
+        const projectCount = 1 + Math.floor(random() * 3);
+        const assignments = [];
+        const used = new Set();
+        for (let p = 0; p < projectCount; p += 1) {
+            let index = Math.floor(random() * PROJECTS.length);
+            for (let guard = 0; guard < PROJECTS.length && used.has(index); guard += 1)
+                index = (index + 1) % PROJECTS.length;
+            used.add(index);
+            const project = PROJECTS[index];
+            assignments.push({ project: project.name, hours: 6 + Math.floor(random() * 16), tone: project.tone });
+        }
+        return {
+            id: `m-${i + 1}`,
+            name,
+            role: ['Engineer', 'Designer', 'PM', 'Engineer', 'Analyst', 'Engineer'][i] ?? 'Contributor',
+            assignments,
+        };
+    });
+    return { rows, total: rows.length };
+}
+// ── calendar-legend-filter (annex §5) ──────────────────────────────────────
+export const calendarLegendFilterConfigSchema = widgetSharedConfigSchema.extend({
+    /** Toggling a category filters the sibling calendar (annex `toggleable`). */
+    toggleable: z.boolean().default(true),
+    /** Rows (checkbox + label + count) or a compact chip strip (annex "rows or chips"). */
+    variant: z.enum(['rows', 'chips']).default('rows'),
+    /** Category name → tone override map, shared with `calendar-month`. */
+    categoryColorMap: z.record(z.string(), toneEnum).optional(),
+    /** Categories hidden on first render; the rest start checked. */
+    defaultHidden: z.array(z.string()).default([]),
+    /**
+     * Sibling calendar instance this legend filters (annex: "toggling filters the
+     * calendar"). The widget emits the hidden set; the host owns the cross-widget
+     * wiring — a widget never reaches into another widget.
+     */
+    linkTarget: z.string().optional(),
+    /** Bucket label for events with no category. */
+    uncategorizedLabel: z.string().optional(),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const LEGEND_POOL = [
+    { title: 'Sprint planning', category: 'meeting' },
+    { title: 'Release v2.4', category: 'release' },
+    { title: 'Contract deadline', category: 'deadline' },
+    { title: 'Team offsite', category: 'event' },
+    { title: 'Maintenance window', category: 'maintenance' },
+];
+/**
+ * Deterministic `calendar-events` payload the legend aggregates (04 §7.7). Same
+ * contract as `calendar-month` — the legend is a VIEW of the calendar's events,
+ * not a second query, so it binds to the identical payload.
+ */
+export function calendarLegendFilterDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const count = 12 + Math.floor(random() * 10);
+    const events = [];
+    for (let i = 0; i < count; i += 1) {
+        const pick = pickFrom(random, LEGEND_POOL);
+        const day = 1 + Math.floor(random() * 28);
+        events.push({
+            id: i + 1,
+            date: `${ANCHOR_YEAR}-07-${String(day).padStart(2, '0')}`,
+            title: pick.title,
+            category: pick.category,
+        });
+    }
+    return { events };
+}
+// ── upcoming-events-list (annex §5) ────────────────────────────────────────
+export const upcomingEventsListConfigSchema = widgetSharedConfigSchema.extend({
+    /** Next-N events (annex `n`). */
+    n: z.number().int().min(1).max(50).default(6),
+    /** Category name → tone override map (drives the row's start border). */
+    categoryColorMap: z.record(z.string(), toneEnum).optional(),
+    showOwner: z.boolean().default(true),
+    showStatus: z.boolean().default(true),
+    /**
+     * Reference day (`YYYY-MM-DD`) for the "date ≥ today" cutoff. Unset → the
+     * shared `format.referenceTime` clock, else the wall clock. Pinning it is what
+     * makes a VRT capture of this widget byte-stable (04 §7.7).
+     */
+    fromDate: z.string().optional(),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const RELEASE_POOL = [
+    { title: 'Billing service', category: 'release', status: 'Scheduled', statusTone: 'info' },
+    { title: 'Dashboard redesign', category: 'release', status: 'At risk', statusTone: 'warn' },
+    { title: 'Search reindex', category: 'maintenance', status: 'Scheduled', statusTone: 'info' },
+    { title: 'SSO rollout', category: 'release', status: 'Blocked', statusTone: 'danger' },
+    { title: 'Quarterly review', category: 'meeting', status: 'Confirmed', statusTone: 'pos' },
+    { title: 'Data retention sweep', category: 'maintenance', status: 'Scheduled', statusTone: 'info' },
+    { title: 'API v2 deprecation', category: 'deadline', status: 'Confirmed', statusTone: 'pos' },
+    { title: 'Mobile hotfix', category: 'release', status: 'Scheduled', statusTone: 'info' },
+];
+/**
+ * Deterministic forward-looking `calendar-events` payload (04 §7.7). Every event
+ * lands on or after the demo anchor day so the widget's "date ≥ today" cutoff
+ * keeps rows on screen for a story/VRT capture pinned to the anchor.
+ */
+export function upcomingEventsListDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    let day = ANCHOR_TODAY;
+    const events = RELEASE_POOL.map((pick, index) => {
+        day = addDays(day, index === 0 ? 0 : 1 + Math.floor(random() * 6));
+        return {
+            id: index + 1,
+            date: day,
+            title: pick.title,
+            category: pick.category,
+            time: `${String(9 + Math.floor(random() * 9)).padStart(2, '0')}:00`,
+            ref: `v${2 + Math.floor(random() * 2)}.${index}.0`,
+            owner: pickFrom(random, PERSONA_NAMES),
+            status: pick.status,
+            statusTone: pick.statusTone,
+        };
+    });
+    return { events };
+}
+// ── date-range-picker (annex §5) ───────────────────────────────────────────
+const rangePresetSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    days: z.number().int().min(1).max(3650).optional(),
+    anchor: z.enum(['mtd', 'qtd', 'ytd']).optional(),
+});
+export const dateRangePickerConfigSchema = widgetSharedConfigSchema.extend({
+    /**
+     * Quick presets (annex `presets`). Labels are host-translated strings, the
+     * same contract the boards family's announcements use — unset falls back to
+     * the family's English `DEFAULT_RANGE_PRESETS`.
+     */
+    presets: z.array(rangePresetSchema).optional(),
+    /** Max selectable span in days (annex `maxRange`); longer picks are clamped. */
+    maxRange: z.number().int().min(1).max(3650).optional(),
+    /** Force the first weekday (ISO 1 = Mon … 7 = Sun); else locale-derived. */
+    firstDayOfWeek: z.number().int().min(1).max(7).optional(),
+    /** Reference "today" (`YYYY-MM-DD`) the presets resolve against. */
+    referenceDate: z.string().optional(),
+    showPresets: z.boolean().default(true),
+    showSummary: z.boolean().default(true),
+});
+/**
+ * Deterministic `form-state` payload — a resolved day pair (04 §7.7). The seed
+ * picks which default preset the demo lands on, so the payload threads its seed
+ * (the determinism gate) while every value stays anchored to the fixed demo
+ * epoch rather than a wall-clock read.
+ */
+export function dateRangePickerDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const spans = [7, 14, 30, 90];
+    const days = pickFrom(random, spans);
+    const { start, end } = resolvePreset({ days }, ANCHOR_TODAY);
+    return { value: { start, end } };
+}
+// ── scheduled-jobs-list (annex §5) ─────────────────────────────────────────
+export const scheduledJobsListConfigSchema = widgetSharedConfigSchema.extend({
+    /** Row field driving the on/off switch (annex `toggleField`). */
+    toggleField: z.string().default('enabled'),
+    /** Row-mapping overrides (annex `rowMapping`) — the source column per slot. */
+    nameField: z.string().default('name'),
+    targetField: z.string().default('target'),
+    frequencyField: z.string().default('frequency'),
+    formatField: z.string().default('format'),
+    nextRunField: z.string().default('next'),
+    recipientsField: z.string().default('recipients'),
+    /** Render the on/off switch (annex); read-only pages hide it. */
+    toggleable: z.boolean().default(true),
+    showRecipients: z.boolean().default(true),
+    nextRunLabel: z.string().optional(),
+    toggleLabel: z.string().optional(),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+const JOB_POOL = [
+    { name: 'Weekly revenue digest', target: 'public.invoices', frequency: 'Every Monday at 09:00', format: 'PDF' },
+    { name: 'Churn cohort export', target: 'public.subscriptions', frequency: 'Every 1st of the month', format: 'CSV' },
+    { name: 'Support SLA report', target: 'public.tickets', frequency: 'Every weekday at 08:00', format: 'XLSX' },
+    { name: 'Audit log archive', target: 'public.audit_log', frequency: 'Every day at 02:00', format: 'CSV' },
+    { name: 'Signup funnel snapshot', target: 'public.sessions', frequency: 'Every Friday at 17:00', format: 'PDF' },
+    { name: 'Inventory reconciliation', target: 'public.products', frequency: 'Every 6 hours', format: 'CSV' },
+];
+/** Deterministic recurring-job `record-list` payload (04 §7.7). */
+export function scheduledJobsListDemoData(seed) {
+    const random = mulberry32(seed || 1);
+    const rows = JOB_POOL.map((job, index) => {
+        const recipientCount = 1 + Math.floor(random() * 3);
+        return {
+            id: `job-${index + 1}`,
+            name: job.name,
+            target: job.target,
+            frequency: job.frequency,
+            format: job.format,
+            // Fixed epoch, never `Date.now()` — the anchor day plus a seeded offset.
+            next: `${addDays(ANCHOR_TODAY, 1 + Math.floor(random() * 7))}T09:00:00.000Z`,
+            enabled: random() > 0.25,
+            recipients: PERSONA_NAMES.slice(0, recipientCount).map((name) => name),
+        };
+    });
+    return { rows, total: rows.length };
+}
+//# sourceMappingURL=calendar-config.js.map

package/dist/families/calendar/calendar-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-config.js","sourceRoot":"","sources":["../../../src/families/calendar/calendar-config.ts"],"names":[],"mappings":"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"}

package/dist/families/calendar/calendar-lib.d.ts

@@ -0,0 +1,200 @@
+import type { Tone } from '@adminium/ui';
+/**
+ * Shared helpers for the `calendar` family (annex §5) — a deterministic seeded
+ * PRNG for `demoData`, tone coercion, and the locale-aware date machinery every
+ * calendar widget needs: a 42-cell month grid, locale-aware week start (via the
+ * @adminium/i18n `weekInfo` layer, never a hardcoded Sunday/Monday), weekday
+ * headers, and Intl-routed date/time/number formatting.
+ *
+ * Numeral policy (10-i18n-theming.md §4.2): calendar day numbers, times, and
+ * the month/year title are *data-context* strings → Latin digits + gregorian
+ * (`latnDataTag`) so the grid stays `tabular-nums`-aligned in every locale
+ * including `ar_EG`. Weekday/month NAMES localize to the locale's script.
+ *
+ * Kept framework-light (no i18n provider dependency), like the `feeds` family —
+ * widgets render in stories/tests without a wrapper and the dashboard resolves
+ * label overrides through @adminium/i18n at the host boundary (04 §2).
+ */
+/** Mulberry32 — the repo's deterministic seeded PRNG (see feeds/tables). */
+export declare function mulberry32(seed: number): () => number;
+/** Deterministic pick from a non-empty tuple. */
+export declare function pickFrom<T>(random: () => number, items: readonly T[]): T;
+/**
+ * Coalesce an empty/whitespace locale to `en-US`. `getFormatters` already
+ * normalizes an empty tag, but a schema-valid `format.locale: ''` reaches
+ * `Avatar`'s `String#toLocaleUpperCase('')`, which throws
+ * `RangeError: Incorrect locale information provided` — so widgets normalize the
+ * tag once, at the boundary, before any locale-sensitive call.
+ */
+export declare function resolveLocale(locale: string | undefined): string;
+/** The `connectionId` + qualified table a `record-open`/`mutate` event carries. */
+export interface BindingSource {
+    connectionId: string;
+    table: string;
+}
+/**
+ * The event target for a bound widget: `connectionId` + the schema-qualified
+ * table name, or `null` when the widget is running on `demoData` (no binding) —
+ * an unbound widget must never emit a mutation against a table that isn't there
+ * (the tables/CardGallery + boards + media convention).
+ *
+ * NB the descriptor is `binding.source.name` (+ optional `schema`), NOT a flat
+ * `binding.table` (04 §5.1).
+ */
+export declare function bindingSourceOf(binding: {
+    connectionId: string;
+    source: {
+        schema?: string | undefined;
+        name: string;
+    };
+} | undefined): BindingSource | null;
+/** Persona names (BRIEF §4) for the resource/member scheduling widgets. */
+export declare const PERSONA_NAMES: readonly ["Ada Lovelace", "Grace Hopper", "Alan Turing", "Katherine Johnson", "Edsger Dijkstra", "Barbara Liskov", "Donald Knuth", "Radia Perlman"];
+/**
+ * Fixed demo anchor month — July 2026 (matches the repo's `DEMO_EPOCH`), so
+ * `demoData(seed)` is byte-identical across runs and never touches `Date.now()`
+ * (04 §7.7). `ANCHOR_TODAY` is the "today" a story/VRT capture can pin for the
+ * today-ring without a wall-clock read.
+ */
+export declare const ANCHOR_YEAR = 2026;
+export declare const ANCHOR_MONTH = 6;
+export declare const ANCHOR_TODAY = "2026-07-15";
+/**
+ * Tone → colored inline-start border + soft tint + tone text. Paired with a
+ * `border-s-2`/`border-s-4` width utility on the element (`border-{tone}`
+ * colors all sides, only the start side has width → a start accent bar that
+ * mirrors under RTL). Shared by the event chips and shift chips.
+ */
+export declare const TONE_SOFT_BORDER: Record<Tone, string>;
+/** Tone → border color only (for a colored side bar over a plain surface). */
+export declare const TONE_BORDER: Record<Tone, string>;
+/** Tone → solid background (utilization segments, dots). */
+export declare const TONE_SOLID_BG: Record<Tone, string>;
+/** Coerce an untrusted tone string to a valid `Tone`, defaulting as given. */
+export declare function toneOf(value: unknown, fallback?: Tone): Tone;
+/** Stable FNV-1a-ish hash of a string → index into a palette. */
+export declare function hashIndex(value: string, modulo: number): number;
+/** Tone for a category, honoring an explicit map, else a stable hashed cycle. */
+export declare function categoryTone(category: string | undefined, map?: Record<string, string> | undefined): Tone;
+/** `YYYY-MM-DD` key for a UTC date. */
+export declare function isoDayKey(date: Date): string;
+/** UTC midnight `Date` from a `YYYY-MM-DD` (or full ISO) string. */
+export declare function parseIsoDay(value: string): Date;
+/** The `Date` for an event's start instant (date + optional `HH:MM` time), UTC. */
+export declare function eventInstant(event: {
+    date: string;
+    time?: string | undefined;
+}): Date;
+/** Locale's first day of the week as a JS weekday (0 = Sun … 6 = Sat). */
+export declare function firstJsWeekday(tag: string, override?: number | undefined): number;
+export interface MonthCell {
+    /** `YYYY-MM-DD`. */
+    key: string;
+    date: Date;
+    /** Day-of-month (1–31). */
+    day: number;
+    /** Belongs to the displayed month (vs. leading/trailing spill days). */
+    inMonth: boolean;
+    /** JS weekday (0 = Sun … 6 = Sat). */
+    weekday: number;
+}
+/**
+ * The 42-cell (6 week × 7 day) month grid for `year`/`monthIndex` (0-based),
+ * starting on the locale's first weekday (or an explicit ISO `firstDayOverride`).
+ * Leading/trailing cells spill into the neighboring months (`inMonth: false`).
+ */
+export declare function monthGrid(year: number, monthIndex: number, firstJs: number): MonthCell[];
+/** The seven days of the week starting `startJs`, as ISO dates for a reference week. */
+export declare function weekDays(startIso: string, firstJs: number): {
+    key: string;
+    date: Date;
+    weekday: number;
+}[];
+/** Localized day number (Latin digits, data context — `tabular-nums` safe). */
+export declare function fmtDayNumber(tag: string, day: number): string;
+/** "July 2026" — month long + numeric year, locale-scripted names, latn digits. */
+export declare function fmtMonthTitle(tag: string, date: Date): string;
+/**
+ * Seven short weekday header labels, ordered from the locale's first weekday.
+ * `firstJs` is a JS weekday (0 = Sun … 6 = Sat); reference week anchored on a
+ * known Sunday (2023-01-01) so the names are stable and TZ-independent.
+ */
+export declare function weekdayHeaders(tag: string, firstJs: number): string[];
+/** "Wednesday, July 15" — weekday + month + day for the agenda header. */
+export declare function fmtDayLabel(tag: string, date: Date): string;
+/** Short weekday + day for compact column headers ("Wed 15"). */
+export declare function fmtColumnDay(tag: string, date: Date): {
+    weekday: string;
+    day: string;
+};
+/** Event start time ("9:00 AM" / "٩:٠٠…") via the Intl layer, pinned to UTC. */
+export declare function fmtEventTime(tag: string, event: {
+    date: string;
+    time?: string | undefined;
+}): string;
+/** Short month name for the `upcoming-events-list` date block ("Jul", "يوليو"). */
+export declare function fmtMonthShort(tag: string, date: Date): string;
+/**
+ * A job's next-run instant ("Jul 20, 09:00"). Data context via the Intl layer —
+ * `getFormatters` already pins latn digits + gregorian for it, so callers must
+ * NOT also wrap the tag in `latnDataTag`.
+ */
+export declare function fmtNextRun(tag: string, iso: string): string;
+/**
+ * Aggregate a `calendar-events` payload into legend categories with counts
+ * (annex §5: "categories aggregated from events"). Order is first-seen so the
+ * legend is stable across renders and locales; uncategorized events bucket under
+ * `fallback` rather than vanishing from the counts.
+ */
+export declare function aggregateCategories(events: readonly {
+    category?: string | undefined;
+    tone?: string | undefined;
+}[], map?: Record<string, string> | undefined, fallback?: string): {
+    name: string;
+    count: number;
+    tone: Tone;
+}[];
+/**
+ * Events at or after `fromKey` (`YYYY-MM-DD`), date-then-time ascending, capped
+ * at `n` — the annex's "events WHERE date ≥ today ORDER BY date LIMIT n".
+ *
+ * The cutoff is a DAY key, not an instant: an event earlier today is still
+ * "upcoming" until the day rolls over, which is what the Release Calendar comp
+ * shows (today's release stays on the list all day).
+ */
+export declare function upcomingFrom<T extends {
+    date: string;
+    time?: string | undefined;
+}>(events: readonly T[], fromKey: string, n: number): T[];
+/** `YYYY-MM-DD` `days` after (or, negative, before) an ISO day. */
+export declare function addDays(key: string, days: number): string;
+/** Inclusive day-key range test — string compare is safe for `YYYY-MM-DD`. */
+export declare function isInRange(key: string, start: string | null, end: string | null): boolean;
+/** Whole days between two day keys, inclusive of both endpoints. */
+export declare function daysBetween(start: string, end: string): number;
+/**
+ * The default quick presets (annex §5: "quick presets (7d/30d/QTD…)"). Labels
+ * are ENGLISH DEFAULTS: widgets are locale-agnostic and the host passes
+ * translated labels through config, the same contract as the boards family's
+ * announcements (04 §2).
+ */
+export declare const DEFAULT_RANGE_PRESETS: readonly {
+    id: string;
+    label: string;
+    days?: number;
+    anchor?: 'mtd' | 'qtd' | 'ytd';
+}[];
+/**
+ * Resolve a preset against a reference day (`YYYY-MM-DD`) into an inclusive day
+ * pair. `days: 7` means "the last 7 days INCLUDING today" (today − 6 … today),
+ * which is what the comps' "Last 7 days" summary counts — an off-by-one here
+ * silently shifts every bound query the picker feeds.
+ */
+export declare function resolvePreset(preset: {
+    days?: number | undefined;
+    anchor?: 'mtd' | 'qtd' | 'ytd' | undefined;
+}, referenceKey: string): {
+    start: string;
+    end: string;
+};
+//# sourceMappingURL=calendar-lib.d.ts.map

package/dist/families/calendar/calendar-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-lib.d.ts","sourceRoot":"","sources":["../../../src/families/calendar/calendar-lib.ts"],"names":[],"mappings":"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"}