@zeyos/zx 2.3.0 → 3.0.0

package/dist/types/core/drag-axis.d.ts

@@ -0,0 +1,111 @@
+/** Pixels an arrow key moves a handle. */
+export declare const STEP = 16;
+/** Pixels a shifted arrow key moves a handle. */
+export declare const STEP_LARGE = 64;
+export type DragAxisOptions = {
+    /**
+     * Axis the handle moves along. `horizontal` reads
+     * `clientX`, `vertical` reads `clientY`.
+     */
+    orientation: 'horizontal' | 'vertical';
+    /**
+     * Called on pointer-down before the
+     * drag begins. Return `false` to refuse it — the usual reason being that there is nothing to
+     * resize on either side of the handle.
+     */
+    onStart?: (event: PointerEvent) => boolean | void;
+    /**
+     * Called at most once per frame with the signed pixel
+     * distance travelled along the axis since pointer-down.
+     */
+    onMove: (delta: number) => void;
+    /**
+     * Called once the pointer is released.
+     * `moved` is false for a press that never travelled, which is a click rather than a drag.
+     */
+    onEnd?: (delta: number, moved: boolean) => void;
+    /**
+     * Called for an arrow key along the
+     * axis. `large` is true while Shift is held.
+     */
+    onStep?: (direction: -1 | 1, large: boolean) => void;
+    /**
+     * Called for Home and End.
+     */
+    onJump?: (edge: 'min' | 'max') => void;
+    /**
+     * Called for Enter and Space, which components use for the
+     * collapse affordance a splitter is expected to offer.
+     */
+    onActivate?: () => void;
+    /**
+     * Consulted before every interaction.
+     */
+    disabled?: () => boolean;
+};
+export type DragAxisController = {
+    /**
+     * Whether a drag is in flight.
+     */
+    isDragging: () => boolean;
+    /**
+     * Ends any drag in flight without reporting it.
+     */
+    cancel: () => void;
+    /**
+     * Removes listeners and cancels any drag in flight.
+     */
+    destroy: () => void;
+};
+/**
+ * @typedef {Object} DragAxisOptions
+ * @property {'horizontal'|'vertical'} orientation Axis the handle moves along. `horizontal` reads
+ *   `clientX`, `vertical` reads `clientY`.
+ * @property {(event: PointerEvent) => boolean|void} [onStart] Called on pointer-down before the
+ *   drag begins. Return `false` to refuse it — the usual reason being that there is nothing to
+ *   resize on either side of the handle.
+ * @property {(delta: number) => void} onMove Called at most once per frame with the signed pixel
+ *   distance travelled along the axis since pointer-down.
+ * @property {(delta: number, moved: boolean) => void} [onEnd] Called once the pointer is released.
+ *   `moved` is false for a press that never travelled, which is a click rather than a drag.
+ * @property {(direction: -1|1, large: boolean) => void} [onStep] Called for an arrow key along the
+ *   axis. `large` is true while Shift is held.
+ * @property {(edge: 'min'|'max') => void} [onJump] Called for Home and End.
+ * @property {() => void} [onActivate] Called for Enter and Space, which components use for the
+ *   collapse affordance a splitter is expected to offer.
+ * @property {() => boolean} [disabled] Consulted before every interaction.
+ */
+/**
+ * @typedef {Object} DragAxisController
+ * @property {() => boolean} isDragging Whether a drag is in flight.
+ * @property {() => void} cancel Ends any drag in flight without reporting it.
+ * @property {() => void} destroy Removes listeners and cancels any drag in flight.
+ */
+/**
+ * Pointer and keyboard mechanics for anything dragged along one axis — a split divider, a dock
+ * divider, the resizable edge of a sheet.
+ *
+ * Deliberately knows nothing about sizes. It reports the signed distance travelled and leaves
+ * every consumer to do its own arithmetic, because the three that need it disagree about what a
+ * drag means: a split view moves one boundary, a dock moves size between two neighbours, and a
+ * sheet grows in the opposite direction depending on which edge it is attached to. What they do
+ * share is the fiddly part — pointer capture that survives the pointer leaving the handle, one
+ * write per frame however fast the pointer reports, telling a click apart from a zero-distance
+ * drag, and the WAI-ARIA keyboard map.
+ *
+ * @param {Element} handle Element the pointer grabs; also the keyboard target.
+ * @param {DragAxisOptions} options Axis and callbacks.
+ * @returns {DragAxisController}
+ */
+export declare function dragAxis(handle: Element, options: DragAxisOptions): DragAxisController;
+/**
+ * Resolves a size option to pixels without touching the DOM.
+ *
+ * Numbers, bare numeric strings, and `px` lengths are pixels; a percentage resolves against
+ * `total`. Every other CSS length — `rem`, `vh`, `calc()` — needs the browser, so it returns `NaN`
+ * and the caller hands the value to CSS instead of guessing at it.
+ * @param {number|string} value Size option.
+ * @param {number} total Container size along the split axis, in pixels.
+ * @returns {number} Pixels, or `NaN` when only the browser can resolve the value.
+ */
+export declare function resolveSize(value: number | string, total: number): number;

package/dist/types/core/position.d.ts

@@ -1,5 +1,6 @@
+export type Placement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top' | 'right-start' | 'right-end' | 'left-start' | 'left-end' | 'right' | 'left';
 export type PositionOptions = {
-    placement?: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top';
+    placement?: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'bottom' | 'top' | 'right-start' | 'right-end' | 'left-start' | 'left-end' | 'right' | 'left';
     /**
      * Gap between anchor and floating element.
      */
@@ -23,9 +24,10 @@ export type PositionController = {
      */
     destroy: () => void;
 };
+/** @typedef {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'} Placement */
 /**
  * @typedef {Object} PositionOptions
- * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'} [placement='bottom-start']
+ * @property {'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'} [placement='bottom-start']
  * @property {number} [offset=4] Gap between anchor and floating element.
  * @property {boolean} [flip=true] Flip vertically when the preferred side overflows.
  * @property {boolean} [matchWidth=false] Set the floating element's minimum width to the anchor width.

package/dist/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 export declare function registerFieldAdapters(): void;
 export { Component } from './core/component.js';
-export { h, htmlEscape, resolveElement, highlightMatch } from './core/dom.js';
+export { h, htmlEscape, resolveElement, highlightMatch, __, compactElement, fragment, parseCompactTag, applyCompactProperties, appendContent, appendCompact, appendCompactChild, onCompactEvent, offCompactEvent, fireCompactEvent } from './core/dom.js';
 export { position } from './core/position.js';
 export { breakpoints, breakpointOf, matchBreakpoint, onBreakpoint } from './core/breakpoint.js';
 export { Http, zeyosService, parseResult } from './core/http.js';
@@ -40,15 +40,23 @@ export { Groupbox } from './components/groupbox/groupbox.js';
 export { Panel } from './components/panel/panel.js';
 export { MasterPanel } from './components/master-panel/master-panel.js';
 export { SplitView, clampSize, resolveSize, snapSize } from './components/split-view/split-view.js';
+export { Dock } from './components/dock/dock.js';
 export { Tabbox } from './components/tabbox/tabbox.js';
 export { NavigationBar } from './components/navigation-bar/navigation-bar.js';
 export { Stepper } from './components/stepper/stepper.js';
 export { Breadcrumb } from './components/breadcrumb/breadcrumb.js';
 export { Pagination, paginationRange } from './components/pagination/pagination.js';
 export { Search } from './components/search/search.js';
+export { Launcher, rankLauncherItems } from './components/launcher/launcher.js';
+export { Avatar, avatarInitials } from './components/avatar/avatar.js';
+export { AccountMenu } from './components/account-menu/account-menu.js';
+export { AppRail, normalizeAppItems } from './components/app-rail/app-rail.js';
+export { AppSidebar } from './components/app-sidebar/app-sidebar.js';
 export { Message } from './components/message/message.js';
 export { Modal } from './components/modal/modal.js';
 export { Dialog } from './components/dialog/dialog.js';
+export { Sheet } from './components/sheet/sheet.js';
+export { SheetStack } from './components/sheet/sheet-stack.js';
 export { Dropdown } from './components/dropdown/dropdown.js';
 export { Tooltip, tooltip, describe } from './components/tooltip/tooltip.js';
 export { MenuButton } from './components/menu-button/menu-button.js';
@@ -59,7 +67,6 @@ export { TagPicker } from './components/tag-picker/tag-picker.js';
 export { NumberField, parseNumber, snapNumber } from './components/number-field/number-field.js';
 export { Rating } from './components/rating/rating.js';
 export { Slider, stepPrecision } from './components/slider/slider.js';
-export { Permission } from './components/permission/permission.js';
 export { DatePicker } from './components/date-picker/date-picker.js';
 export { MonthPicker } from './components/date-picker/month-picker.js';
 export { TimePicker } from './components/date-picker/time-picker.js';
@@ -68,12 +75,15 @@ export { DateRangePicker, clampRange, defaultDateRangePresets, normalizeRange, r
 export { DateRangeBox, formatRangeText, parseRangeText } from './components/datebox/date-range-box.js';
 export { Timebox, splitTime, joinTime } from './components/timebox/timebox.js';
 export { Table } from './components/table/table.js';
+export { Grid, billingColumns, isBillingLine } from './components/grid/grid.js';
+export { Chart, ChartJsAdapter, chartSummaryTable, cloneChartValue, isEmptyChartData } from './components/chart/chart.js';
 export { TreeView } from './components/tree/tree.js';
 export { Finder } from './components/finder/finder.js';
 export { DataFilter } from './components/data-filter/data-filter.js';
 export { Field } from './components/field/field.js';
 export { Fieldset } from './components/fieldset/fieldset.js';
 export { Form } from './components/form/form.js';
+export { Questionnaire } from './components/questionnaire/questionnaire.js';
 export { ValueList } from './components/value-list/value-list.js';
 export { MultiValueEditor } from './components/multi-value-editor/multi-value-editor.js';
 export { FieldUpload } from './components/field-upload/field-upload.js';