@gjsify/adwaita-nativescript 0.44.0 → 0.46.0

package/lib/types/widgets/window-insets.d.ts

@@ -18,6 +18,30 @@ export interface InsetPadding {
     readonly contentBottom: number;
 }
 export declare const NO_INSETS: WindowInsets;
+/**
+ * The edges a HOST layout already pays, so the widget must not pay them again.
+ *
+ * Declared here rather than beside the platform files that answer it, so this module
+ * stays the one place the inset arithmetic lives and keeps importing nothing.
+ */
+export interface HostPaidEdges {
+    readonly top: boolean;
+    readonly bottom: boolean;
+}
+/** Nothing above the widget pays anything — it owes every edge. */
+export declare const NO_HOST_PAYMENT: HostPaidEdges;
+/**
+ * Drop the edges a host layout already paid, leaving what the widget still owes.
+ *
+ * Separate from {@link toolbarViewInsetPadding} because it answers a different question:
+ * that one splits an owed inset between the slots of ONE widget, this one decides
+ * whether the inset is owed at all. Which edges a host pays is a per-platform fact
+ * (`host-insets.{android,ios}.ts`); how much of it lands on which slot is not.
+ *
+ * Left and right pass through: no host in this tree pays them, and dropping an edge
+ * nobody paid is how an inset silently goes missing.
+ */
+export declare function insetsOwedBy(insets: WindowInsets, paidByHost: HostPaidEdges): WindowInsets;
 /**
  * Assign `insets` to the slots of a toolbar view of `shape`.
  *

package/lib/types/widgets/wrap-box-layout.d.ts

@@ -1,5 +1,6 @@
-import { normalizeWrapBoxSpacing, type AdwWrapBoxJustify, type AdwWrapBoxOrientation, type AdwWrapBoxPackDirection, type AdwWrapPolicy } from '@gjsify/adwaita-core';
-export { normalizeWrapBoxSpacing };
+import { normalizeWrapBoxSpacing, wrapBoxChildFlex, wrapBoxFlexStyle, type WrapBoxChildFlex, type WrapBoxFlexInput, type WrapBoxFlexStyle } from '@gjsify/adwaita-core';
+export { normalizeWrapBoxSpacing, wrapBoxChildFlex, wrapBoxFlexStyle };
+export type { WrapBoxChildFlex, WrapBoxFlexInput, WrapBoxFlexStyle };
 /** `Adw.WrapBox:child-spacing` / `:line-spacing` default, in DIPs. Both are 0 in C. */
 export declare const DEFAULT_WRAP_BOX_SPACING = 0;
 /**
@@ -22,61 +23,3 @@ export declare function wrapBoxSpacingChanges(current: number, next: unknown): b
  * the NS CSS subset cannot be trusted with.
  */
 export declare function wrapBoxChildMargin(childSpacing: number, lineSpacing: number): string;
