npm - @gjsify/react-native - Versions diffs - 0.49.0 → 0.51.0 - Mend

@gjsify/react-native 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/PROPS.md +59 -59
package/README.md +17 -0
package/lib/esm/components.js +1 -1
package/lib/esm/press.js +1 -1
package/lib/esm/primitives/accessibility.js +1 -1
package/lib/esm/primitives/answers.js +1 -1
package/lib/esm/primitives/errors.js +1 -1
package/lib/esm/primitives/resolve.js +1 -1
package/lib/esm/prop-table.js +1 -1
package/lib/types/press.d.ts +5 -0
package/lib/types/primitives/accessibility.d.ts +7 -0
package/lib/types/primitives/answers.d.ts +42 -1
package/lib/types/primitives/errors.d.ts +58 -2
package/lib/types/primitives/errors.spec.d.ts +2 -0
package/lib/types/prop-table.d.ts +23 -5
package/package.json +10 -10

package/PROPS.md CHANGED Viewed

@@ -28,13 +28,13 @@ widget `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `onLayout` | refused | — | GTK reports its allocation through `Gtk.Widget.vfunc_size_allocate`, a SUBCLASS override rather than a signal, so there is no handler to bind. `useWindowDimensions` (tier P2) is the window-level answer |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -55,13 +55,13 @@ widget `GtkLabel` · a text child writes `label`.
 |---|---|---|---|
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
-| `accessibilityLiveRegion` | announcement | `notify::label`, `Gtk.Accessible.announce()` | — |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityLiveRegion` | announcement | `notify::label`, `Gtk.Accessible.announce()` | takes `assertive`, `none`, `polite` |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `adjustsFontSizeToFit` | refused | — | GTK has no shrink-to-fit text; a label ellipsizes or wraps. Use `numberOfLines` with `ellipsizeMode` |
 | `allowFontScaling` | ignored | — | text scaling is a desktop-wide GNOME setting, not a per-label opt-in |
-| `ellipsizeMode` | property | `ellipsize` | — |
+| `ellipsizeMode` | property | `ellipsize` | takes `head`, `middle`, `tail` |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `maxFontSizeMultiplier` | ignored | — | see `allowFontScaling` |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -90,8 +90,8 @@ widget `GtkButton` · a text child writes `label`.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `android_ripple` | ignored | — | an Android-only ripple; Adwaita has its own press feedback |
 | `delayLongPress` | refused | — | see `onLongPress` |
@@ -104,7 +104,7 @@ widget `GtkButton` · a text child writes `label`.
 | `onPress` | event | `clicked` | — |
 | `onPressIn` | refused | — | press state is the GTK CSS `:active` pseudo-class, not React state (ADR 0032 § 7) — write `active:opacity-70` and GTK animates it with no re-render at all |
 | `onPressOut` | refused | — | see `onPressIn` — `active:` is the mechanism |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -126,12 +126,12 @@ widget `GtkScrolledWindow` · children go into `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `contentContainerClassName` | ignored | — | read directly as the content node’s class list |
 | `contentContainerStyle` | ignored | — | read directly as the content node’s style set |
-| `horizontal` | property | `orientation`, `hscrollbar-policy`, `vscrollbar-policy` | — |
+| `horizontal` | property | `orientation`, `hscrollbar-policy`, `vscrollbar-policy` | takes `false`, `true` |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `keyboardDismissMode` | ignored | — | see `keyboardShouldPersistTaps` |
 | `keyboardShouldPersistTaps` | ignored | — | there is no on-screen keyboard to dismiss |
@@ -141,8 +141,8 @@ widget `GtkScrolledWindow` · children go into `GtkBox` · takes no text child.
 | `refreshControl` | refused | — | GTK has no pull-to-refresh idiom and `RefreshControl` is `refused` in the support table for that reason. Give the desktop build a refresh action |
 | `scrollEnabled` | refused | — | a `Gtk.ScrolledWindow` has no switch that stops scrolling — setting both policies to `never` hides the bars AND clamps the child, which is a different thing. Render the content without the ScrollView when it must not scroll |
 | `scrollEventThrottle` | refused | — | see `onScroll` |
-| `showsHorizontalScrollIndicator` | property | `hscrollbar-policy` | — |
-| `showsVerticalScrollIndicator` | property | `vscrollbar-policy` | — |
+| `showsHorizontalScrollIndicator` | property | `hscrollbar-policy` | takes `false`, `true` |
+| `showsVerticalScrollIndicator` | property | `vscrollbar-policy` | takes `false`, `true` |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -164,8 +164,8 @@ widget `AdwSpinner` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `animating` | property | `visible` | — |
 | `color` | style | `style: color` | — |
@@ -173,7 +173,7 @@ widget `AdwSpinner` · takes no text child.
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `onLayout` | refused | — | GTK reports its allocation through `Gtk.Widget.vfunc_size_allocate`, a SUBCLASS override rather than a signal, so there is no handler to bind. `useWindowDimensions` (tier P2) is the window-level answer |
-| `size` | property | `width-request`, `height-request` | — |
+| `size` | property | `width-request`, `height-request` | takes `large`, `small`, or a number of pixels |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -195,8 +195,8 @@ widget `GtkEntry` · a text child writes `text` · a `ref` receives the `text-in
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `autoCapitalize` | ignored | — | an on-screen keyboard behaviour; a hardware keyboard has no shift state to preset |
 | `autoComplete` | ignored | — | is Android’s autofill hint, and there is no autofill service on a GTK desktop to hint to — a password manager fills a field through the accessibility bus or a paste, neither of which the widget declares anything for. `keyboardType` is the one hint that does land: it writes `Gtk.Entry:input-purpose`, which an input method reads |
@@ -206,7 +206,7 @@ widget `GtkEntry` · a text child writes `text` · a `ref` receives the `text-in
 | `editable` | property | `editable` | — |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `keyboardAppearance` | ignored | — | there is no on-screen keyboard to theme |
-| `keyboardType` | property | `input-purpose` | — |
+| `keyboardType` | property | `input-purpose` | takes `decimal-pad`, `default`, `email-address`, `number-pad`, `numeric`, `phone-pad`, `url` |
 | `maxLength` | property | `max-length` | — |
 | `multiline` | ignored | — | it chose the widget; it is not also a property |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -244,8 +244,8 @@ One React Native prop, two GTK widgets: `multiline` selects this row instead of
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `autoCapitalize` | ignored | — | an on-screen keyboard behaviour; a hardware keyboard has no shift state to preset |
 | `autoComplete` | ignored | — | is Android’s autofill hint, and there is no autofill service on a GTK desktop to hint to — a password manager fills a field through the accessibility bus or a paste, neither of which the widget declares anything for. `keyboardType` is the one hint that does land: it writes `Gtk.Entry:input-purpose`, which an input method reads |
@@ -255,7 +255,7 @@ One React Native prop, two GTK widgets: `multiline` selects this row instead of
 | `editable` | property | `editable` | — |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `keyboardAppearance` | ignored | — | there is no on-screen keyboard to theme |
-| `keyboardType` | property | `input-purpose` | — |
+| `keyboardType` | property | `input-purpose` | takes `decimal-pad`, `default`, `email-address`, `number-pad`, `numeric`, `phone-pad`, `url` |
 | `maxLength` | refused | — | `Gtk.TextView` installs no `max-length` (measured) — the limit belongs to the buffer |
 | `multiline` | ignored | — | it chose the widget; it is not also a property |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -291,8 +291,8 @@ widget `GtkSwitch` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `disabled` | property | `sensitive` | — |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -324,8 +324,8 @@ widget `GtkPicture` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `alt` | property | `alternative-text` | — |
 | `blurRadius` | refused | — | is a per-pixel effect. GTK composites a `Gdk.Paintable` and has no filter property on the widget that draws it — the counterpart is a `Gsk` render node or a `Gtk.Snapshot` subclass, which is a widget of its own rather than a prop on this one |
@@ -343,7 +343,7 @@ widget `GtkPicture` · takes no text child.
 | `onProgress` | refused | — | is a load event, and `Gtk.Picture` emits NO signals at all (measured: its GType lists none) — it is handed a file or a paintable and draws it, reporting neither progress nor failure. A missing file leaves `paintable` null with no diagnostic, so a callback that never fires would hide exactly the case it exists to report. Load the bytes yourself and set `paintable` through a ref |
 | `progressiveRenderingEnabled` | ignored | — | GTK decodes an image in one pass |
 | `resizeMethod` | ignored | — | an Android decoder hint |
-| `resizeMode` | property | `content-fit` | — |
+| `resizeMode` | property | `content-fit` | takes `center`, `contain`, `cover`, `stretch` |
 | `resizeMultiplier` | ignored | — | an Android decoder hint |
 | `source` | file | `file` | — |
 | `testID` | property | `name` | — |
@@ -368,8 +368,8 @@ widget `GtkOverlay` · children go into `GtkBox` · backdrop `GtkPicture` · tak
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `alt` | property | `alternative-text` | — |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -377,8 +377,8 @@ widget `GtkOverlay` · children go into `GtkBox` · backdrop `GtkPicture` · tak
 | `imageStyle` | ignored | — | read directly as the picture node’s style set |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `onLayout` | refused | — | GTK reports its allocation through `Gtk.Widget.vfunc_size_allocate`, a SUBCLASS override rather than a signal, so there is no handler to bind. `useWindowDimensions` (tier P2) is the window-level answer |
-| `pointerEvents` | property | `can-target` | — |
-| `resizeMode` | property | `content-fit` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
+| `resizeMode` | property | `content-fit` | takes `center`, `contain`, `cover`, `stretch` |
 | `source` | file | `file` | — |
 | `testID` | property | `name` | — |
@@ -401,8 +401,8 @@ widget `GtkButton` · a text child writes `label`.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `activeOpacity` | refused | — | sets the pressed appearance, which on GTK is the CSS `:active` pseudo-class rather than a prop (ADR 0032 § 7). Write `active:opacity-70` — it resolves through the same variant mechanism as every other utility, reads the project's own token scale, and GTK animates it with no re-render at all |
 | `delayLongPress` | refused | — | see `onLongPress` |
@@ -417,7 +417,7 @@ widget `GtkButton` · a text child writes `label`.
 | `onPress` | event | `clicked` | — |
 | `onPressIn` | refused | — | press state is the GTK CSS `:active` pseudo-class, not React state (ADR 0032 § 7) — write `active:opacity-70` and GTK animates it with no re-render at all |
 | `onPressOut` | refused | — | see `onPressIn` — `active:` is the mechanism |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `pressRetentionOffset` | refused | — | see `hitSlop` — GTK hit-tests the allocation and nothing around it |
 | `testID` | property | `name` | — |
 | `touchSoundDisabled` | ignored | — | an Android touch sound; a desktop button makes none |
@@ -441,8 +441,8 @@ widget `GtkButton` · a text child writes `label`.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `activeOpacity` | refused | — | sets the pressed appearance, which on GTK is the CSS `:active` pseudo-class rather than a prop (ADR 0032 § 7). Write `active:opacity-70` — it resolves through the same variant mechanism as every other utility, reads the project's own token scale, and GTK animates it with no re-render at all |
 | `delayLongPress` | refused | — | see `onLongPress` |
@@ -459,7 +459,7 @@ widget `GtkButton` · a text child writes `label`.
 | `onPressIn` | refused | — | press state is the GTK CSS `:active` pseudo-class, not React state (ADR 0032 § 7) — write `active:opacity-70` and GTK animates it with no re-render at all |
 | `onPressOut` | refused | — | see `onPressIn` — `active:` is the mechanism |
 | `onShowUnderlay` | refused | — | see `underlayColor` — there is no underlay to show |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `pressRetentionOffset` | refused | — | see `hitSlop` — GTK hit-tests the allocation and nothing around it |
 | `testID` | property | `name` | — |
 | `touchSoundDisabled` | ignored | — | an Android touch sound; a desktop button makes none |
@@ -484,8 +484,8 @@ widget `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `delayLongPress` | refused | — | see `onLongPress` |
 | `delayPressIn` | refused | — | see `onPressIn` — there is no press-in event to delay |
@@ -499,7 +499,7 @@ widget `GtkBox` · takes no text child.
 | `onPress` | gesture | `Gtk.GestureClick::released` | — |
 | `onPressIn` | refused | — | press state is the GTK CSS `:active` pseudo-class, not React state (ADR 0032 § 7) — write `active:opacity-70` and GTK animates it with no re-render at all |
 | `onPressOut` | refused | — | see `onPressIn` — `active:` is the mechanism |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `pressRetentionOffset` | refused | — | see `hitSlop` — GTK hit-tests the allocation and nothing around it |
 | `testID` | property | `name` | — |
 | `touchSoundDisabled` | ignored | — | an Android touch sound; a desktop button makes none |
