pixelize-design-library 2.4.1 → 2.4.2-beta.0

package/dist/Theme/tokens/builders/accentText.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DARK_CANVAS_LUMINANCE = exports.AA_NORMAL_TEXT = exports.onGradient = exports.onFilled = exports.accentTextOnCanvas = exports.isDarkCanvas = exports.pickAccentText = void 0;
+exports.DARK_CANVAS_LUMINANCE = exports.AA_NORMAL_TEXT = exports.onGradient = exports.onFilled = exports.accentTextOnCanvas = exports.isDarkCanvas = exports.DEFAULT_BLACK = exports.DEFAULT_WHITE = exports.DEFAULT_CANVAS = exports.pickAccentText = void 0;
 const color_1 = require("./color");
 /** WCAG AA for normal-size text. Accent-as-text must clear this against the canvas. */
 const AA_NORMAL_TEXT = 4.5;
@@ -52,6 +52,11 @@ const pickAccentText = (primary, canvas, mode) => {
     return safeInk();
 };
 exports.pickAccentText = pickAccentText;
+/** Canvas assumed when no Pixelize theme is mounted. Never painted; only fed to contrast math. */
+exports.DEFAULT_CANVAS = "#ffffff";
+/** Mode-stable ink absolutes, used when no theme supplies `colors.white` / `colors.black`. */
+exports.DEFAULT_WHITE = "#ffffff";
+exports.DEFAULT_BLACK = "#000000";
 /** Below this relative luminance a canvas is treated as dark. Well clear of both real canvases. */
 const DARK_CANVAS_LUMINANCE = 0.2;
 exports.DARK_CANVAS_LUMINANCE = DARK_CANVAS_LUMINANCE;

package/dist/Theme/tokens/builders/buildBrandTokens.d.ts

@@ -13,4 +13,3 @@ export declare function buildPrimaryOpacity(primary500: string): {
 };
 /** Tint used for focus rings / primary-tinted shadows (matches ~28% alpha pattern). */
 export declare function buildPrimaryShadowTint(primary500: string): string;
-//# sourceMappingURL=buildBrandTokens.d.ts.map

package/dist/Theme/tokens/builders/buildDarkPalette.d.ts

@@ -20,4 +20,3 @@ export declare const accentLightnessDelta: (accent500: string, white: string) =>
 export declare const liftScale: (scale: ColorScale, delta: number) => ColorScale;
 export declare function buildDarkPalette(light: PaletteProps): PaletteProps;
 export default buildDarkPalette;
-//# sourceMappingURL=buildDarkPalette.d.ts.map

package/dist/Theme/tokens/builders/buildDarkPalette.js

@@ -169,8 +169,11 @@ const TEXT_TARGETS = {
 const PLACEHOLDER_TARGETS = {
     50: 25, 100: 30, 200: 35, 300: 42, 400: 48, 500: 54, 600: 60, 700: 66, 800: 72, 900: 80,
 };
+// Rung 200 is the default hairline. At L18 it sat 5 points off a card at L13 — below the
+// perceptible step, so dark cards read as edgeless. L22 draws the same 1.2x edge the light
+// ramp does, which is what makes a card look like a card in either mode.
 const BORDER_TARGETS = {
-    50: 12, 100: 15, 200: 18, 300: 21, 400: 24, 500: 27, 600: 33, 700: 42, 800: 52, 900: 62,
+    50: 14, 100: 18, 200: 22, 300: 24, 400: 26, 500: 27, 600: 33, 700: 42, 800: 52, 900: 62,
 };
 const DISABLED_TARGETS = {
     50: 14, 100: 18, 200: 22, 300: 26, 400: 30, 500: 34, 600: 42, 700: 52, 800: 62, 900: 72,
@@ -215,12 +218,22 @@ const NAMED_SURFACE_L = {
     accent: 17,
     muted: 18,
 };
-const SURFACE_SAT = 14;
+/**
+ * Surfaces are hue-NEUTRAL in dark: every brand shares one canvas, so switching theme recolors the
+ * accents and nothing else. Tinting them instead (this was 14) made a full-screen wash — Meadow's
+ * whole app read green — which reads as a different product per brand rather than a different
+ * accent. Light mode keeps its tinted canvas; there the tint is a hint on white, not the whole
+ * screen. Brand identity in dark lives in `primary`/semantic/text, which stay hued.
+ */
+const SURFACE_SAT = 0;
 const TEXT_SAT = 12;
 const PLACEHOLDER_SAT = 10;
 const BORDER_SAT = 12;
 const DISABLED_SAT = 8;
-const GRAY_SAT = 6;
+// Neutral for the same reason as SURFACE_SAT — gray's low rungs ARE surfaces, and a tinted ramp
+// on a neutral canvas reads as a mismatch. It also buys back the contrast the neutral canvas
+// cost: `gray[400]` on `muted` was 2.99 on lavender/zinc at sat 6, and is 3.16 at 0.
+const GRAY_SAT = 0;
 function buildDarkPalette(light) {
     const hueSource = light.primary[500];
     const { h } = (0, color_1.hexToHsl)(hueSource);
@@ -265,7 +278,9 @@ function buildDarkPalette(light) {
         placeholder: fromTargets(hueSource, PLACEHOLDER_TARGETS, PLACEHOLDER_SAT),
         border: fromTargets(hueSource, BORDER_TARGETS, BORDER_SAT),
         boxborder: fromTargets(hueSource, BORDER_TARGETS, BORDER_SAT),
-        table: { hover: fromTargets(hueSource, TABLE_HOVER_TARGETS, BORDER_SAT) },
+        // Neutral: a row hover is a surface fill, and across a full table its tint is exactly the
+        // brand wash the canvas was changed to avoid.
+        table: { hover: fromTargets(hueSource, TABLE_HOVER_TARGETS, SURFACE_SAT) },
         disabled: fromTargets(hueSource, DISABLED_TARGETS, DISABLED_SAT),
         // Derived from the LIFTED accent against the dark canvas: the lift stops at the white-label
         // floor (~4.55), which leaves primary[500] short of AA as text, so text needs its own rung.

package/dist/Theme/tokens/builders/chartColorsFromTheme.d.ts

@@ -1,7 +1,29 @@
 import type { PaletteProps } from "../types";
 export type ThemeColorPalette = PaletteProps;
-/** Default multi-series palette for Apex charts (strings required by ApexCharts). */
+export type ChartMode = "light" | "dark";
+/**
+ * Categorical series palette. Generated in OKLCH on one fixed hue sequence per mode, so a
+ * theme switch never repaints a series. Verified with the six-check validator: lightness
+ * band, chroma floor, CVD separation, normal-vision floor and contrast all pass on both
+ * surfaces. Worst adjacent protan/deutan separation is 10.9 (light) / 11.6 (dark) OKLab
+ * dE, against a target of 8 — the previous four-color default scored 4.8 and was
+ * unreadable for red-green color blindness. Re-run the validator before editing a value.
+ */
+export declare const CATEGORICAL_SERIES: Record<ChartMode, readonly string[]>;
+export declare const chartMode: (colors: ThemeColorPalette) => ChartMode;
+export declare function getCategoricalSeriesColors(colors: ThemeColorPalette): string[];
 export declare function getDefaultSeriesColors(colors: ThemeColorPalette): string[];
+/** Ink, grid and surface tokens every chart type shares. */
+export declare function chartInk(colors: ThemeColorPalette): {
+    surface: string;
+    text: string;
+    muted: string;
+    grid: string;
+    axis: string;
+    tooltipBg: string;
+};
+/** Ink for a label drawn on top of a filled mark. Always clears AA. */
+export declare const labelOnSeries: (fill: string, colors: ThemeColorPalette) => string;
 export declare function mergeChartTitleStyle(colors: ThemeColorPalette, titleStyle?: {
     color?: string;
     fontSize?: string;
@@ -14,4 +36,3 @@ export declare function mergeChartTitleStyle(colors: ThemeColorPalette, titleSty
     fontFamily: string;
 };
 export declare function chartAxisLabelColor(colors: ThemeColorPalette): string;
-//# sourceMappingURL=chartColorsFromTheme.d.ts.map

package/dist/Theme/tokens/builders/chartColorsFromTheme.js

@@ -1,26 +1,56 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelOnSeries = exports.chartMode = exports.CATEGORICAL_SERIES = void 0;
+exports.getCategoricalSeriesColors = getCategoricalSeriesColors;
 exports.getDefaultSeriesColors = getDefaultSeriesColors;
+exports.chartInk = chartInk;
 exports.mergeChartTitleStyle = mergeChartTitleStyle;
 exports.chartAxisLabelColor = chartAxisLabelColor;
-/** Default multi-series palette for Apex charts (strings required by ApexCharts). */
+const accentText_1 = require("./accentText");
+/**
+ * Categorical series palette. Generated in OKLCH on one fixed hue sequence per mode, so a
+ * theme switch never repaints a series. Verified with the six-check validator: lightness
+ * band, chroma floor, CVD separation, normal-vision floor and contrast all pass on both
+ * surfaces. Worst adjacent protan/deutan separation is 10.9 (light) / 11.6 (dark) OKLab
+ * dE, against a target of 8 — the previous four-color default scored 4.8 and was
+ * unreadable for red-green color blindness. Re-run the validator before editing a value.
+ */
+exports.CATEGORICAL_SERIES = {
+    light: ["#009068", "#3177dc", "#5a8b00", "#8b5dce", "#9b7300", "#af4da9", "#cb4a2a", "#009d82"],
+    dark: ["#00976d", "#377ee3", "#5f9200", "#9163d5", "#a27900", "#b654b0", "#d25030", "#00aa8e"],
+};
+const chartMode = (colors) => (0, accentText_1.isDarkCanvas)(colors.backgroundColor.main) ? "dark" : "light";
+exports.chartMode = chartMode;
+function getCategoricalSeriesColors(colors) {
+    return [...exports.CATEGORICAL_SERIES[(0, exports.chartMode)(colors)]];
+}
 function getDefaultSeriesColors(colors) {
-    return [
-        colors.primary[500],
-        colors.semantic.error[500],
-        colors.semantic.success[500],
-        colors.orange[500],
-    ];
+    return getCategoricalSeriesColors(colors);
+}
+/** Ink, grid and surface tokens every chart type shares. */
+function chartInk(colors) {
+    const surface = colors.backgroundColor.main;
+    return {
+        surface,
+        text: colors.text[900],
+        muted: colors.text[500],
+        grid: colors.border[500],
+        axis: colors.text[500],
+        tooltipBg: colors.backgroundColor.secondary,
+    };
 }
+/** Ink for a label drawn on top of a filled mark. Always clears AA. */
+const labelOnSeries = (fill, colors) => (0, accentText_1.onFilled)(fill, colors.white, colors.black);
+exports.labelOnSeries = labelOnSeries;
 function mergeChartTitleStyle(colors, titleStyle) {
     return {
-        fontSize: "16px",
+        fontSize: "14px",
         fontWeight: 600,
-        fontFamily: "Arial",
-        color: colors.primary[500],
+        fontFamily: "inherit",
+        color: colors.text[900],
         ...titleStyle,
     };
 }
 function chartAxisLabelColor(colors) {
-    return colors.gray[700];
+    return colors.text[500];
 }

package/dist/Theme/tokens/builders/color.d.ts

@@ -47,4 +47,3 @@ export declare function mix(a: string, b: string, weight: number): string;
 export declare function relativeLuminance(hex: string): number;
 /** WCAG 2.1 contrast ratio, 1–21. AA body text needs >= 4.5. */
 export declare function contrastRatio(a: string, b: string): number;
-//# sourceMappingURL=color.d.ts.map

package/dist/Theme/tokens/builders/index.d.ts

@@ -3,4 +3,3 @@ export * from "./buildBrandTokens";
 export * from "./buildDarkPalette";
 export * from "./chartColorsFromTheme";
 export * from "./color";
-//# sourceMappingURL=index.d.ts.map

package/dist/Theme/tokens/builders/outlineRung.d.ts

@@ -0,0 +1,34 @@
+import type { PaletteProps, ResolvedColorMode } from "../types";
+/**
+ * The floor a hover/active state's step off its own resting surface must clear to be seen at
+ * all — same value the SideBar ladder, Accordion, and NavigationBar hover states are held to.
+ * A "hover" a user cannot perceive is not a hover.
+ */
+export declare const MIN_PERCEPTIBLE_STEP = 1.15;
+/** WCAG 1.4.11 — a control outline is a UI component boundary, held to 3:1. */
+export declare const AA_NON_TEXT = 3;
+/**
+ * Walks a hex toward `target` contrast against `backdrop`, keeping its hue and saturation so the
+ * result still reads as the same colour. Darkens when `mode` is light, lightens when dark, and
+ * stops at the FIRST passing step so nothing overshoots to black or white.
+ */
+export declare function liftToContrast(hex: string, backdrop: string, mode: ResolvedColorMode, target?: number): string;
+/**
+ * `boxborder[500]` is the rung every control outline reads (Checkbox, SearchSelect, the date
+ * pickers, the editor's inputs). It was authored as a decorative value — measured 1.30-2.56:1
+ * across brands, so those controls rendered effectively borderless in BOTH modes. Resolved here
+ * rather than hand-pinned per brand: a copied hex goes stale the moment a canvas moves.
+ *
+ * `border[*]` is deliberately untouched — that ramp draws table gridlines, which are decorative
+ * and outside 1.4.11.
+ */
+export declare function withOutlineRung(palette: PaletteProps, mode: ResolvedColorMode): PaletteProps;
+/**
+ * A hover/active tint resolved against the surface it actually sits on, guaranteed to clear
+ * `MIN_PERCEPTIBLE_STEP`. Written for the recurring shape found across NavigationBar, UserDetails
+ * and Accordion: a pale `primary[50]`/`gray[50]` tint that measures near-1.0 on a near-white
+ * surface — invisible — with no dark-mode branch, so the same call site is wrong in both modes at
+ * once. `restSurface` is required rather than assumed white/black: a menu item's hover sits on
+ * its OWN list background, not necessarily the page canvas.
+ */
+export declare function resolveHoverTint(seed: string, restSurface: string): string;

package/dist/Theme/tokens/builders/outlineRung.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AA_NON_TEXT = exports.MIN_PERCEPTIBLE_STEP = void 0;
+exports.liftToContrast = liftToContrast;
+exports.withOutlineRung = withOutlineRung;
+exports.resolveHoverTint = resolveHoverTint;
+const color_1 = require("./color");
+const accentText_1 = require("./accentText");
+/**
+ * The floor a hover/active state's step off its own resting surface must clear to be seen at
+ * all — same value the SideBar ladder, Accordion, and NavigationBar hover states are held to.
+ * A "hover" a user cannot perceive is not a hover.
+ */
+exports.MIN_PERCEPTIBLE_STEP = 1.15;
+/** WCAG 1.4.11 — a control outline is a UI component boundary, held to 3:1. */
+exports.AA_NON_TEXT = 3;
+/**
+ * Walks a hex toward `target` contrast against `backdrop`, keeping its hue and saturation so the
+ * result still reads as the same colour. Darkens when `mode` is light, lightens when dark, and
+ * stops at the FIRST passing step so nothing overshoots to black or white.
+ */
+function liftToContrast(hex, backdrop, mode, target = exports.AA_NON_TEXT) {
+    if ((0, color_1.contrastRatio)(hex, backdrop) >= target)
+        return hex;
+    const { s } = (0, color_1.hexToHsl)(hex);
+    const step = mode === "dark" ? 1 : -1;
+    let { l } = (0, color_1.hexToHsl)(hex);
+    while (l > 0 && l < 100) {
+        l += step;
+        const next = (0, color_1.withLightness)(hex, l, s);
+        if ((0, color_1.contrastRatio)(next, backdrop) >= target)
+            return next;
+    }
+    return (0, color_1.withLightness)(hex, mode === "dark" ? 100 : 0, s);
+}
+/**
+ * `boxborder[500]` is the rung every control outline reads (Checkbox, SearchSelect, the date
+ * pickers, the editor's inputs). It was authored as a decorative value — measured 1.30-2.56:1
+ * across brands, so those controls rendered effectively borderless in BOTH modes. Resolved here
+ * rather than hand-pinned per brand: a copied hex goes stale the moment a canvas moves.
+ *
+ * `border[*]` is deliberately untouched — that ramp draws table gridlines, which are decorative
+ * and outside 1.4.11.
+ */
+function withOutlineRung(palette, mode) {
+    const current = palette.boxborder[500];
+    // The border sits between the control's fill and the surface behind it; hold it to the
+    // harder of the two.
+    const backdrop = (0, color_1.contrastRatio)(current, palette.backgroundColor.main) <=
+        (0, color_1.contrastRatio)(current, palette.background[50])
+        ? palette.backgroundColor.main
+        : palette.background[50];
+    const resolved = liftToContrast(current, backdrop, mode);
+    if (resolved === current)
+        return palette;
+    return { ...palette, boxborder: { ...palette.boxborder, 500: resolved } };
+}
+/**
+ * A hover/active tint resolved against the surface it actually sits on, guaranteed to clear
+ * `MIN_PERCEPTIBLE_STEP`. Written for the recurring shape found across NavigationBar, UserDetails
+ * and Accordion: a pale `primary[50]`/`gray[50]` tint that measures near-1.0 on a near-white
+ * surface — invisible — with no dark-mode branch, so the same call site is wrong in both modes at
+ * once. `restSurface` is required rather than assumed white/black: a menu item's hover sits on
+ * its OWN list background, not necessarily the page canvas.
+ */
+function resolveHoverTint(seed, restSurface) {
+    const mode = (0, accentText_1.isDarkCanvas)(restSurface) ? "dark" : "light";
+    return liftToContrast(seed, restSurface, mode, exports.MIN_PERCEPTIBLE_STEP);
+}

package/dist/Theme/tokens/builders/statusTone.d.ts

@@ -0,0 +1,34 @@
+import type { ColorScale, ResolvedColorMode } from "../types";
+export type StatusTone = {
+    /** Chip fill. */
+    bg: string;
+    /** Label ink, guaranteed >= 4.5:1 on `bg`. */
+    fg: string;
+    /** Chip outline, guaranteed >= 3:1 on `bg`. */
+    border: string;
+};
+/**
+ * Status chips (open / in-progress / resolved …) were authored as `X.500` text on an `X.100`
+ * tint, which measures 3.3-4.4:1 — under the 4.5:1 body-text bar in BOTH modes. The ink is
+ * resolved from the scale's own hue instead of pinned, so every brand and both modes land on the
+ * lightest ink that still passes rather than a hand-copied hex that goes stale.
+ *
+ * `reverseScale` flips the utility ramps in dark, so `X.100` is already a dark tint there and the
+ * ink walks lighter instead of darker — hence the mode argument.
+ */
+export declare function resolveStatusTone(scale: ColorScale, mode: ResolvedColorMode): StatusTone;
+/**
+ * Avatar initials are drawn white on a generated fill. The seed hues in use measured 1.92:1
+ * (`#eab308`), 2.54:1 (`#10b981`) and 3.76:1 (`#ef4444`) — failing in light mode too, not just
+ * dark. Darkening the fill keeps the intended hue and the white-initials look while clearing AA.
+ */
+export declare function resolveAvatarFill(hex: string, target?: number): string;
+/**
+ * Hue set for generated avatars. Values are seeds, not final fills — always pass them through
+ * `resolveAvatarFill` so the white initials stay legible.
+ */
+export declare const AVATAR_SEEDS: readonly ["#ef4444", "#f97316", "#eab308", "#22c55e", "#10b981", "#06b6d4", "#3b82f6", "#8b5cf6", "#ec4899"];
+/** Stable per-name avatar fill: same name always yields the same accessible colour. */
+export declare function avatarFillFor(seedText: string): string;
+/** True when `fg` clears the body-text bar on `bg` — exported for consumer assertions. */
+export declare const meetsBodyText: (fg: string, bg: string) => boolean;

package/dist/Theme/tokens/builders/statusTone.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meetsBodyText = exports.AVATAR_SEEDS = void 0;
+exports.resolveStatusTone = resolveStatusTone;
+exports.resolveAvatarFill = resolveAvatarFill;
+exports.avatarFillFor = avatarFillFor;
+const color_1 = require("./color");
+const accentText_1 = require("./accentText");
+const outlineRung_1 = require("./outlineRung");
+/**
+ * Status chips (open / in-progress / resolved …) were authored as `X.500` text on an `X.100`
+ * tint, which measures 3.3-4.4:1 — under the 4.5:1 body-text bar in BOTH modes. The ink is
+ * resolved from the scale's own hue instead of pinned, so every brand and both modes land on the
+ * lightest ink that still passes rather than a hand-copied hex that goes stale.
+ *
+ * `reverseScale` flips the utility ramps in dark, so `X.100` is already a dark tint there and the
+ * ink walks lighter instead of darker — hence the mode argument.
+ */
+function resolveStatusTone(scale, mode) {
+    const bg = scale[100];
+    const inkSeed = mode === "dark" ? scale[300] : scale[700];
+    const edgeSeed = mode === "dark" ? scale[400] : scale[300];
+    return {
+        bg,
+        fg: (0, outlineRung_1.liftToContrast)(inkSeed, bg, mode, accentText_1.AA_NORMAL_TEXT),
+        border: (0, outlineRung_1.liftToContrast)(edgeSeed, bg, mode, outlineRung_1.AA_NON_TEXT),
+    };
+}
+/**
+ * Avatar initials are drawn white on a generated fill. The seed hues in use measured 1.92:1
+ * (`#eab308`), 2.54:1 (`#10b981`) and 3.76:1 (`#ef4444`) — failing in light mode too, not just
+ * dark. Darkening the fill keeps the intended hue and the white-initials look while clearing AA.
+ */
+function resolveAvatarFill(hex, target = accentText_1.AA_NORMAL_TEXT) {
+    // "light" walks downward in lightness — i.e. darken until white ink clears the bar.
+    return (0, outlineRung_1.liftToContrast)(hex, "#ffffff", "light", target);
+}
+/**
+ * Hue set for generated avatars. Values are seeds, not final fills — always pass them through
+ * `resolveAvatarFill` so the white initials stay legible.
+ */
+exports.AVATAR_SEEDS = [
+    "#ef4444",
+    "#f97316",
+    "#eab308",
+    "#22c55e",
+    "#10b981",
+    "#06b6d4",
+    "#3b82f6",
+    "#8b5cf6",
+    "#ec4899",
+];
+/** Stable per-name avatar fill: same name always yields the same accessible colour. */
+function avatarFillFor(seedText) {
+    let hash = 0;
+    for (let i = 0; i < seedText.length; i++) {
+        hash = (hash * 31 + seedText.charCodeAt(i)) >>> 0;
+    }
+    return resolveAvatarFill(exports.AVATAR_SEEDS[hash % exports.AVATAR_SEEDS.length]);
+}
+/** True when `fg` clears the body-text bar on `bg` — exported for consumer assertions. */
+const meetsBodyText = (fg, bg) => (0, color_1.contrastRatio)(fg, bg) >= accentText_1.AA_NORMAL_TEXT;
+exports.meetsBodyText = meetsBodyText;

package/dist/Theme/tokens/index.d.ts

@@ -12,4 +12,3 @@ export * from "./types";
 export * from "./primitives";
 export * from "./brands";
 export * from "./builders";
-//# sourceMappingURL=index.d.ts.map

package/dist/Theme/tokens/primitives/breakpoints.d.ts

@@ -6,4 +6,3 @@ declare const breakpoints: {
     "2xl": string;
 };
 export default breakpoints;
-//# sourceMappingURL=breakpoints.d.ts.map

package/dist/Theme/tokens/primitives/index.d.ts

@@ -7,4 +7,3 @@ export { default as breakpoints } from "./breakpoints";
 export { default as lineHeights } from "./lineHeights";
 export { default as letterSpacings } from "./letterSpacings";
 export { default as typography, fonts, fontSizes, fontWeights } from "./typography";
-//# sourceMappingURL=index.d.ts.map

package/dist/Theme/tokens/primitives/letterSpacings.d.ts

@@ -7,4 +7,3 @@ declare const letterSpacings: {
     widest: string;
 };
 export default letterSpacings;
-//# sourceMappingURL=letterSpacings.d.ts.map

package/dist/Theme/tokens/primitives/lineHeights.d.ts

@@ -16,4 +16,3 @@ declare const lineHeights: {
     "10": string;
 };
 export default lineHeights;
-//# sourceMappingURL=lineHeights.d.ts.map

package/dist/Theme/tokens/primitives/radii.d.ts

@@ -10,4 +10,3 @@ declare const radii: {
     full: string;
 };
 export default radii;
-//# sourceMappingURL=radii.d.ts.map

package/dist/Theme/tokens/primitives/shadows.d.ts

@@ -13,4 +13,3 @@ declare const shadows: {
     darkLg: string;
 };
 export default shadows;
-//# sourceMappingURL=shadows.d.ts.map

package/dist/Theme/tokens/primitives/sizes.d.ts

@@ -60,4 +60,3 @@ declare const sizes: {
     96: string;
 };
 export default sizes;
-//# sourceMappingURL=sizes.d.ts.map

package/dist/Theme/tokens/primitives/space.d.ts

@@ -31,4 +31,3 @@ declare const space: {
     96: string;
 };
 export default space;
-//# sourceMappingURL=space.d.ts.map

package/dist/Theme/tokens/primitives/typography.d.ts

@@ -70,4 +70,3 @@ declare const typography: {
     };
 };
 export default typography;
-//# sourceMappingURL=typography.d.ts.map

package/dist/Theme/tokens/primitives/zIndices.d.ts

@@ -14,4 +14,3 @@ declare const zIndices: {
     tooltip: number;
 };
 export default zIndices;
-//# sourceMappingURL=zIndices.d.ts.map

package/dist/Theme/tokens/types.d.ts

@@ -113,4 +113,3 @@ export type ThemeName = "lavender" | "meadow" | "radiant" | "skyline" | "slate"
 export type ColorMode = "light" | "dark" | "system";
 /** Color mode after `system` has been resolved against the OS. */
 export type ResolvedColorMode = "light" | "dark";
-//# sourceMappingURL=types.d.ts.map

package/dist/Theme/useCustomTheme.d.ts

@@ -1,3 +1,2 @@
 import { CustomThemeProps } from "./themeProps";
 export declare const useCustomTheme: () => CustomThemeProps;
-//# sourceMappingURL=useCustomTheme.d.ts.map

package/dist/Utils/accountHandoff.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cross-app "Account handoff": deep-link from a product app (CRM, Tickets, HRMS)
+ * into the Account app carrying the token, so the user lands signed in. Consuming
+ * apps once copy-pasted this per repo; it lives here so they share one contract.
+ *
+ * Query-param contract (must stay in sync across every caller):
+ * `sourceApp`, `returnUrl`, `orgId`, `api_key` (+ `userId` on the users page).
+ *
+ * The library is pre-bundled, so it must not read `import.meta.env` — that would
+ * bake in the library's own build env. Env-derived values are injected as config.
+ */
+export declare function isAllowedReturnUrl(url: string): boolean;
+export type ResolveReturnUrlOptions = {
+    /** App-specific fallback (e.g. its own origin) used when the param is missing/disallowed. */
+    defaultReturnUrl?: string;
+};
+/**
+ * Receiver side (Account). Returns the `returnUrl` param only when it passes the
+ * allowlist, else the caller's `defaultReturnUrl` when that is allowed, else null.
+ * `fallbackOrgId` is accepted for caller symmetry; the app owns any org-derived
+ * fallback via `opts.defaultReturnUrl`.
+ */
+export declare function resolveReturnUrl(searchParams: URLSearchParams, fallbackOrgId?: number | string | null, opts?: ResolveReturnUrlOptions): string | null;
+export type AccountHandoffConfig = {
+    sourceApp: string;
+    /** The app's `VITE_ACCOUNT_UI` (may be empty). */
+    accountUiBase?: string;
+    /** This app's dev port, e.g. "3002". */
+    appLocalPort: string;
+    /** Account's dev port. Defaults to "3000". */
+    accountLocalPort?: string;
+    /** The app's `VITE_FORCE_REMOTE_ACCOUNT_UI === "true"`. */
+    forceRemote?: boolean;
+    /** Where Account returns the user to. Defaults to this app's own origin. */
+    buildReturnUrl?: (orgId?: number | string | null) => string;
+};
+export type AccountHandoffLinkOptions = {
+    sourceApp?: string;
+    returnUrl?: string;
+    orgId?: number | string | null;
+    token?: string | null;
+};
+export type AccountHandoffUsersOptions = AccountHandoffLinkOptions & {
+    userId?: number | string | null;
+};
+export type AccountHandoff = {
+    resolveAccountUiBase: () => string;
+    buildUsersPageUrl: (options?: AccountHandoffUsersOptions) => string;
+    navigateToUsersPage: (options?: AccountHandoffUsersOptions) => void;
+    buildOrganizationPageUrl: (options?: AccountHandoffLinkOptions) => string;
+    navigateToOrganizationPage: (options?: AccountHandoffLinkOptions) => void;
+};
+export declare function createAccountHandoff(config: AccountHandoffConfig): AccountHandoff;