@orangelogic/design-system 2.117.0 → 2.119.0

package/library/components/video.js

@@ -1,13 +1,13 @@
 import { _ as Bd, a as Sa, b as Be, c as Je } from "../chunks/inheritsLoose.BuSn_CvZ.js";
 import { c as ps, a as Bn } from "../chunks/_commonjsHelpers.DQNKXVTB.js";
 import { r as Sb } from "../chunks/___vite-browser-external_commonjs-proxy.C2tf3HsQ.js";
-import { C as Cb } from "../chunks/image.cT-FziNS.js";
+import { C as Cb } from "../chunks/image.BugewF1g.js";
 import Mb from "./resize-observer.js";
 import { r as Db, R as Pb, a as Rp, b as Lb } from "../chunks/resizable-component.styles.DpK0TTP5.js";
 import { c as Rb } from "../chunks/component.styles.CRO4Odto.js";
-import { b as Ib } from "../chunks/debounce.CIEhztrj.js";
+import { b as Ib } from "../chunks/browser.BHOCIF_A.js";
 import { c as Ob } from "../chunks/custom-element.L4WJXn1j.js";
-import { L as kb } from "../chunks/i18n.CH-wak_P.js";
+import { L as kb } from "../chunks/i18n.DDj5y9px.js";
 import { w as gn } from "../chunks/watch.CThbualB.js";
 import { i as Bb, x as Kc } from "../chunks/lit-element.jLBm65_O.js";
 import { n as ki } from "../chunks/lib-cortex-element.CVMmyPMC.js";

package/library/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orangelogic/design-system",
   "type": "module",
-  "version": "2.117.0",
+  "version": "2.119.0",
   "license": "UNLICENSED",
   "types": "library/types.d.ts",
   "scripts": {

package/library/packages/atoms/src/animations/index.d.ts

@@ -29,6 +29,7 @@ export * from './bouncing_exits/bounceOutDown';
 export * from './bouncing_exits/bounceOutLeft';
 export * from './bouncing_exits/bounceOutRight';
 export * from './bouncing_exits/bounceOutUp';
+export { easings } from './easings/easings';
 export * from './fading_entrances/fadeIn';
 export * from './fading_entrances/fadeInBottomLeft';
 export * from './fading_entrances/fadeInBottomRight';
@@ -64,6 +65,7 @@ export * from './lightspeed/lightSpeedInLeft';
 export * from './lightspeed/lightSpeedInRight';
 export * from './lightspeed/lightSpeedOutLeft';
 export * from './lightspeed/lightSpeedOutRight';
+export * from './rotating/rotate';
 export * from './rotating_entrances/rotateIn';
 export * from './rotating_entrances/rotateInDownLeft';
 export * from './rotating_entrances/rotateInDownRight';
@@ -96,4 +98,3 @@ export * from './zooming_exits/zoomOutDown';
 export * from './zooming_exits/zoomOutLeft';
 export * from './zooming_exits/zoomOutRight';
 export * from './zooming_exits/zoomOutUp';
-export { easings } from './easings/easings';

package/library/packages/atoms/src/animations/rotating/rotate.d.ts

@@ -0,0 +1,4 @@
+export declare const rotate: {
+    offset: number;
+    transform: string;
+}[];

package/library/packages/atoms/src/components/diff/diff.d.ts

@@ -0,0 +1,46 @@
+import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
+import { CSSResultGroup } from 'lit';
+
+/**
+ * @summary Renders a visual diff between two text or HTML values.
+ *
+ * In **auto mode** (default), pass `old-value` and `new-value` as attributes/properties.
+ * The component computes a word-level diff and highlights deleted text with strikethrough
+ * and inserted text in green.
+ *
+ * In **slot mode**, provide `slot="old"` and/or `slot="new"` children to fully control
+ * the rendering of each value — useful for non-text values like tags or icons.
+ *
+ * @slot old - Custom rendering for the old (deleted) value.
+ * @slot new - Custom rendering for the new (inserted) value.
+ *
+ * @csspart deleted - Wraps deleted content in slot mode.
+ * @csspart inserted - Wraps inserted content in slot mode.
+ *
+ * @cssproperty [--cx-diff-deleted-bg=var(--cx-color-neutral-200)] - Background color for deleted text.
+ * @cssproperty [--cx-diff-deleted-color=inherit] - Text color for deleted text.
+ * @cssproperty [--cx-diff-inserted-bg=var(--cx-color-success-200)] - Background color for inserted text.
+ * @cssproperty [--cx-diff-inserted-color=inherit] - Text color for inserted text.
+ * @cssproperty [--cx-diff-gap=var(--cx-spacing-2x-small)] - Gap between old and new values in slot mode.
+ */
+export default class CxDiff extends CortexElement {
+    static readonly styles: CSSResultGroup;
+    static readonly dependencies: {};
+    private readonly hasSlotController;
+    /** The old/previous value (plain text or HTML). Used in auto mode. */
+    oldValue: string;
+    /** The new/current value (plain text or HTML). Used in auto mode. */
+    newValue: string;
+    private diffResult;
+    private latestRequestId;
+    handleValuesChange(): void;
+    private refreshDiff;
+    private renderSlotMode;
+    private renderAutoMode;
+    render(): symbol | import('lit').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cx-diff': CxDiff;
+    }
+}

package/library/packages/atoms/src/components/diff/diff.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/library/packages/atoms/src/components/diff/utils/diff-worker-client.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Computes a word-level HTML diff between two values on a shared web worker.
+ *
+ * Every caller shares a single worker instance; requests are correlated to
+ * their responses by an internal id. Mounting many consumers therefore neither
+ * spawns multiple workers nor accumulates per-request listeners.
+ *
+ * Resolves with the diff HTML, or an empty string if the worker errors.
+ */
+export declare function computeDiff(oldValue: string, newValue: string): Promise<string>;

package/library/packages/atoms/src/components/select/select.d.ts

@@ -70,7 +70,7 @@ export default class CxSelect extends CortexElement implements CortexFormControl
     popup: CxPopup;
     combobox: HTMLSlotElement;
     displayInput: HTMLInputElement;
-    valueInput: HTMLInputElement;
+    valueInput: HTMLInputElement | null;
     listbox: HTMLSlotElement;
     private hasFocus;
     displayLabel: string;
@@ -272,6 +272,14 @@ export default class CxSelect extends CortexElement implements CortexFormControl
      * Gets the validation message
      */
     get validationMessage(): string;
+    /** Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid. */
+    checkValidity(): boolean;
+    /** Gets the associated form, if one exists. */
+    getForm(): HTMLFormElement | null;
+    /** Checks for validity and shows the browser's validation message if the control is invalid. */
+    reportValidity(): boolean;
+    /** Sets a custom validation message. Pass an empty string to restore validity. */
+    setCustomValidity(message: string): void;
     /**
      *
      * @param option The option to update the selected state
@@ -362,14 +370,6 @@ export default class CxSelect extends CortexElement implements CortexFormControl
     show(): Promise<void>;
     /** Hides the listbox. */
     hide(): Promise<void>;
-    /** Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid. */
-    checkValidity(): boolean;
-    /** Gets the associated form, if one exists. */
-    getForm(): HTMLFormElement | null;
-    /** Checks for validity and shows the browser's validation message if the control is invalid. */
-    reportValidity(): boolean;
-    /** Sets a custom validation message. Pass an empty string to restore validity. */
-    setCustomValidity(message: string): void;
     /** Sets focus on the control. */
     focus(options?: FocusOptions): void;
     /** Removes focus from the control. */

package/library/packages/atoms/src/components/tab-group/tab-group.d.ts

@@ -63,7 +63,7 @@ export default class CxTabGroup extends CortexElement {
     menu: CxMenu;
     tabButtons: HTMLElement;
     dropdownTrigger: CxButton;
-    private allDots;
+    private readonly allDots;
     private activeTab?;
     private hasScrollControls;
     private shouldHideScrollStartButton;

package/library/packages/atoms/src/components/table/components/index.d.ts

@@ -1,2 +1,3 @@
+export { default as CxTableFooter } from './table-footer/table-footer';
 export { default as CxTableRowActions } from './table-row-actions/table-row-actions';
 export { default as CxTableToolbar } from './table-toolbar/table-toolbar';

package/library/packages/atoms/src/components/table/components/table-footer/table-footer.d.ts

@@ -0,0 +1,25 @@
+import { default as CortexElement } from '../../../../../../base/src/cortex-element.ts';
+import { PaginationPlacement } from '../../../../../../types/src/table';
+import { CSSResultGroup } from 'lit';
+
+/**
+ * @summary Table footer that holds the pagination control for `bottom*` placement values.
+ *
+ * @slot pagination - The pagination control injected by `cx-table`.
+ *
+ * @csspart base - The component's host element (styled via `:host`).
+ */
+export default class CxTableFooter extends CortexElement {
+    static readonly styles: CSSResultGroup;
+    /**
+     * Controls horizontal alignment of the pagination control.
+     * Driven by `cx-table` — consumers should not set this directly.
+     */
+    paginationPlacement: PaginationPlacement;
+    render(): import('lit').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cx-table-footer': CxTableFooter;
+    }
+}

package/library/packages/atoms/src/components/table/components/table-footer/table-footer.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/library/packages/atoms/src/components/table/components/table-toolbar/table-toolbar.d.ts

@@ -10,7 +10,7 @@ import { default as CxSpace } from '../../../space/space.ts';
 import { default as CxTooltip } from '../../../tooltip/tooltip.ts';
 import { default as CxTypography } from '../../../typography/typography.ts';
 import { default as CortexElement } from '../../../../../../base/src/cortex-element.ts';
-import { SavedSearchItem, TableDropdownFilterData } from '../../../../../../types/src/table';
+import { PaginationPlacement, SavedSearchItem, TableDropdownFilterData } from '../../../../../../types/src/table';
 import { CSSResultGroup } from 'lit';
 import { default as CxTableDropdownFilter } from './table-dropdown-filter';
 import { default as CxTableSavedSearchDropdown } from './table-saved-search-dropdown';
