@gjsify/adwaita-core 0.41.0 → 0.42.0

package/lib/esm/breakpoint.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";const e=/^(min|max)-(width|height)\s*:\s*(\d+(?:\.\d+)?)\s*(px|sp|pt)?$/i;function isLeaf(e){return e.op===void 0}function splitOn(e,t){let n=0;for(let r=e.length-1;r>=0;r--){let i=e[r];if(i===`)`)n++;else if(i===`(`)n--;else if(n===0){let n=r-t.length+1;if(n>0&&r+1<e.length&&/\s/.test(e[n-1])&&/\s/.test(e[r+1])&&e.slice(n,r+1).toLowerCase()===t)return{left:e.slice(0,n),right:e.slice(r+1)}}}return null}function splitTopLevel(e){for(let t of[`or`,`and`]){let n=splitOn(e,t);if(n)return{op:t,...n}}return null}function parseBreakpointCondition(t){let n=t.trim();if(!n)return null;let r=splitTopLevel(n);if(r){let e=parseBreakpointCondition(r.left),t=parseBreakpointCondition(r.right);return!e||!t?null:{op:r.op,left:e,right:t}}if(n.startsWith(`(`)&&n.endsWith(`)`))return parseBreakpointCondition(n.slice(1,-1));let i=e.exec(n);return i?{bound:i[1].toLowerCase(),dimension:i[2].toLowerCase(),value:Number.parseFloat(i[3])}:null}function evaluateBreakpointCondition(e,t){if(isLeaf(e)){let n=e.dimension===`width`?t.width:t.height;return e.bound===`max`?n<=e.value:n>=e.value}let n=evaluateBreakpointCondition(e.left,t);return e.op===`and`?n&&evaluateBreakpointCondition(e.right,t):n||evaluateBreakpointCondition(e.right,t)}var AdwBreakpoint=class{constructor(e,t){this._applied=!1,this.condition=typeof e==`string`?parseBreakpointCondition(e):e??null,this._handlers=t}get applied(){return this._applied}evaluate(e){let t=this.condition?evaluateBreakpointCondition(this.condition,e):!1;return t===this._applied?this._applied:(this._applied=t,t?this._handlers.onApply():this._handlers.onUnapply?.(),this._applied)}};export{AdwBreakpoint,evaluateBreakpointCondition,parseBreakpointCondition};
+import"./_virtual/_rolldown/runtime.js";const e=/^(min|max)-(width|height)\s*:\s*(\d+(?:\.\d+)?)\s*(px|sp|pt)?$/i;function isLeaf(e){return e.op===void 0}function splitOn(e,t){let n=0;for(let r=e.length-1;r>=0;r--){let i=e[r];if(i===`)`)n++;else if(i===`(`)n--;else if(n===0){let n=r-t.length+1;if(n>0&&r+1<e.length&&/\s/.test(e[n-1])&&/\s/.test(e[r+1])&&e.slice(n,r+1).toLowerCase()===t)return{left:e.slice(0,n),right:e.slice(r+1)}}}return null}function splitTopLevel(e){for(let t of[`or`,`and`]){let n=splitOn(e,t);if(n)return{op:t,...n}}return null}function parseBreakpointCondition(t){let n=t.trim();if(!n)return null;let r=splitTopLevel(n);if(r){let e=parseBreakpointCondition(r.left),t=parseBreakpointCondition(r.right);return!e||!t?null:{op:r.op,left:e,right:t}}if(n.startsWith(`(`)&&n.endsWith(`)`))return parseBreakpointCondition(n.slice(1,-1));let i=e.exec(n);return i?{bound:i[1].toLowerCase(),dimension:i[2].toLowerCase(),value:Number.parseFloat(i[3])}:null}function evaluateBreakpointCondition(e,t){if(isLeaf(e)){let n=e.dimension===`width`?t.width:t.height;return e.bound===`max`?n<=e.value:n>=e.value}let n=evaluateBreakpointCondition(e.left,t);return e.op===`and`?n&&evaluateBreakpointCondition(e.right,t):n||evaluateBreakpointCondition(e.right,t)}var AdwBreakpoint=class{constructor(e,t,n=!1){this._applied=!1,this.condition=typeof e==`string`?parseBreakpointCondition(e):e??null,this._handlers=t,this._applied=n}get applied(){return this._applied}evaluate(e){let t=this.condition?evaluateBreakpointCondition(this.condition,e):!1;return t===this._applied?this._applied:(this._applied=t,t?this._handlers.onApply():this._handlers.onUnapply?.(),this._applied)}};export{AdwBreakpoint,evaluateBreakpointCondition,parseBreakpointCondition};