@@ -523,8 +523,8 @@ widget `GtkButton` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `color` | refused | — | is the button’s background on Android and its text colour on iOS — one prop, two meanings, and GTK has a third answer: `suggested-action` and `destructive-action` are Adwaita’s own classes for the two cases a colour is usually asking for. Set them from the application stylesheet, or use `<Pressable>` |
 | `disabled` | property | `sensitive` | — |
@@ -561,13 +561,13 @@ widget `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `onLayout` | refused | — | GTK reports its allocation through `Gtk.Widget.vfunc_size_allocate`, a SUBCLASS override rather than a signal, so there is no handler to bind. `useWindowDimensions` (tier P2) is the window-level answer |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -589,8 +589,8 @@ widget `AdwDialog` · children go into `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `allowSwipeDismissal` | refused | — | swipe-to-dismiss is a touch gesture; the desktop dismissal is Escape or a click on the backdrop, and `onRequestClose` already reports both |
 | `animationType` | refused | — | libadwaita animates the presentation itself and picks the animation from `Adw.Dialog:presentation-mode` — a floating sheet fades and scales, a bottom sheet slides up — so there is no property that selects one. Reach the dialog through a `ref` and set `presentation-mode` if the sheet should arrive from the bottom |
@@ -631,8 +631,8 @@ widget `GtkImage` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `color` | style | `style: color` | — |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
@@ -661,8 +661,8 @@ widget `GtkBox` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `behavior` | ignored | — | describes how to move out of an on-screen keyboard’s way, and none appears |
 | `contentContainerStyle` | refused | — | styles the inner view React Native adds to do the avoiding, and there is no avoiding here — so there is no second node to style. Put it on `style`, which lands on the one box this element is |
@@ -671,7 +671,7 @@ widget `GtkBox` · takes no text child.
 | `keyboardVerticalOffset` | ignored | — | see `behavior` |
 | `nativeID` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `onLayout` | refused | — | GTK reports its allocation through `Gtk.Widget.vfunc_size_allocate`, a SUBCLASS override rather than a signal, so there is no handler to bind. `useWindowDimensions` (tier P2) is the window-level answer |
-| `pointerEvents` | property | `can-target` | — |
+| `pointerEvents` | property | `can-target` | takes `auto`, `none` |
 | `testID` | property | `name` | — |
 `accessibilityRole` is answered for every other value, and these are refused by name:
@@ -697,8 +697,8 @@ widget `GtkBox` · children go into `GtkScrolledWindow` · takes no text child.
 | `accessibilityHint` | accessible | `Gtk.Accessible.update_property(): help-text` | — |
 | `accessibilityLabel` | accessible | `Gtk.Accessible.update_property(): label` | — |
 | `accessibilityLiveRegion` | refused | — | declares that a screen reader should speak this element when its CONTENT changes. GTK has the announcement — `Gtk.Accessible.announce(message, priority)` since 4.14 — but not the watch: it is an imperative call, and this element’s content is a SUBTREE, which GTK emits no signal for. `<Text>` answers this prop, because its content is one property (`Gtk.Label:label`) and so is both the moment and the message. Elsewhere, call `announce()` on the widget through a ref when you change the content |
-| `accessibilityRole` | property | `accessible-role` | refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
-| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | — |
+| `accessibilityRole` | property | `accessible-role` | takes `adjustable`, `alert`, `button`, `checkbox`, `combobox`, `dropdownlist`, `grid`, `header`, `iconmenu`, `image`, `imagebutton`, `link`, `list`, `menu`, `menubar`, `menuitem`, `none`, `progressbar`, `radio`, `radiogroup`, `scrollbar`, `search`, `spinbutton`, `switch`, `tab`, `tabbar`, `tablist`, `text`, `timer`, `togglebutton`, `toolbar`, `viewgroup`, `webview`; refuses `drawerlayout`, `horizontalscrollview`, `keyboardkey`, `pager`, `scrollview`, `slidingdrawer`, `summary` — see below |
+| `accessibilityState` | accessible | `busy → Gtk.Accessible.update_state(): busy`, `checked → Gtk.Accessible.update_state(): checked`, `disabled → Gtk.Accessible.update_state(): disabled`, `expanded → Gtk.Accessible.update_state(): expanded`, `selected → Gtk.Accessible.update_state(): selected` | takes `busy`, `checked`, `disabled`, `expanded`, `selected` |
 | `accessible` | ignored | — | asks for two things, and GTK already answers one: every GTK widget is in the accessibility tree, so “this element is an accessibility element” is the desktop default rather than an opt-in. The other thing it asks — merge my whole subtree into ONE accessible node, which is what `accessible={true}` does on iOS — GTK has no mechanism for, and a desktop screen reader navigates the widget tree it is given. To take an element OUT of that tree, set `accessibilityRole="none"`: it is the one prop that writes `Gtk.Accessible:accessible-role`, and two props writing one property is the silent-drop shape this table refuses by name |
 | `columnWrapperStyle` | refused | — | see `numColumns` |
 | `contentContainerStyle` | refused | — | styles the box React Native puts the rows in, and there is no such box: `Gtk.ListView` builds each row from the factory and owns the space between them. Style the row inside `renderItem`, or the list itself through `style` |
@@ -707,7 +707,7 @@ widget `GtkBox` · children go into `GtkScrolledWindow` · takes no text child.
 | `getItem` | ignored | — | read by the component — VirtualizedList’s accessor form of `data` |
 | `getItemCount` | ignored | — | see `getItem` |
 | `getItemLayout` | refused | — | tunes React Native’s own virtualisation, and `Gtk.ListView` does that job itself — it creates and recycles rows through the factory as the viewport moves (measured: 205 of 500 rows set up in a 400×300 window) and installs no property that changes the batching. There is nothing for this to set |
-| `horizontal` | property | `orientation`, `hscrollbar-policy`, `vscrollbar-policy` | — |
+| `horizontal` | property | `orientation`, `hscrollbar-policy`, `vscrollbar-policy` | takes `false`, `true` |
 | `id` | refused | — | would write `Gtk.Widget:name`, and so does `testID`. Two props for one property is the silent-drop shape the host refuses by name (`signalTaken`), so this layer picks one: use `testID` |
 | `initialNumToRender` | refused | — | tunes React Native’s own virtualisation, and `Gtk.ListView` does that job itself — it creates and recycles rows through the factory as the viewport moves (measured: 205 of 500 rows set up in a 400×300 window) and installs no property that changes the batching. There is nothing for this to set |
 | `initialScrollIndex` | refused | — | scrolls to a row before the first paint. `Gtk.ListView.scroll_to(position, flags, scroll_info)` is the counterpart and it is an imperative call on a realised view, not a property — reach the view through a ref and call it |
@@ -732,8 +732,8 @@ widget `GtkBox` · children go into `GtkScrolledWindow` · takes no text child.
 | `renderSectionHeader` | ignored | — | read by the item factory |
 | `scrollEventThrottle` | refused | — | see `onScroll` |
 | `sections` | ignored | — | read by the component — SectionList’s form of `data` |
-| `showsHorizontalScrollIndicator` | property | `hscrollbar-policy` | — |
-| `showsVerticalScrollIndicator` | property | `vscrollbar-policy` | — |
+| `showsHorizontalScrollIndicator` | property | `hscrollbar-policy` | takes `false`, `true` |
+| `showsVerticalScrollIndicator` | property | `vscrollbar-policy` | takes `false`, `true` |
 | `stickySectionHeadersEnabled` | refused | — | GTK’s own sticky headers are a `Gtk.ListView:header-factory` over a model that implements `Gtk.SectionModel` (MEASURED: `Gio.ListStore` does not, every selection model and `Gtk.FlattenListModel` do). This layer flattens the sections into one model with header ROWS instead, so a header scrolls with its section — which is what `stickySectionHeadersEnabled={false}` asks for and the only thing it can deliver |
 | `testID` | property | `name` | — |
 | `updateCellsBatchingPeriod` | refused | — | tunes React Native’s own virtualisation, and `Gtk.ListView` does that job itself — it creates and recycles rows through the factory as the viewport moves (measured: 205 of 500 rows set up in a 400×300 window) and installs no property that changes the batching. There is nothing for this to set |

package/README.md CHANGED Viewed

@@ -78,6 +78,23 @@ expect(explainProp('Text', 'onPress')).toContain('Wrap it in a `<Pressable>`');
 runtime one. [PROPS.md](PROPS.md) is the generated document, one section per
 primitive, held byte for byte by `check-rn-surface.mjs`.
+**A prop can be answered and still refuse a VALUE, and the table says so at both
+grains** — `propRefusedValues` lists the spellings with a reason of their own,
+`propAllowedValues` lists the ones a mapped prop takes at all, and
+`acceptsPropValue`/`explainPropValue` answer for one value:
+```ts
+acceptsPropValue('View', 'pointerEvents', 'box-none'); // false — GTK's `can-target`
+propAllowedValues('View', 'pointerEvents'); // ['auto', 'none']
+```
+Both halves are needed because they are different facts: a value can be refused by
+NAME, with its own sentence, or by being absent from the list its route maps. Reading
+only the first answered ACCEPTED for `box-none` until #1648 (ADR 0039 § Amendment).
+What is still not answered is the TYPE grain — `acceptsPropValue('Text',
+'selectable', 'yes')` is `true` while a render refuses the string — because that is a
+predicate rather than a list; `status/open-todos.md` carries what it would take.
 ## `<TextInput>`'s ref is a handle, not the widget
 React Native's `TextInput` is a class, so `useRef<TextInput>(null)` and

package/lib/esm/components.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"./_virtual/_rolldown/runtime.js";import{applyAccessibility as e}from"./accessibility.js";import{accessor as t}from"./accessor.js";import{PrimitiveError as n}from"./primitives/errors.js";import{onLiveRegion as r}from"./announce.js";import{splitAnimatedStyle as i}from"./primitives/style.js";import{resolvePrimitive as a}from"./primitives/resolve.js";import{childFacts as o,childNodes as s,isAbsoluteChild as c,isTextNode as l}from"./child-facts.js";import{ParentContext as u,ParentProvider as d}from"./parent-context.js";import{onGesture as f,onPressStateChange as p}from"./press.js";import{createHandle as m}from"./primitives/handles.js";import{animatedProperty as h,assertNoStaticClash as g}from"./animated/properties.js";import{styleConfig as _}from"./style-config.js";import v from"gi://GObject?version=2.0";import y from"gi://Gtk?version=4.0";import b from"gi://Gio?version=2.0";import x from"gi://GLib?version=2.0";import{createElement as S,useCallback as C,useContext as w,useEffect as T,useMemo as E,useRef as D,useState as O}from"react";function useSignals(e,n){let r=D(null),i=D(n);return i.current=n,{props:E(()=>{let n={};for(let a of e)n[`on:${a.signal}`]=()=>{let e=i.current[a.prop];if(typeof e!=`function`)return;if(a.read===null){e();return}let n=r.current;e(n===null?void 0:n[t(a.read)])};return n},[e.map(e=>`${e.prop}>${e.signal}>${e.read??``}`).join(`\|`)]),widgetRef:r}}function nodeProps(e,t,n){let r={...t,...e.props,...n};return e.cssClasses.length>0&&(r[`css-classes`]=[...e.cssClasses]),r}function usePlan(e,t){let r=t,i=w(u),c=_(),l=s(r.children),d=a(e,r,{tokens:c.tokens,sheet:c.sheet,...i===null?{}:{parent:i},children:o(l,c.tokens)}),f=Object.keys(d.intent);if(f.length>0)throw new n(e,f.join(`, `),"carries layout that ~~cannot~~ ~~be resolved at this position. These need~~ a parent to resolve ~~against~~ — `flex-1` and `self-*` need the parent orientation, `absolute` needs the parent to be an overlay — and this element is the root of its tree, or ~~its~~ ~~parent~~ is ~~not~~ a ~~box~~. Wrap it in a <View>, or move the utility to a child.");let p=useSignals(d.events,r),h=r.ref,g=d.handle,v=d.node.tag,y=E(()=>e=>{p.widgetRef.current=e;let t=e==null?e:m(g,e,v);typeof h==`function`?h(t):h!=null&&(h.current=t)},[h,p.widgetRef,g,v]);useGestures(d.gestures,r,p.widgetRef),useLiveRegions(d.announcements,p.widgetRef),useAccessibility(d.accessibility,p.widgetRef);let b=useFiles(d.files),x={...p.props,ref:y,...b.outer};d.slot!==null&&(x.slot=d.slot);let S={...b.content};d.contentSlot!==null&&(S.slot=d.contentSlot);let C={...b.backdrop};d.backdropSlot!==null&&(C.slot=d.backdropSlot);let T=E(()=>d.childContext,[JSON.stringify(d.childContext),d.childContext]);return{plan:d,children:l,inherited:i?.props??{},extra:x,contentExtra:S,backdropExtra:C,published:T,tokens:c.tokens,widgetRef:p.widgetRef}}function useFiles(e){return E(()=>{let t={outer:{},content:{},backdrop:{}};for(let n of e)t[n.on][n.property]=n.kind===`path`?b.File.new_for_path(n.value):b.File.new_for_uri(n.value);return t},[e.map(e=>`${e.on}>${e.property}>${e.kind}>${e.value}`).join(`\|`)])}function useGestures(e,t,n){let r=D(t);r.current=t;let i=e.map(e=>`${e.prop}>${e.signal}`).join(`\|`);T(()=>{let e=n.current;if(i===``\|\|e==null)return;let t=i.split(`\|`).map(t=>{let[n,i]=t.split(`>`);return f(e,i,()=>{let e=r.current[n];typeof e==`function`&&e()})});return()=>{for(let e of t)e()}},[i,n])}function useLiveRegions(e,t){let n=e.map(e=>`${e.signal}>${e.read}>${e.priority}`).join(`\|`);T(()=>{let e=t.current;if(n===``\|\|e==null)return;let i=n.split(`\|`).map(t=>{let[n,i,a]=t.split(`>`);return r(e,{prop:`accessibilityLiveRegion`,signal:n,read:i,priority:a})});return()=>{for(let e of i)e()}},[n,t])}function useAccessibility(t,n){let r=t.length===0?``:JSON.stringify(t);T(()=>{let t=n.current;if(!(r===``\|\|t==null))return e(t,JSON.parse(r))},[r,n])}function render(e){let{plan:t,children:n,inherited:r,extra:i,contentExtra:a,backdropExtra:o,published:s,tokens:u}=e,wrap=e=>S(d,{value:s},...e);if(t.content===null){let e=n.~~some~~(l)?n:[wrap(n)];return S(t.node.tag,nodeProps(t.node,r,i),...e)}let f=t.absoluteSlot===null?[]:n.filter(e=>c(e,u)),p=t.absoluteSlot===null?n:n.filter(e=>!c(e,u)),m=S(t.content.tag,nodeProps(t.content,{},a),wrap(p)),h=t.backdrop===null?[]:[S(t.backdrop.tag,nodeProps(t.backdrop,{},o))];return S(t.node.tag,nodeProps(t.node,r,i),...h,m,...f.length===0?[]:[wrap(f)])}function View(e){return render(usePlan(`View`,e))}function Text(e){return render(usePlan(`Text`,e))}function Pressable(e){let t=typeof e.children==`function`?e.children:null,[n,r]=O(!1),i=usePlan(`Pressable`,t===null?e:{...e,children:t({pressed:n})}),a=i.widgetRef;return T(()=>{if(t===null)return;let e=a.current;if(e!=null)return p(e,r)},[t===null,a]),render(i)}const k=v.registerClass({GTypeName:`GjsifyReactNativeRailLayout`},class RailLayout extends y.BoxLayout{vfunc_measure(e,t,n){let plain=n=>super.vfunc_measure(e,t,n);if(t!==y.Orientation.VERTICAL\|\|n>=0\|\|this.get_orientation()!==y.Orientation.HORIZONTAL)return plain(n);let r=super.vfunc_measure(e,y.Orientation.HORIZONTAL,-1)[0],i=e.get_ancestor(y.ScrolledWindow.$gtype),a=i===null?0:Math.round(i.get_hadjustment().get_page_size()),o=Math.max(a,r);if(o<=0)return plain(n);let[,s,,c]=super.vfunc_measure(e,y.Orientation.VERTICAL,o);return[s,s,c,c]}});let A=0;const railWatchCount=()=>A;function useIntrinsicContentHeight(e){let t=D(null),n=D(null);return C(r=>{let i=t.current;i!==null&&(i.adjustment.disconnect(i.id),t.current=null,--A),n.current!==null&&(x.source_remove(n.current),n.current=null);let a=r??null;if(a===null\|\|!e)return;let o=a.get_layout_manager();if(!(o instanceof k)){let e=new k({orientation:y.Orientation.HORIZONTAL});o instanceof y.BoxLayout&&e.set_spacing(o.get_spacing()),a.set_layout_manager(e)}let s=a.get_ancestor(y.ScrolledWindow.$gtype);if(s===null)return;let c=s.get_hadjustment(),l=c.connect(`notify::page-size`,()=>{n.current===null&&(n.current=x.idle_add(x.PRIORITY_DEFAULT_IDLE,()=>(n.current=null,a.queue_resize(),x.SOURCE_REMOVE)))});t.current={adjustment:c,id:l},A+=1},[e])}function ScrollView(e){let t=usePlan(`ScrollView`,e),n=useIntrinsicContentHeight(e.horizontal===!0);return render({...t,contentExtra:{...t.contentExtra,ref:n}})}function ActivityIndicator(e){return render(usePlan(`ActivityIndicator`,e))}function TextInput(e){return render(usePlan(`TextInput`,e))}function Switch(e){return render(usePlan(`Switch`,e))}function Image(e){return render(usePlan(`Image`,e))}function ImageBackground(e){return render(usePlan(`ImageBackground`,e))}function TouchableOpacity(e){return render(usePlan(`TouchableOpacity`,e))}function TouchableHighlight(e){return render(usePlan(`TouchableHighlight`,e))}function TouchableWithoutFeedback(e){return render(usePlan(`TouchableWithoutFeedback`,e))}function Button(e){return render(usePlan(`Button`,e))}function SafeAreaView(e){return render(usePlan(`SafeAreaView`,e))}function Modal(e){let t=usePlan(`Modal`,e);return e.visible===!1?null:render(t)}function KeyboardAvoidingView(e){return render(usePlan(`KeyboardAvoidingView`,e))}function StatusBar(e){return null}const j="configures the status bar above a phone screen, and a desktop window has none — the space above it belongs to the compositor and the header bar inside it is `Adw.HeaderBar`, an ordinary widget you render. This refuses rather than accepting the call, because a setter that appears to work is indistinguishable from one that does";Object.defineProperties(StatusBar,Object.getOwnPropertyDescriptors({setBarStyle:()=>{throw new n(`StatusBar`,`setBarStyle`,j)},setHidden:()=>{throw new n(`StatusBar`,`setHidden`,j)},setBackgroundColor:()=>{throw new n(`StatusBar`,`setBackgroundColor`,j)},setTranslucent:()=>{throw new n(`StatusBar`,`setTranslucent`,j)},setNetworkActivityIndicatorVisible:()=>{throw new n(`StatusBar`,`setNetworkActivityIndicatorVisible`,j)},pushStackEntry:()=>{throw new n(`StatusBar`,`pushStackEntry`,j)},popStackEntry:()=>{throw new n(`StatusBar`,`popStackEntry`,j)},replaceStackEntry:()=>{throw new n(`StatusBar`,`replaceStackEntry`,j)},get currentHeight(){throw new n(`StatusBar`,`currentHeight`,"is the height of a phone’s status bar, and code reads it straight into a layout (`paddingTop: StatusBar.currentHeight`). A desktop window has no such bar, so any number here would inset every ported screen by a bar that is not there. Use 0 explicitly if that is what you mean")}}));function animatedBindings(e,t){let{plain:n,animated:r}=i(t),a=[];for(let[t,n]of Object.entries(r))h(e,t),a.push({key:t,value:n});return{plain:n,bindings:a}}function AnimatedView(e){let n=_(),{plain:r,bindings:i}=animatedBindings(`Animated.View`,e.style),a={...e,style:r};g(`Animated.View`,a,i.map(e=>e.key),n.tokens);let o=usePlan(`View`,a),s=o.widgetRef,c=i.map(e=>`${e.key}#${e.value.id}`).join(`\|`),l=D(i);l.current=i,T(()=>{let e=s.current;if(c===``\|\|e==null)return;let n=e,r=l.current.map(r=>{let i=t(h(`Animated.View`,r.key).property);return r.value.__attach({widget:e,write:e=>{n[i]=e}})});return()=>{for(let e of r)e()}},[c,s]);let u={};for(let e of i)u[t(h(`Animated.View`,e.key).property)]=e.value.__getValue();return render({...o,extra:{...o.extra,...u}})}function Icon(e){return render(usePlan(`Icon`,e))}export{ActivityIndicator,AnimatedView,Button,Icon,Image,ImageBackground,KeyboardAvoidingView,Modal,Pressable,SafeAreaView,ScrollView,StatusBar,Switch,Text,TextInput,TouchableHighlight,TouchableOpacity,TouchableWithoutFeedback,View,nodeProps,railWatchCount,usePlan};
1	+ import"./_virtual/_rolldown/runtime.js";import{applyAccessibility as e}from"./accessibility.js";import{accessor as t}from"./accessor.js";import{PrimitiveError as n,describeElement as r}from"./primitives/errors.js";import{onLiveRegion as i}from"./announce.js";import{splitAnimatedStyle as a}from"./primitives/style.js";import{resolvePrimitive as o}from"./primitives/resolve.js";import{childFacts as s,childNodes as c,isAbsoluteChild as l,isTextNode as u}from"./child-facts.js";import{ParentContext as d,ParentProvider as f}from"./parent-context.js";import{onGesture as p,onPressStateChange as m}from"./press.js";import{createHandle as h}from"./primitives/handles.js";import{animatedProperty as g,assertNoStaticClash as _}from"./animated/properties.js";import{styleConfig as v}from"./style-config.js";import y from"gi://GObject?version=2.0";import b from"gi://Gtk?version=4.0";import x from"gi://Gio?version=2.0";import S from"gi://GLib?version=2.0";import{createElement as C,useCallback as w,useContext as T,useEffect as E,useMemo as D,useRef as O,useState as k}from"react";function useSignals(e,n){let r=O(null),i=O(n);return i.current=n,{props:D(()=>{let n={};for(let a of e)n[`on:${a.signal}`]=()=>{let e=i.current[a.prop];if(typeof e!=`function`)return;if(a.read===null){e();return}let n=r.current;e(n===null?void 0:n[t(a.read)])};return n},[e.map(e=>`${e.prop}>${e.signal}>${e.read??``}`).join(`\|`)]),widgetRef:r}}function nodeProps(e,t,n){let r={...t,...e.props,...n};return e.cssClasses.length>0&&(r[`css-classes`]=[...e.cssClasses]),r}function usePlan(e,t){let i=t,a=T(d),l=v(),u=c(i.children),f=o(e,i,{tokens:l.tokens,sheet:l.sheet,...a===null?{}:{parent:a},children:s(u,l.tokens)}),p=Object.keys(f.intent);if(p.length>0)throw new n(e,p.join(`, `),"carries layout that only a parent can resolve — `flex-1` and `self-*` need the parent orientation, `absolute` needs the parent to be an overlay — and no parent context was published above this element: either it is the root of its React tree, or it was built outside its parent’s provider. Wrap it in a <View>, or move the utility to a child.",r(i));let m=useSignals(f.events,i),g=i.ref,_=f.handle,y=f.node.tag,b=D(()=>e=>{m.widgetRef.current=e;let t=e==null?e:h(_,e,y);typeof g==`function`?g(t):g!=null&&(g.current=t)},[g,m.widgetRef,_,y]);useGestures(f.gestures,i,m.widgetRef),useLiveRegions(f.announcements,m.widgetRef),useAccessibility(f.accessibility,m.widgetRef);let x=useFiles(f.files),S={...m.props,ref:b,...x.outer};f.slot!==null&&(S.slot=f.slot);let C={...x.content};f.contentSlot!==null&&(C.slot=f.contentSlot);let w={...x.backdrop};f.backdropSlot!==null&&(w.slot=f.backdropSlot);let E=D(()=>f.childContext,[JSON.stringify(f.childContext),f.childContext]);return{plan:f,children:u,inherited:a?.props??{},extra:S,contentExtra:C,backdropExtra:w,published:E,tokens:l.tokens,widgetRef:m.widgetRef}}function useFiles(e){return D(()=>{let t={outer:{},content:{},backdrop:{}};for(let n of e)t[n.on][n.property]=n.kind===`path`?x.File.new_for_path(n.value):x.File.new_for_uri(n.value);return t},[e.map(e=>`${e.on}>${e.property}>${e.kind}>${e.value}`).join(`\|`)])}function useGestures(e,t,n){let r=O(t);r.current=t;let i=e.map(e=>`${e.prop}>${e.signal}`).join(`\|`);E(()=>{let e=n.current;if(i===``\|\|e==null)return;let t=i.split(`\|`).map(t=>{let[n,i]=t.split(`>`);return p(e,i,()=>{let e=r.current[n];typeof e==`function`&&e()})});return()=>{for(let e of t)e()}},[i,n])}function useLiveRegions(e,t){let n=e.map(e=>`${e.signal}>${e.read}>${e.priority}`).join(`\|`);E(()=>{let e=t.current;if(n===``\|\|e==null)return;let r=n.split(`\|`).map(t=>{let[n,r,a]=t.split(`>`);return i(e,{prop:`accessibilityLiveRegion`,signal:n,read:r,priority:a})});return()=>{for(let e of r)e()}},[n,t])}function useAccessibility(t,n){let r=t.length===0?``:JSON.stringify(t);E(()=>{let t=n.current;if(!(r===``\|\|t==null))return e(t,JSON.parse(r))},[r,n])}function render(e){let{plan:t,children:n,inherited:r,extra:i,contentExtra:a,backdropExtra:o,published:s,tokens:c}=e,wrap=e=>C(f,{value:s},...e);if(t.content===null){let e=t.textSink!==null&&n.every(u)?n:[wrap(n)];return C(t.node.tag,nodeProps(t.node,r,i),...e)}let d=t.absoluteSlot===null?[]:n.filter(e=>l(e,c)),p=t.absoluteSlot===null?n:n.filter(e=>!l(e,c)),m=C(t.content.tag,nodeProps(t.content,{},a),wrap(p)),h=t.backdrop===null?[]:[C(t.backdrop.tag,nodeProps(t.backdrop,{},o))];return C(t.node.tag,nodeProps(t.node,r,i),...h,m,...d.length===0?[]:[wrap(d)])}function View(e){return render(usePlan(`View`,e))}function Text(e){return render(usePlan(`Text`,e))}function Pressable(e){let t=typeof e.children==`function`?e.children:null,[n,r]=k(!1),i=usePlan(`Pressable`,t===null?e:{...e,children:t({pressed:n})}),a=i.widgetRef;return E(()=>{if(t===null)return;let e=a.current;if(e!=null)return m(e,r)},[t===null,a]),render(i)}const A=y.registerClass({GTypeName:`GjsifyReactNativeRailLayout`},class RailLayout extends b.BoxLayout{vfunc_measure(e,t,n){let plain=n=>super.vfunc_measure(e,t,n);if(t!==b.Orientation.VERTICAL\|\|n>=0\|\|this.get_orientation()!==b.Orientation.HORIZONTAL)return plain(n);let r=super.vfunc_measure(e,b.Orientation.HORIZONTAL,-1)[0],i=e.get_ancestor(b.ScrolledWindow.$gtype),a=i===null?0:Math.round(i.get_hadjustment().get_page_size()),o=Math.max(a,r);if(o<=0)return plain(n);let[,s,,c]=super.vfunc_measure(e,b.Orientation.VERTICAL,o);return[s,s,c,c]}});let j=0;const railWatchCount=()=>j;function useIntrinsicContentHeight(e){let t=O(null),n=O(null);return w(r=>{let i=t.current;i!==null&&(i.adjustment.disconnect(i.id),t.current=null,--j),n.current!==null&&(S.source_remove(n.current),n.current=null);let a=r??null;if(a===null\|\|!e)return;let o=a.get_layout_manager();if(!(o instanceof A)){let e=new A({orientation:b.Orientation.HORIZONTAL});o instanceof b.BoxLayout&&e.set_spacing(o.get_spacing()),a.set_layout_manager(e)}let s=a.get_ancestor(b.ScrolledWindow.$gtype);if(s===null)return;let c=s.get_hadjustment(),l=c.connect(`notify::page-size`,()=>{n.current===null&&(n.current=S.idle_add(S.PRIORITY_DEFAULT_IDLE,()=>(n.current=null,a.queue_resize(),S.SOURCE_REMOVE)))});t.current={adjustment:c,id:l},j+=1},[e])}function ScrollView(e){let t=usePlan(`ScrollView`,e),n=useIntrinsicContentHeight(e.horizontal===!0);return render({...t,contentExtra:{...t.contentExtra,ref:n}})}function ActivityIndicator(e){return render(usePlan(`ActivityIndicator`,e))}function TextInput(e){return render(usePlan(`TextInput`,e))}function Switch(e){return render(usePlan(`Switch`,e))}function Image(e){return render(usePlan(`Image`,e))}function ImageBackground(e){return render(usePlan(`ImageBackground`,e))}function TouchableOpacity(e){return render(usePlan(`TouchableOpacity`,e))}function TouchableHighlight(e){return render(usePlan(`TouchableHighlight`,e))}function TouchableWithoutFeedback(e){return render(usePlan(`TouchableWithoutFeedback`,e))}function Button(e){return render(usePlan(`Button`,e))}function SafeAreaView(e){return render(usePlan(`SafeAreaView`,e))}function Modal(e){let t=usePlan(`Modal`,e);return e.visible===!1?null:render(t)}function KeyboardAvoidingView(e){return render(usePlan(`KeyboardAvoidingView`,e))}function StatusBar(e){return null}const M="configures the status bar above a phone screen, and a desktop window has none — the space above it belongs to the compositor and the header bar inside it is `Adw.HeaderBar`, an ordinary widget you render. This refuses rather than accepting the call, because a setter that appears to work is indistinguishable from one that does";Object.defineProperties(StatusBar,Object.getOwnPropertyDescriptors({setBarStyle:()=>{throw new n(`StatusBar`,`setBarStyle`,M)},setHidden:()=>{throw new n(`StatusBar`,`setHidden`,M)},setBackgroundColor:()=>{throw new n(`StatusBar`,`setBackgroundColor`,M)},setTranslucent:()=>{throw new n(`StatusBar`,`setTranslucent`,M)},setNetworkActivityIndicatorVisible:()=>{throw new n(`StatusBar`,`setNetworkActivityIndicatorVisible`,M)},pushStackEntry:()=>{throw new n(`StatusBar`,`pushStackEntry`,M)},popStackEntry:()=>{throw new n(`StatusBar`,`popStackEntry`,M)},replaceStackEntry:()=>{throw new n(`StatusBar`,`replaceStackEntry`,M)},get currentHeight(){throw new n(`StatusBar`,`currentHeight`,"is the height of a phone’s status bar, and code reads it straight into a layout (`paddingTop: StatusBar.currentHeight`). A desktop window has no such bar, so any number here would inset every ported screen by a bar that is not there. Use 0 explicitly if that is what you mean")}}));function animatedBindings(e,t){let{plain:n,animated:r}=a(t),i=[];for(let[t,n]of Object.entries(r))g(e,t),i.push({key:t,value:n});return{plain:n,bindings:i}}function AnimatedView(e){let n=v(),{plain:r,bindings:i}=animatedBindings(`Animated.View`,e.style),a={...e,style:r};_(`Animated.View`,a,i.map(e=>e.key),n.tokens);let o=usePlan(`View`,a),s=o.widgetRef,c=i.map(e=>`${e.key}#${e.value.id}`).join(`\|`),l=O(i);l.current=i,E(()=>{let e=s.current;if(c===``\|\|e==null)return;let n=e,r=l.current.map(r=>{let i=t(g(`Animated.View`,r.key).property);return r.value.__attach({widget:e,write:e=>{n[i]=e}})});return()=>{for(let e of r)e()}},[c,s]);let u={};for(let e of i)u[t(g(`Animated.View`,e.key).property)]=e.value.__getValue();return render({...o,extra:{...o.extra,...u}})}function Icon(e){return render(usePlan(`Icon`,e))}export{ActivityIndicator,AnimatedView,Button,Icon,Image,ImageBackground,KeyboardAvoidingView,Modal,Pressable,SafeAreaView,ScrollView,StatusBar,Switch,Text,TextInput,TouchableHighlight,TouchableOpacity,TouchableWithoutFeedback,View,nodeProps,railWatchCount,usePlan};

