@gjsify/adwaita-nativescript 0.36.0 → 0.37.0

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

@@ -1,36 +1,25 @@
 import { normalizeWrapBoxSpacing, type AdwWrapBoxJustify, type AdwWrapBoxOrientation, type AdwWrapBoxPackDirection, type AdwWrapPolicy } from '@gjsify/adwaita-core';
 export { normalizeWrapBoxSpacing };
-/**
- * `Adw.WrapBox:child-spacing` / `:line-spacing` default, in DIPs.
- *
- * Both are `g_param_spec_int (…, 0, G_MAXINT, 0, …)` — adw-wrap-box.c:285-287
- * and :393-395. The port used to default both to 6, so identical markup was
- * looser on a phone than in the browser and an EMPTY wrap box was already 12
- * DIPs tall.
- */
+/** `Adw.WrapBox:child-spacing` / `:line-spacing` default, in DIPs. Both are 0 in C. */
 export declare const DEFAULT_WRAP_BOX_SPACING = 0;
 /**
  * Whether writing `next` over `current` is a change the widget must act on.
  *
- * The comparison happens AFTER the clamp (adw-wrap-box.c:592-593, :930-931), so
- * a negative value written over a spacing of 0 is an early return: it neither
- * reaches the layout nor notifies. On this port the same predicate decides
- * whether every child's margin is rewritten.
+ * The comparison happens AFTER the clamp, so a negative value written over a
+ * spacing of 0 is an early return: it neither reaches the layout nor notifies. Here
+ * the same predicate decides whether every child's margin is rewritten.
  */
 export declare function wrapBoxSpacingChanges(current: number, next: unknown): boolean;
 /**
  * The uniform margin that gives a `FlexboxLayout` child its share of the gaps.
  *
- * NativeScript has no gap property on any layout — `Style` carries no
- * `columnGap`/`rowGap` — so the inter-item spacing has to come out of the
- * children: half of it on each facing edge adds up to the whole gap between any
- * two neighbours. The margin string is NS's `top right bottom left` shorthand.
+ * Half the spacing on each facing edge adds up to the whole gap between any two
+ * neighbours. The margin string is NS's `top right bottom left` shorthand.
  *
- * This is the one place the port is knowingly looser than libadwaita: the halves
- * on the OUTER edges are an inset `Adw.WrapBox` does not have. It is invisible
- * at the default spacing of 0 and bounded by half a gap otherwise, where the
- * alternative — negative margins on the container — is not something the NS CSS
- * subset can be trusted with.
+ * Knowingly looser than libadwaita: the halves on the OUTER edges are an inset
+ * `Adw.WrapBox` does not have. Invisible at the default spacing of 0 and bounded by
+ * half a gap otherwise; the alternative is negative margins on the container, which
+ * 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. */
@@ -63,14 +52,12 @@ export interface WrapBoxFlexInput {
  * 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, exactly as the browser element maps it onto CSS.
+ * `WRAP_BOX_LINE_VECTORS`; this function only maps its answer onto the knobs NS has.
  *
- * Like a flex container, `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; what it CAN reach is the single-child case,
- * through {@link wrapBoxChildFlex}.
+ * `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. */
@@ -83,15 +70,13 @@ export interface WrapBoxChildFlex {
 /**
  * The PER-CHILD half of the decision, which the container knobs cannot carry.
  *
- * Two of libadwaita's rules are facts about a child rather than about the box,
- * and a single `justifyContent` has nowhere to put either. 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 (`n_children > 1` guards the keep-at-minimum
- * branch, adw-wrap-layout.c:338; adw-wrap-box.c:349-352 says so outright).
+ * 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, which is the most a renderer knows
- * without a layout pass: 1 means the lone-child-on-the-final-line case exactly,
- * anything more means at least one complete line.
+ * `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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-nativescript",
-    "version": "0.36.0",
+    "version": "0.37.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.36.0",
-        "@gjsify/adwaita-fonts": "^0.36.0",
-        "@gjsify/adwaita-icons": "^0.36.0",
-        "@gjsify/native-platform": "^0.36.0"
+        "@gjsify/adwaita-core": "^0.37.0",
+        "@gjsify/adwaita-fonts": "^0.37.0",
+        "@gjsify/adwaita-icons": "^0.37.0",
+        "@gjsify/native-platform": "^0.37.0"
     },
     "peerDependencies": {
         "@nativescript/core": "*"
@@ -61,8 +61,8 @@
         }
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.36.0",
-        "@gjsify/unit": "^0.36.0",
+        "@gjsify/cli": "^0.37.0",
+        "@gjsify/unit": "^0.37.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },