@gjsify/adwaita-core 0.14.0 → 0.16.0

package/lib/esm/index.js

@@ -1 +1 @@
-import{AdwBreakpoint as e,evaluateBreakpointCondition as t,parseBreakpointCondition as n}from"./breakpoint.js";import{DEFAULT_ICON_COLOR as r,DEFAULT_ICON_COLOR_DARK as i,adwaitaColorScheme as a,isThemeIconColor as o,onAdwaitaColorSchemeChanged as s,setAdwaitaColorScheme as c,themeIconColor as l,toggleAdwaitaColorScheme as u}from"./color-scheme.js";import{AdwAlertResponses as d}from"./dialog.js";import{AdwToast as f,AdwToastQueue as p,DEFAULT_TOAST_TIMEOUT as m}from"./toast.js";export{d as AdwAlertResponses,e as AdwBreakpoint,f as AdwToast,p as AdwToastQueue,r as DEFAULT_ICON_COLOR,i as DEFAULT_ICON_COLOR_DARK,m as DEFAULT_TOAST_TIMEOUT,a as adwaitaColorScheme,t as evaluateBreakpointCondition,o as isThemeIconColor,s as onAdwaitaColorSchemeChanged,n as parseBreakpointCondition,c as setAdwaitaColorScheme,l as themeIconColor,u as toggleAdwaitaColorScheme};
+import{AdwBreakpoint as e,evaluateBreakpointCondition as t,parseBreakpointCondition as n}from"./breakpoint.js";import{DEFAULT_ICON_COLOR as r,DEFAULT_ICON_COLOR_DARK as i,adwaitaColorScheme as a,isThemeIconColor as o,onAdwaitaColorSchemeChanged as s,setAdwaitaColorScheme as c,themeIconColor as l,toggleAdwaitaColorScheme as u}from"./color-scheme.js";import{AdwAlertResponses as d}from"./dialog.js";import{AdwToast as f,AdwToastQueue as p,DEFAULT_TOAST_TIMEOUT as m}from"./toast.js";import{ComboState as h,ExpanderState as g,SpinState as _,ToggleGroupState as v}from"./rows.js";export{d as AdwAlertResponses,e as AdwBreakpoint,f as AdwToast,p as AdwToastQueue,h as ComboState,r as DEFAULT_ICON_COLOR,i as DEFAULT_ICON_COLOR_DARK,m as DEFAULT_TOAST_TIMEOUT,g as ExpanderState,_ as SpinState,v as ToggleGroupState,a as adwaitaColorScheme,t as evaluateBreakpointCondition,o as isThemeIconColor,s as onAdwaitaColorSchemeChanged,n as parseBreakpointCondition,c as setAdwaitaColorScheme,l as themeIconColor,u as toggleAdwaitaColorScheme};

