@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/calendar/ScheduleMatrix.d.ts

@@ -0,0 +1,37 @@
+import type { ScheduleMatrixConfig } from './calendar-config.js';
+import type { ScheduleMatrixData } from './calendar-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { scheduleMatrixConfigSchema, scheduleMatrixDemoData } from './calendar-config.js';
+export type { ScheduleMatrixConfig } from './calendar-config.js';
+/**
+ * `schedule-matrix` (annex §5) — the resource-scheduling grid: rows = people
+ * (avatar, role, total hours), columns = days, cells hold up to N type-colored
+ * shift chips, with per-day coverage micro-bars (danger at zero) and a shift-type
+ * legend strip. The first (resource) column and the day columns are a single
+ * logical CSS grid that mirrors under `dir="rtl"`. Binds to a `record-list` of
+ * resources plus an assignments matrix + shift-type metadata.
+ */
+/**
+ * Reorder a week's day columns so the first column is the given ISO weekday
+ * (1 = Mon … 7 = Sun). Rotation preserves the run of consecutive days; the
+ * days that fall before the chosen start wrap to the end (Monday-first, etc.).
+ */
+export declare function orderDaysByWeekStart(days: readonly string[], weekStart?: number | undefined): readonly string[];
+export interface ScheduleMatrixProps {
+    data: ScheduleMatrixData;
+    /** Force the first weekday column (ISO 1 = Mon … 7 = Sun); else server order. */
+    weekStart?: number | undefined;
+    maxPerCell?: number | undefined;
+    targetCoverage?: number | undefined;
+    showCoverage?: boolean | undefined;
+    showLegend?: boolean | undefined;
+    locale?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function ScheduleMatrix({ data, weekStart, maxPerCell, targetCoverage, showCoverage, showLegend, locale, emptyTitle, emptyBody, testId, }: ScheduleMatrixProps): import("react").JSX.Element;
+/** Tolerant read of the schedule `record-list` envelope. */
+export declare function scheduleDataOf(data: unknown): ScheduleMatrixData;
+export declare function ScheduleMatrixWidget({ config, data }: WidgetProps<ScheduleMatrixConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ScheduleMatrix.d.ts.map

package/dist/families/calendar/ScheduleMatrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleMatrix.d.ts","sourceRoot":"","sources":["../../../src/families/calendar/ScheduleMatrix.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAEV,kBAAkB,EAGnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAM/G;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAMD,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,SAAS,EACT,UAAc,EACd,cAAc,EACd,YAAmB,EACnB,UAAiB,EACjB,MAAM,EACN,UAAU,EACV,SAAS,EACT,MAAM,GACP,EAAE,mBAAmB,+BA0JrB;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAShE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAcvF"}

package/dist/families/calendar/ScheduleMatrix.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getFormatters } from '@adminium/i18n';
+import { Avatar, EmptyState, MonoText } from '@adminium/ui';
+import { useMemo } from 'react';
+import { TONE_SOFT_BORDER, TONE_SOLID_BG, fmtColumnDay, parseIsoDay, resolveLocale, toneOf, } from './calendar-lib.js';
+// Config schema + deterministic demo payload live in the pure `calendar-config`
+// module so the registry metadata graph never reaches this component file
+// (04 §2.3). Re-exported here to keep existing import points stable.
+export { scheduleMatrixConfigSchema, scheduleMatrixDemoData } from './calendar-config.js';
+/**
+ * `schedule-matrix` (annex §5) — the resource-scheduling grid: rows = people
+ * (avatar, role, total hours), columns = days, cells hold up to N type-colored
+ * shift chips, with per-day coverage micro-bars (danger at zero) and a shift-type
+ * legend strip. The first (resource) column and the day columns are a single
+ * logical CSS grid that mirrors under `dir="rtl"`. Binds to a `record-list` of
+ * resources plus an assignments matrix + shift-type metadata.
+ */
+/**
+ * Reorder a week's day columns so the first column is the given ISO weekday
+ * (1 = Mon … 7 = Sun). Rotation preserves the run of consecutive days; the
+ * days that fall before the chosen start wrap to the end (Monday-first, etc.).
+ */
+export function orderDaysByWeekStart(days, weekStart) {
+    if (weekStart === undefined || days.length === 0)
+        return days;
+    const isoWeekday = (iso) => ((parseIsoDay(iso).getUTCDay() + 6) % 7) + 1;
+    const start = days.findIndex((day) => isoWeekday(day) === weekStart);
+    if (start <= 0)
+        return days;
+    return [...days.slice(start), ...days.slice(0, start)];
+}
+function keyOf(resourceId, date) {
+    return `${resourceId}|${date}`;
+}
+export function ScheduleMatrix({ data, weekStart, maxPerCell = 2, targetCoverage, showCoverage = true, showLegend = true, locale, emptyTitle, emptyBody, testId, }) {
+    const tag = resolveLocale(locale);
+    const fmt = getFormatters(tag);
+    const { rows: resources, shiftTypes, assignments } = data;
+    const days = useMemo(() => orderDaysByWeekStart(data.days, weekStart), [data.days, weekStart]);
+    const typeById = useMemo(() => {
+        const map = new Map();
+        for (const type of shiftTypes)
+            map.set(type.id, type);
+        return map;
+    }, [shiftTypes]);
+    const cellIndex = useMemo(() => {
+        const map = new Map();
+        for (const assignment of assignments) {
+            const key = keyOf(assignment.resourceId, assignment.date);
+            const list = map.get(key);
+            if (list === undefined)
+                map.set(key, [assignment]);
+            else
+                list.push(assignment);
+        }
+        return map;
+    }, [assignments]);
+    const hoursByResource = useMemo(() => {
+        const map = new Map();
+        for (const assignment of assignments) {
+            const hours = typeById.get(assignment.typeId)?.hours ?? 0;
+            map.set(assignment.resourceId, (map.get(assignment.resourceId) ?? 0) + hours);
+        }
+        return map;
+    }, [assignments, typeById]);
+    const coverageByDay = useMemo(() => {
+        const map = new Map();
+        for (const day of days)
+            map.set(day, 0);
+        for (const assignment of assignments) {
+            if (map.has(assignment.date))
+                map.set(assignment.date, (map.get(assignment.date) ?? 0) + 1);
+        }
+        return map;
+    }, [assignments, days]);
+    if (resources.length === 0 || days.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "nothing-scheduled", title: emptyTitle ?? 'No shifts scheduled', body: emptyBody ?? 'Assigned shifts will appear on this schedule.' }));
+    }
+    const target = targetCoverage ?? Math.max(1, Math.ceil(resources.length / 2));
+    const gridCols = `minmax(9rem,1.4fr) repeat(${days.length}, minmax(4.5rem,1fr))`;
+    return (_jsxs("div", { "data-widget": "schedule-matrix", "data-testid": testId, className: "flex h-full flex-col overflow-auto", children: [_jsxs("div", { role: "table", className: "min-w-full", children: [_jsxs("div", { role: "row", className: "sticky top-0 z-[1] grid items-end gap-1 border-b border-border bg-surface-2 px-2 py-2 grid-cols-[var(--adm-cols)]", style: { '--adm-cols': gridCols }, children: [_jsx("span", { className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: "Resource" }), days.map((day) => {
+                                const label = fmtColumnDay(tag, parseIsoDay(day));
+                                return (_jsxs("div", { role: "columnheader", className: "text-center", children: [_jsx("div", { className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: label.weekday }), _jsx(MonoText, { className: "text-caption tabular-nums text-fg-muted", children: label.day })] }, day));
+                            })] }), resources.map((resource) => (_jsxs("div", { role: "row", className: "grid items-stretch gap-1 border-b border-border/50 px-2 py-1.5 grid-cols-[var(--adm-cols)] hover:bg-surface-2/50", style: { '--adm-cols': gridCols }, children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(Avatar, { name: resource.name, size: "sm", locale: tag }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate text-caption font-semibold text-fg", children: resource.name }), _jsxs("p", { className: "truncate text-[10px] text-fg-subtle", children: [resource.role, " \u00B7 ", _jsxs(MonoText, { className: "tabular-nums", children: [fmt.number(hoursByResource.get(resource.id) ?? 0), "h"] })] })] })] }), days.map((day) => {
+                                const cell = cellIndex.get(keyOf(resource.id, day)) ?? [];
+                                const shown = cell.slice(0, maxPerCell);
+                                const overflow = cell.length - shown.length;
+                                return (_jsxs("div", { className: "flex flex-col gap-0.5", role: "cell", children: [shown.map((assignment, i) => {
+                                            const type = typeById.get(assignment.typeId);
+                                            const tone = toneOf(type?.tone, 'accent');
+                                            return (_jsx("span", { title: type === undefined ? assignment.typeId : `${type.label} · ${type.start}–${type.end}`, className: `truncate rounded-e-sm border-s-2 px-1 py-px text-[10px] font-semibold leading-tight ${TONE_SOFT_BORDER[tone]}`, children: type?.label ?? assignment.typeId }, i));
+                                        }), overflow > 0 && _jsxs("span", { className: "text-[10px] font-semibold text-fg-subtle", children: ["+", fmt.number(overflow)] })] }, day));
+                            })] }, resource.id))), showCoverage && (_jsxs("div", { role: "row", className: "grid items-center gap-1 border-t border-border bg-surface-2/40 px-2 py-2 grid-cols-[var(--adm-cols)]", style: { '--adm-cols': gridCols }, children: [_jsx("span", { className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: "Coverage" }), days.map((day) => {
+                                const count = coverageByDay.get(day) ?? 0;
+                                const pct = Math.min(100, Math.round((count / target) * 100));
+                                const tone = count === 0 ? 'danger' : count >= target ? 'pos' : 'warn';
+                                return (_jsxs("div", { className: "flex flex-col items-center gap-1", title: `${count}/${target}`, children: [_jsx("div", { className: "h-1.5 w-full overflow-hidden rounded-full bg-surface-3", children: _jsx("div", { className: `h-full w-[var(--cov)] rounded-full ${TONE_SOLID_BG[tone]}`, style: { '--cov': `${pct}%` } }) }), _jsx(MonoText, { className: "text-[10px] tabular-nums text-fg-subtle", children: fmt.number(count) })] }, day));
+                            })] }))] }), showLegend && (_jsx("div", { className: "flex flex-wrap items-center gap-x-4 gap-y-1 border-t border-border px-3 py-2", children: shiftTypes.map((type) => (_jsxs("span", { className: "flex items-center gap-1.5 text-caption text-fg-muted", children: [_jsx("span", { className: `size-2 shrink-0 rounded-full ${TONE_SOLID_BG[toneOf(type.tone, 'accent')]}`, "aria-hidden": "true" }), type.label, _jsxs(MonoText, { className: "tabular-nums text-fg-subtle", children: [type.start, "\u2013", type.end] })] }, type.id))) }))] }));
+}
+/** Tolerant read of the schedule `record-list` envelope. */
+export function scheduleDataOf(data) {
+    const source = (typeof data === 'object' && data !== null ? data : {});
+    return {
+        rows: Array.isArray(source.rows) ? source.rows : [],
+        total: typeof source.total === 'number' ? source.total : (source.rows?.length ?? 0),
+        days: Array.isArray(source.days) ? source.days : [],
+        shiftTypes: Array.isArray(source.shiftTypes) ? source.shiftTypes : [],
+        assignments: Array.isArray(source.assignments) ? source.assignments : [],
+    };
+}
+export function ScheduleMatrixWidget({ config, data }) {
+    return (_jsx(ScheduleMatrix, { data: scheduleDataOf(data), ...(config.weekStart === undefined ? {} : { weekStart: config.weekStart }), maxPerCell: config.maxPerCell, ...(config.targetCoverage === undefined ? {} : { targetCoverage: config.targetCoverage }), showCoverage: config.showCoverage, showLegend: config.showLegend, ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }) }));
+}
+//# sourceMappingURL=ScheduleMatrix.js.map

package/dist/families/calendar/ScheduleMatrix.js.map

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

package/dist/families/calendar/ScheduledJobsList.d.ts

@@ -0,0 +1,40 @@
+import { scheduledJobsListConfigSchema, scheduledJobsListDemoData } from './calendar-config.js';
+import type { ScheduledJobsListConfig } from './calendar-config.js';
+import type { ScheduledJob } from './calendar-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { scheduledJobsListConfigSchema, scheduledJobsListDemoData };
+export type { ScheduledJobsListConfig, ScheduledJob };
+/**
+ * `scheduled-jobs-list` (annex §5) — recurring-job rows: an icon tile, the name
+ * plus a format badge, a meta line ("target · human cadence"), a recipient
+ * avatar stack, the "Next run" column, and an on/off switch; disabled rows dim
+ * (Scheduled Reports, Data Exports, Adminium UI Kit's saved reports).
+ *
+ * The cadence string arrives ALREADY humanized: cron → prose needs the
+ * schedule's timezone and the viewer's locale, both of which live at the host /
+ * server boundary, so the widget renders what it is given rather than shipping a
+ * cron parser to the browser.
+ *
+ * Toggling emits a `mutate` UPDATE intent — the widget never writes. The host
+ * runs it through the CRUD API with undo + audit (04 §2), which is also why the
+ * switch is optimistic-free: the row re-renders from the next payload.
+ */
+export interface ScheduledJobsListProps {
+    jobs: readonly ScheduledJob[];
+    toggleable?: boolean | undefined;
+    showRecipients?: boolean | undefined;
+    locale?: string | undefined;
+    nextRunLabel?: string | undefined;
+    toggleLabel?: string | undefined;
+    recipientsLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onToggle?: ((job: ScheduledJob, enabled: boolean) => void) | undefined;
+    onSelect?: ((job: ScheduledJob) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function ScheduledJobsList({ jobs, toggleable, showRecipients, locale, nextRunLabel, toggleLabel, recipientsLabel, emptyTitle, emptyBody, onToggle, onSelect, testId, }: ScheduledJobsListProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `ScheduledJob`s via the row mapping. */
+export declare function scheduledJobsOf(data: unknown, config: ScheduledJobsListConfig): ScheduledJob[];
+export declare function ScheduledJobsListWidget({ config, data, onEvent }: WidgetProps<ScheduledJobsListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ScheduledJobsList.d.ts.map

package/dist/families/calendar/ScheduledJobsList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduledJobsList.d.ts","sourceRoot":"","sources":["../../../src/families/calendar/ScheduledJobsList.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEhG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,UAAiB,EACjB,cAAqB,EACrB,MAAM,EACN,YAAyB,EACzB,WAAW,EACX,eAA8B,EAC9B,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,EAAE,sBAAsB,+BA0FxB;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,GAAG,YAAY,EAAE,CA8B9F;AAED,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BA6BtG"}

package/dist/families/calendar/ScheduledJobsList.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, AvatarStack, EmptyState, IconTile, MonoText, Switch, Tag } from '@adminium/ui';
+import { CalendarClock } from 'lucide-react';
+import { scheduledJobsListConfigSchema, scheduledJobsListDemoData } from './calendar-config.js';
+import { bindingSourceOf, fmtNextRun, resolveLocale, toneOf } from './calendar-lib.js';
+export { scheduledJobsListConfigSchema, scheduledJobsListDemoData };
+export function ScheduledJobsList({ jobs, toggleable = true, showRecipients = true, locale, nextRunLabel = 'Next run', toggleLabel, recipientsLabel = 'Recipients', emptyTitle, emptyBody, onToggle, onSelect, testId, }) {
+    const tag = resolveLocale(locale);
+    if (jobs.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "nothing-scheduled", title: emptyTitle ?? 'No scheduled jobs', body: emptyBody ?? 'Recurring reports and exports will appear here once scheduled.' }));
+    }
+    return (_jsx("ul", { "data-widget": "scheduled-jobs-list", "data-testid": testId, className: "h-full divide-y divide-border overflow-auto", children: jobs.map((job) => {
+            const enabled = job.enabled !== false;
+            const next = job.next === undefined ? '' : fmtNextRun(tag, job.next);
+            const recipients = job.recipients ?? [];
+            return (_jsxs("li", { "data-part": "job-row", "data-enabled": enabled ? '' : undefined, 
+                // Disabled rows dim (annex) — the whole row, not just the switch, so
+                // the "this is off" read survives at a glance.
+                className: `flex items-center gap-3 px-3 py-2.5 ${enabled ? '' : 'opacity-55'}`, children: [_jsx(IconTile, { size: "md", tone: toneOf(job.tone, enabled ? 'accent' : 'neutral'), icon: _jsx(CalendarClock, {}) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [onSelect === undefined ? (_jsx("span", { className: "min-w-0 truncate text-body-sm font-semibold text-fg", children: job.name })) : (_jsx("button", { type: "button", onClick: () => onSelect(job), className: "min-w-0 truncate text-start text-body-sm font-semibold text-fg hover:text-accent focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: job.name })), job.format !== undefined && (_jsx(Tag, { mono: true, tone: "neutral", className: "shrink-0 uppercase", children: job.format }))] }), (job.target !== undefined || job.frequency !== undefined) && (_jsxs("p", { className: "mt-0.5 flex min-w-0 items-center gap-1.5 text-caption text-fg-muted", children: [job.target !== undefined && _jsx(MonoText, { className: "truncate", children: job.target }), job.target !== undefined && job.frequency !== undefined && (_jsx("span", { "aria-hidden": "true", className: "text-fg-subtle", children: "\u00B7" })), job.frequency !== undefined && _jsx("span", { className: "truncate", children: job.frequency })] }))] }), showRecipients && recipients.length > 0 && (_jsx(AvatarStack, { max: 3, size: "xs", label: recipientsLabel, className: "shrink-0", children: recipients.map((name) => (_jsx(Avatar, { size: "xs", name: name, locale: tag }, name))) })), _jsxs("div", { "data-part": "job-next", className: "hidden w-40 shrink-0 flex-col text-end sm:flex", children: [_jsx("span", { className: "text-[10px] font-bold uppercase tracking-wide text-fg-subtle", children: nextRunLabel }), _jsx(MonoText, { className: "truncate text-caption text-fg", children: next === '' ? '—' : next })] }), toggleable && (_jsx(Switch, { "data-part": "job-toggle", checked: enabled, "aria-label": toggleLabel ?? job.name, onCheckedChange: (checked) => onToggle?.(job, checked), className: "shrink-0" }))] }, job.id));
+        }) }));
+}
+/** Project an untrusted `record-list` onto `ScheduledJob`s via the row mapping. */
+export function scheduledJobsOf(data, config) {
+    const raw = Array.isArray(data)
+        ? data
+        : typeof data === 'object' && data !== null
+            ? (data.rows ?? data.data)
+            : undefined;
+    if (!Array.isArray(raw))
+        return [];
+    const str = (row, key) => {
+        const value = row[key];
+        return typeof value === 'string' && value !== '' ? value : undefined;
+    };
+    return raw
+        .filter((row) => typeof row === 'object' && row !== null)
+        .map((row, index) => {
+        const id = row.id;
+        const recipients = row[config.recipientsField];
+        return {
+            id: typeof id === 'string' || typeof id === 'number' ? id : index,
+            name: str(row, config.nameField) ?? `#${index + 1}`,
+            target: str(row, config.targetField),
+            frequency: str(row, config.frequencyField),
+            format: str(row, config.formatField),
+            next: str(row, config.nextRunField),
+            enabled: row[config.toggleField] !== false,
+            recipients: Array.isArray(recipients)
+                ? recipients.filter((name) => typeof name === 'string' && name !== '')
+                : undefined,
+            tone: str(row, 'tone'),
+        };
+    });
+}
+export function ScheduledJobsListWidget({ config, data, onEvent }) {
+    const source = bindingSourceOf(config.binding);
+    return (_jsx(ScheduledJobsList, { jobs: scheduledJobsOf(data, config), toggleable: config.toggleable, showRecipients: config.showRecipients, ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.nextRunLabel === undefined ? {} : { nextRunLabel: config.nextRunLabel }), ...(config.toggleLabel === undefined ? {} : { toggleLabel: config.toggleLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.testId === undefined ? {} : { testId: config.testId }), onToggle: (job, enabled) => {
+            if (source === null)
+                return; // unbound: nothing to write to
+            onEvent({
+                type: 'mutate',
+                intent: 'update',
+                connectionId: source.connectionId,
+                table: source.table,
+                recordId: job.id,
+                values: { [config.toggleField]: enabled },
+            });
+        }, ...(config.href === undefined
+            ? {}
+            : { onSelect: () => onEvent({ type: 'drill-through', href: config.href }) }) }));
+}
+//# sourceMappingURL=ScheduledJobsList.js.map

package/dist/families/calendar/ScheduledJobsList.js.map

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

package/dist/families/calendar/UpcomingEventsList.d.ts

@@ -0,0 +1,54 @@
+import { upcomingEventsListConfigSchema, upcomingEventsListDemoData } from './calendar-config.js';
+import { ANCHOR_TODAY } from './calendar-lib.js';
+import type { UpcomingEventsListConfig } from './calendar-config.js';
+import type { UpcomingEvent } from './calendar-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { upcomingEventsListConfigSchema, upcomingEventsListDemoData };
+export type { UpcomingEventsListConfig, UpcomingEvent };
+/**
+ * `upcoming-events-list` (annex §5) — the next-N feed, date-ascending: a date
+ * block, a mono version/ref, a category pill, an owner avatar, a status pill,
+ * and a colour-coded leading border (Release Calendar).
+ *
+ * The annex calls that border "colored left border"; it is implemented as
+ * `border-s-4` — the LOGICAL inline-start side — so it sits on the right under
+ * RTL, where the row actually starts. A physical `border-l` would strand the
+ * accent on the wrong edge in `ar-EG` (10-i18n-theming.md §5.2).
+ *
+ * The "date ≥ today" cutoff resolves against an explicit reference day when one
+ * is given (`fromDate`, else the shared `format.referenceTime`), so a story or
+ * VRT capture is byte-stable without a wall-clock read; unpinned, it falls back
+ * to the real clock, which is what a live page wants.
+ */
+export interface UpcomingEventsListProps {
+    events: readonly UpcomingEvent[];
+    n?: number | undefined;
+    /** Cutoff day (`YYYY-MM-DD`); events before it are dropped. */
+    fromDate?: string | undefined;
+    categoryColorMap?: Record<string, string> | undefined;
+    showOwner?: boolean | undefined;
+    showStatus?: boolean | undefined;
+    locale?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onSelect?: ((event: UpcomingEvent) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function UpcomingEventsList({ events, n, fromDate, categoryColorMap, showOwner, showStatus, locale, emptyTitle, emptyBody, onSelect, testId, }: UpcomingEventsListProps): import("react").JSX.Element;
+/**
+ * Project an untrusted `calendar-events` payload onto `UpcomingEvent`s — the
+ * `calendar-month` contract plus the Release Calendar's ref/owner/status slots
+ * (annex §5 `rowMapping`).
+ */
+export declare function upcomingEventsOf(data: unknown): UpcomingEvent[];
+/**
+ * The cutoff day: an explicit `fromDate` wins, then the shared
+ * `format.referenceTime` clock (04 §2.1 — what makes demo/VRT captures stable),
+ * else the caller's wall clock. `ANCHOR_TODAY` is NOT used as a fallback: a live
+ * page with no pinned clock must follow the real date, not the demo epoch.
+ */
+export declare function cutoffDayOf(config: UpcomingEventsListConfig): string | undefined;
+export declare function UpcomingEventsListWidget({ config, data, onEvent }: WidgetProps<UpcomingEventsListConfig>): import("react").JSX.Element;
+/** Re-exported so stories/tests can pin the same anchor the generators use. */
+export { ANCHOR_TODAY };
+//# sourceMappingURL=UpcomingEventsList.d.ts.map

package/dist/families/calendar/UpcomingEventsList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpcomingEventsList.d.ts","sourceRoot":"","sources":["../../../src/families/calendar/UpcomingEventsList.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EACL,YAAY,EAWb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,CAAC;AACtE,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACtD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,CAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,SAAgB,EAChB,UAAiB,EACjB,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACP,EAAE,uBAAuB,+BAsFzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CAuB/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,GAAG,SAAS,CAIhF;AAED,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,wBAAwB,CAAC,+BAmBxG;AAED,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/families/calendar/UpcomingEventsList.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Avatar, EmptyState, MonoText, StatusPill, Tag } from '@adminium/ui';
+import { upcomingEventsListConfigSchema, upcomingEventsListDemoData } from './calendar-config.js';
+import { ANCHOR_TODAY, TONE_BORDER, categoryTone, fmtDayNumber, fmtEventTime, fmtMonthShort, isoDayKey, parseIsoDay, resolveLocale, toneOf, upcomingFrom, } from './calendar-lib.js';
+export { upcomingEventsListConfigSchema, upcomingEventsListDemoData };
+export function UpcomingEventsList({ events, n = 6, fromDate, categoryColorMap, showOwner = true, showStatus = true, locale, emptyTitle, emptyBody, onSelect, testId, }) {
+    const tag = resolveLocale(locale);
+    const cutoff = fromDate ?? isoDayKey(new Date());
+    const upcoming = upcomingFrom(events, cutoff, n);
+    if (upcoming.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "nothing-scheduled", title: emptyTitle ?? 'Nothing upcoming', body: emptyBody ?? 'Scheduled events will appear here as they are planned.' }));
+    }
+    return (_jsx("ul", { "data-widget": "upcoming-events-list", "data-testid": testId, className: "h-full space-y-1.5 overflow-auto p-2", children: upcoming.map((event, index) => {
+            const tone = event.tone === undefined ? categoryTone(event.category, categoryColorMap) : toneOf(event.tone);
+            const day = parseIsoDay(event.date);
+            const time = fmtEventTime(tag, event);
+            const content = (_jsxs(_Fragment, { children: [_jsxs("div", { "data-part": "date-block", className: "flex w-11 shrink-0 flex-col items-center rounded-md bg-surface-2 px-1 py-1.5", children: [_jsx("span", { className: "text-[10px] font-bold uppercase leading-none text-fg-muted", children: fmtMonthShort(tag, day) }), _jsx(MonoText, { className: "text-body font-bold leading-tight text-fg", children: fmtDayNumber(tag, day.getUTCDate()) })] }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "min-w-0 truncate text-body-sm font-semibold text-fg", children: event.title }), event.ref !== undefined && (_jsx(MonoText, { className: "shrink-0 text-caption text-fg-subtle", children: event.ref }))] }), _jsxs("div", { className: "mt-1 flex flex-wrap items-center gap-1.5", children: [event.category !== undefined && _jsx(Tag, { tone: tone, children: event.category }), time !== '' && _jsx(MonoText, { className: "text-caption text-fg-muted", children: time })] })] }), showOwner && event.owner !== undefined && (_jsx(Avatar, { size: "xs", name: event.owner, locale: tag, className: "shrink-0" })), showStatus && event.status !== undefined && (
+                    /*
+                      `status` is the registry KEY (resolved to a tone by the shared
+                      status→tone map); the child is the already-localized label the
+                      host passed through the payload. An explicit `statusTone` still
+                      overrides the registry, which is how a domain-specific status the
+                      map has never seen still renders in its intended tone.
+                    */
+                    _jsx(StatusPill, { status: event.status, className: "shrink-0", ...(event.statusTone === undefined ? {} : { tone: toneOf(event.statusTone, 'neutral') }), children: event.status }))] }));
+            const shell = `flex items-center gap-3 rounded-md border-s-4 bg-surface-1 px-2.5 py-2 ${TONE_BORDER[tone]}`;
+            return (_jsx("li", { "data-part": "upcoming-row", "data-category": event.category, children: onSelect === undefined ? (_jsx("div", { className: shell, children: content })) : (_jsx("button", { type: "button", onClick: () => onSelect(event), className: `${shell} w-full text-start hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent`, children: content })) }, event.id ?? index));
+        }) }));
+}
+/**
+ * Project an untrusted `calendar-events` payload onto `UpcomingEvent`s — the
+ * `calendar-month` contract plus the Release Calendar's ref/owner/status slots
+ * (annex §5 `rowMapping`).
+ */
+export function upcomingEventsOf(data) {
+    const raw = Array.isArray(data)
+        ? data
+        : typeof data === 'object' && data !== null
+            ? (data.events ?? data.data)
+            : undefined;
+    if (!Array.isArray(raw))
+        return [];
+    const str = (value) => (typeof value === 'string' && value !== '' ? value : undefined);
+    return raw
+        .filter((row) => typeof row === 'object' && row !== null)
+        .map((row) => ({
+        id: row.id,
+        date: str(row.date) ?? '',
+        title: str(row.title) ?? '',
+        category: str(row.category),
+        time: str(row.time),
+        tone: str(row.tone),
+        ref: str(row.ref) ?? str(row.version),
+        owner: str(row.owner) ?? str(row.assignee),
+        status: str(row.status),
+        statusTone: str(row.statusTone),
+    }))
+        .filter((event) => event.date !== '');
+}
+/**
+ * The cutoff day: an explicit `fromDate` wins, then the shared
+ * `format.referenceTime` clock (04 §2.1 — what makes demo/VRT captures stable),
+ * else the caller's wall clock. `ANCHOR_TODAY` is NOT used as a fallback: a live
+ * page with no pinned clock must follow the real date, not the demo epoch.
+ */
+export function cutoffDayOf(config) {
+    if (config.fromDate !== undefined)
+        return config.fromDate;
+    const reference = config.format?.referenceTime;
+    return reference === undefined ? undefined : isoDayKey(new Date(reference));
+}
+export function UpcomingEventsListWidget({ config, data, onEvent }) {
+    const cutoff = cutoffDayOf(config);
+    return (_jsx(UpcomingEventsList, { events: upcomingEventsOf(data), n: config.n, showOwner: config.showOwner, showStatus: config.showStatus, ...(cutoff === undefined ? {} : { fromDate: cutoff }), ...(config.categoryColorMap === undefined ? {} : { categoryColorMap: config.categoryColorMap }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.testId === undefined ? {} : { testId: config.testId }), ...(config.href === undefined
+            ? {}
+            : { onSelect: () => onEvent({ type: 'drill-through', href: config.href }) }) }));
+}
+/** Re-exported so stories/tests can pin the same anchor the generators use. */
+export { ANCHOR_TODAY };
+//# sourceMappingURL=UpcomingEventsList.js.map

package/dist/families/calendar/UpcomingEventsList.js.map

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