@thewhatmatters/wmds 0.2.0

package/dist/lib/chartTheme.js

@@ -0,0 +1,329 @@
+"use client";
+//#region src/lib/chartTheme.ts
+var e = {
+	neutral: {
+		stroke: "var(--color-text-primary)",
+		fill: "var(--color-text-primary)"
+	},
+	primary: {
+		stroke: "var(--color-primary)",
+		fill: "var(--color-primary)"
+	},
+	success: {
+		stroke: "var(--color-success)",
+		fill: "var(--color-success)"
+	},
+	destructive: {
+		stroke: "var(--color-error)",
+		fill: "var(--color-error)"
+	}
+}, t = {
+	grid: "var(--color-border)",
+	axis: "var(--color-muted)",
+	cursor: "var(--color-border)",
+	placeholder: "var(--color-border)",
+	tooltipBg: "var(--color-background-popover)",
+	tooltipBorder: "var(--color-border)",
+	tooltipFg: "var(--color-text-primary)",
+	tooltipMuted: "var(--color-text-secondary)",
+	errorSegment: "var(--color-error-muted)",
+	noDataBand: "var(--color-skeleton)",
+	noDataStripe: "color-mix(in srgb, var(--color-text-primary) 16%, transparent)"
+}, n = {
+	hero: {
+		top: 12,
+		right: 12,
+		bottom: 32,
+		left: 44
+	},
+	compact: {
+		top: 8,
+		right: 8,
+		bottom: 28,
+		left: 36
+	},
+	sparkline: {
+		top: 4,
+		right: 4,
+		bottom: 4,
+		left: 4
+	}
+}, r = {
+	hero: {
+		strokeWidth: 1.5,
+		fillOpacity: .08,
+		type: "monotone",
+		animation: !0
+	},
+	compact: {
+		strokeWidth: 1.5,
+		fillOpacity: .08,
+		type: "monotone",
+		animation: !0
+	},
+	sparkline: {
+		strokeWidth: 1.25,
+		fillOpacity: .18,
+		type: "monotone",
+		animation: !1
+	}
+};
+function i(t = "neutral") {
+	return e[t].stroke;
+}
+var a = {
+	width: 5,
+	gap: 1,
+	segmentRadius: 2
+}, o = {
+	default: {
+		segments: 60,
+		height: 32,
+		segmentRadius: 2
+	},
+	compact: {
+		segments: 40,
+		height: 24,
+		segmentRadius: 2
+	},
+	periodWeek: {
+		height: 32,
+		segmentRadius: 2
+	},
+	periodMonth: {
+		height: 32,
+		segmentRadius: 2
+	},
+	periodQuarter: {
+		height: 32,
+		segmentRadius: 2
+	},
+	periodYear: {
+		height: 32,
+		segmentRadius: 2
+	}
+};
+function s(e) {
+	switch (e) {
+		case "week": return 7;
+		case "month": return 30;
+		case "quarter": return 90;
+		case "year": return 365;
+		case "rolling": return 30;
+	}
+}
+function c(e) {
+	return e === "week" || e === "month" || e === "quarter" || e === "year" || e === "rolling" ? e : "month";
+}
+function l(e) {
+	if (e.segments != null) return e.segments;
+	switch (e.kind) {
+		case "week": return 7;
+		case "month": return e.dayCount ?? 30;
+		case "quarter": return 13;
+		case "year": return 12;
+		case "rolling": return 30;
+	}
+}
+function u(e) {
+	switch (e.kind) {
+		case "week": return "periodWeek";
+		case "month":
+		case "rolling": return "periodMonth";
+		case "quarter": return "periodQuarter";
+		case "year": return "periodYear";
+	}
+}
+function d(e) {
+	return Number.isNaN(e) ? 0 : Math.min(1, Math.max(0, e));
+}
+function f(e, t) {
+	return Array.from({ length: t }, (t, n) => d(e[n] ?? 0));
+}
+function p(e, t) {
+	return e.length === 0 ? 0 : t === "max" ? Math.max(...e) : t === "min" ? Math.min(...e) : e.reduce((e, t) => e + t, 0) / e.length;
+}
+function m(e, t, n = {}) {
+	let r = n.aggregate ?? "avg", i = n.pointLabel ?? ((e) => `Day ${e + 1}`), a = n.bucketLabel ?? ((e, t) => e === t ? i(e) : `${i(e)} – ${i(t)}`);
+	return t <= 0 ? [] : e.length === 0 ? Array.from({ length: t }, (e, t) => ({
+		rate: 0,
+		label: i(t),
+		points: []
+	})) : e.length <= t ? Array.from({ length: t }, (t, n) => {
+		let r = d(e[n] ?? 0), a = i(n);
+		return {
+			rate: r,
+			label: a,
+			points: e[n] == null ? [] : [{
+				label: a,
+				rate: r
+			}]
+		};
+	}) : Array.from({ length: t }, (n, o) => {
+		let s = Math.floor(o * e.length / t), c = Math.floor((o + 1) * e.length / t), l = Math.max(c, s + 1), u = [];
+		for (let t = s; t < l; t += 1) u.push({
+			label: i(t),
+			rate: d(e[t] ?? 0)
+		});
+		return {
+			rate: p(u.map((e) => e.rate), r),
+			label: a(s, l - 1),
+			points: u
+		};
+	});
+}
+function h(e = a) {
+	return e.width + e.gap;
+}
+function g(e, t = a) {
+	return e <= 0 ? 0 : Math.max(1, Math.floor((e + t.gap) / h(t)));
+}
+function _(e, t = a) {
+	return e <= 0 ? 0 : e * t.width + (e - 1) * t.gap;
+}
+function v(e) {
+	let { mode: t, preset: n, segments: r, period: i, dataLength: a = 0 } = e;
+	if (t === "period") {
+		let e = i ?? {
+			kind: "month",
+			dayCount: a || 30
+		}, t = n ?? u(e), s = r ?? e.segments ?? l(e);
+		return {
+			preset: t,
+			config: o[t],
+			segmentCount: s
+		};
+	}
+	let s = n ?? "default", c = o[s];
+	return {
+		preset: s,
+		config: c,
+		segmentCount: r ?? ("segments" in c ? c.segments : void 0) ?? o.default.segments
+	};
+}
+function y(e, t = {}) {
+	let n = a, r = t.preset ?? "default", i = o[r], s = t.segments ?? ("segments" in i ? i.segments : void 0) ?? o.default.segments, c = g(e, n), l = Math.max(1, Math.min(s, c)), u = l * n.width, d = l > 1 ? Math.max(n.gap, (e - u) / (l - 1)) : 0;
+	return {
+		preset: r,
+		config: i,
+		displayCount: l,
+		tickWidth: n.width,
+		gap: d,
+		barWidth: e
+	};
+}
+function b(e, t, n) {
+	return e * (t + n);
+}
+var x = {
+	solid: { kind: "solid" },
+	velocity: {
+		kind: "velocity",
+		startOpacity: 1,
+		endOpacity: .22
+	},
+	semantic: {
+		kind: "semantic",
+		stops: [
+			{
+				offset: 0,
+				color: "var(--color-chart-rag-1)"
+			},
+			{
+				offset: .33,
+				color: "var(--color-chart-rag-2)"
+			},
+			{
+				offset: .66,
+				color: "var(--color-chart-rag-3)"
+			},
+			{
+				offset: 1,
+				color: "var(--color-chart-rag-4)"
+			}
+		]
+	}
+}, S = 12, C = [
+	"var(--color-chart-categorical-1)",
+	"var(--color-chart-categorical-2)",
+	"var(--color-chart-categorical-3)",
+	"var(--color-chart-categorical-4)",
+	"var(--color-chart-categorical-5)",
+	"var(--color-chart-categorical-6)",
+	"var(--color-chart-categorical-7)",
+	"var(--color-chart-categorical-8)",
+	"var(--color-chart-categorical-9)",
+	"var(--color-chart-categorical-10)",
+	"var(--color-chart-categorical-11)",
+	"var(--color-chart-categorical-12)"
+];
+function w(e) {
+	return C[(e % C.length + C.length) % C.length];
+}
+function T(e, t) {
+	return t <= 0 ? "0%" : `${Math.round(e / t * 100)}%`;
+}
+var E = [
+	"dot",
+	"line",
+	"dashed"
+];
+function D(e, t) {
+	let n = t?.colorStartIndex ?? 0;
+	return Object.fromEntries(e.map(({ key: e, label: t }, r) => [e, {
+		label: t,
+		color: w(n + r)
+	}]));
+}
+function O(e, t, n = "primary") {
+	let r = i(n);
+	return { [e]: {
+		label: t,
+		color: r
+	} };
+}
+function k(e) {
+	return e.toLocaleString(void 0, { maximumFractionDigits: 2 });
+}
+function A(e) {
+	return Number.isFinite(e) ? Math.abs(e) >= 1e4 ? new Intl.NumberFormat(void 0, {
+		notation: "compact",
+		maximumFractionDigits: 1
+	}).format(e) : new Intl.NumberFormat(void 0, { maximumFractionDigits: 0 }).format(e) : "";
+}
+function j(e, t) {
+	return t === "year" ? new Intl.DateTimeFormat(void 0, { month: "short" }).format(e) : new Intl.DateTimeFormat(void 0, {
+		month: "short",
+		day: "numeric"
+	}).format(e);
+}
+function M(e, t) {
+	return t === "year" ? new Intl.DateTimeFormat(void 0, {
+		month: "short",
+		year: "numeric"
+	}).format(e) : t === "quarter" ? new Intl.DateTimeFormat(void 0, {
+		month: "short",
+		day: "numeric"
+	}).format(e) : new Intl.DateTimeFormat(void 0, {
+		month: "short",
+		day: "numeric",
+		year: "numeric"
+	}).format(e);
+}
+function N(e, t, n) {
+	return (n ?? Object.keys(e)).filter((n) => {
+		if (e[n] == null) return !1;
+		let r = t[n];
+		return !(r == null || typeof r == "number" && !Number.isFinite(r));
+	}).map((n) => {
+		let r = e[n], i = t[n];
+		return {
+			key: n,
+			label: r.label,
+			color: r.color,
+			value: typeof i == "number" ? k(i) : i
+		};
+	});
+}
+//#endregion
+export { r as chartAreaPresets, m as chartBucketPeriodData, n as chartCartesianMargins, S as chartCategoricalCount, C as chartCategoricalPalette, e as chartColorTokens, j as chartFormatAxisDateLabel, A as chartFormatAxisValue, T as chartFormatPercent, M as chartFormatTooltipLabel, k as chartFormatTooltipValue, g as chartMaxTicksForWidth, f as chartNormalizePeriodData, c as chartPeriodKindFromValue, _ as chartSegmentBarWidth, x as chartSegmentFillVariants, b as chartSegmentPosition, o as chartSegmentPresets, h as chartSegmentStride, a as chartSegmentTickSpec, w as chartSeriesColor, D as chartSeriesConfigFromKeys, O as chartSeriesConfigFromTone, i as chartStroke, E as chartTooltipIndicators, N as chartTooltipItemsFromConfig, t as chartUiTokens, y as resolveCapacityBarLayout, s as resolveChartPeriodDayCount, u as resolvePeriodSegmentPreset, l as resolvePeriodSegments, v as resolveSegmentBarConfig };