@@ -113,6 +113,11 @@ export default class CxTableToolbar extends CortexElement {
      */
     showSavedSearch: boolean;
     searchValue: string;
+    /**
+     * Where the pagination control is placed. Only the `top*` values render the
+     * paginator inside this toolbar; the value drives the header alignment.
+     */
+    paginationPlacement: PaginationPlacement;
     private handleSearchSubmit;
     private handleAdvancedSearchClick;
     private handleClearSearch;
@@ -126,6 +131,7 @@ export default class CxTableToolbar extends CortexElement {
     private renderSavedSearchDropdown;
     private renderExportDropdown;
     private renderDropdownFilters;
+    private renderPagination;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/library/packages/atoms/src/components/table/table.d.ts

@@ -9,14 +9,15 @@ import { default as CxSpinner } from '../spinner/spinner.ts';
 import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
 import { RowComponent, TabulatorFull as Tabulator } from '../../../../hybrid/table-core/src/index.ts';
 import { PaginationCounter } from '../../../../types/src/pagination';
-import { HoverMenuOptions, SavedSearchItem, TableClipboardAction, TableDropdownFilterData, ColumnDefinition, Options, OptionsColumns, OptionsSpreadsheet, SheetDefinition, TableDataFormat } from '../../../../types/src/table';
+import { HoverMenuOptions, PaginationPlacement, SavedSearchItem, TableClipboardAction, TableDropdownFilterData, ColumnDefinition, Options, OptionsColumns, OptionsSpreadsheet, SheetDefinition, TableDataFormat } from '../../../../types/src/table';
 import { CSSResultGroup, TemplateResult } from 'lit';
-import { CxTableRowActions, CxTableToolbar } from './components';
+import { CxTableFooter, CxTableRowActions, CxTableToolbar } from './components';
 
 /**
  * @summary Tables are used to display data in a structured format.
  *
  * @csspart table - The table element.
+ * @csspart pagination-footer - The footer container that holds the pagination control when `pagination-placement` is a `bottom*` value.
  *
  * @cssproperty [--width=100%] - The width of the table.
  * @cssproperty [--table-height=auto] - The height of the table. By setting a height on the table, the Virtual DOM is enabled and the render speed is improved.
@@ -77,6 +78,7 @@ export default class CxTable extends CortexElement {
         'cx-select': typeof CxSelect;
         'cx-space': typeof CxSpace;
         'cx-spinner': typeof CxSpinner;
+        'cx-table-footer': typeof CxTableFooter;
         'cx-table-row-actions': typeof CxTableRowActions;
         'cx-table-toolbar': typeof CxTableToolbar;
     };
@@ -90,6 +92,7 @@ export default class CxTable extends CortexElement {
     private readonly tabulatorElement;
     private readonly table;
     private readonly tableToolbar;
+    private readonly tableFooter;
     movableRows: boolean;
     movableColumns: boolean;
     data: Options['data'];
@@ -603,6 +606,10 @@ export default class CxTable extends CortexElement {
      * Whether to show the button to go the last page.
      */
     paginationShowLast: boolean;
+    /**
+     * Where to place the pagination control relative to the table.
+     */
+    paginationPlacement: PaginationPlacement;
     /**
      * The hover menu options.
      */
@@ -696,6 +703,9 @@ export default class CxTable extends CortexElement {
     private dataUrlRequestId;
     get initialized(): boolean | undefined;
     get searchValue(): string;
+    get isBottomPlacement(): boolean;
+    get showToolbarPagination(): boolean;
+    get showPaginationFooter(): boolean;
     get showTableToolbar(): string | boolean;
     get clipboardOption(): Options['clipboard'];
     initTable(): Promise<void>;
@@ -727,7 +737,8 @@ export default class CxTable extends CortexElement {
     handleGroupLoadMoreMetaChange(): void;
     handlePaginationSizeChange(): void;
     handlePaginationChange(): Promise<void>;
-    private attachPaginatorToToolbar;
+    handlePaginationPlacementChange(): Promise<void>;
+    private placePaginator;
     handlePaginationInitialPageChange(): void;
     handleLoadingChange(): void;
     setLoading(value: boolean): void;

package/library/packages/atoms/src/index.d.ts

@@ -16,6 +16,7 @@ export { default as CxColorPicker } from './components/color-picker/color-picker
 export { default as CxCopyButton } from './components/copy-button/copy-button';
 export { default as CxDateCalendar } from './components/date-calendar/date-calendar';
 export { default as CxDetails } from './components/details/details';
+export { default as CxDiff } from './components/diff/diff';
 export { default as CxDialog } from './components/dialog/dialog';
 export { default as CxDivider } from './components/divider/divider';
 export { default as CxDocumentViewer } from './components/document-viewer/document-viewer';

package/library/packages/events/src/cx-capacity-change.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Emitted (debounced) by `cx-capacity-planner` when the user has edited one or
+ * more weeks. The detail carries the FULL category set for every edited week so
+ * the host's diff-by-(user, category, week) save create/update/deletes
+ * correctly within a week.
+ */
+export type CxCapacityChangeEvent = CustomEvent<{
+    weeks: Array<{
+        allocations: Array<{
+            categoryId: string;
+            hours: number;
+        }>;
+        weekStart: string;
+    }>;
+}>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-capacity-change': CxCapacityChangeEvent;
+    }
+}

package/library/packages/events/src/cx-capacity-week-bar.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Events emitted by `cx-capacity-week-bar` (a sub-component of
+ * `cx-capacity-planner` / `cx-team-capacity`). The week bar is purely
+ * presentational — it forwards pointer/keyboard intent to its container via
+ * these events; all allocation math lives in the container.
+ */
+/** Fired when a resizable band is pressed (drag-to-rebalance start). */
+export type CxCapacityWeekBarBandPointerDownEvent = CustomEvent<{
+    /** Measured pixel width of the bar element at press time (drift-proof). */
+    barWidth: number;
+    categoryId: string;
+    /** The originating pointer event (the container needs clientX / barW). */
+    pointerEvent: PointerEvent;
+}>;
+/** Fired when a band is stepped via the keyboard (Arrow / Page keys). */
+export type CxCapacityWeekBarBandStepEvent = CustomEvent<{
+    categoryId: string;
+    /** Signed hours to apply to the grabbed band via the shared rebalance. */
+    deltaHours: number;
+}>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-capacity-week-bar-band-pointer-down': CxCapacityWeekBarBandPointerDownEvent;
+        'cx-capacity-week-bar-band-step': CxCapacityWeekBarBandStepEvent;
+    }
+}

package/library/packages/events/src/cx-folder-select-children-loaded.d.ts

@@ -0,0 +1,10 @@
+import { Folder } from '../../types/src/folder-select';
+
+export type FolderSelectChildrenLoadedEvent = CustomEvent<{
+    folders: Folder[];
+}>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-folder-select-children-loaded': FolderSelectChildrenLoadedEvent;
+    }
+}

package/library/packages/events/src/cx-list-editor-change.d.ts

@@ -1,5 +1,5 @@
 export type CxListEditorChangeEvent = CustomEvent<{
-    data: Array<Record<string, string>>;
+    data: Array<Record<string, unknown>>;
 }>;
 declare global {
     interface GlobalEventHandlersEventMap {

package/library/packages/events/src/cx-sb-dam-view-config-change.d.ts

@@ -0,0 +1,8 @@
+export type CxSbDamViewConfigChangeEvent = CustomEvent<{
+    id: string;
+}>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-sb-dam-view-config-change': CxSbDamViewConfigChangeEvent;
+    }
+}

package/library/packages/events/src/events.d.ts

@@ -26,6 +26,8 @@ export * from './cx-border-input-group-change';
 export * from './cx-cancel';
 export * from './cx-cancel-connection';
 export * from './cx-cancel-upload';
+export * from './cx-capacity-change';
+export * from './cx-capacity-week-bar';
 export * from './cx-change';
 export * from './cx-chart-plan-change';
 export * from './cx-clear';
@@ -79,6 +81,7 @@ export * from './cx-find-and-replace';
 export * from './cx-finish';
 export * from './cx-focus';
 export * from './cx-folder-select-search-term-change';
+export * from './cx-folder-select-children-loaded';
 export * from './cx-gallery-chunk-request';
 export * from './cx-gallery-config-save';
 export * from './cx-gallery-item-click';
@@ -153,6 +156,7 @@ export * from './cx-rich-text-video-save';
 export * from './cx-save';
 export * from './cx-save-settings';
 export * from './cx-sb-button-click';
+export * from './cx-sb-dam-view-config-change';
 export * from './cx-video-thumbnail-resolved';
 export * from './cx-search';
 export * from './cx-select';

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Format/defaults/formatters/diff.d.ts

@@ -0,0 +1,5 @@
+import { DiffFormatterParams } from '../../../../../../../../types/src/table';
+import { default as CellComponent } from '../../../../core/cell/CellComponent';
+import { default as Format } from '../../Format';
+
+export default function diff(this: Format, cell: CellComponent, formatterParams: DiffFormatterParams): HTMLElement | string;

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Format/defaults/formatters.d.ts

@@ -6,6 +6,7 @@ import { default as color } from './formatters/color';
 import { default as composite } from './formatters/composite';
 import { default as datetime } from './formatters/datetime';
 import { default as datetimediff } from './formatters/datetimediff';
+import { default as diff } from './formatters/diff';
 import { default as handle } from './formatters/handle';
 import { default as html } from './formatters/html';
 import { default as icon } from './formatters/icon';
@@ -36,6 +37,7 @@ declare const defaultFormatters: {
     composite: typeof composite;
     datetime: typeof datetime;
     datetimediff: typeof datetimediff;
+    diff: typeof diff;
     handle: typeof handle;
     html: typeof html;
     icon: typeof icon;

package/library/packages/molecules/src/dynamic-select/dynamic-select.d.ts

@@ -5,6 +5,7 @@ import { default as CxSelect } from '../../../atoms/src/components/select/select
 import { default as CortexElement } from '../../../base/src/cortex-element.ts';
 import { Option } from '../../../types/src/content-builder';
 import { DynamicSelectApi } from '../../../types/src/dynamic-select';
+import { TableSelectColumn } from '../../../types/src/table-select';
 
 /**
  * @summary The `<cx-dynamic-select>` component is used to create a dynamic select input that can fetch options from an API.
@@ -162,6 +163,12 @@ export default class CxDynamicSelect extends CortexElement {
      */
     allowDefaultMouseDown: boolean;
     api?: DynamicSelectApi;
+    /**
+     * Column definitions for table-select mode.
+     * When provided, options are rendered as `<tr>` rows with the corresponding fields.
+     * The first column's cell text is used as the trigger label.
+     */
+    columns: TableSelectColumn[];
     useSearchTerm: boolean;
     /**
      * When set to true, the select will not select the current option when the user presses the Enter key.
@@ -197,10 +204,21 @@ export default class CxDynamicSelect extends CortexElement {
     private fetchOptions;
     handleStartChange(): Promise<void>;
     handleSearchTermChange(): Promise<void>;
+    handleColumnsChange(): Promise<void>;
+    private tableGetOptionValue;
+    private tableSetOptionSelected;
+    private tableSetOptionCurrent;
+    private tableGetOptionLabel;
+    private tableGetOptionSelected;
+    private tableGetOptionDisabled;
+    private tableFilterCallback;
+    private getCellValue;
+    private getColWidth;
     private handleInputChange;
     private handleLoadMore;
     private handleCustomChange;
-    render(): import('lit').TemplateResult<1>;
+    private renderTableOptions;
+    render(): import('lit-html/development/directive').DirectiveResult<typeof import('lit/directives/keyed.js').Keyed>;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/library/packages/molecules/src/folder-select/components/folder-select-tree/folder-select-tree.d.ts

@@ -33,6 +33,12 @@ export default class CxFolderSelectTree extends CortexElement {
     data: Folder[];
     hasMore: boolean;
     loading: boolean;
+    /**
+     * Folders fetched for selected IDs not yet rendered in the tree (e.g. nested
+     * under an unexpanded parent). Rendered as hidden tree items so cx-select can
+     * show their tags before lazy loading.
+     */
+    private preloadedFolders;
     /**
      * Selected folders encoded as `${path}-${id}`. Owned by this component
      * and forwarded down to all cx-folder-select-tree-items so they can
@@ -65,7 +71,12 @@ export default class CxFolderSelectTree extends CortexElement {
     handleSelectedChange(event: CxSelectionChangeEvent<CxTreeItem>): Promise<void>;
     loadMore(event: MouseEvent): Promise<void>;
     handleFetchFolders(): Promise<void>;
+    handleSelectedValueChange(): Promise<void>;
     private fetchFolders;
+    private handleChildrenLoaded;
+    private removePreloadedFolders;
+    private preloadSelectedFolders;
+    private seedSelectionFromValue;
     private renderFolder;
     render(): TemplateResult;
 }

package/library/packages/organisms/src/capacity-planner/capacity-core.d.ts

@@ -0,0 +1,81 @@
+import { CapacityCategory } from '../../../types/src/capacity-planner';
+import { clamp, quantizeLargestRemainder } from '../../../utils/src/custom-element/math';
+import { isoWeekNumber } from '../../../utils/src/date';
+
+export { clamp, isoWeekNumber, quantizeLargestRemainder };
+/** Minimum hours a category bottoms out at when dragged down. */
+export declare const FLOOR = 0.2;
+/**
+ * Reserved id for the synthetic "Unavailable" pseudo-category. It is never
+ * part of the server-provided `categories` prop and is NEVER included in the
+ * emitted change payload — the component synthesizes it purely so the UI total
+ * is always exactly the weekly capacity while real categories may sum to less.
+ * The sentinel is deliberately collision-proof (double-underscore delimited) so
+ * it cannot clash with a real category id.
+ */
+export declare const UNAVAILABLE_ID = "__unavailable__";
+/** Display name for the synthetic Unavailable band. */
+export declare const UNAVAILABLE_NAME = "Unavailable";
+/**
+ * Neutral grey for the Unavailable band — a clear mid-grey from the
+ * design-system neutral scale (`--cx-color-neutral-400`, #A1A1AA in the light
+ * theme), distinct from the saturated category hues. Falls back to the literal
+ * when the token is unavailable (e.g. jsdom).
+ */
+export declare const UNAVAILABLE_COLOR = "var(--cx-color-neutral-400, #A1A1AA)";
+/** The weekly-capacity constraints a shared math function operates under. */
+export interface CapacityConstraints {
+    /** Total hours available per week (C). */
+    capacity: number;
+    /** Optional per-category clamp (max hours a single REAL category may hold). */
+    maxHourPerCell?: number;
+}
+/**
+ * Adjust the largest non-pinned band so the total is exactly C, correcting any
+ * accumulated float drift. `pinned` is the index that must not be touched
+ * (the grabbed band on a drag); pass `-1` to allow correcting any band.
+ */
+export declare function correctToCapacity(vals: number[], pinned: number, capacity: number): number[];
+/**
+ * Per-band cap over the EFFECTIVE set (reals + Unavailable). The cap applies
+ * to REAL categories only — the synthetic Unavailable band (always the LAST
+ * effective band) is uncapped. The cap is ignored only when it is non-positive.
+ *
+ * `n` is the number of EFFECTIVE bands.
+ */
+export declare function effectiveCapFor(index: number, n: number, maxHourPerCell?: number): number;
+/**
+ * Distribute a `pool` of hours (the amount above all per-band floor baselines)
+ * across the bands at `indices`, proportional to `weightFor(j)`, writing the
+ * result into `vals[j]`. Implemented as a capped water-fill: whenever a band
+ * would exceed `capFor(j)`, it is pinned at its cap and its surplus spills onto
+ * the still-uncapped bands. Each band gets at least `floorFor(j)`. This is the
+ * ONE implementation shared by `rebalance` and the copy/fill/paste normalize so
+ * the cap behaviour cannot diverge between drag and copy.
+ */
+export declare function cappedWaterFill(vals: number[], indices: number[], pool: number, capFor: (index: number) => number, floorFor: (index: number) => number, weightFor: (index: number) => number): void;
+/**
+ * Normalize a source's REAL allocations into a written week under the
+ * Unavailable model. Real values are preserved verbatim (clamped ≥ 0), the
+ * synthetic Unavailable band absorbs the slack so the total is exactly C, and
+ * `maxHourPerCell` is enforced on the REAL categories only (a real that exceeds
+ * the cap spills its surplus onto the under-cap reals; the leftover still lands
+ * in Unavailable). A real category legitimately sitting at 0 stays 0, so a
+ * real-only week round-trips its values exactly. Routes copy / fill / paste.
+ * Returns a FULL effective map (reals + Unavailable).
+ */
+export declare function normalizeWeekToCapacity(allocations: Record<string, number>, categories: CapacityCategory[], { capacity, maxHourPerCell }: CapacityConstraints): Record<string, number>;
+/**
+ * Proportional rebalance for a drag on EFFECTIVE band `catIndex` (the reals
+ * followed by the synthetic Unavailable band). Grows/shrinks the grabbed band
+ * by the drag distance (`deltaHours`) and distributes the inverse change across
+ * the other bands — INCLUDING Unavailable — in proportion to their drag-start
+ * snapshot, never below FLOOR and never above `maxHourPerCell` (Unavailable is
+ * uncapped). The total is always exactly C. Implemented as a capped water-fill:
+ * the surplus from any band that hits its cap spills onto the uncapped bands.
+ *
+ * `snap` is the FULL effective snapshot (reals + Unavailable, Unavailable last).
+ */
+export declare function rebalance(snap: number[], catIndex: number, deltaHours: number, { capacity, maxHourPerCell }: CapacityConstraints): number[];
+/** Stable deterministic palette color for a category with no explicit color. */
+export declare function colorForCategory(id: string, index: number): string;