-/** The `FlexboxLayout` knobs a wrap box's properties resolve to. */
-export interface WrapBoxFlexStyle {
-    /** `FlexboxLayout:flexDirection` — the main axis, reversed for `end-to-start`. */
-    flexDirection: 'row' | 'row-reverse' | 'column' | 'column-reverse';
-    /** `FlexboxLayout:flexWrap` — always wrapping; reversed by `wrap-reverse`. */
-    flexWrap: 'wrap' | 'wrap-reverse';
-    /** `FlexboxLayout:justifyContent` — where a COMPLETE line's leftover goes. */
-    justifyContent: 'flex-start' | 'center' | 'flex-end' | 'space-between';
-    /** `FlexboxLayout:alignContent` — `line-homogeneous` stretches the lines. */
-    alignContent: 'stretch' | 'flex-start';
-    /** `FlexboxLayout.setFlexGrow` for a child on a complete line. */
-    childFlexGrow: number;
-    /** `FlexboxLayout.setFlexShrink` for every child — `wrap-policy`. */
-    childFlexShrink: number;
-}
-/** The widget properties the two resolvers read. */
-export interface WrapBoxFlexInput {
-    orientation: AdwWrapBoxOrientation;
-    packDirection: AdwWrapBoxPackDirection;
-    wrapReverse: boolean;
-    justify: AdwWrapBoxJustify;
-    justifyLastLine: boolean;
-    align: number;
-    lineHomogeneous: boolean;
-    wrapPolicy: AdwWrapPolicy;
-}
-/**
- * The CONTAINER half of the decision, resolved onto `FlexboxLayout`.
- *
- * The line DECISION is `resolveWrapBoxLine` in `@gjsify/adwaita-core`, held to
- * `WRAP_BOX_LINE_VECTORS`; this function only maps its answer onto the knobs NS has.
- *
- * `FlexboxLayout` has ONE `justifyContent` for every line, so it can only carry the
- * COMPLETE-line rule. NativeScript offers no `:only-child` selector and no generated
- * content, so the final-line rule has no container-level expression at all; the
- * single-child case is reached through {@link wrapBoxChildFlex}.
- */
-export declare function wrapBoxFlexStyle(input: WrapBoxFlexInput): WrapBoxFlexStyle;
-/** What one child of the box gets set on it. */
-export interface WrapBoxChildFlex {
-    /** `FlexboxLayout.setFlexGrow` — whether this child absorbs the line's leftover. */
-    flexGrow: number;
-    /** `FlexboxLayout.setFlexShrink` — `wrap-policy`, the same for every child. */
-    flexShrink: number;
-}
-/**
- * The PER-CHILD half of the decision, which the container knobs cannot carry.
- *
- * A box with exactly ONE child has one line, that line is the LAST one, and its
- * child is alone on it — so it is governed by `justify-last-line`, and `spread`
- * STRETCHES it rather than spreading anything (C guards the keep-at-minimum branch
- * with `n_children > 1`).
- *
- * `childCount` is the box's own child count, the most a renderer knows without a
- * layout pass: 1 is the lone-child-on-the-final-line case exactly, anything more
- * means at least one complete line.
- */
-export declare function wrapBoxChildFlex(input: WrapBoxFlexInput, childCount: number): WrapBoxChildFlex;

package/lib/types/widgets/xml-values.d.ts

@@ -0,0 +1,18 @@
+/**
+ * An attribute as a finite number, or `fallback` when it is not one.
+ *
+ * A string is trimmed and parsed; empty is NOT zero (`Number('')` is 0, which is how
+ * a missing value becomes a real setting). `NaN` and `Infinity` are refused, so a
+ * caller can keep validating a RANGE without also having to re-check the type.
+ */
+export declare function xmlNumber(value: unknown, fallback: number): number;
+/**
+ * An attribute as a boolean.
+ *
+ * Only the two spellings XML can mean are accepted — anything else takes the
+ * `fallback` rather than the truthiness of the string, because truthiness is exactly
+ * what made `revealed="false"` reveal. `'True'`/`'FALSE'` are accepted too: XML
+ * attribute VALUES are not case-normalised by any parser, and a template that means
+ * one of the two booleans should not depend on which case its author typed.
+ */
+export declare function xmlBoolean(value: unknown, fallback: boolean): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-nativescript",
-    "version": "0.44.0",
+    "version": "0.46.0",
     "description": "Native Adwaita widgets for the NativeScript runtime — real NativeScript components (StackLayout/GridLayout/Switch/Label) styled like Libadwaita, not a webview",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -47,10 +47,10 @@
         "design-system"
     ],
     "dependencies": {
-        "@gjsify/adwaita-core": "^0.44.0",
-        "@gjsify/adwaita-fonts": "^0.44.0",
-        "@gjsify/adwaita-icons": "^0.44.0",
-        "@gjsify/native-platform": "^0.44.0"
+        "@gjsify/adwaita-core": "^0.46.0",
+        "@gjsify/adwaita-fonts": "^0.46.0",
+        "@gjsify/adwaita-icons": "^0.46.0",
+        "@gjsify/native-platform": "^0.46.0"
     },
     "peerDependencies": {
         "@nativescript/core": "*"
@@ -61,8 +61,8 @@
         }
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.44.0",
-        "@gjsify/unit": "^0.44.0",
+        "@gjsify/cli": "^0.46.0",
+        "@gjsify/unit": "^0.46.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -77,7 +77,10 @@
         "nativescriptPlatforms": [
             "android",
             "ios"
-        ]
+        ],
+        "widgetVocabulary": {
+            "role": "renderer"
+        }
     },
     "license": "MIT",
     "repository": {

package/lib/esm/widgets/adw-drop-down.js

@@ -1 +0,0 @@
-import"../_virtual/_rolldown/runtime.js";import{AdwIcon as e}from"./adw-icon.js";import{attachRowPressFeedback as t}from"./row-press.js";import{Label as n,StackLayout as r,action as i}from"@nativescript/core";import{ComboState as a}from"@gjsify/adwaita-core";import{panDownSymbolic as o}from"@gjsify/adwaita-icons/ui";const s=`notify::selected`;var AdwDropDown=class extends r{_label;_chevron;_state=new a;_chooserTitle=``;constructor(){super(),this.orientation=`horizontal`,this.className=`adw-drop-down`;let r=new n;r.className=`adw-drop-down-label`,r.text=``;let i=new e;i.className=`adw-drop-down-chevron`,i.icon=o,this.addChild(r),this.addChild(i),this._label=r,this._chevron=i,this._state.subscribe(e=>{if(this._label.text=e.label,e.interactive){let t={eventName:s,object:this,selected:e.selected,value:e.value,label:e.label};this.notify(t)}}),this.addEventListener(`tap`,()=>{this._openChooser()}),t(this)}async _openChooser(){if(this._state.count===0)return;let e=this._state.options.map(e=>e.label),t=await i({title:this._chooserTitle||void 0,cancelButtonText:`Cancel`,actions:e});this._state.select(e.indexOf(t))}get options(){return this._state.options}set options(e){this._state.setOptions(e)}get selected(){return this._state.selectedIndex}set selected(e){this._state.setSelectedIndex(e)}get selectedValue(){return this._state.selectedValue}set selectedValue(e){this._state.setSelectedValue(e)}get selectedItem(){return this._state.options[this._state.selectedIndex]??null}get chooserTitle(){return this._chooserTitle}set chooserTitle(e){this._chooserTitle=e??``}};export{AdwDropDown,s as NOTIFY_SELECTED};

package/lib/esm/widgets/adw-entry.js

@@ -1 +0,0 @@
-import"../_virtual/_rolldown/runtime.js";import{GridLayout as e,ItemSpec as t,TextField as n}from"@nativescript/core";import{ENTRY_ROW_MAX_LENGTH_LIMIT as r,clampEntryText as i,entryTextLength as a}from"@gjsify/adwaita-core";const o=`notify::text`,s=`activate`;var AdwEntry=class extends e{_field;_text=``;_maxLength=0;constructor(){super(),this.className=`adw-entry`,this.addColumn(new t(1,`star`)),this.addRow(new t(1,`auto`));let e=new n;e.className=`adw-entry-input`,e.set(`backgroundColor`,`transparent`),e.set(`borderWidth`,0),this.addChild(e),this._field=e,e.addEventListener(`textChange`,()=>this._applyText(this._field.text??``)),e.addEventListener(`returnPress`,()=>{let e={eventName:s,object:this};this.notify(e)})}_applyText(e){let t=i(e,this._maxLength);if(this._field.text!==t&&(this._field.text=t),t===this._text)return;this._text=t;let n={eventName:o,object:this,text:t,textLength:a(t)};this.notify(n)}get text(){return this._text}set text(e){this._applyText(e??``)}get textLength(){return a(this._text)}get maxLength(){return this._maxLength}set maxLength(e){this._maxLength=Number.isFinite(e)?Math.min(r,Math.max(0,Math.trunc(e))):0,this._applyText(this._text)}get placeholder(){return this._field.hint??``}set placeholder(e){this._field.hint=e??``}get editable(){return this._field.editable}set editable(e){this._field.editable=!!e}get field(){return this._field}};export{s as ACTIVATE,AdwEntry,o as NOTIFY_TEXT};