package/dist/lib/clusterScale.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cluster control scale — canonical heights for Chip + IconButton + compact Button
+ * in one row (Card header, filter rails, toolbar groups). See ADR-0011.
+ *
+ * Implementation uses stable Tailwind spacing utilities (7 / 9 / 11 × 4px base).
+ * CSS vars in `src/theme/cluster.css` document the same px for apps — do not use
+ * `length:var(--cluster-*)` in component class strings (unreliable in dev CSS order).
+ */
+export declare const clusterTiers: readonly ["sm", "md", "lg"];
+export type ClusterTier = (typeof clusterTiers)[number];
+/** Documented pixel heights at default `--spacing` (4px). */
+export declare const clusterHeightPx: Record<ClusterTier, number>;
+/** Pill / row height — Chip shells, Button min-height in clusters. */
+export declare const clusterHeightClasses: Record<ClusterTier, string>;
+export declare const clusterMinHeightClasses: Record<ClusterTier, string>;
+/** Square hit target — IconButton in clusters. */
+export declare const clusterSquareClasses: Record<ClusterTier, string>;
+/**
+ * Canonical pairing — same cluster tier, same pixel height.
+ * Component `size` prop names differ; use this table in Storybook and headers.
+ */
+export declare const clusterComponentSizeMap: {
+    readonly chip: {
+        readonly sm: "sm";
+        readonly md: "md";
+        readonly lg: "lg";
+    };
+    readonly iconButton: {
+        readonly sm: "xs";
+        readonly md: "sm";
+        readonly lg: "md";
+    };
+    readonly button: {
+        readonly sm: "xs";
+        readonly md: "sm";
+        readonly lg: "md";
+    };
+    readonly segmentedControl: {
+        readonly sm: "sm";
+        readonly md: "md";
+        readonly lg: "lg";
+    };
+};
+/** IconButton `size` for a cluster tier — e.g. header `Chip sm` → `xs`. */
+export declare function iconButtonSizeForCluster(tier: ClusterTier): "xs" | "sm" | "md";
+/** Button `size` for a cluster tier — compact actions beside chips. */
+export declare function buttonSizeForCluster(tier: ClusterTier): "xs" | "sm" | "md";
+//# sourceMappingURL=clusterScale.d.ts.map