package/lib/types/breakpoint.d.ts

@@ -48,7 +48,17 @@ export declare class AdwBreakpoint {
     readonly condition: BreakpointConditionNode | null;
     private _handlers;
     private _applied;
-    constructor(condition: string | BreakpointConditionNode | null, handlers: AdwBreakpointHandlers);
+    /**
+     * `applied` is the state this breakpoint INHERITS — the one a breakpoint it replaces
+     * had reached. It exists because {@link evaluate} fires on a TRANSITION only: a
+     * renderer that has to rebuild the object (a browser element rebinding its
+     * ResizeObserver after a re-parent) otherwise restarts at `false`, and a view the
+     * old breakpoint had collapsed, re-evaluated where the condition is FALSE, matches
+     * its own starting state and never hears `onUnapply`. Measured: a
+     * `<adw-navigation-split-view>` moved 800px → 500px → 900px stayed collapsed at
+     * 900px, and only a narrow→wide cycle IN PLACE healed it.
+     */
+    constructor(condition: string | BreakpointConditionNode | null, handlers: AdwBreakpointHandlers, applied?: boolean);
     /** Whether the condition is currently satisfied (apply has fired, not unapply). */
     get applied(): boolean;
     /**

package/lib/types/conformance/about-dialog.d.ts

@@ -38,7 +38,12 @@ export interface TranslatorCreditsVector {
  * and no section is drawn, where JS `''.split('\n')` is `['']` and
  * draws the section with one blank row.
  *
- * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
+ * CORE-ONLY: GAP — `adw-about-dialog` has no `translator-credits` property, and the browser
+ * spec skips every row that sets one (`if (input.translatorCredits !== undefined) continue`, in
+ * adw-about-dialog.spec.ts). So the empty-string row above — the one this docblock singles out
+ * as what a port gets wrong — reaches nothing outside the core suite. It was exempted here as an
+ * internal step of ABOUT_DIALOG_CREDITS_LEGAL_VECTORS, a three-boolean visibility table with no
+ * translator input at all. Tracked in #1072
  */
 export declare const TRANSLATOR_CREDITS_VECTORS: ReadonlyArray<TranslatorCreditsVector>;
 /** One assembled credits-page expectation. */
@@ -190,7 +195,11 @@ export interface AboutDialogLabelVector {
  * page "About <app>" AND labelling the dialog "About <app>" says the app's name
  * three times on one screen.
  *
- * CORE-ONLY: a string table the renderers read THROUGH ADW_ABOUT_DIALOG_LABELS; the rendered text is asserted by ABOUT_DIALOG_HEADER/DETAILS_VECTORS
+ * CORE-ONLY: GAP — the renderers read these strings THROUGH `ADW_ABOUT_DIALOG_LABELS`, so a
+ * spec reading them back would be circular with respect to the `.ui` fidelity this table exists
+ * to pin. ABOUT_DIALOG_HEADER/DETAILS_VECTORS are about icon and name visibility and row
+ * presence, never the label text, and `whatsNewRow` — the U+2019 row above — is filtered out of
+ * the browser spec. Tracked in #1072
  */
 export declare const ABOUT_DIALOG_LABEL_VECTORS: ReadonlyArray<AboutDialogLabelVector>;
 /** One `gtk_license_info` row expectation. */
@@ -211,7 +220,12 @@ export interface LicenseInfoVector {
  * - 1 == GTK_LICENSE_0BSD)` is the C's own drift check; this is that
  * assertion, ported.
  *
- * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
+ * CORE-ONLY: GAP — `adw-about-dialog` has no `license-type` property. It derives the type as
+ * CUSTOM or UNKNOWN from whether `license` is empty (elements/adw-about-dialog.ts), and nothing
+ * on either side reads an `spdxId` or a `url`, so rows 2, 7 and 18 reach no renderer; the
+ * NativeScript bridge ships the widget without a spec. It was exempted here as an internal step
+ * of ABOUT_DIALOG_CREDITS_LEGAL_VECTORS, a three-boolean visibility table whose only licence
+ * input is `hasLegal`. Tracked in #1072
  */
 export declare const LICENSE_INFO_VECTORS: ReadonlyArray<LicenseInfoVector>;
 /** One SPDX-id lookup expectation. */
@@ -225,7 +239,8 @@ export interface LicenseSpdxVector {
 /**
  * The two lookup loops in `populate_from_appdata`.
  *
- * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (LICENSE_INFO_VECTORS → the legal section)
+ * CORE-ONLY: GAP — both lookups run inside `populate_from_appdata`, and neither renderer has an
+ * appdata path to route an SPDX id through. Tracked in #1072
  */
 export declare const LICENSE_SPDX_VECTORS: ReadonlyArray<LicenseSpdxVector>;
 /** One `get_license_text` expectation. */
@@ -239,7 +254,10 @@ export interface LicenseTextVector {
 /**
  * `get_license_text`.
  *
- * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
+ * CORE-ONLY: GAP — `getLicenseText` is called by no renderer. The browser element writes
+ * `this.license` straight into the Legal page and never builds the stock preamble with its URL
+ * and Pango markup, so the rows for types 7 and 18 reach nothing outside the core suite.
+ * Tracked in #1072
  */
 export declare const LICENSE_TEXT_VECTORS: ReadonlyArray<LicenseTextVector>;
 /** One licence-setter step. */
@@ -267,7 +285,10 @@ export interface LicenseSetterVector {
  * licence-type change DOES switch the type, while assigning `""` to an already
  * empty licence does not.
  *
- * CORE-ONLY: a property-ordering table with no rendered surface — the RESULT is ABOUT_DIALOG_CREDITS_LEGAL_VECTORS, which both renderers drive
+ * CORE-ONLY: a property-ordering table with no rendered surface — the RESULT is
+ * ABOUT_DIALOG_CREDITS_LEGAL_VECTORS, driven by the browser suite. ONE renderer, not two: the
+ * NativeScript bridge ships an `adw-about-dialog` widget and no spec for it, so nothing on that
+ * side is held to ANY about-dialog vector.
  */
 export declare const LICENSE_SETTER_VECTORS: ReadonlyArray<LicenseSetterVector>;
 /** One Legal-page visibility expectation. */

package/lib/types/conformance/chrome.d.ts

@@ -15,6 +15,8 @@ export interface ClampThresholdsVector {
  * `lower`/`max`/`upper`.
  *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (CLAMP_ALLOCATE_VECTORS)
+ * Not for every row: both renderer suites filter that table to `params.childMin === 0`, so the
+ * three rows below that set a child minimum are asserted here alone. Tracked in #1072
  */
 export declare const CLAMP_THRESHOLD_VECTORS: ReadonlyArray<ClampThresholdsVector>;
 /** One `clampChildSize` expectation. */
@@ -31,6 +33,8 @@ export interface ClampChildSizeVector {
  * `child_size_from_clamp`.
  *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (CLAMP_ALLOCATE_VECTORS)
+ * Not for every row: one row below sets `childMin: 150`, and both renderer suites filter that
+ * table to `params.childMin === 0`, so that row is asserted here alone. Tracked in #1072
  */
 export declare const CLAMP_CHILD_SIZE_VECTORS: ReadonlyArray<ClampChildSizeVector>;
 /** One `clampSizeFromChild` expectation. */

package/lib/types/conformance/spinner.d.ts

@@ -35,8 +35,11 @@ export interface SpinnerArcShapeVector {
 /**
  * The moments worth naming in one arc cycle.
  *
- * CORE-ONLY: the arc is drawn per frame from `spinnerArc` and a renderer can only show
- * the RESULT — the browser suite asserts the drawn envelope and the round caps.
+ * CORE-ONLY: GAP — the arc is drawn per frame from `spinnerArc` and a renderer can only show the
+ * RESULT. What the browser suite checks is the round caps, and that the arc BREATHES at all
+ * (`spread > 0`, whose discriminator is the constant 90° chase this element used to draw). The
+ * envelope these rows pin — never outside [MIN_ARC_LENGTH, MAX_ARC_LENGTH] — is checked by no
+ * renderer. Tracked in #1072
  */
 export declare const SPINNER_ARC_PHASE_VECTORS: ReadonlyArray<SpinnerArcShapeVector>;
 /** One "is this constant what the C says" expectation. */

package/lib/types/conformance/split-view.d.ts

@@ -12,7 +12,11 @@ export interface AdwLengthUnitVector {
 /**
  * `adw_length_unit_to_px`.
  *
- * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (SIDEBAR_BOUNDS_VECTORS, which both renderers drive)
+ * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it
+ * separately would assert the same thing twice (SIDEBAR_BOUNDS_VECTORS, driven by the browser suite).
+ * ONE renderer, not two: NativeScript drives SIDEBAR_WIDTH_VECTORS instead, and works in DIPs, so
+ * `split-view-width.spec.ts` skips every row that sets a unit or a dpi — no NativeScript surface
+ * reaches this conversion at all.
  */
 export declare const ADW_LENGTH_UNIT_VECTORS: ReadonlyArray<AdwLengthUnitVector>;
 /** One `glibClamp` expectation. */
@@ -30,7 +34,11 @@ export interface GlibClampVector {
  * `high` there, and `allocate_uncollapsed` reaches inverted bounds whenever the
  * content pane's own minimum leaves less room than `min-sidebar-width`.
  *
- * CORE-ONLY: GLib’s CLAMP itself — a primitive with no widget surface; every widget that reaches it does so through a table that IS driven
+ * CORE-ONLY: GLib’s CLAMP itself, a primitive with no widget surface. What separates it from
+ * `Math.min`/`Math.max` is the inverted rows, and those ARE driven — `resolveNavigationSidebarWidth`
+ * inverts the bounds at 300px total width, which is a row of SIDEBAR_WIDTH_VECTORS.
+ * Its other reachers, `toolbarViewAllocate` and `carouselClampPosition`, do not reach a driven table;
+ * the earlier wording here claimed every reacher did, which was false in two places.
  */
 export declare const GLIB_CLAMP_VECTORS: ReadonlyArray<GlibClampVector>;
 /** One `resolveSidebarBounds` expectation. */
@@ -106,7 +114,11 @@ export interface SplitViewMeasureVector {
  * Without this container minimum the content pane shrinks to nothing instead of the window
  * refusing to get narrower.
  *
- * CORE-ONLY: the container minimum lands as `min-width: min-content` on the content pane, which is CSS’s own spelling of the same rule — there is no computed number of ours to compare. Asserted in the renderer as "the pane is not crushable" instead
+ * CORE-ONLY: GAP — the container minimum lands as `min-width: min-content` on the content pane,
+ * CSS’s own spelling of the same rule, so there is no computed number of ours for a renderer to
+ * compare against. What the browser suite checks is the weaker property that the pane is not
+ * crushable (`getComputedStyle(content).minWidth !== '0px'`, split-views.spec.ts); the numbers in
+ * these rows reach no renderer. Tracked in #1072
  */
 export declare const SPLIT_VIEW_MEASURE_VECTORS: ReadonlyArray<SplitViewMeasureVector>;
 /** One `layoutNavigationSplitView` expectation. */

package/lib/types/conformance/tab-view.d.ts

@@ -347,7 +347,7 @@ export interface TabTooltipVector {
  * browser sets `tab.title = tabTooltip(page)` (`elements/adw-tab-view.ts`),
  * NativeScript re-exports it as `tabTooltipText` (`widgets/tab-view-state.ts`) —
  * and neither is held to these rows. Both surfaces are readable from their own
- * suites, so wiring them is a loop, not new capability.
+ * suites, so wiring them is a loop, not new capability. Tracked in #1072
  */
 export declare const TAB_TOOLTIP_VECTORS: ReadonlyArray<TabTooltipVector>;
 /** One `tabIconState` expectation. */

package/package.json

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