@texaryn/react 0.2.4 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @texaryn/react
 
+## 0.4.0
+
+### Minor Changes
+
+- 04270e8: Give every array action control an accessible name that says which row it acts on.
+  
+  Five buttons all announced as "Remove" leave a screen reader user guessing. Each now carries the current 1-based position and whatever schema titles exist, so "Remove Contact 2 from Contacts", degrading to "Remove item 2" when nothing is titled. Reorder controls read "Move up Contact 2 in Contacts", and the per-array control reads "Add item to Contacts". The visible words stay "Remove", "Up" and "Add", with the longer string in `aria-label`, which contains the visible text so speech input still works.
+  
+  The row's own value is deliberately not used: it is mutable, often blank, frequently duplicated, and sometimes sensitive. The position is recomputed on every render rather than captured when a row is created, because a row survives a move while its position does not.
+  
+  The add control is named from the item template rather than from the first row, so an empty array still says "Add Tag" where naming it matters most. That needed the template's annotations, which the projection did not carry: `NodeProjection.itemAnnotations` is new and optional, so an adapter that cannot supply it stays valid, and `ArrayMeta.itemTitle` carries the result to renderers.
+  
+  React exposes the decision as `useArrayActions` so its three widget sets cannot drift, and the name builders are exported for custom widgets. Reorder-control parity is unchanged: the three React sets still expose no reorder button.
+- c9b930f: Show a required field's requirement to a sighted user, without announcing it twice.
+  
+  Required was conveyed only through `aria-required`, so a sighted user had nothing to tell a required field from an optional one. Every required label now carries a visible `(required)`.
+  
+  Three channels carry that one fact and are deliberately kept separate. The visible label reads "Full Name (required)". The accessible name stays exactly "Full Name", because the indicator is `aria-hidden` and `aria-required` already reports the state; putting it in the name as well makes some screen readers say it twice. WCAG's Label in Name allows exactly this omission when the state is surfaced programmatically.
+  
+  The indicator is the word rather than an asterisk, so nothing has to be explained elsewhere on the form. `field.label` and `fieldLabel()` still return the raw schema title: the decoration lives in the label rendering, so a visual convention does not become the canonical field title a custom widget sees. React exposes `FieldLabelContent` so its three widget sets cannot drift, and each binding exports `REQUIRED_INDICATOR` so a custom widget can match the wording.
+
+### Patch Changes
+
+- Updated dependencies [04270e8]
+  - @texaryn/core@0.7.0
+
+## 0.3.0
+
+### Minor Changes
+
+- 3545378: Expose a titled nested object as a named group in React and Vue, closing the last gap the DOM accessibility contract declared.
+  
+  A nested object rendered as a plain `div` gives no indication where one group of fields ends and the next begins. It is now a `fieldset` named by its `legend`, matching what `@texaryn/web-components` already did. The element is chosen once at mount and only the grouping semantics are re-derived, because a conditional subschema can add or drop a title on any recompile and swapping `div` for `fieldset` at that moment would remount the subtree and take the caret with it. An untitled nested object stays a `fieldset` but carries `role="none"`, since an unnamed group is noise in the accessibility tree.
+  
+  The decision is shared through a new `useObjectGroup` hook, so the three React widget sets cannot drift apart on it. The root object is still a plain container: it is the form itself, not a group inside one.
+- 3e53ca9: Keep each field's error container mounted as a live region instead of inserting it with the message already inside.
+  
+  A region that appears together with its content is not reliably announced, which is what every binding did: React and Vue rendered nothing until an error existed, and Web Components kept the node but hid it, which takes it out of the accessibility tree just the same. The container now exists from mount, stays empty while the field is valid, and only its contents change.
+  
+  It is `aria-live="polite" aria-atomic="true"` rather than `role="alert"`. This is a public semantic change: `ErrorProps` promised `role: 'alert'` and now carries the live-region attributes instead. Alert is assertive, and validation runs on change, blur and submit, so keeping it would have interrupted typing and spoken once per failing field on submit. `aria-describedby` stays conditional, pointing at the region only while it has something to say. `ErrorSummary` loses its `role="alert"` and keeps rendering conditionally, because the fields now announce their own errors and an aggregate region would repeat the same validation event.
+- 4a161b2: Give every rendering surface its own DOM id namespace, so two forms on one page no longer share ids or reference each other's elements.
+  
+  `FormProvider` becomes a real component rather than an alias for `FormContext.Provider`, and owns the namespace for everything under it, `ErrorSummary` included. Rendering through `FormContext.Provider` now throws, because the context alone carries no namespace. `makeId`, `getInputProps`, `getLabelProps`, `getErrorProps` and `getDescriptionProps` take the prefix explicitly; there is no unprefixed fallback, which would let a custom widget reintroduce the collision. `@texaryn/vue` takes the prefix from `provideFormRuntime` and now requires Vue 3.5 for `useId`. Generated ids are opaque relationship identifiers rather than styling hooks.
+- e7c00ce: Render a schema's `readOnly` as read-only rather than disabled, and enforce it in the runtime.
+  
+  A disabled control is not focusable and is announced differently; a read-only one stays focusable and selectable, which is what `readOnly` means. Compiled nodes now carry a resolved `readOnly` that a read-only object or array passes to everything beneath it, because editing a descendant changes the ancestor's value. The runtime refuses `SetValue`, `InsertItem`, `RemoveItem` and `MoveItem` on a read-only node, so a custom widget set cannot write past the restriction; `Reset` stays allowed as the owning authority replacing state. Renderers use the native `readonly` attribute where HTML has one and `aria-readonly` plus refusing the change where it does not, which is select and checkbox. `disabled` remains part of the node API, but the compiler no longer derives it from `readOnly`, so compiled nodes currently resolve it to false.
+
+### Patch Changes
+
+- Updated dependencies [e7c00ce]
+  - @texaryn/core@0.6.0
+
 ## 0.2.4
 
 ### Patch Changes

package/README.md

@@ -90,15 +90,25 @@ The runtime is destroyed automatically when the hook unmounts.
 
 ### `FormProvider`
 
-Provides a `FormRuntime` to renderer components and hooks:
+Provides a `FormRuntime` to renderer components and hooks, and owns the DOM id
+namespace for that rendering surface:
 
 ```tsx
 <FormProvider value={form.runtime}>
+  <ErrorSummary />
   <FormRoot registry={registry} />
 </FormProvider>
 ```
 
-`useFormContext()` returns the current runtime.
+`useFormContext()` returns the current runtime and `useFormIdPrefix()` returns
+the namespace. Rendering through `FormContext.Provider` instead throws: the
+context alone carries no namespace, which is what let two forms on one page
+share ids.
+
+Generated ids are opaque relationship identifiers rather than styling hooks.
+Their shape is not part of the public contract; use classes or data attributes
+for CSS. Uniqueness is per React application, so two independent roots on one
+page need distinct `identifierPrefix` options.
 
 ### `FormRoot`
 
@@ -257,6 +267,13 @@ The schema adapter interprets data semantics. The core compiles and runs the for
 - `useFieldArray`
 - `UseFieldArrayReturn`
 - `useFieldBinding`
+- `useObjectGroup`
+- `useArrayActions`
+- `ArrayActions`
+- `removeActionName`
+- `moveUpActionName`
+- `addActionName`
+- `ObjectGroup`
 - `FieldBinding`
 - `DomValueInputProps`
 - `DomCheckedInputProps`
@@ -267,6 +284,8 @@ The schema adapter interprets data semantics. The core compiles and runs the for
 
 - `FormContext`
 - `FormProvider`
+- `FormProviderProps`
+- `useFormIdPrefix`
 - `FormRoot`
 - `FormRootProps`
 - `NodeRenderer`
@@ -278,6 +297,9 @@ The schema adapter interprets data semantics. The core compiles and runs the for
 ### Error display
 
 - `FieldErrors`
+- `FieldLabelContent`
+- `FieldLabelContentProps`
+- `REQUIRED_INDICATOR`
 - `FieldErrorsProps`
 - `ErrorSummary`
 

package/dist/components/ErrorSummary.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Deliberately not a live region. The fields already announce their own
+ * errors, so an aggregate one would speak the same validation event twice.
+ * What this needs instead is to become a focus destination after a failed
+ * submit, which is separate work.
+ */
 export declare function ErrorSummary(): import("react").JSX.Element | null;
 //# sourceMappingURL=ErrorSummary.d.ts.map

package/dist/components/ErrorSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorSummary.d.ts","sourceRoot":"","sources":["../../src/components/ErrorSummary.tsx"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,uCAuB3B"}
+{"version":3,"file":"ErrorSummary.d.ts","sourceRoot":"","sources":["../../src/components/ErrorSummary.tsx"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,YAAY,uCAwB3B"}

package/dist/components/ErrorSummary.js

@@ -1,13 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useFormContext } from '../context.js';
 import { useStore } from '../hooks/use-store.js';
+import { useFormIdPrefix } from '../id-prefix.js';
 import { makeId } from '../props/field-props.js';
+/**
+ * Deliberately not a live region. The fields already announce their own
+ * errors, so an aggregate one would speak the same validation event twice.
+ * What this needs instead is to become a focus destination after a failed
+ * submit, which is separate work.
+ */
 export function ErrorSummary() {
     const runtime = useFormContext();
+    const idPrefix = useFormIdPrefix();
     const visibleErrors = useStore(runtime.visibleErrors);
     if (visibleErrors.length === 0) {
         return null;
     }
-    return (_jsx("div", { role: "alert", children: _jsx("ul", { children: visibleErrors.map((entry) => (_jsxs("li", { children: [_jsx("a", { href: `#${makeId(entry.nodeId, 'input')}`, children: entry.fieldTitle ?? entry.pointer ?? entry.nodeId }), ': ', entry.errors.map((error) => error.message ?? error.keyword).join(', ')] }, entry.nodeId))) }) }));
+    return (_jsx("div", { children: _jsx("ul", { children: visibleErrors.map((entry) => (_jsxs("li", { children: [_jsx("a", { href: `#${makeId(idPrefix, entry.nodeId, 'input')}`, children: entry.fieldTitle ?? entry.pointer ?? entry.nodeId }), ': ', entry.errors.map((error) => error.message ?? error.keyword).join(', ')] }, entry.nodeId))) }) }));
 }
 //# sourceMappingURL=ErrorSummary.js.map

package/dist/components/ErrorSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorSummary.js","sourceRoot":"","sources":["../../src/components/ErrorSummary.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;IAChC,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAErD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,CACL,cAAK,IAAI,EAAC,OAAO,YACf,uBACG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAmB,EAAE,EAAE,CAAC,CAC1C,yBACE,YAAG,IAAI,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YACzC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAChD,EACH,IAAI,EACJ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KALhE,KAAK,CAAC,MAAM,CAMhB,CACN,CAAC,GACC,GACD,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"ErrorSummary.js","sourceRoot":"","sources":["../../src/components/ErrorSummary.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;IAChC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;IAClC,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAErD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,CACL,wBACE,uBACG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAmB,EAAE,EAAE,CAAC,CAC1C,yBACE,YAAG,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YACnD,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAChD,EACH,IAAI,EACJ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KALhE,KAAK,CAAC,MAAM,CAMhB,CACN,CAAC,GACC,GACD,CACP,CAAA;AACH,CAAC"}

package/dist/components/FieldErrors.d.ts

@@ -4,5 +4,10 @@ export interface FieldErrorsProps {
     errors: readonly ValidationError[];
     showErrors: boolean;
 }
-export declare function FieldErrors({ node, errors, showErrors }: FieldErrorsProps): import("react").JSX.Element | null;
+/**
+ * Always rendered, and empty while there is nothing to say. Returning null
+ * until an error exists meant the region arrived already populated, which is
+ * the case screen readers do not reliably announce.
+ */
+export declare function FieldErrors({ node, errors, showErrors }: FieldErrorsProps): import("react").JSX.Element;
 //# sourceMappingURL=FieldErrors.d.ts.map

package/dist/components/FieldErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldErrors.d.ts","sourceRoot":"","sources":["../../src/components/FieldErrors.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,gBAAgB,sCAczE"}
+{"version":3,"file":"FieldErrors.d.ts","sourceRoot":"","sources":["../../src/components/FieldErrors.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAI/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,gBAAgB,+BAWzE"}

package/dist/components/FieldErrors.js

@@ -1,10 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { getErrorProps } from '../props/index.js';
+import { useFormIdPrefix } from '../id-prefix.js';
+/**
+ * Always rendered, and empty while there is nothing to say. Returning null
+ * until an error exists meant the region arrived already populated, which is
+ * the case screen readers do not reliably announce.
+ */
 export function FieldErrors({ node, errors, showErrors }) {
-    if (!showErrors || errors.length === 0) {
-        return null;
-    }
-    const errorProps = getErrorProps(node);
-    return (_jsx("div", { ...errorProps, children: errors.map((error, index) => (_jsx("div", { children: error.message ?? error.keyword }, index))) }));
+    const idPrefix = useFormIdPrefix();
+    const visible = showErrors ? errors : [];
+    return (_jsx("div", { ...getErrorProps(node, idPrefix), children: visible.map((error, index) => (_jsx("div", { children: error.message ?? error.keyword }, index))) }));
 }
 //# sourceMappingURL=FieldErrors.js.map

package/dist/components/FieldErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldErrors.js","sourceRoot":"","sources":["../../src/components/FieldErrors.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAQjD,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAoB;IACxE,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAEtC,OAAO,CACL,iBAAS,UAAU,YAChB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC5B,wBAAkB,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAtC,KAAK,CAAwC,CACxD,CAAC,GACE,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"FieldErrors.js","sourceRoot":"","sources":["../../src/components/FieldErrors.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAQjD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAoB;IACxE,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAExC,OAAO,CACL,iBAAS,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,YACnC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAC7B,wBAAkB,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAtC,KAAK,CAAwC,CACxD,CAAC,GACE,CACP,CAAA;AACH,CAAC"}

package/dist/components/FieldLabelContent.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+/** The wording every binding uses, so a custom widget can match it. */
+export declare const REQUIRED_INDICATOR = "(required)";
+export interface FieldLabelContentProps {
+    label: string;
+    required: boolean;
+}
+/**
+ * Label content for a field: the schema's label, plus a visible required
+ * indicator that is kept out of the accessible name.
+ *
+ * Three separate channels carry one fact, and they must not be collapsed. The
+ * sighted user reads "(required)". The accessible name stays the label alone,
+ * because `aria-required` already reports the state and putting it in the name
+ * as well makes some screen readers say it twice. The indicator says the word
+ * rather than an asterisk, so nobody has to be told elsewhere what a marker
+ * means.
+ *
+ * Shared by the three React widget sets so they cannot drift on it.
+ */
+export declare function FieldLabelContent({ label, required }: FieldLabelContentProps): React.JSX.Element;
+//# sourceMappingURL=FieldLabelContent.d.ts.map

package/dist/components/FieldLabelContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLabelContent.d.ts","sourceRoot":"","sources":["../../src/components/FieldLabelContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,eAAe,CAAA;AAE9C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,qBAO5E"}

package/dist/components/FieldLabelContent.js

@@ -0,0 +1,21 @@
+import { jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React from 'react';
+/** The wording every binding uses, so a custom widget can match it. */
+export const REQUIRED_INDICATOR = '(required)';
+/**
+ * Label content for a field: the schema's label, plus a visible required
+ * indicator that is kept out of the accessible name.
+ *
+ * Three separate channels carry one fact, and they must not be collapsed. The
+ * sighted user reads "(required)". The accessible name stays the label alone,
+ * because `aria-required` already reports the state and putting it in the name
+ * as well makes some screen readers say it twice. The indicator says the word
+ * rather than an asterisk, so nobody has to be told elsewhere what a marker
+ * means.
+ *
+ * Shared by the three React widget sets so they cannot drift on it.
+ */
+export function FieldLabelContent({ label, required }) {
+    return (_jsxs(_Fragment, { children: [label, required ? _jsxs("span", { "aria-hidden": "true", children: [" ", REQUIRED_INDICATOR] }) : null] }));
+}
+//# sourceMappingURL=FieldLabelContent.js.map

package/dist/components/FieldLabelContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLabelContent.js","sourceRoot":"","sources":["../../src/components/FieldLabelContent.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAO9C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA0B;IAC3E,OAAO,CACL,8BACG,KAAK,EACL,QAAQ,CAAC,CAAC,CAAC,+BAAkB,MAAM,kBAAG,kBAAkB,IAAQ,CAAC,CAAC,CAAC,IAAI,IACvE,CACJ,CAAA;AACH,CAAC"}

package/dist/context.d.ts

@@ -1,5 +1,19 @@
+import type { ReactNode } from 'react';
 import type { FormRuntime } from '@texaryn/core';
 export declare const FormContext: import("react").Context<FormRuntime | null>;
-export declare const FormProvider: import("react").Provider<FormRuntime | null>;
+export interface FormProviderProps {
+    value: FormRuntime | null;
+    children?: ReactNode;
+}
+/**
+ * The rendering surface, and therefore the DOM namespace, for one form.
+ *
+ * The prefix is owned here rather than by useForm because one runtime can
+ * legitimately be rendered twice; a prefix taken from the runtime would give
+ * both surfaces the same ids. It is provided above the children so that
+ * siblings of FormRoot, ErrorSummary in particular, resolve the same namespace
+ * the fields do.
+ */
+export declare function FormProvider({ value, children }: FormProviderProps): import("react").JSX.Element;
 export declare function useFormContext(): FormRuntime;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,eAAO,MAAM,WAAW,6CAA0C,CAAA;AAElE,eAAO,MAAM,YAAY,8CAAuB,CAAA;AAEhD,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,eAAO,MAAM,WAAW,6CAA0C,CAAA;AAElE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAOlE;AAED,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}

package/dist/context.js

@@ -1,6 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from 'react';
+import { IdPrefixProvider, useGeneratedIdPrefix } from './id-prefix.js';
 export const FormContext = createContext(null);
-export const FormProvider = FormContext.Provider;
+/**
+ * The rendering surface, and therefore the DOM namespace, for one form.
+ *
+ * The prefix is owned here rather than by useForm because one runtime can
+ * legitimately be rendered twice; a prefix taken from the runtime would give
+ * both surfaces the same ids. It is provided above the children so that
+ * siblings of FormRoot, ErrorSummary in particular, resolve the same namespace
+ * the fields do.
+ */
+export function FormProvider({ value, children }) {
+    const idPrefix = useGeneratedIdPrefix();
+    return (_jsx(FormContext.Provider, { value: value, children: _jsx(IdPrefixProvider, { value: idPrefix, children: children }) }));
+}
 export function useFormContext() {
     const runtime = useContext(FormContext);
     if (!runtime) {

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGjD,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAElE,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAA;AAEhD,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAOlE;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAqB;IACjE,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAA;IACvC,OAAO,CACL,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChC,KAAC,gBAAgB,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAAoB,GAC3C,CACxB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/hooks/use-array-actions.d.ts

@@ -0,0 +1,15 @@
+import type { UINode } from '@texaryn/core';
+export interface ArrayActions {
+    /** Accessible name for the control that removes the row at this position. */
+    removeName(position: number, item: UINode | undefined): string;
+    /** Accessible name for the control that appends a row. */
+    addName: string;
+}
+/**
+ * Shared by the three React widget sets so their action names cannot drift.
+ * The array title is read from the document rather than the node prop: these
+ * widgets are memoized on node id, so a conditional annotation added by a
+ * recompile would otherwise never reach the name.
+ */
+export declare function useArrayActions(node: UINode): ArrayActions;
+//# sourceMappingURL=use-array-actions.d.ts.map

package/dist/hooks/use-array-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-array-actions.d.ts","sourceRoot":"","sources":["../../src/hooks/use-array-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAA;AAI1D,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9D,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAW1D"}

package/dist/hooks/use-array-actions.js

@@ -0,0 +1,21 @@
+import { useRendererContext } from '../components/renderer-context.js';
+import { addActionName, removeActionName } from '../props/action-names.js';
+/**
+ * Shared by the three React widget sets so their action names cannot drift.
+ * The array title is read from the document rather than the node prop: these
+ * widgets are memoized on node id, so a conditional annotation added by a
+ * recompile would otherwise never reach the name.
+ */
+export function useArrayActions(node) {
+    const { document } = useRendererContext();
+    const current = (document.nodes[node.id] ?? node);
+    const arrayTitle = current.annotations.title;
+    return {
+        removeName: (position, item) => removeActionName(position, item?.annotations.title, arrayTitle),
+        // The item template's title, not the first row's. A row may not exist yet,
+        // which is exactly when naming the add control matters most, and a row's
+        // annotations can in principle depend on its data.
+        addName: addActionName(current.arrayMeta?.itemTitle, arrayTitle),
+    };
+}
+//# sourceMappingURL=use-array-actions.js.map

package/dist/hooks/use-array-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-array-actions.js","sourceRoot":"","sources":["../../src/hooks/use-array-actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAS1E;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAA;IACzC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAkB,CAAA;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAA;IAC5C,OAAO;QACL,UAAU,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC;QAC/F,2EAA2E;QAC3E,yEAAyE;QACzE,mDAAmD;QACnD,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;KACjE,CAAA;AACH,CAAC"}

package/dist/hooks/use-field-binding.d.ts

@@ -4,6 +4,12 @@ export interface DomInputBaseProps {
     id: string;
     name: string;
     disabled: boolean;
+    /**
+     * Set only where HTML has no native `readonly`, which is every control but
+     * text, number and textarea. Those carry the native attribute instead, on
+     * the value surface below.
+     */
+    'aria-readonly'?: true;
     'aria-required': boolean;
     'aria-invalid'?: boolean;
     'aria-describedby'?: string;
@@ -13,6 +19,7 @@ export interface DomInputBaseProps {
 /** Value-shaped surface for text, number, textarea and select controls. */
 export interface DomValueInputProps extends DomInputBaseProps {
     value: string | number;
+    readOnly?: boolean;
     onChange(event: {
         target: {
             value: string;
@@ -36,6 +43,7 @@ export interface FieldBinding {
     touched: boolean;
     dirty: boolean;
     disabled: boolean;
+    readOnly: boolean;
     visible: boolean;
     /** Derived from the node for adapters. `aria-required` stays owned by getInputProps. */
     required: boolean;

package/dist/hooks/use-field-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-binding.d.ts","sourceRoot":"","sources":["../../src/hooks/use-field-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAQ/D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CACxD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IAEf,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;IAEd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAA;IAEjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAE/B,yEAAyE;IACzE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,OAAO,EAAE,OAAO,CAAA;IAEhB,UAAU,EAAE,UAAU,CAAA;IACtB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,kBAAkB,CAAA;IACjC,gBAAgB,EAAE,oBAAoB,CAAA;CACvC;AA6BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAuD7D"}
+{"version":3,"file":"use-field-binding.d.ts","sourceRoot":"","sources":["../../src/hooks/use-field-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAU/D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,IAAI,CAAA;IACtB,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CACxD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IAEf,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;IAEd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAA;IAEjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAE/B,yEAAyE;IACzE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,OAAO,EAAE,OAAO,CAAA;IAEhB,UAAU,EAAE,UAAU,CAAA;IACtB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,kBAAkB,CAAA;IACjC,gBAAgB,EAAE,oBAAoB,CAAA;CACvC;AA6BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAwE7D"}

package/dist/hooks/use-field-binding.js

@@ -1,5 +1,6 @@
 import { useField } from './use-field.js';
-import { getInputProps, getLabelProps, getErrorProps, getDescriptionProps, } from '../props/field-props.js';
+import { useFormIdPrefix } from '../id-prefix.js';
+import { getInputProps, getLabelProps, getErrorProps, getDescriptionProps, hasNativeReadOnly, } from '../props/field-props.js';
 const NO_ERRORS = Object.freeze([]);
 // Mirrors createDefaultRegistry: enum outranks the primitive kind.
 function fieldKind(node) {
@@ -29,7 +30,8 @@ function coerce(kind, node, raw) {
 }
 export function useFieldBinding(node) {
     const field = useField(node.id);
-    const input = getInputProps(node, field);
+    const idPrefix = useFormIdPrefix();
+    const input = getInputProps(node, field, idPrefix);
     const kind = fieldKind(node);
     const base = {
         id: input.id,
@@ -41,15 +43,33 @@ export function useFieldBinding(node) {
         placeholder: input.placeholder,
         onBlur: input.onBlur,
     };
+    // Select and checkbox have no native readonly, so they say so through ARIA
+    // and drop the change. Text-like controls keep the native attribute, which
+    // the browser enforces before an event is ever raised.
+    const valueReadOnly = node.readOnly
+        ? hasNativeReadOnly(node)
+            ? { readOnly: true }
+            : { 'aria-readonly': true }
+        : {};
     const domInputProps = {
         ...base,
+        ...valueReadOnly,
         value: displayValue(kind, field.value),
-        onChange: (event) => field.onChange(coerce(kind, node, event.target.value)),
+        onChange: (event) => {
+            if (node.readOnly)
+                return;
+            field.onChange(coerce(kind, node, event.target.value));
+        },
     };
     const domCheckboxProps = {
         ...base,
         checked: Boolean(field.value),
-        onChange: (event) => field.onChange(event.target.checked),
+        ...(node.readOnly ? { 'aria-readonly': true } : {}),
+        onChange: (event) => {
+            if (node.readOnly)
+                return;
+            field.onChange(event.target.checked);
+        },
     };
     const errors = field.showErrors ? field.errors : NO_ERRORS;
     const first = errors[0];
@@ -61,6 +81,7 @@ export function useFieldBinding(node) {
         touched: field.touched,
         dirty: field.dirty,
         disabled: field.disabled,
+        readOnly: node.readOnly,
         visible: field.visible,
         required: Boolean(node.constraints.required),
         label: node.annotations.title ?? node.dataPointer ?? node.id,
@@ -69,9 +90,9 @@ export function useFieldBinding(node) {
         errors,
         error: first ? first.message ?? first.keyword : undefined,
         invalid: errors.length > 0,
-        labelProps: getLabelProps(node),
-        descriptionProps: getDescriptionProps(node),
-        errorProps: getErrorProps(node),
+        labelProps: getLabelProps(node, idPrefix),
+        descriptionProps: getDescriptionProps(node, idPrefix),
+        errorProps: getErrorProps(node, idPrefix),
         domInputProps,
         domCheckboxProps,
     };

package/dist/hooks/use-field-binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-binding.js","sourceRoot":"","sources":["../../src/hooks/use-field-binding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-field-binding.js","sourceRoot":"","sources":["../../src/hooks/use-field-binding.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-object-group.d.ts

@@ -0,0 +1,22 @@
+import type { UINode } from '@texaryn/core';
+export interface ObjectGroup {
+    /**
+     * Fixed for the widget's lifetime. The root object is the form itself, so
+     * only a nested object is a candidate for being a named group.
+     */
+    nested: boolean;
+    /**
+     * Live, because a conditional subschema can add or drop a title on any
+     * recompile while this widget survives. Undefined means the group has no
+     * name, and an unnamed group is noise.
+     */
+    title: string | undefined;
+    children: UINode[];
+}
+/**
+ * The grouping decision, shared by every React widget set so the three cannot
+ * drift apart. The node comes from the document rather than the prop, because
+ * a memo bailout on an unchanged id would otherwise freeze the title.
+ */
+export declare function useObjectGroup(node: UINode): ObjectGroup;
+//# sourceMappingURL=use-object-group.d.ts.map

package/dist/hooks/use-object-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-object-group.d.ts","sourceRoot":"","sources":["../../src/hooks/use-object-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAA;AAG1D,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAUxD"}

package/dist/hooks/use-object-group.js

@@ -0,0 +1,18 @@
+import { useRendererContext } from '../components/renderer-context.js';
+/**
+ * The grouping decision, shared by every React widget set so the three cannot
+ * drift apart. The node comes from the document rather than the prop, because
+ * a memo bailout on an unchanged id would otherwise freeze the title.
+ */
+export function useObjectGroup(node) {
+    const { document } = useRendererContext();
+    const current = (document.nodes[node.id] ?? node);
+    return {
+        nested: node.parentId !== null,
+        title: current.annotations.title,
+        children: current.children
+            .map((id) => document.nodes[id])
+            .filter((child) => child != null),
+    };
+}
+//# sourceMappingURL=use-object-group.js.map

package/dist/hooks/use-object-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-object-group.js","sourceRoot":"","sources":["../../src/hooks/use-object-group.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAiBtE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAA;IACzC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAkB,CAAA;IAClE,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI;QAC9B,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;aACvB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aAC/B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;KACrD,CAAA;AACH,CAAC"}

package/dist/id-prefix.d.ts

@@ -0,0 +1,10 @@
+export declare const IdPrefixProvider: import("react").Provider<string | null>;
+export declare function useGeneratedIdPrefix(): string;
+/**
+ * The DOM namespace of one rendering surface.
+ *
+ * Uniqueness is per React application, not per page: two independent roots
+ * need distinct `identifierPrefix` options to stay disjoint.
+ */
+export declare function useFormIdPrefix(): string;
+//# sourceMappingURL=id-prefix.d.ts.map

package/dist/id-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-prefix.d.ts","sourceRoot":"","sources":["../src/id-prefix.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,yCAA2B,CAAA;AAaxD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CASxC"}

package/dist/id-prefix.js

@@ -0,0 +1,31 @@
+import { createContext, useContext, useId } from 'react';
+const IdPrefixContext = createContext(null);
+export const IdPrefixProvider = IdPrefixContext.Provider;
+/**
+ * React's useId output format is not part of its contract, and React 18 emits
+ * colons, which are legal in an id but must be escaped before they reach
+ * querySelector or a stylesheet. Encoding each code point to base 36 keeps the
+ * seed injective and server/client deterministic while restricting it to
+ * characters that need no escaping, so a generated id stays usable as written.
+ */
+function encodeSeed(seed) {
+    return Array.from(seed, (char) => char.codePointAt(0).toString(36)).join('_');
+}
+export function useGeneratedIdPrefix() {
+    return `texaryn-${encodeSeed(useId())}`;
+}
+/**
+ * The DOM namespace of one rendering surface.
+ *
+ * Uniqueness is per React application, not per page: two independent roots
+ * need distinct `identifierPrefix` options to stay disjoint.
+ */
+export function useFormIdPrefix() {
+    const prefix = useContext(IdPrefixContext);
+    if (!prefix) {
+        throw new Error('No id prefix in scope. Render the form under <FormProvider value={runtime}>; ' +
+            'FormContext.Provider alone cannot namespace ids, which is what makes two forms collide.');
+    }
+    return prefix;
+}
+//# sourceMappingURL=id-prefix.js.map

package/dist/id-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-prefix.js","sourceRoot":"","sources":["../src/id-prefix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAExD,MAAM,eAAe,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAA;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAA;AAExD;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,WAAW,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAA;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC7E,yFAAyF,CAC5F,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}