package/dist/lib/clusterScale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterScale.d.ts","sourceRoot":"","sources":["../../src/lib/clusterScale.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,YAAY,6BAA8B,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,6DAA6D;AAC7D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIvD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI/D,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;CAK4B,CAAC;AAEjE,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAE1E"}

package/dist/lib/clusterScale.js

@@ -0,0 +1,48 @@
+"use client";
+//#region src/lib/clusterScale.ts
+var e = [
+	"sm",
+	"md",
+	"lg"
+], t = {
+	sm: "h-7 min-h-7",
+	md: "h-9 min-h-9",
+	lg: "min-h-11"
+}, n = {
+	sm: "min-h-7",
+	md: "min-h-9",
+	lg: "min-h-11"
+}, r = {
+	sm: "size-7 shrink-0",
+	md: "size-9 shrink-0",
+	lg: "size-11 shrink-0"
+}, i = {
+	chip: {
+		sm: "sm",
+		md: "md",
+		lg: "lg"
+	},
+	iconButton: {
+		sm: "xs",
+		md: "sm",
+		lg: "md"
+	},
+	button: {
+		sm: "xs",
+		md: "sm",
+		lg: "md"
+	},
+	segmentedControl: {
+		sm: "sm",
+		md: "md",
+		lg: "lg"
+	}
+};
+function a(e) {
+	return i.iconButton[e];
+}
+function o(e) {
+	return i.button[e];
+}
+//#endregion
+export { o as buttonSizeForCluster, i as clusterComponentSizeMap, t as clusterHeightClasses, n as clusterMinHeightClasses, r as clusterSquareClasses, e as clusterTiers, a as iconButtonSizeForCluster };

package/dist/lib/cn.d.ts

@@ -0,0 +1,3 @@
+/** Join conditional class names — filters falsy parts. */
+export declare function cn(...parts: Array<string | false | undefined | null>): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,UAEpE"}

package/dist/lib/cn.js

@@ -0,0 +1,7 @@
+"use client";
+//#region src/lib/cn.ts
+function e(...e) {
+	return e.filter(Boolean).join(" ");
+}
+//#endregion
+export { e as cn };

package/dist/lib/compositionAudit.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Static composition audit — molecules / organisms must compose atoms (ADR-0002, atomic-composition rule).
+ * Run via the hidden Internal/Audits/Composition fixture or `npm run validate:composition`.
+ */
+export type CompositionTier = "molecules" | "organisms";
+export interface CompositionAuditRule {
+    id: string;
+    message: string;
+    composeFrom: string;
+    /** Return true when the line is a violation. */
+    testLine: (line: string) => boolean;
+}
+export interface CompositionViolation {
+    file: string;
+    line: number;
+    ruleId: string;
+    message: string;
+    composeFrom: string;
+    snippet: string;
+}
+export interface CompositionShellException {
+    /** Path suffix — e.g. `components/molecules/Chip/Chip.tsx` */
+    file: string;
+    ruleId: string;
+    reason: string;
+}
+/** @deprecated Use `CompositionShellException`. */
+export type CompositionAllowlistEntry = CompositionShellException;
+export interface CompositionAuditReport {
+    tier: CompositionTier;
+    scannedFiles: string[];
+    violations: CompositionViolation[];
+    /** Hits covered by documented molecule/organism shells — not composition gaps. */
+    shellExceptions: Array<CompositionViolation & {
+        reason: string;
+    }>;
+    /** Unresolved hits — must stay empty for CI to pass. */
+    openGaps: CompositionViolation[];
+    passed: boolean;
+}
+/** Approved shell affordances — keep reasons in sync with Storybook Anatomy. */
+export declare const compositionShellExceptions: CompositionShellException[];
+/**
+ * Registry of known composition debt — must stay empty.
+ * Add an entry only while fixing a gap; remove when resolved. CI fails when non-empty.
+ */
+export declare const compositionTrackedOpenGaps: CompositionShellException[];
+/** @deprecated Use `compositionShellExceptions`. */
+export declare const compositionAuditAllowlist: CompositionShellException[];
+export declare const compositionAuditRules: CompositionAuditRule[];
+export declare function shouldScanCompositionFile(path: string): boolean;
+export declare function auditCompositionSources(sources: Record<string, string>, options?: {
+    /** @deprecated Use `shellExceptions`. */
+    allowlist?: CompositionShellException[];
+    shellExceptions?: CompositionShellException[];
+    tier?: CompositionTier;
+}): CompositionAuditReport;
+export declare function formatCompositionAuditReport(report: CompositionAuditReport): string;
+//# sourceMappingURL=compositionAudit.d.ts.map

package/dist/lib/compositionAudit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositionAudit.d.ts","sourceRoot":"","sources":["../../src/lib/compositionAudit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,kFAAkF;IAClF,eAAe,EAAE,KAAK,CAAC,oBAAoB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,wDAAwD;IACxD,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,yBAAyB,EA8HjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,yBAAyB,EAAO,CAAC;AAE1E,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,oBAAoB,EAiDvD,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgB/D;AAwBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE;IACR,yCAAyC;IACzC,SAAS,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACxC,eAAe,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,GACA,sBAAsB,CAyExB;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA2BnF"}

package/dist/lib/dialogOverlay.d.ts

@@ -0,0 +1,7 @@
+/** Tab cycle within a modal surface — returns cleanup. */
+export declare function trapFocus(container: HTMLElement): () => void;
+/** Prevent background scroll while a modal is open — returns cleanup. */
+export declare function lockBodyScroll(): () => void;
+/** Focus the first tabbable control inside the panel — usually the primary action or close. */
+export declare function focusInitialElement(container: HTMLElement, preferSelector?: string): void;
+//# sourceMappingURL=dialogOverlay.d.ts.map

package/dist/lib/dialogOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogOverlay.d.ts","sourceRoot":"","sources":["../../src/lib/dialogOverlay.ts"],"names":[],"mappings":"AAGA,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,IAAI,CAqC5D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,MAAM,IAAI,CAY3C;AAED,+FAA+F;AAC/F,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,WAAW,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAWN"}

package/dist/lib/dialogOverlay.js

@@ -0,0 +1,41 @@
+"use client";
+//#region src/lib/dialogOverlay.ts
+var e = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+function t(t) {
+	function n(n) {
+		if (n.key !== "Tab") return;
+		let r = Array.from(t.querySelectorAll(e)).filter((e) => e.offsetParent !== null || e === document.activeElement);
+		if (r.length === 0) {
+			n.preventDefault();
+			return;
+		}
+		let i = r[0], a = r[r.length - 1], o = document.activeElement;
+		if (n.shiftKey) {
+			(o === i || !t.contains(o)) && (n.preventDefault(), a.focus());
+			return;
+		}
+		o === a && (n.preventDefault(), i.focus());
+	}
+	return t.addEventListener("keydown", n), () => {
+		t.removeEventListener("keydown", n);
+	};
+}
+function n() {
+	if (typeof document > "u") return () => void 0;
+	let { body: e } = document, t = e.style.overflow;
+	return e.style.overflow = "hidden", () => {
+		e.style.overflow = t;
+	};
+}
+function r(t, n) {
+	if (n) {
+		let e = t.querySelector(n);
+		if (e != null) {
+			e.focus();
+			return;
+		}
+	}
+	t.querySelector(e)?.focus();
+}
+//#endregion
+export { r as focusInitialElement, n as lockBodyScroll, t as trapFocus };

package/dist/lib/displayCascade.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Display and width utilities that share one element and one specificity.
+ *
+ * A later stylesheet's `.hidden` or `.flex` beats an earlier `md:` rule,
+ * because a media query does not raise specificity. `!` beats a later
+ * non-important rule. `max-md:hidden` is not the class `hidden`, so an app's
+ * `.hidden` does not match that element.
+ */
+export interface ClassCascadeConflict {
+    kind: "display" | "width";
+    reason: string;
+}
+/** Conflict when emission order can change the used display or width. */
+export declare function classCascadeConflict(className: string): ClassCascadeConflict | null;
+export interface ClassSource {
+    /** Repo-relative path, slash-separated. */
+    path: string;
+    source: string;
+}
+export interface ClassCascadeHit {
+    path: string;
+    className: string;
+    reason: string;
+}
+/** Class lists in components, stories, and examples whose display or width depends on emission order. */
+export declare function auditClassCascade(files: ClassSource[]): ClassCascadeHit[];
+//# sourceMappingURL=displayCascade.d.ts.map

package/dist/lib/displayCascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayCascade.d.ts","sourceRoot":"","sources":["../../src/lib/displayCascade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAqDnF;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAuSD,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CA0BzE"}

package/dist/lib/gridOverlayUtils.d.ts

@@ -0,0 +1,34 @@
+/** Class toggled on `<html>` so CSS-only overlays stay in sync with the React control. */
+export declare const GRID_ON_CLASS = "grid-on";
+/** Skip the `g` shortcut while the user is typing in a field. */
+export declare function isEditableGridOverlayTarget(target: EventTarget | null): boolean;
+/** `g` / `G` with no modifiers, and not while typing. */
+export declare function gridOverlayKeyShouldToggle(event: Pick<KeyboardEvent, "key" | "metaKey" | "ctrlKey" | "altKey" | "target">): boolean;
+/**
+ * How far column guides should extend outside the overlay host so they cover
+ * the document above and below `grid-page` without growing the scrollport.
+ * `hostTop` and `hostHeight` are document coordinates (px).
+ */
+export declare function gridGuidesDocumentSpread(hostTop: number, hostHeight: number, documentHeight: number): {
+    before: number;
+    after: number;
+};
+/**
+ * How far the page overlay may extend. A FooterReveal footer keeps its own
+ * guides on the field, behind the type. The page overlay stops at that
+ * footer's in-flow top so its stripes do not paint over the headline.
+ * `footerTop` is the cover's bottom (the footer's in-flow start), or null.
+ */
+export declare function gridGuidesSpreadLimit(hostTop: number, hostBottom: number, documentHeight: number, footerTop: number | null): number;
+/** In-flow document top. Sticky `getBoundingClientRect` is the stuck visual, not this. */
+export declare function elementDocumentTop(el: HTMLElement): number;
+/**
+ * Where a sticky FooterReveal footer begins in document flow.
+ * `offsetTop` on the footer itself is the stuck position (often 0). The
+ * preceding cover's bottom is the in-flow edge the page guides must stop at.
+ */
+export declare function stickyFooterInFlowTop(footer: HTMLElement): number | null;
+/** Read `--grid-cols` from an element (the `grid-page` wrap, or `:root`). */
+export declare function readGridColumnCount(from: Element | null): number;
+export declare function setDocumentGridOn(on: boolean, root?: ParentNode | null): void;
+//# sourceMappingURL=gridOverlayUtils.d.ts.map

package/dist/lib/gridOverlayUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridOverlayUtils.d.ts","sourceRoot":"","sources":["../../src/lib/gridOverlayUtils.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,aAAa,YAAY,CAAC;AAIvC,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAK/E;AAED,yDAAyD;AACzD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAC9E,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAGR;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAQ1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAIxE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAKhE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,GAAE,UAAU,GAAG,IAAW,GAAG,IAAI,CAGnF"}

package/dist/lib/gridOverlayUtils.js

@@ -0,0 +1,43 @@
+"use client";
+//#region src/lib/gridOverlayUtils.ts
+var e = "grid-on", t = /* @__PURE__ */ new Set([
+	"INPUT",
+	"TEXTAREA",
+	"SELECT"
+]);
+function n(e) {
+	if (typeof e != "object" || !e) return !1;
+	let n = e;
+	return n.isContentEditable ? !0 : typeof n.tagName == "string" && t.has(n.tagName);
+}
+function r(e) {
+	return e.metaKey || e.ctrlKey || e.altKey || e.key !== "g" && e.key !== "G" ? !1 : !n(e.target);
+}
+function i(e, t, n) {
+	return {
+		before: Math.max(0, Math.floor(e)),
+		after: Math.max(0, Math.floor(n - e - t))
+	};
+}
+function a(e, t, n, r) {
+	return r == null || r + 1 < e ? n : Math.min(n, Math.max(t, r));
+}
+function o(e) {
+	let t = 0, n = e;
+	for (; n;) t += n.offsetTop, n = n.offsetParent;
+	return t;
+}
+function s(e) {
+	let t = e.previousElementSibling;
+	return t instanceof HTMLElement ? o(t) + t.offsetHeight : null;
+}
+function c(e) {
+	if (!e || typeof getComputedStyle > "u") return 12;
+	let t = getComputedStyle(e).getPropertyValue("--grid-cols").trim(), n = Number.parseInt(t, 10);
+	return Number.isFinite(n) && n > 0 ? n : 12;
+}
+function l(t, n = null) {
+	(n ?? (typeof document > "u" ? null : document))?.documentElement.classList.toggle(e, t);
+}
+//#endregion
+export { e as GRID_ON_CLASS, o as elementDocumentTop, i as gridGuidesDocumentSpread, a as gridGuidesSpreadLimit, r as gridOverlayKeyShouldToggle, n as isEditableGridOverlayTarget, c as readGridColumnCount, l as setDocumentGridOn, s as stickyFooterInFlowTop };