package/lib/esm/press.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"./_virtual/_rolldown/runtime.js";import e from"gi://Gtk?version=4.0";let t=0;const pressWatchCount=()=>t,isPressed=t=>(t.get_state_flags()&e.StateFlags.ACTIVE)!==0;function onPressStateChange(e,n){let r=isPressed(e),i=e.connect(`state-flags-changed`,()=>{let t=isPressed(e);t!==r&&(r=t,n(t))});return t+=1,n(r),()=>{e.disconnect(i),--t}}function onGesture(t,n,r){let i=new e.GestureClick,a=i.~~connect~~(n,()=>r());return t.add_controller(i),()=>{t.remove_controller(i),i.disconnect(a)}}export{onGesture,onPressStateChange,pressWatchCount};
1	+ import"./_virtual/_rolldown/runtime.js";import e from"gi://GObject?version=2.0";import t from"gi://Gtk?version=4.0";let n=0;const pressWatchCount=()=>n,isPressed=e=>(e.get_state_flags()&t.StateFlags.ACTIVE)!==0;function onPressStateChange(e,t){let r=isPressed(e),i=e.connect(`state-flags-changed`,()=>{let n=isPressed(e);n!==r&&(r=n,t(n))});return n+=1,t(r),()=>{e.disconnect(i),--n}}function onGesture(n,r,i){let a=new t.GestureClick,o=e.signal_connect(a,r,()=>i());return n.add_controller(a),()=>{n.remove_controller(a),a.disconnect(o)}}export{onGesture,onPressStateChange,pressWatchCount};

package/lib/esm/primitives/accessibility.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"../_virtual/_rolldown/runtime.js";const e={false:0,true:1,mixed:2};function coerceAttribute(t,n){switch(t.as){case`string`:return typeof n==`string`?n:null;case`boolean`:return typeof n==`boolean`?n:null;case`tristate`:return typeof n==`boolean`?n?e.true:e.false:n===`mixed`?e.mixed:null}}const t={string:`a string`,boolean:`true or false`,tristate:`true, false or "mixed" — GTK reads it as a Gtk.AccessibleTristate`};function resolveAccessible(e,n,r){if(e.from===`value`){let i=coerceAttribute(e.attribute,r);return i===null?{entries:[],problem:`writes the GTK accessible ${e.attribute.set} "${e.attribute.name}" and needs ${t[e.attribute.as]}`}:{entries:[{prop:n,set:e.attribute.set,name:e.attribute.name,value:i}],problem:null}}if(typeof r!=`object`\|\|!r\|\|Array.isArray(r))return{entries:[],problem:`is a record of accessibility states and needs an object — its keys are ${Object.keys(e.members).sort().join(`, `)}`};let i=[];for(let[a,o]of Object.entries(r)){if(o===void 0)continue;let r=e.refuses[a];if(r!==void 0)return{entries:[],problem:`carries "${a}", which ${r}`};let s=e.members[a];if(s===void 0)return{entries:[],problem~~:`carries "${a}"~~, ~~which is not a state this layer answers for. It takes: ${~~Object.keys(e.members)~~.sort(~~)~~.join(`, `)~~}`};let c=coerceAttribute(s,o);if(c===null)return{entries:[],problem:`carries "${a}", which needs ${t[s.as]}`};i.push({prop:n,set:s.set,name:s.name,value:c})}return{entries:i,problem:null}}export{resolveAccessible};
1	+ import"../_virtual/_rolldown/runtime.js";import{describeValue as e,unknownAccessibleKeyDetail as t}from"./errors.js";const n={false:0,true:1,mixed:2};function coerceAttribute(e,t){switch(e.as){case`string`:return typeof t==`string`?t:null;case`boolean`:return typeof t==`boolean`?t:null;case`tristate`:return typeof t==`boolean`?t?n.true:n.false:t===`mixed`?n.mixed:null}}const r={string:`a string`,boolean:`true or false`,tristate:`true, false or "mixed" — GTK reads it as a Gtk.AccessibleTristate`};function resolveAccessible(n,i,a){if(n.from===`value`){let t=coerceAttribute(n.attribute,a);return t===null?{entries:[],problem:`writes the GTK accessible ${n.attribute.set} "${n.attribute.name}" and needs ${r[n.attribute.as]}; got ${e(a)}`}:{entries:[{prop:i,set:n.attribute.set,name:n.attribute.name,value:t}],problem:null}}if(typeof a!=`object`\|\|!a\|\|Array.isArray(a))return{entries:[],problem:`is a record of accessibility states and needs an object — its keys are ${Object.keys(n.members).sort().join(`, `)}; got ${e(a)}`};let o=[];for(let[s,c]of Object.entries(a)){if(c===void 0)continue;let a=n.refuses[s];if(a!==void 0)return{entries:[],problem:`carries "${s}", which ${a}`};let l=n.members[s];if(l===void 0)return{entries:[],problem:t(s,Object.keys(n.members))};let u=coerceAttribute(l,c);if(u===null)return{entries:[],problem:`carries "${s}", which needs ${r[l.as]}; got ${e(c)}`};o.push({prop:i,set:l.set,name:l.name,value:u})}return{entries:o,problem:null}}export{resolveAccessible};

package/lib/esm/primitives/answers.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"../_virtual/_rolldown/runtime.js";function accessibleReach(e){let call=e=>e===`property`?`Gtk.Accessible.update_property()`:`Gtk.Accessible.update_state()`;return e.from===`value`?[`${call(e.attribute.set)}: ${e.attribute.name}`]:Object.keys(e.members).sort().map(t=>{let n=e.members[t];return`${t} → ${call(n.set)}: ${n.name}`})}const isAccepted=e=>e!==`refused`&&e!==`unknown`,unknownPropDetail=e=>`is not a prop this primitive answers for. It takes: ${Object.keys(e.props).sort().join(`, `)}. An unlisted prop is refused rather than dropped: a prop that silently does nothing is indistinguishable from a bug in the application, forever`,unknownPrimitiveDetail=e=>`is not a primitive this layer answers for. Known: ${[...e].sort().join(`, `)}`,e={};function answerForRoute(t){switch(t.to){case`property`:return{status:`property`,why:``,gtk:t.names,refuses:t.refuses??e};case`style-property`:return{status:`style`,why:``,gtk:[`style: ${t.name}`],refuses:e};case`event`:return{status:`event`,why:``,gtk:[t.signal],refuses:e};case`file`:return{status:`file`,why:``,gtk:[t.property],refuses:e};case`gesture`:return{status:`gesture`,why:``,gtk:[`Gtk.GestureClick::${t.signal}`],refuses:e};case`announce`:return{status:`announcement`,why:``,gtk:[t.signal,`Gtk.Accessible.announce()`],refuses:e};case`accessible`:return{status:`accessible`,why:``,gtk:accessibleReach(t),refuses:t.from===`members`?t.refuses:e};case`ignored`:return{status:`ignored`,why:t.why,gtk:[],refuses:e};case`refused`:return{status:`refused`,why:t.why,gtk:[],refuses:e}}}function answerFor(t,n,r,i){if(n.refusesStyle!==void 0&&(r===`style`\|\|r===`className`))return{primitive:t,prop:r,status:`refused`,why:n.refusesStyle,gtk:[],refuses:e};if(i.has(r))return{primitive:t,prop:r,status:`framework`,why:``,gtk:[],refuses:e};let a=n.props[r];if(a===void 0)return{primitive:t,prop:r,status:`unknown`,why:unknownPropDetail(n),gtk:[],refuses:e};let o=(Array.isArray(a)?a:[a]).map(answerForRoute),s=o[0];return{primitive:t,prop:r,status:s.status,why:s.why,gtk:o.flatMap(e=>e.gtk),refuses:Object.assign({},...o.map(e=>e.refuses))}}function propNamesOf(e){return Object.keys(e.props).sort()}export{answerFor,isAccepted,propNamesOf,unknownPrimitiveDetail,unknownPropDetail};
1	+ import"../_virtual/_rolldown/runtime.js";function accessibleReach(e){let call=e=>e===`property`?`Gtk.Accessible.update_property()`:`Gtk.Accessible.update_state()`;return e.from===`value`?[`${call(e.attribute.set)}: ${e.attribute.name}`]:Object.keys(e.members).sort().map(t=>{let n=e.members[t];return`${t} → ${call(n.set)}: ${n.name}`})}const isAccepted=e=>e!==`refused`&&e!==`unknown`,unknownPropDetail=e=>`is not a prop this primitive answers for. It takes: ${Object.keys(e.props).sort().join(`, `)}. An unlisted prop is refused rather than dropped: a prop that silently does nothing is indistinguishable from a bug in the application, forever`,unknownPrimitiveDetail=e=>`is not a primitive this layer answers for. Known: ${[...e].sort().join(`, `)}`,e={},named=e=>({values:e,numbers:!1});function coercionVocabulary(e){switch(e.as){case`map`:return named(Object.keys(e.map??{}));case`pixels-or-map`:return{values:Object.keys(e.map??{}),numbers:!0};case`string`:case`boolean`:case`not`:case`int`:return null}}function routeValueVocabulary(e){switch(e.to){case`property`:return coercionVocabulary(e);case`announce`:return named(Object.keys(e.map));case`accessible`:return e.from===`members`?named(Object.keys(e.members)):null;case`style-property`:case`event`:case`file`:case`gesture`:case`ignored`:case`refused`:return null}}function intersectVocabularies(e){let t=e.filter(e=>e!==null);return t.length===0?null:{values:t[0].values.filter(e=>t.every(t=>t.values.includes(e))),numbers:t.every(e=>e.numbers)}}function answerForRoute(t){let n=routeValueVocabulary(t);switch(t.to){case`property`:return{status:`property`,why:``,gtk:t.names,refuses:t.refuses??e,allows:n};case`style-property`:return{status:`style`,why:``,gtk:[`style: ${t.name}`],refuses:e,allows:n};case`event`:return{status:`event`,why:``,gtk:[t.signal],refuses:e,allows:n};case`file`:return{status:`file`,why:``,gtk:[t.property],refuses:e,allows:n};case`gesture`:return{status:`gesture`,why:``,gtk:[`Gtk.GestureClick::${t.signal}`],refuses:e,allows:n};case`announce`:return{status:`announcement`,why:``,gtk:[t.signal,`Gtk.Accessible.announce()`],refuses:e,allows:n};case`accessible`:return{status:`accessible`,why:``,gtk:accessibleReach(t),refuses:t.from===`members`?t.refuses:e,allows:n};case`ignored`:return{status:`ignored`,why:t.why,gtk:[],refuses:e,allows:n};case`refused`:return{status:`refused`,why:t.why,gtk:[],refuses:e,allows:n}}}function answerFor(t,n,r,i){if(n.refusesStyle!==void 0&&(r===`style`\|\|r===`className`))return{primitive:t,prop:r,status:`refused`,why:n.refusesStyle,gtk:[],refuses:e,allows:null};if(i.has(r))return{primitive:t,prop:r,status:`framework`,why:``,gtk:[],refuses:e,allows:null};let a=n.props[r];if(a===void 0)return{primitive:t,prop:r,status:`unknown`,why:unknownPropDetail(n),gtk:[],refuses:e,allows:null};let o=(Array.isArray(a)?a:[a]).map(answerForRoute),s=o[0];return{primitive:t,prop:r,status:s.status,why:s.why,gtk:o.flatMap(e=>e.gtk),refuses:Object.assign({},...o.map(e=>e.refuses)),allows:intersectVocabularies(o.map(e=>e.allows))}}function propNamesOf(e){return Object.keys(e.props).sort()}export{answerFor,isAccepted,propNamesOf,routeValueVocabulary,unknownPrimitiveDetail,unknownPropDetail};

package/lib/esm/primitives/errors.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"../_virtual/_rolldown/runtime.js";const primitiveErrorMessage=(e,t,n)=>`@gjsify/react-native: <${e}>${t===``?``:` ${t}`} — ${n}`,describeValue=e=>typeof e==`string`?`"${e}"`:typeof e==`object`&&e?Object.prototype.toString.call(e):String(e);var PrimitiveError=class extends Error{constructor(e,t,n){super(primitiveErrorMessage(e,t,n)),this.name=`PrimitiveError`,this.primitive=e,this.subject=t}};export{PrimitiveError,describeValue,primitiveErrorMessage};
1	+ import"../_virtual/_rolldown/runtime.js";const primitiveErrorMessage=(e,t,n,r=``)=>`@gjsify/react-native: <${e}>${t===``?``:` ${t}`} — ${n}${r===``?``:` ${r}`}`,describeElement=e=>{let t=[],n=(Array.isArray(e.className)?e.className.filter(e=>typeof e==`string`).join(` `):typeof e.className==`string`?e.className:``).trim().replace(/\s+/gu,` `);return n!==``&&t.push(`className="${n.length>120?`${n.slice(0,117)}…`:n}"`),typeof e.testID==`string`&&e.testID!==``&&t.push(`testID="${e.testID}"`),t.length===0?``:`[${t.join(` `)}]`},describeValue=e=>typeof e==`string`?`"${e}"`:typeof e==`object`&&e?Object.prototype.toString.call(e):String(e),unknownMappedValueDetail=(e,t)=>`has no GTK equivalent for ${e}. Known: ${[...t].sort().join(`, `)}. A value absent from that list is absent because GTK has no member for it, not because the table is short`,unknownAccessibleKeyDetail=(e,t)=>`carries "${e}", which is not a state this layer answers for. It takes: ${[...t].sort().join(`, `)}`;var PrimitiveError=class extends Error{constructor(e,t,n,r=``){super(primitiveErrorMessage(e,t,n,r)),this.name=`PrimitiveError`,this.primitive=e,this.subject=t,this.where=r}};export{PrimitiveError,describeElement,describeValue,primitiveErrorMessage,unknownAccessibleKeyDetail,unknownMappedValueDetail};

package/lib/esm/primitives/resolve.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"../_virtual/_rolldown/runtime.js";import{PrimitiveError as e,describeValue as t}from"./errors.js";import{resolveAccessible as n}from"./accessibility.js";import{unknownPrimitiveDetail as r,unknownPropDetail as i}from"./answers.js";import{resolveIntent as a}from"./intents.js";import{mintClass as o,normalise as s,partition as c,variantDeclarations as l}from"./style.js";import{FRAMEWORK_PROPS as u,PRIMITIVES as d,PRIMITIVE_NAMES as f}from"./table.js";const p=[`orientation`,`spacing`],withOrientationClass=(e,t)=>{if(t.length===0)return t;let n=e.orientation;return typeof n==`string`?[n,...t]:t},wrapped=(e,t,n)=>{if(n===null)return{tag:e,props:t};let{spacing:r,...i}=t;return{tag:n.tag,props:{...i,...n.props}}};function declaresAbsolute(e,t,n=`View`){let{props:r}=s(e,t,n);return c(r).intent.overlay?.role===`child`}function resolvePrimitive(t,n,m){let h=d[t];if(h===void 0)throw new e(t,``,r(f));let g=h.switchOn!==void 0&&n[h.switchOn.prop]===!0?h.switchOn.whenTrue:h,_=g.content,v={...g.widgetProps},y={..._?.widgetProps},b={...g.backdrop?.widgetProps},x={},S=[],C=[],w=[],T=[],E=[],D=new Set([_?.styleProp,_?.classNameProp,g.backdrop?.styleProp,g.backdrop?.classNameProp].filter(e=>typeof e==`string`));if(g.refusesStyle!==void 0&&(n.className!==void 0\|\|n.style!==void 0))throw new e(t,n.className===void 0?`prop "style"`:`prop "className"`,g.refusesStyle);for(let r of Object.keys(n)){if(u.has(r)\|\|D.has(r))continue;let a=n[r];if(a===void 0)continue;let o=g.props[r];if(o===void 0)throw new e(t,`prop "${r}"`,i(g));for(let e of Array.isArray(o)?o:[o])applyRoute(e,r,a,{primitive:t,spec:g,outerProps:v,contentProps:y,backdropProps:b,styleExtra:x,events:S,files:C,gestures:w,announcements:T,accessibility:E})}let O=s(n,m.tokens,t),k=c({...O.props,...x}),A=orientationOf(k.props.orientation??v.orientation,g.orientation),j=_===void 0?A:orientationOf(y.orientation,_.orientation),M=a({primitive:t,intent:k.intent,orientation:j,widget:g.widget,...m.parent===void 0?{}:{parent:m.parent},...m.children===void 0?{}:{children:m.children},emittedProps:k.props}),N=o(m.sheet,[...k.css,...M.css],l(O.groups,m.tokens,t));Object.assign(v,k.props,M.props),assertOneTextAuthority(t,g,v,m.children);let P=[...g.cssClasses,...N===null?[]:[N]],F=g.overlayOnAbsoluteChild;if(F!==void 0&&(m.children?.absolute??0)>0){let e={...g.widgetProps};for(let t of p)v[t]!==void 0&&(e[t]=v[t],delete v[t]);let n=wrapped(g.tag,e,M.wrapping);return{primitive:t,node:{tag:F.tag,props:v,cssClasses:withOrientationClass(v,P)},content:{tag:n.tag,props:n.props,cssClasses:[]},backdrop:null,backdropSlot:null,contentSlot:null,slot:M.slot,absoluteSlot:F.slot,events:S,files:C,gestures:w,announcements:T,accessibility:E,handle:g.handle??null,textSink:g.textSink,childContext:{...M.childContext,orientation:j,overlay:!0},intent:M.remaining}}let I=_===void 0?null:resolveNode(_,n,y,m,t),L=g.backdrop===void 0?null:resolveNode(g.backdrop,n,b,m,t),R=wrapped(g.tag,v,M.wrapping);return{primitive:t,node:{tag:R.tag,props:R.props,cssClasses:withOrientationClass(R.props,P)},content:I===null?null:I.node,backdrop:L===null?null:L.node,backdropSlot:g.backdrop?.slot??null,contentSlot:_?.slot??null,slot:M.slot,absoluteSlot:null,events:S,files:C,gestures:w,announcements:T,accessibility:E,handle:g.handle??null,textSink:g.textSink,childContext:I===null?{...M.childContext,overlay:!1}:{...I.childContext,...I.childContext.textAlign===void 0&&M.childContext.textAlign!==void 0?{textAlign:M.childContext.textAlign}:{},overlay:!1},intent:M.remaining}}function resolveNode(e,t,n,r,i){let u=`${i} ${e.styleProp??`content`}`,d=s({...e.classNameProp===null?{}:{className:t[e.classNameProp]},...e.styleProp===null?{}:{style:t[e.styleProp]}},r.tokens,u),f=c(d.props),p=orientationOf(f.props.orientation??n.orientation,e.orientation),m=a({primitive:u,intent:f.intent,orientation:p,widget:e.widget,parent:{orientation:p,props:{},overlay:!1},emittedProps:f.props}),h=o(r.sheet,[...f.css,...m.css],l(d.groups,r.tokens,u));Object.assign(n,f.props,m.props);let g=wrapped(e.tag,n,m.wrapping);return{node:{tag:g.tag,props:g.props,cssClasses:withOrientationClass(g.props,h===null?[]:[h])},childContext:{...m.childContext,orientation:p}}}function applyRoute(r,i,a,o){switch(r.to){case`refused`:throw new e(o.primitive,`prop "${i}"`,r.why);case`ignored`:return;case`style-property`:o.styleExtra[r.name]=a;return;case`event`:if(typeof a!=`function`)throw new e(o.primitive,`prop "${i}"`,`binds the GTK signal "${r.signal}" and needs a function; got ${t(a)}`);o.events.push({prop:i,signal:r.signal,read:r.read??null});return;case`file`:o.files.push({on:nodeOf(r.on,o,i),property:r.property,...normaliseSource(o.primitive,i,a)});return;case`gesture`:if(typeof a!=`function`)throw new e(o.primitive,`prop "${i}"`,`binds a Gtk.GestureClick's "${r.signal}" and needs a function; got ${t(a)}`);o.gestures.push({prop:i,signal:r.signal});return;case`announce`:{let n=r.map[String(a)];if(n===void 0)throw new e(o.primitive,`prop "${i}"~~`,`has no GTK equivalent for ${~~t(a)~~}. Known: ${~~Object.keys(r.map)~~.sort(~~)~~.join(`, `~~)~~}. A value absent from that list is absent because GTK has no member for it, not because the table is short`)~~;if(n===null)return;o.announcements.push({prop:i,signal:r.signal,read:r.read,priority:n});return}case`accessible`:{let{entries:s,problem:c}=n(r,i,a);if(c!==null)throw new e(o.primitive,`prop "${i}"~~`,`${c}; got ${t(a~~)~~}`)~~;o.accessibility.push(...s);return}case`property`:{let e=nodeOf(r.on,o,i),t=e===`content`?o.contentProps:e===`backdrop`?o.backdropProps:o.outerProps,n=coerce(r,i,a,o.primitive);for(let e of r.names)t[e]=n;r.also!==void 0&&Object.assign(t,r.also);return}}}function nodeOf(t,n,r){if(t===`content`&&n.spec.content===void 0)throw new e(n.primitive,`prop "${r}"`,`is routed to a content node this primitive does not declare — the table is wrong, not the call`);if(t===`backdrop`&&n.spec.backdrop===void 0)throw new e(n.primitive,`prop "${r}"`,`is routed to a backdrop node this primitive does not declare — the table is wrong, not the call`);return t??`outer`}function normaliseSource(n,r,i){let refuse=t=>{throw new e(n,`prop "${r}"`,t)};if(typeof i==`number`)return refuse("is a number, which is what `require('./image.png')` returns: an opaque id into React Native’s own asset registry. This build chain has no such registry (ADR 0032 § 12 leaves the build to the consumer), so there is nothing to resolve it against. Use `{ uri: '/path/to/image.png' }`, or ship the image in a GResource and use `{ uri: 'resource:///…' }`");if(Array.isArray(i))return refuse("is an array, which is React Native’s per-device-scale picker (`@2x`, `@3x`). GTK draws ONE texture and scales it by the surface’s own scale factor, so there is no candidate to choose between. Give one source");if(typeof i==`string`)return refuse("is a bare string. React Native’s own type is `{ uri }`, and accepting both spellings here would make one string ambiguous between a path and a URI at exactly the layer that has to decide. Write `{ uri: … }`");if(typeof i!=`object`\|\|!i)return refuse(`expects { uri }; got ${t(i)}`);let a=i,o=Object.keys(a).filter(e=>e!==`uri`);if(o.length>0)return refuse(`carries ${o.join(`, `)} beside \`uri\`. Those describe a remote image React Native measures before it arrives (\`width\`/\`height\`) or fetches with headers, and neither reaches a \`Gtk.Picture\` — it takes a file and draws it. Keep \`uri\` alone`);let s=a.uri;if(typeof s!=`string`\|\|s===``)return refuse(`expects { uri: string }; got uri = ${t(s)}`);let c=/^([a-zA-Z][a-zA-Z0-9+.-]+):/.exec(s)?.[1]?.toLowerCase();return c===void 0?{kind:`path`,value:s}:c===`file`\|\|c===`resource`?{kind:`uri`,value:s}:refuse(c===`http`\|\|c===`https`\|\|c===`data`?`is a \`${c}:\` URI, and loading one needs a fetch, a decoder and a cache — an asynchronous pipeline this layer does not own. Handing a non-native \`Gio.File\` to \`Gtk.Picture:file\` would decode on the main loop instead. Fetch the bytes yourself, build a \`Gdk.Texture\`, and set \`paintable\` through a ref`:`is a \`${c}:\` URI, and this layer only opens what GTK can read synchronously: a local path, \`file:\` and \`resource:\` (measured). Anything else needs a loader that is not here`)}function coerce(n,r,i,a){let bad=n=>{throw new e(a,`prop "${r}"`,`expects ${n}; got ${t(i)}`)};switch(n.as){case`string`:return typeof i==`string`?i:typeof i==`number`\|\|typeof i==`boolean`?String(i):bad(`a string`);case`boolean`:return typeof i==`boolean`?i:bad(`a boolean`);case`not`:return typeof i==`boolean`?!i:bad(`a boolean`);case`int`:return typeof i==`number`&&Number.isFinite(i)?Math.trunc(i):bad(`a number`);case`map`:return lookup(n,r,i,a);case`pixels-or-map`:return typeof i==`number`&&Number.isFinite(i)?Math.trunc(i):lookup(n,r,i,a)}}function lookup(n,r,i,a){let o=n.map??{},s=o[String(i)];if(s!==void 0)return s;let c=n.refuses?.[String(i)];throw c===void 0?new e(a,`prop "${r}"~~`,`has no GTK equivalent for ${~~t(i)~~}. Known: ${~~Object.keys(o)~~.sort(~~)~~.join(`, `~~)~~}. A value absent from that list is absent because GTK has no member for it, not because the table is short`)~~:new e(a,`prop "${r}" = ${t(i)}`,c)}function assertOneTextAuthority(t,n,r,i){if(!(n.textSink===null\|\|i?.text!==!0)&&r[n.textSink]!==void 0)throw new e(t,`prop → "${n.textSink}"`,`is the same widget property a text CHILD writes, and both were given. Whichever the reconciler applied last would win, possibly differently on a first render and on an update — so it is refused. Keep one`)}const orientationOf=(e,t)=>e===`horizontal`\|\|e===`vertical`?e:t;export{declaresAbsolute,resolvePrimitive};
1	+ import"../_virtual/_rolldown/runtime.js";import{PrimitiveError as e,describeValue as t,unknownMappedValueDetail as n}from"./errors.js";import{resolveAccessible as r}from"./accessibility.js";import{unknownPrimitiveDetail as i,unknownPropDetail as a}from"./answers.js";import{resolveIntent as o}from"./intents.js";import{mintClass as s,normalise as c,partition as l,variantDeclarations as u}from"./style.js";import{FRAMEWORK_PROPS as d,PRIMITIVES as f,PRIMITIVE_NAMES as p}from"./table.js";const m=[`orientation`,`spacing`],withOrientationClass=(e,t)=>{if(t.length===0)return t;let n=e.orientation;return typeof n==`string`?[n,...t]:t},wrapped=(e,t,n)=>{if(n===null)return{tag:e,props:t};let{spacing:r,...i}=t;return{tag:n.tag,props:{...i,...n.props}}};function declaresAbsolute(e,t,n=`View`){let{props:r}=c(e,t,n);return l(r).intent.overlay?.role===`child`}function resolvePrimitive(t,n,r){let h=f[t];if(h===void 0)throw new e(t,``,i(p));let g=h.switchOn!==void 0&&n[h.switchOn.prop]===!0?h.switchOn.whenTrue:h,_=g.content,v={...g.widgetProps},y={..._?.widgetProps},b={...g.backdrop?.widgetProps},x={},S=[],C=[],w=[],T=[],E=[],D=new Set([_?.styleProp,_?.classNameProp,g.backdrop?.styleProp,g.backdrop?.classNameProp].filter(e=>typeof e==`string`));if(g.refusesStyle!==void 0&&(n.className!==void 0\|\|n.style!==void 0))throw new e(t,n.className===void 0?`prop "style"`:`prop "className"`,g.refusesStyle);for(let r of Object.keys(n)){if(d.has(r)\|\|D.has(r))continue;let i=n[r];if(i===void 0)continue;let o=g.props[r];if(o===void 0)throw new e(t,`prop "${r}"`,a(g));for(let e of Array.isArray(o)?o:[o])applyRoute(e,r,i,{primitive:t,spec:g,outerProps:v,contentProps:y,backdropProps:b,styleExtra:x,events:S,files:C,gestures:w,announcements:T,accessibility:E})}let O=c(n,r.tokens,t),k=l({...O.props,...x}),A=orientationOf(k.props.orientation??v.orientation,g.orientation),j=_===void 0?A:orientationOf(y.orientation,_.orientation),M=o({primitive:t,intent:k.intent,orientation:j,widget:g.widget,...r.parent===void 0?{}:{parent:r.parent},...r.children===void 0?{}:{children:r.children},emittedProps:k.props}),N=s(r.sheet,[...k.css,...M.css],u(O.groups,r.tokens,t));Object.assign(v,k.props,M.props),assertOneTextAuthority(t,g,v,r.children);let P=[...g.cssClasses,...N===null?[]:[N]],F=g.overlayOnAbsoluteChild;if(F!==void 0&&(r.children?.absolute??0)>0){let e={...g.widgetProps};for(let t of m)v[t]!==void 0&&(e[t]=v[t],delete v[t]);let n=wrapped(g.tag,e,M.wrapping);return{primitive:t,node:{tag:F.tag,props:v,cssClasses:withOrientationClass(v,P)},content:{tag:n.tag,props:n.props,cssClasses:[]},backdrop:null,backdropSlot:null,contentSlot:null,slot:M.slot,absoluteSlot:F.slot,events:S,files:C,gestures:w,announcements:T,accessibility:E,handle:g.handle??null,textSink:g.textSink,childContext:{...M.childContext,orientation:j,overlay:!0},intent:M.remaining}}let I=_===void 0?null:resolveNode(_,n,y,r,t),L=g.backdrop===void 0?null:resolveNode(g.backdrop,n,b,r,t),R=wrapped(g.tag,v,M.wrapping);return{primitive:t,node:{tag:R.tag,props:R.props,cssClasses:withOrientationClass(R.props,P)},content:I===null?null:I.node,backdrop:L===null?null:L.node,backdropSlot:g.backdrop?.slot??null,contentSlot:_?.slot??null,slot:M.slot,absoluteSlot:null,events:S,files:C,gestures:w,announcements:T,accessibility:E,handle:g.handle??null,textSink:g.textSink,childContext:I===null?{...M.childContext,overlay:!1}:{...I.childContext,...I.childContext.textAlign===void 0&&M.childContext.textAlign!==void 0?{textAlign:M.childContext.textAlign}:{},overlay:!1},intent:M.remaining}}function resolveNode(e,t,n,r,i){let a=`${i} ${e.styleProp??`content`}`,d=c({...e.classNameProp===null?{}:{className:t[e.classNameProp]},...e.styleProp===null?{}:{style:t[e.styleProp]}},r.tokens,a),f=l(d.props),p=orientationOf(f.props.orientation??n.orientation,e.orientation),m=o({primitive:a,intent:f.intent,orientation:p,widget:e.widget,parent:{orientation:p,props:{},overlay:!1},emittedProps:f.props}),h=s(r.sheet,[...f.css,...m.css],u(d.groups,r.tokens,a));Object.assign(n,f.props,m.props);let g=wrapped(e.tag,n,m.wrapping);return{node:{tag:g.tag,props:g.props,cssClasses:withOrientationClass(g.props,h===null?[]:[h])},childContext:{...m.childContext,orientation:p}}}function applyRoute(i,a,o,s){switch(i.to){case`refused`:throw new e(s.primitive,`prop "${a}"`,i.why);case`ignored`:return;case`style-property`:s.styleExtra[i.name]=o;return;case`event`:if(typeof o!=`function`)throw new e(s.primitive,`prop "${a}"`,`binds the GTK signal "${i.signal}" and needs a function; got ${t(o)}`);s.events.push({prop:a,signal:i.signal,read:i.read??null});return;case`file`:s.files.push({on:nodeOf(i.on,s,a),property:i.property,...normaliseSource(s.primitive,a,o)});return;case`gesture`:if(typeof o!=`function`)throw new e(s.primitive,`prop "${a}"`,`binds a Gtk.GestureClick's "${i.signal}" and needs a function; got ${t(o)}`);s.gestures.push({prop:a,signal:i.signal});return;case`announce`:{let r=i.map[String(o)];if(r===void 0)throw new e(s.primitive,`prop "${a}"`,n(t(o),Object.keys(i.map)));if(r===null)return;s.announcements.push({prop:a,signal:i.signal,read:i.read,priority:r});return}case`accessible`:{let{entries:t,problem:n}=r(i,a,o);if(n!==null)throw new e(s.primitive,`prop "${a}"`,n);s.accessibility.push(...t);return}case`property`:{let e=nodeOf(i.on,s,a),t=e===`content`?s.contentProps:e===`backdrop`?s.backdropProps:s.outerProps,n=coerce(i,a,o,s.primitive);for(let e of i.names)t[e]=n;i.also!==void 0&&Object.assign(t,i.also);return}}}function nodeOf(t,n,r){if(t===`content`&&n.spec.content===void 0)throw new e(n.primitive,`prop "${r}"`,`is routed to a content node this primitive does not declare — the table is wrong, not the call`);if(t===`backdrop`&&n.spec.backdrop===void 0)throw new e(n.primitive,`prop "${r}"`,`is routed to a backdrop node this primitive does not declare — the table is wrong, not the call`);return t??`outer`}function normaliseSource(n,r,i){let refuse=t=>{throw new e(n,`prop "${r}"`,t)};if(typeof i==`number`)return refuse("is a number, which is what `require('./image.png')` returns: an opaque id into React Native’s own asset registry. This build chain has no such registry (ADR 0032 § 12 leaves the build to the consumer), so there is nothing to resolve it against. Use `{ uri: '/path/to/image.png' }`, or ship the image in a GResource and use `{ uri: 'resource:///…' }`");if(Array.isArray(i))return refuse("is an array, which is React Native’s per-device-scale picker (`@2x`, `@3x`). GTK draws ONE texture and scales it by the surface’s own scale factor, so there is no candidate to choose between. Give one source");if(typeof i==`string`)return refuse("is a bare string. React Native’s own type is `{ uri }`, and accepting both spellings here would make one string ambiguous between a path and a URI at exactly the layer that has to decide. Write `{ uri: … }`");if(typeof i!=`object`\|\|!i)return refuse(`expects { uri }; got ${t(i)}`);let a=i,o=Object.keys(a).filter(e=>e!==`uri`);if(o.length>0)return refuse(`carries ${o.join(`, `)} beside \`uri\`. Those describe a remote image React Native measures before it arrives (\`width\`/\`height\`) or fetches with headers, and neither reaches a \`Gtk.Picture\` — it takes a file and draws it. Keep \`uri\` alone`);let s=a.uri;if(typeof s!=`string`\|\|s===``)return refuse(`expects { uri: string }; got uri = ${t(s)}`);let c=/^([a-zA-Z][a-zA-Z0-9+.-]+):/.exec(s)?.[1]?.toLowerCase();return c===void 0?{kind:`path`,value:s}:c===`file`\|\|c===`resource`?{kind:`uri`,value:s}:refuse(c===`http`\|\|c===`https`\|\|c===`data`?`is a \`${c}:\` URI, and loading one needs a fetch, a decoder and a cache — an asynchronous pipeline this layer does not own. Handing a non-native \`Gio.File\` to \`Gtk.Picture:file\` would decode on the main loop instead. Fetch the bytes yourself, build a \`Gdk.Texture\`, and set \`paintable\` through a ref`:`is a \`${c}:\` URI, and this layer only opens what GTK can read synchronously: a local path, \`file:\` and \`resource:\` (measured). Anything else needs a loader that is not here`)}function coerce(n,r,i,a){let bad=n=>{throw new e(a,`prop "${r}"`,`expects ${n}; got ${t(i)}`)};switch(n.as){case`string`:return typeof i==`string`?i:typeof i==`number`\|\|typeof i==`boolean`?String(i):bad(`a string`);case`boolean`:return typeof i==`boolean`?i:bad(`a boolean`);case`not`:return typeof i==`boolean`?!i:bad(`a boolean`);case`int`:return typeof i==`number`&&Number.isFinite(i)?Math.trunc(i):bad(`a number`);case`map`:return lookup(n,r,i,a);case`pixels-or-map`:return typeof i==`number`&&Number.isFinite(i)?Math.trunc(i):lookup(n,r,i,a)}}function lookup(r,i,a,o){let s=r.map??{},c=s[String(a)];if(c!==void 0)return c;let l=r.refuses?.[String(a)];throw l===void 0?new e(o,`prop "${i}"`,n(t(a),Object.keys(s))):new e(o,`prop "${i}" = ${t(a)}`,l)}function assertOneTextAuthority(t,n,r,i){if(!(n.textSink===null\|\|i?.text!==!0)&&r[n.textSink]!==void 0)throw new e(t,`prop → "${n.textSink}"`,`is the same widget property a text CHILD writes, and both were given. Whichever the reconciler applied last would win, possibly differently on a first render and on an update — so it is refused. Keep one`)}const orientationOf=(e,t)=>e===`horizontal`\|\|e===`vertical`?e:t;export{declaresAbsolute,resolvePrimitive};

package/lib/esm/prop-table.js CHANGED Viewed

	@@ -1 +1 @@
1	- import"./_virtual/_rolldown/runtime.js";import{PrimitiveError as e,describeValue as t,primitiveErrorMessage as n}from"./primitives/errors.js";import{answerFor as r,isAccepted as i,propNamesOf as a,unknownPrimitiveDetail as o}from"./primitives/answers.js";import{FRAMEWORK_PROPS as s,PRIMITIVES as c,PRIMITIVE_NAMES as l}from"./primitives/table.js";const u=Object.fromEntries(Object.entries(c).filter(([,e])=>e.switchOn!==void 0).map(([e,t])=>[e,t.switchOn.prop]));function specFor(t,n){let r=c[t];if(r===void 0)throw new e(t,``,o(l));let i=r.switchOn;return i===void 0\|\|n===void 0\|\|n[i.prop]!==!0?r:i.whenTrue}function propAnswer(e,t,n){return r(e,specFor(e,n),t,s)}function acceptsProp(e,t,n){return i(propAnswer(e,t,n).status)}function explainProp(e,t,r){let a=propAnswer(e,t,r);return i(a.status)?null:n(e,`prop "${t}"`,a.why)}function propRefusedValues(e,t,n){return Object.keys(propAnswer(e,t,n).refuses).sort()}function acceptsPropValue(e,t,n,r){return explainPropValue(e,t,n,r)===null}function explainPropValue(e,r,a,o){let s=propAnswer(e,r,o);if(!i(s.status))return explainProp(e,r,o);let c=s.refuses[String(a)];return c===void 0?null:s.status===`accessible`?n(e,`prop "${r}"`,`carries "${String(a)}", which ${c}`):n(e,`prop "${r}" = ${t(a)}`,c)}function propNames(e,t){return a(specFor(e,t))}function propTable(e){return l.flatMap(t=>propNames(t,e).map(n=>propAnswer(t,n,e)))}export{l as PRIMITIVE_NAMES,u as PRIMITIVE_VARIANTS,acceptsProp,acceptsPropValue,explainProp,explainPropValue,propAnswer,propNames,propRefusedValues,propTable};
1	+ import"./_virtual/_rolldown/runtime.js";import{PrimitiveError as e,describeValue as t,primitiveErrorMessage as n,unknownAccessibleKeyDetail as r,unknownMappedValueDetail as i}from"./primitives/errors.js";import{answerFor as a,isAccepted as o,propNamesOf as s,unknownPrimitiveDetail as c}from"./primitives/answers.js";import{FRAMEWORK_PROPS as l,PRIMITIVES as u,PRIMITIVE_NAMES as d}from"./primitives/table.js";const f=Object.fromEntries(Object.entries(u).filter(([,e])=>e.switchOn!==void 0).map(([e,t])=>[e,t.switchOn.prop]));function specFor(t,n){let r=u[t];if(r===void 0)throw new e(t,``,c(d));let i=r.switchOn;return i===void 0\|\|n===void 0\|\|n[i.prop]!==!0?r:i.whenTrue}function propAnswer(e,t,n){return a(e,specFor(e,n),t,l)}function acceptsProp(e,t,n){return o(propAnswer(e,t,n).status)}function explainProp(e,t,r){let i=propAnswer(e,t,r);return o(i.status)?null:n(e,`prop "${t}"`,i.why)}function propRefusedValues(e,t,n){return Object.keys(propAnswer(e,t,n).refuses).sort()}function acceptsPropValue(e,t,n,r){return explainPropValue(e,t,n,r)===null}function vocabularyAccepts(e,t){return e.numbers&&typeof t==`number`&&Number.isFinite(t)?!0:e.values.includes(String(t))}function explainPropValue(e,a,s,c){let l=propAnswer(e,a,c);if(!o(l.status))return explainProp(e,a,c);let u=l.refuses[String(s)];return u===void 0?l.allows!==null&&!vocabularyAccepts(l.allows,s)?l.status===`accessible`?n(e,`prop "${a}"`,r(String(s),l.allows.values)):n(e,`prop "${a}"`,i(t(s),l.allows.values)):null:l.status===`accessible`?n(e,`prop "${a}"`,`carries "${String(s)}", which ${u}`):n(e,`prop "${a}" = ${t(s)}`,u)}function propAllowedValues(e,t,n){let r=propAnswer(e,t,n).allows;return r===null?null:[...r.values].sort()}function propNames(e,t){return s(specFor(e,t))}function propTable(e){return d.flatMap(t=>propNames(t,e).map(n=>propAnswer(t,n,e)))}export{d as PRIMITIVE_NAMES,f as PRIMITIVE_VARIANTS,acceptsProp,acceptsPropValue,explainProp,explainPropValue,propAllowedValues,propAnswer,propNames,propRefusedValues,propTable};

package/lib/types/press.d.ts CHANGED Viewed

@@ -23,5 +23,10 @@ export declare function onPressStateChange(widget: Gtk.Widget, listener: (presse
  * The controller is REMOVED and the handler disconnected, in that order: a controller
  * left on a widget outlives every JS reference to it, and its handler is then one of
  * the callbacks GJS blocks during GC.
+ *
+ * `GObject.signal_connect` rather than `gesture.connect`: `ResolvedGesture.signal` is a
+ * `string` that `components.ts` joins into one key and splits back out, so the name is
+ * DATA by the time it arrives here — and since `@girs` 5.0.0 `connect` takes only the
+ * names `Gtk.GestureClick` itself declares. Same connection, same id.
  */
 export declare function onGesture(widget: Gtk.Widget, signal: string, listener: () => void): () => void;

package/lib/types/primitives/accessibility.d.ts CHANGED Viewed

@@ -105,6 +105,13 @@ export interface AccessibilityProps {
  *
  * Throws nothing itself: it reports a bad value as a `problem` so the caller raises
  * the one `PrimitiveError` this layer raises, with the primitive's own name in it.
+ *
+ * A `problem` is the COMPLETE detail, `got …` included where a value is worth
+ * showing. The caller used to append `; got <the whole prop value>` to all of them,
+ * which printed `[object Object]` for every record-level refusal — the fact the
+ * message already named the key made the tail noise, and for a bad MEMBER it named
+ * the wrong thing entirely. It also made the key-level sentences unreproducible by
+ * `prop-table.ts`, which is handed the KEY and never the record (#1648, ADR 0039 § 1).
  */
 export declare function resolveAccessible(route: AccessibleRoute, prop: string, value: unknown): {
     entries: readonly ResolvedAccessible[];

package/lib/types/primitives/answers.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import type { PrimitiveSpec } from './table.js';
+import type { PrimitiveSpec, PropRoute } from './table.js';
 /**
  * What this layer does about a prop.
  *
@@ -62,6 +62,31 @@ export interface PropAnswer {
      * stay one string (ADR 0039 § 2).
      */
     readonly refuses: Readonly<Record<string, string>>;
+    /**
+     * The values this prop ACCEPTS by name, when the table enumerates them — the
+     * inverse grain of {@link refuses}, and `null` when there is no such list.
+     *
+     * THE TWO GRAINS ARE NOT THE SAME FACT, and reading only one is how #1648
+     * happened. `refuses` enumerates what is forbidden; a `map` enumerates what is
+     * allowed, and a value outside it is refused BY OMISSION. `pointerEvents` is
+     * `{ auto, none }` with no `refuses` at all, so the oracle answered ACCEPTED for
+     * `box-none` — a real React Native spelling that a render throws on — and a
+     * consumer deleted their own working mapping on the strength of it.
+     */
+    readonly allows: ValueVocabulary | null;
+}
+/**
+ * The values one route accepts by name, for the routes whose table row says.
+ *
+ * `numbers` is not a special case bolted on: `pixels-or-map` accepts a pixel COUNT
+ * beside its two named steps, and a vocabulary that could not say so would make
+ * `<ActivityIndicator size={24}>` read as refused.
+ */
+export interface ValueVocabulary {
+    /** Accepted spellings, in the table's own keys. Compared against `String(value)`. */
+    readonly values: readonly string[];
+    /** A finite number is accepted without appearing in {@link values}. */
+    readonly numbers: boolean;
 }
 /** Does this status let a render proceed? `ignored` counts — it is a declared no-op, not a refusal. */
 export declare const isAccepted: (status: PropStatus) => boolean;
@@ -69,6 +94,22 @@ export declare const isAccepted: (status: PropStatus) => boolean;
 export declare const unknownPropDetail: (spec: PrimitiveSpec) => string;
 /** The detail of the refusal an unknown PRIMITIVE gets. `resolve.ts` throws exactly this. */
 export declare const unknownPrimitiveDetail: (names: readonly string[]) => string;
+/**
+ * One route → the values it accepts by name, or `null` when it enumerates none.
+ *
+ * THE COMPLETENESS QUESTION, asked of every route kind in one place (#1648). A route
+ * that refuses a value by OMISSION from a list is invisible to {@link PropAnswer.refuses},
+ * and three kinds do it — a mapped property, an `announce` map, and an accessible
+ * record's member keys. Before this function each of them was a separate oversight
+ * waiting to be reported; now the switch has no `default`, so the next route kind
+ * cannot be added without answering the question for it.
+ *
+ * `file` is the deliberate `null` worth naming: its refusals ARE value-level
+ * (`http:` has no synchronous loader, a `require()` id has no asset registry) but
+ * they are computed from the value's shape rather than drawn from a list, so no
+ * vocabulary can express them and the oracle must not pretend otherwise.
+ */
+export declare function routeValueVocabulary(route: PropRoute): ValueVocabulary | null;
 /**
  * What `primitive` does about `prop`.
  *

package/lib/types/primitives/errors.d.ts CHANGED Viewed

@@ -6,7 +6,32 @@
  * Two template literals that happen to agree are not that: the format is here once and
  * both the throw and the static answer are built from it.
  */
-export declare const primitiveErrorMessage: (primitive: string, subject: string, detail: string) => string;
+export declare const primitiveErrorMessage: (primitive: string, subject: string, detail: string, where?: string) => string;
+/**
+ * Which element, as far as the author's own words can say it.
+ *
+ * A refusal names a PRIMITIVE, and an application has many elements per primitive: a
+ * consumer with twenty-five `<View className="flex-1 bg-canvas">` sites gets a message
+ * that identifies none of them, and the stack is this package's own frames
+ * (`usePlan`, `View`, `renderWithHooks`) with no component names in a bundle. Finding
+ * the element took patching the built `lib/` to print `props.className`, which is not
+ * a thing a consumer should have to do.
+ *
+ * TWO FIELDS, NOT A PROPS DUMP, and each is a deliberate choice. `className` is what
+ * the author wrote and is how they will search for it; `testID` is the other thing
+ * they chose the value of. `children` is a React tree, `style` can be a large object,
+ * and `nativeID` is refused by name (`primitives/table.ts`) so it can never be
+ * present.
+ *
+ * CAPPED, because a computed class list is ordinary authoring — 24 of the measured
+ * application's `className=` sites are arrays or joins — and a refusal that scrolls is
+ * a refusal nobody reads. An array is flattened the way `splitVariants` flattens one,
+ * so the message shows what the element resolved to rather than the expression.
+ */
+export declare const describeElement: (props: {
+    className?: string | readonly (string | false | null | undefined)[] | null;
+    testID?: unknown;
+}) => string;
 /**
  * How a VALUE reads inside a subject — `prop "accessibilityRole" = "keyboardkey"`.
  *
@@ -16,6 +41,29 @@ export declare const primitiveErrorMessage: (primitive: string, subject: string,
  * not one string.
  */
 export declare const describeValue: (value: unknown) => string;
+/**
+ * The refusal a value gets for being ABSENT from the list its route maps.
+ *
+ * ONE FORMATTER FOR THREE READERS, which is the whole point: `resolve.ts` throws it
+ * for a mapped property and for an `announce` route, and `prop-table.ts` returns it
+ * as the static answer. It was written out twice in `resolve.ts` and not at all in
+ * `prop-table.ts` — and the missing third copy is #1648, an oracle that answered
+ * ACCEPTED for `pointerEvents="box-none"` while the render threw this very sentence.
+ *
+ * `described` arrives already rendered rather than as the value, because the two
+ * modules that build this reach `describeValue` and the one that classifies routes
+ * may hold no relative value import (ADR 0039 § 2).
+ */
+export declare const unknownMappedValueDetail: (described: string, known: readonly string[]) => string;
+/**
+ * The refusal a KEY gets for not being a member of an accessible record.
+ *
+ * The same fact as {@link unknownMappedValueDetail} at the other grain the table has
+ * — `accessibilityState` enumerates its members rather than its values — so it is
+ * shared for the same reason: `accessibility.ts` decides it and `prop-table.ts` has
+ * to answer with it.
+ */
+export declare const unknownAccessibleKeyDetail: (key: string, known: readonly string[]) => string;
 /** A primitive, prop or combination this layer cannot answer for, and why. */
 export declare class PrimitiveError extends Error {
     readonly name = "PrimitiveError";
@@ -23,5 +71,13 @@ export declare class PrimitiveError extends Error {
     readonly primitive: string;
     /** The prop, utility or combination that caused it. Empty when it is the primitive itself. */
     readonly subject: string;
-    constructor(primitive: string, subject: string, detail: string);
+    /**
+     * The author's own handle on the element — `[className="…"]` — or empty.
+     *
+     * Optional, so every existing throw and `prop-table`'s static answers produce the
+     * same string they did before. ADR 0039 § 1 asks that the static answer and the
+     * thrown message be one string, and an optional argument is how both stay one.
+     */
+    readonly where: string;
+    constructor(primitive: string, subject: string, detail: string, where?: string);
 }

package/lib/types/primitives/errors.spec.d.ts ADDED Viewed

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

package/lib/types/prop-table.d.ts CHANGED Viewed

@@ -1,6 +1,6 @@
-import { type PropAnswer, type PropStatus } from './primitives/answers.js';
+import { type PropAnswer, type PropStatus, type ValueVocabulary } from './primitives/answers.js';
 import { PRIMITIVE_NAMES } from './primitives/table.js';
-export type { PropAnswer, PropStatus };
+export type { PropAnswer, PropStatus, ValueVocabulary };
 /**
  * Every primitive this layer answers for.
  *
@@ -68,11 +68,29 @@ export declare function acceptsPropValue(primitive: string, prop: string, value:
  * under Node type stripping is why) — so the formatter the throw uses lives in
  * `errors.ts` and both call it.
  *
- * A value merely ABSENT from a mapped prop's table is NOT answered here: that is the
- * "Known: …" a typo gets, it is built from the map at the moment of the throw, and this
- * surface is about the values the table refuses ON PURPOSE.
+ * TWO GRAINS OF REFUSAL, AND THE SECOND ONE WAS MISSING (#1648). A prop can refuse a
+ * value by NAME — `answer.refuses`, a deny-list with a reason per entry — and it can
+ * refuse one by OMISSION from the list its route maps: `pointerEvents` is
+ * `{ auto, none }`, `box-none` is a real React Native spelling with no GTK
+ * expression, and a render throws on it. Reading only the deny-list answered ACCEPTED
+ * for the second kind on every mapped property, every `announce` route and every
+ * accessible record — and a consumer deleted a working `box-none` mapping of their
+ * own because a green test said the layer had caught up.
+ *
+ * What is still NOT answered here is the TYPE grain: `coerce` refuses a non-boolean
+ * for `editable` and a non-function for `onPress`, and neither is a list this table
+ * can publish. `acceptsPropValue` is an oracle for the vocabulary, not for the type.
  */
 export declare function explainPropValue(primitive: string, prop: string, value: unknown, variant?: PropVariant): string | null;
+/**
+ * The values this prop accepts by name, or `null` when the table enumerates none.
+ *
+ * The reader for {@link PropAnswer.allows}, beside `propRefusedValues` because they
+ * are the two halves of one question and a consumer holding a ledger of "which props
+ * has the layer caught up on" needs both: a deny-list says which spellings have a
+ * reason, an allow-list says which ones exist at all.
+ */
+export declare function propAllowedValues(primitive: string, prop: string, variant?: PropVariant): readonly string[] | null;
 /** Every prop name this primitive's table row carries, sorted. Framework props are not among them. */
 export declare function propNames(primitive: string, variant?: PropVariant): readonly string[];
 /**

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/react-native",
-    "version": "0.49.0",
+    "version": "0.51.0",
     "description": "The React Native view vocabulary rendered onto GTK4/Adwaita, over @gjsify/gtk-host",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -120,8 +120,8 @@
         "react-native"
     ],
     "dependencies": {
-        "@gjsify/adwaita-app": "^0.49.0",
-        "@gjsify/gtk-host": "^0.49.0"
+        "@gjsify/adwaita-app": "^0.51.0",
+        "@gjsify/gtk-host": "^0.51.0"
     },
     "peerDependencies": {
         "@react-navigation/core": "^7.21.13",
@@ -148,13 +148,13 @@
         }
     },
     "devDependencies": {
-        "@girs/adw-1": "4.6.0",
-        "@girs/gdk-4.0": "4.6.0",
-        "@girs/gjs": "4.6.0",
-        "@girs/gtk-4.0": "4.6.0",
-        "@gjsify/cli": "^0.49.0",
-        "@gjsify/rolldown-plugin-gjsify": "^0.49.0",
-        "@gjsify/unit": "^0.49.0",
+        "@girs/adw-1": "5.0.0",
+        "@girs/gdk-4.0": "5.0.0",
+        "@girs/gjs": "5.0.0",
+        "@girs/gtk-4.0": "5.0.0",
+        "@gjsify/cli": "^0.51.0",
+        "@gjsify/rolldown-plugin-gjsify": "^0.51.0",
+        "@gjsify/unit": "^0.51.0",
         "@react-navigation/core": "^7.21.13",
         "@react-navigation/routers": "^7.6.4",
         "@types/node": "^25.9.2",