package/lib/esm/rows.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";var ExpanderState=class{constructor(){this._expanded=!1,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){for(let e of[...this._listeners])e(this._expanded)}get expanded(){return this._expanded}setExpanded(e){let t=!!e;return t===this._expanded?!1:(this._expanded=t,this._emit(),!0)}toggle(){return this.setExpanded(!this._expanded)}expand(){return this.setExpanded(!0)}collapse(){return this.setExpanded(!1)}},ComboState=class{constructor(){this._options=[],this._selected=0,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(e){let t={selected:this._selected,value:this.selectedValue,label:this.selectedLabel,interactive:e};for(let e of[...this._listeners])e(t)}_setIndex(e,t){return e===this._selected?!1:(this._selected=e,this._emit(t),!0)}get options(){return this._options}setOptions(e){this._options=Array.isArray(e)?e:[],this._selected>=this._options.length&&(this._selected=0),this._emit(!1)}get selectedIndex(){return this._selected}setSelectedIndex(e){return this._setIndex(Number.isFinite(e)?e:0,!1)}get selectedValue(){return this._options[this._selected]?.value??``}get selectedLabel(){return this._options[this._selected]?.label??``}setSelectedValue(e){let t=this._options.findIndex(t=>t.value===e);return t>=0?this.setSelectedIndex(t):!1}select(e){return e<0||e===this._selected?!1:this._setIndex(e,!0)}get count(){return this._options.length}},SpinState=class{constructor(){this._value=0,this._min=0,this._max=100,this._step=1,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(e){let t={value:this._value,interactive:e};for(let e of[...this._listeners])e(t)}_clamp(e){return Math.min(this._max,Math.max(this._min,e))}_bump(e){let t=this._clamp(this._value+e);return t===this._value?!1:(this._value=t,this._emit(!0),!0)}_reclamp(){let e=this._clamp(this._value);return e===this._value?!1:(this._value=e,this._emit(!1),!0)}get value(){return this._value}get min(){return this._min}get max(){return this._max}get step(){return this._step}setValue(e){let t=this._clamp(Number.isFinite(e)?e:0);return t===this._value?!1:(this._value=t,this._emit(!1),!0)}setMin(e){return this._min=Number.isFinite(e)?e:0,this._reclamp()}setMax(e){return this._max=Number.isFinite(e)?e:0,this._reclamp()}setStep(e){this._step=Number.isFinite(e)&&e>0?e:1}increment(){return this._bump(this._step)}decrement(){return this._bump(-this._step)}},ToggleGroupState=class{constructor(){this._labels=[],this._selected=0,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){let e={selected:this._selected,value:this.selectedValue};for(let t of[...this._listeners])t(e)}get labels(){return this._labels}setLabels(e){this._labels=Array.isArray(e)?e:[],this._selected>=this._labels.length&&(this._selected=0)}get selected(){return this._selected}setSelected(e){let t=Number.isFinite(e)?e:0;return t===this._selected||t<0||t>=this._labels.length?!1:(this._selected=t,this._emit(),!0)}get selectedValue(){return this._labels[this._selected]??``}get count(){return this._labels.length}};export{ComboState,ExpanderState,SpinState,ToggleGroupState};

package/lib/types/index.d.ts

@@ -1,8 +1,10 @@
-export { AdwBreakpoint, evaluateBreakpointCondition, parseBreakpointCondition, } from './breakpoint.js';
+export { AdwBreakpoint, evaluateBreakpointCondition, parseBreakpointCondition } from './breakpoint.js';
 export type { AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './breakpoint.js';
 export { DEFAULT_ICON_COLOR, DEFAULT_ICON_COLOR_DARK, adwaitaColorScheme, isThemeIconColor, onAdwaitaColorSchemeChanged, setAdwaitaColorScheme, themeIconColor, toggleAdwaitaColorScheme, } from './color-scheme.js';
 export type { AdwColorScheme } from './color-scheme.js';
 export { AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT } from './toast.js';
 export type { AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, } from './toast.js';
 export { AdwAlertResponses } from './dialog.js';
-export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses, } from './dialog.js';
+export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, OrderedConfirmResponses } from './dialog.js';
+export { ComboState, ExpanderState, SpinState, ToggleGroupState } from './rows.js';
+export type { AdwComboOption, ComboStateChange, ComboStateListener, ExpanderStateListener, SpinStateChange, SpinStateListener, ToggleGroupStateChange, ToggleGroupStateListener, } from './rows.js';

package/lib/types/rows.d.ts

@@ -0,0 +1,185 @@
+/** Subscriber for {@link ExpanderState} changes — receives the new expanded flag. */
+export type ExpanderStateListener = (expanded: boolean) => void;
+/**
+ * The disclosure state of an expander row: a single boolean that toggles between
+ * revealed and collapsed. Idempotent — setting the current value again is a no-op
+ * and fires no notification. Both programmatic and interactive changes notify (as
+ * `Adw.ExpanderRow` does).
+ */
+export declare class ExpanderState {
+    private _expanded;
+    private readonly _listeners;
+    /** Subscribe to expanded-state changes. Returns an unsubscribe function. */
+    subscribe(listener: ExpanderStateListener): () => void;
+    private _emit;
+    /** Whether the disclosure is revealed. */
+    get expanded(): boolean;
+    /** Set the expanded flag. Notifies only on an actual change. Returns whether it changed. */
+    setExpanded(value: boolean): boolean;
+    /** Flip expanded↔collapsed (the disclosure tap). Returns whether it changed. */
+    toggle(): boolean;
+    /** Reveal the disclosure. Returns whether it changed. */
+    expand(): boolean;
+    /** Collapse the disclosure. Returns whether it changed. */
+    collapse(): boolean;
+}
+/** One selectable option in a {@link ComboState}. */
+export interface AdwComboOption {
+    /** Display label shown in the row + chooser. */
+    label: string;
+    /** Underlying value returned by {@link ComboState.selectedValue}. */
+    value: string;
+}
+/** Payload of a {@link ComboState} change. */
+export interface ComboStateChange {
+    /** The (new) selected index. */
+    selected: number;
+    /** The selected option's `value` (or `''` when out of range). */
+    value: string;
+    /** The selected option's `label` (or `''` when out of range) — drives the inline display. */
+    label: string;
+    /** True for a user pick ({@link ComboState.select}); false for a programmatic set. */
+    interactive: boolean;
+}
+/** Subscriber for {@link ComboState} changes. */
+export type ComboStateListener = (change: ComboStateChange) => void;
+/**
+ * The selection state of a combo row: an options list plus the selected index,
+ * with a two-way index↔value mapping and empty/out-of-range guards. Mirrors
+ * `Adw.ComboRow`: a programmatic set ({@link setSelectedIndex} / {@link setSelectedValue}
+ * / {@link setOptions}) updates silently (`interactive: false` — the renderer refreshes
+ * the inline value but re-emits no `notify::selected`), while {@link select} is the
+ * user pick that notifies (`interactive: true`).
+ */
+export declare class ComboState {
+    private _options;
+    private _selected;
+    private readonly _listeners;
+    /** Subscribe to selection changes. Returns an unsubscribe function. */
+    subscribe(listener: ComboStateListener): () => void;
+    private _emit;
+    private _setIndex;
+    /** The selectable options. */
+    get options(): AdwComboOption[];
+    /**
+     * Replace the options. Resets the selection to 0 when the current index no
+     * longer fits (mirroring `Adw.ComboRow`), then notifies (`interactive: false`)
+     * so the renderer re-syncs the inline value label (the label may change even at
+     * the same index).
+     */
+    setOptions(options: AdwComboOption[]): void;
+    /** The selected option index (may sit past the options length — {@link selectedValue} then is `''`). */
+    get selectedIndex(): number;
+    /** Programmatic index set — notifies `interactive: false`. Returns whether it changed. */
+    setSelectedIndex(index: number): boolean;
+    /** The selected option's `value`, or `''` when out of range. */
+    get selectedValue(): string;
+    /** The selected option's `label`, or `''` when out of range (the inline display text). */
+    get selectedLabel(): string;
+    /** Programmatic value set — moves the index to the first option with this `value`. No-op for an unknown value. */
+    setSelectedValue(value: string): boolean;
+    /**
+     * Select an option by index as a USER pick (the chooser result) — notifies
+     * `interactive: true`. A no-op (returns false) for a negative index or the
+     * already-selected one, matching the renderer's chooser guard.
+     */
+    select(index: number): boolean;
+    /** Number of options. */
+    get count(): number;
+}
+/** Payload of a {@link SpinState} change. */
+export interface SpinStateChange {
+    /** The new value (already clamped to `[min, max]`). */
+    value: number;
+    /** True for a stepper press ({@link SpinState.increment}/{@link SpinState.decrement}); false for a programmatic set/re-clamp. */
+    interactive: boolean;
+}
+/** Subscriber for {@link SpinState} changes. */
+export type SpinStateListener = (change: SpinStateChange) => void;
+/**
+ * The numeric adjustment state of a spin row: `value` bounded by `[min, max]` and
+ * stepped by `step`. Every mutation clamps into range. Mirrors `Adw.SpinRow`: a
+ * programmatic {@link setValue} (or a re-clamp from a moved {@link setMin}/{@link setMax})
+ * notifies `interactive: false` (the renderer refreshes the display but re-emits no
+ * `notify::value`), while {@link increment}/{@link decrement} are the stepper presses
+ * that notify `interactive: true`.
+ */
+export declare class SpinState {
+    private _value;
+    private _min;
+    private _max;
+    private _step;
+    private readonly _listeners;
+    /** Subscribe to value changes. Returns an unsubscribe function. */
+    subscribe(listener: SpinStateListener): () => void;
+    private _emit;
+    private _clamp;
+    private _bump;
+    /** Re-clamp the current value after a bound moved; notifies `interactive: false` on change. */
+    private _reclamp;
+    /** The current numeric value (always within `[min, max]`). */
+    get value(): number;
+    /** Lower bound. */
+    get min(): number;
+    /** Upper bound. */
+    get max(): number;
+    /** Increment/decrement step applied per stepper press. */
+    get step(): number;
+    /** Programmatic value set — clamp, notify `interactive: false` on change. Returns whether it changed. */
+    setValue(value: number): boolean;
+    /** Set the lower bound and re-clamp the value into range. Returns whether the value changed. */
+    setMin(value: number): boolean;
+    /** Set the upper bound and re-clamp the value into range. Returns whether the value changed. */
+    setMax(value: number): boolean;
+    /** Set the step. A non-positive or non-finite step falls back to `1`. */
+    setStep(value: number): void;
+    /** Step up by `step`, clamped to `max`. Notifies `interactive: true` on change. Returns whether it changed. */
+    increment(): boolean;
+    /** Step down by `step`, clamped to `min`. Notifies `interactive: true` on change. Returns whether it changed. */
+    decrement(): boolean;
+}
+/** Payload of a {@link ToggleGroupState} change. */
+export interface ToggleGroupStateChange {
+    /** The newly-selected segment index. */
+    selected: number;
+    /** The newly-selected segment's label (or `''` when out of range). */
+    value: string;
+}
+/** Subscriber for {@link ToggleGroupState} changes. */
+export type ToggleGroupStateListener = (change: ToggleGroupStateChange) => void;
+/**
+ * The selection state of a segmented toggle group: a label list plus the selected
+ * index. Mirrors `Adw.ToggleGroup`: {@link setLabels} replaces the segments (resetting
+ * the selection to 0 when the current index no longer fits) WITHOUT notifying — the
+ * renderer rebuilds its segment views — while {@link setSelected} is the guarded
+ * selection change (bounds + no-op-on-same) that notifies. Both programmatic and
+ * interactive selections notify (as `Adw.ToggleGroup` does).
+ */
+export declare class ToggleGroupState {
+    private _labels;
+    private _selected;
+    private readonly _listeners;
+    /** Subscribe to selection changes. Returns an unsubscribe function. */
+    subscribe(listener: ToggleGroupStateListener): () => void;
+    private _emit;
+    /** The segment labels. */
+    get labels(): string[];
+    /**
+     * Replace the segment labels. Resets the selection to 0 when the current index
+     * no longer fits. Silent — the renderer rebuilds its segment views and re-applies
+     * the active pill from {@link selected}.
+     */
+    setLabels(labels: string[]): void;
+    /** The selected segment index. */
+    get selected(): number;
+    /**
+     * Select a segment. Guarded like `Adw.ToggleGroup`: a non-finite, negative,
+     * out-of-range, or already-selected index is a no-op. Notifies on a valid change.
+     * Returns whether it changed.
+     */
+    setSelected(index: number): boolean;
+    /** The selected segment's label, or `''` when out of range. */
+    get selectedValue(): string;
+    /** Number of segments. */
+    get count(): number;
+}

package/lib/types/rows.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-core",
-    "version": "0.14.0",
+    "version": "0.16.0",
     "description": "Headless Adwaita widget behavior (breakpoint condition grammar + apply/unapply state machine, color-scheme observable) shared by the web and NativeScript Adwaita renderers — pure TS, no platform imports",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -39,8 +39,8 @@
         "headless"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.14.0",
-        "@gjsify/unit": "^0.14.0",
+        "@gjsify/cli": "^0.16.0",
+        "@gjsify/unit": "^0.16.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },