@texaryn/vue 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @texaryn/vue
+
+## 0.1.0
+
+### Minor Changes
+
+- f002477: First release of `@texaryn/vue`: Vue 3 bindings over the same core the React packages use.
+  
+  Composables (`useForm`, `useField`, `useFieldArray`, `useStore`), provide/inject context, `FormRoot` and `NodeRenderer`, and a default widget set matching the React registry's tests and ranks.
+  
+  Two things work differently from `@texaryn/react`, and both follow from `setup` running once where a hook re-runs per render. `useStore` accepts a store or a getter and watches it. `useField` and `useFieldArray` take the node id as a ref or getter, which is what keeps a field attached to its own array item across a move rather than to the position it left. `useForm` and `useStore` require an active scope, because each owns something only teardown releases.
+  
+  The whole example catalog runs through this package in the conformance matrix, and the playground renders it over the same `FormRuntime` instance the React shell owns.

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024-2026 Hamza Hamidi
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,91 @@
+# @texaryn/vue
+
+Vue 3 bindings for Texaryn: composables, provide/inject context, a renderer
+and a small set of native widgets.
+
+A `0.0.0` placeholder exists on npm to reserve the name. The first usable
+release will be `0.1.0`.
+
+```vue
+<script setup lang="ts">
+import { createJsonSchemaAdapter } from '@texaryn/schema-json'
+import { useForm, provideFormRuntime, createDefaultRegistry } from '@texaryn/vue'
+
+const schema = {
+  $schema: 'https://json-schema.org/draft/2020-12/schema',
+  type: 'object',
+  properties: { name: { type: 'string', title: 'Name' } },
+  required: ['name'],
+}
+
+const port = await createJsonSchemaAdapter(schema, {})
+const form = useForm(port, { initialData: { name: '' } })
+provideFormRuntime(form.runtime)
+
+const registry = createDefaultRegistry()
+</script>
+
+<template>
+  <!-- FormRoot has to be a descendant, not this component itself -->
+  <FormRoot :registry="registry" />
+</template>
+```
+
+`useForm` creates the runtime and ties it to the calling scope. Providing is a
+separate call rather than a side effect of construction: React's equivalent is
+`<FormProvider>` in the template, and Vue's is a setup call.
+
+A component cannot inject what it provided itself, so `FormRoot` and anything
+calling `useField` has to be a descendant of whichever component called
+`provideFormRuntime`.
+
+## Lifetime is a requirement, not a convention
+
+`useForm` and `useStore` throw when called outside `setup()` or an active
+`effectScope`. Both own something that only teardown releases, a runtime with
+live validation timers and a store subscription, and neither returns a handle
+the caller could stop. Requiring a scope is what makes that ownership real:
+the check runs before anything is created, so a misuse cannot leak the thing
+it was about to allocate. Stopping the scope destroys the runtime and
+unsubscribes.
+
+## What it does not depend on
+
+`@texaryn/core` and Vue. Not `@texaryn/react`. The point of a second binding is
+to find out what core actually promises, and reaching into the first binding
+for a helper would answer a different question.
+
+## Node ids are accepted as refs or getters, and that matters
+
+`useField` and `useFieldArray` take `MaybeRefOrGetter<NodeId>`, not `NodeId`.
+
+Node ids follow position in the document. Array item identity is carried
+separately as `StableItemId`, and a row keyed on that keeps its component
+instance through a move while the node underneath it becomes a different one.
+React re-reads the id on every render, so it follows for free. A Vue
+composable that captured the id in `setup` would keep reading the old position
+and keep writing to it, so typing into a moved row would overwrite the row
+that took its place.
+
+The same reasoning applies to reads. `getNodeState` is a map lookup with no
+reactivity of its own, and the runtime replaces a node's state bundle when its
+id leaves the document and returns. `useField` reads the document ref when it
+resolves the bundle so a recompile re-resolves it.
+
+Both are covered by tests that fail when the behaviour is removed.
+
+## Conformance
+
+`tests/example-conformance/vue.test.ts` runs the whole catalog through this
+package and makes the same two claims the React renderers make: every example
+mounts without a console error or warning, and every active node in every
+example resolves a widget. The framework-neutral half of that harness is
+shared; mounting is not, because the two frameworks do not share a mounting
+model.
+
+## No single file components
+
+The package ships plain TypeScript with render functions, so it builds with
+the same `tsc --build` as every other package in the workspace and needs no
+Vue-specific toolchain to compile. Consumers are free to use SFCs; nothing
+here requires them to.

package/dist/components/FormRoot.d.ts

@@ -0,0 +1,17 @@
+import type { PropType } from 'vue';
+import type { RendererRegistry } from '@texaryn/core';
+import type { WidgetComponent } from '../widget.js';
+export declare const FormRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    registry: {
+        type: PropType<RendererRegistry<WidgetComponent>>;
+        required: true;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    registry: {
+        type: PropType<RendererRegistry<WidgetComponent>>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//# sourceMappingURL=FormRoot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormRoot.d.ts","sourceRoot":"","sources":["../../src/components/FormRoot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGnD,eAAO,MAAM,QAAQ;;cAIC,QAAQ,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;;;;;;;cAA3C,QAAQ,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;;;iGAgB/D,CAAA"}

package/dist/components/FormRoot.js

@@ -0,0 +1,24 @@
+import { computed, defineComponent, h } from 'vue';
+import { provideRendererRegistry, useFormRuntime } from '../context.js';
+import { useStore } from '../use-store.js';
+import { NodeRenderer } from './NodeRenderer.js';
+export const FormRoot = defineComponent({
+    name: 'FormRoot',
+    props: {
+        registry: {
+            type: Object,
+            required: true,
+        },
+    },
+    setup(props) {
+        const runtime = useFormRuntime();
+        // Provided once here rather than at every node: inject walks the parent
+        // chain, so one provide reaches the whole tree. Passed as a getter so a
+        // changed prop re-resolves that tree instead of freezing it.
+        provideRendererRegistry(() => props.registry);
+        const document = useStore(runtime.document, runtime.document.getSnapshot());
+        const rootNode = computed(() => document.value.nodes[document.value.rootId]);
+        return () => (rootNode.value ? h(NodeRenderer, { node: rootNode.value }) : null);
+    },
+});
+//# sourceMappingURL=FormRoot.js.map

package/dist/components/FormRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRoot.js","sourceRoot":"","sources":["../../src/components/FormRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGlD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC;IACtC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,MAAqD;YAC3D,QAAQ,EAAE,IAAI;SACf;KACF;IACD,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,wEAAwE;QACxE,wEAAwE;QACxE,6DAA6D;QAC7D,uBAAuB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAE7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QAC3E,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QAE5E,OAAO,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAClF,CAAC;CACF,CAAC,CAAA"}

package/dist/components/NodeRenderer.d.ts

@@ -0,0 +1,22 @@
+import type { PropType } from 'vue';
+import type { UINode } from '@texaryn/core';
+/**
+ * Compiling a schema with `active: false` produces a node with
+ * `visible: false`. That is the source of truth for hiding a node, so it is
+ * read off the node rather than through useField, which would cost a
+ * subscription for a subtree that never renders.
+ */
+export declare const NodeRenderer: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    node: {
+        type: PropType<UINode>;
+        required: true;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    node: {
+        type: PropType<UINode>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//# sourceMappingURL=NodeRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeRenderer.d.ts","sourceRoot":"","sources":["../../src/components/NodeRenderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;cAGG,QAAQ,CAAC,MAAM,CAAC;;;;;;;cAAhB,QAAQ,CAAC,MAAM,CAAC;;;iGAW1C,CAAA"}

package/dist/components/NodeRenderer.js

@@ -0,0 +1,24 @@
+import { computed, defineComponent, h } from 'vue';
+import { useRendererRegistry } from '../context.js';
+/**
+ * Compiling a schema with `active: false` produces a node with
+ * `visible: false`. That is the source of truth for hiding a node, so it is
+ * read off the node rather than through useField, which would cost a
+ * subscription for a subtree that never renders.
+ */
+export const NodeRenderer = defineComponent({
+    name: 'NodeRenderer',
+    props: {
+        node: { type: Object, required: true },
+    },
+    setup(props) {
+        const registry = useRendererRegistry();
+        const widget = computed(() => registry.value.resolve(props.node));
+        return () => {
+            if (!props.node.visible || !widget.value)
+                return null;
+            return h(widget.value, { node: props.node });
+        };
+    },
+});
+//# sourceMappingURL=NodeRenderer.js.map

package/dist/components/NodeRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeRenderer.js","sourceRoot":"","sources":["../../src/components/NodeRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;IAC1C,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,MAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC3D;IACD,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAA;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAEjE,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAA;YACrD,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9C,CAAC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/context.d.ts

@@ -0,0 +1,29 @@
+import type { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue';
+import type { FormRuntime, RendererRegistry } from '@texaryn/core';
+import type { WidgetComponent } from './widget.js';
+export declare const FormRuntimeKey: InjectionKey<FormRuntime>;
+export declare const RendererRegistryKey: InjectionKey<ComputedRef<RendererRegistry<WidgetComponent>>>;
+export declare function provideFormRuntime(runtime: FormRuntime): void;
+export declare function useFormRuntime(): FormRuntime;
+/**
+ * The registry is provided as a computed rather than a value, so a caller
+ * that swaps renderers re-resolves the tree it already has.
+ *
+ * Providing the value itself would freeze the tree on whichever renderer was
+ * selected when it mounted. React gets this free by re-providing on every
+ * render; Vue provides once, so the reactivity has to be in what is provided.
+ * The playground switches renderer without remounting the form, because the
+ * runtime belongs to the example rather than to the presentation over it.
+ */
+export declare function provideRendererRegistry(registry: MaybeRefOrGetter<RendererRegistry<WidgetComponent>>): void;
+/**
+ * Provided once by FormRoot rather than per node.
+ *
+ * React re-provides it at every NodeRenderer because a context value has to
+ * sit above the component that reads it in the element tree it builds. Vue's
+ * inject walks the component parent chain, so one provide at the root reaches
+ * every widget however deeply nested, and repeating it per node would create
+ * an injection scope per node for no gain.
+ */
+export declare function useRendererRegistry(): ComputedRef<RendererRegistry<WidgetComponent>>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,WAAW,CAA6B,CAAA;AAClF,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CACjE,CAAA;AAE5B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE7D;AAED,wBAAgB,cAAc,IAAI,WAAW,CAM5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,GAC5D,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAMpF"}

package/dist/context.js

@@ -0,0 +1,43 @@
+import { computed, inject, provide, toValue } from 'vue';
+export const FormRuntimeKey = Symbol('texaryn.runtime');
+export const RendererRegistryKey = Symbol('texaryn.registry');
+export function provideFormRuntime(runtime) {
+    provide(FormRuntimeKey, runtime);
+}
+export function useFormRuntime() {
+    const runtime = inject(FormRuntimeKey, null);
+    if (!runtime) {
+        throw new Error('useFormRuntime must be used under a component that called provideFormRuntime');
+    }
+    return runtime;
+}
+/**
+ * The registry is provided as a computed rather than a value, so a caller
+ * that swaps renderers re-resolves the tree it already has.
+ *
+ * Providing the value itself would freeze the tree on whichever renderer was
+ * selected when it mounted. React gets this free by re-providing on every
+ * render; Vue provides once, so the reactivity has to be in what is provided.
+ * The playground switches renderer without remounting the form, because the
+ * runtime belongs to the example rather than to the presentation over it.
+ */
+export function provideRendererRegistry(registry) {
+    provide(RendererRegistryKey, computed(() => toValue(registry)));
+}
+/**
+ * Provided once by FormRoot rather than per node.
+ *
+ * React re-provides it at every NodeRenderer because a context value has to
+ * sit above the component that reads it in the element tree it builds. Vue's
+ * inject walks the component parent chain, so one provide at the root reaches
+ * every widget however deeply nested, and repeating it per node would create
+ * an injection scope per node for no gain.
+ */
+export function useRendererRegistry() {
+    const registry = inject(RendererRegistryKey, null);
+    if (!registry) {
+        throw new Error('useRendererRegistry must be used inside a FormRoot tree');
+    }
+    return registry;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAKxD,MAAM,CAAC,MAAM,cAAc,GAA8B,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAC9B,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAE5B,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;IACjG,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA6D;IAE7D,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/field-props.d.ts

@@ -0,0 +1,29 @@
+import type { FieldNode, ValidationError } from '@texaryn/core';
+/**
+ * The accessible attribute surface for a field, derived from the node and its
+ * current state.
+ *
+ * This is a deliberate reimplementation of `@texaryn/react`'s prop getters
+ * rather than an import of them: this package must not depend on the React
+ * binding, and the slice exists to find out what the two genuinely share.
+ * Nothing here is Vue specific, which makes it the first candidate for a
+ * framework-neutral home. That move waits for evidence from a second
+ * consumer, not from this file existing.
+ */
+export interface FieldAria {
+    id: string;
+    name: string;
+    disabled: boolean;
+    'aria-required': boolean;
+    'aria-invalid'?: boolean;
+    'aria-describedby'?: string;
+    placeholder?: string;
+}
+export declare function makeId(nodeId: string, suffix: string): string;
+export declare function fieldAria(node: FieldNode, state: {
+    disabled: boolean;
+    showErrors: boolean;
+    errors: readonly ValidationError[];
+}): FieldAria;
+export declare function fieldLabel(node: FieldNode): string;
+//# sourceMappingURL=field-props.d.ts.map

package/dist/field-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-props.d.ts","sourceRoot":"","sources":["../src/field-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,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;CACrB;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,GACpF,SAAS,CAoBX;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAElD"}

package/dist/field-props.js

@@ -0,0 +1,26 @@
+export function makeId(nodeId, suffix) {
+    return `texaryn-${nodeId}-${suffix}`;
+}
+export function fieldAria(node, state) {
+    const describedBy = [];
+    if (node.helpText ?? node.annotations?.description) {
+        describedBy.push(makeId(node.id, 'description'));
+    }
+    const invalid = state.showErrors && state.errors.length > 0;
+    if (invalid) {
+        describedBy.push(makeId(node.id, 'error'));
+    }
+    return {
+        id: makeId(node.id, 'input'),
+        name: node.dataPointer || node.id,
+        disabled: state.disabled,
+        'aria-required': Boolean(node.constraints?.required),
+        'aria-invalid': invalid ? true : undefined,
+        'aria-describedby': describedBy.length > 0 ? describedBy.join(' ') : undefined,
+        placeholder: node.placeholder ?? undefined,
+    };
+}
+export function fieldLabel(node) {
+    return node.annotations.title ?? node.dataPointer ?? node.id;
+}
+//# sourceMappingURL=field-props.js.map

package/dist/field-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-props.js","sourceRoot":"","sources":["../src/field-props.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,MAAc;IACnD,OAAO,WAAW,MAAM,IAAI,MAAM,EAAE,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAe,EACf,KAAqF;IAErF,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;QACpD,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC1C,kBAAkB,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9E,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;KAC3C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE,CAAA;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { useStore } from './use-store.js';
+export { useForm } from './use-form.js';
+export type { UseFormReturn } from './use-form.js';
+export { FormRuntimeKey, RendererRegistryKey, provideFormRuntime, provideRendererRegistry, useFormRuntime, useRendererRegistry, } from './context.js';
+export { useField } from './use-field.js';
+export type { UseFieldReturn } from './use-field.js';
+export { useFieldArray } from './use-field-array.js';
+export type { FieldArrayItem, UseFieldArrayReturn } from './use-field-array.js';
+export { useFieldWidget } from './use-field-widget.js';
+export type { FieldKind, FieldWidget } from './use-field-widget.js';
+export { fieldAria, fieldLabel, makeId } from './field-props.js';
+export type { FieldAria } from './field-props.js';
+export type { WidgetComponent } from './widget.js';
+export { FormRoot } from './components/FormRoot.js';
+export { NodeRenderer } from './components/NodeRenderer.js';
+export { FieldErrors } from './widgets/FieldErrors.js';
+export { Checkbox, NumberInput, Select, Textarea, TextInput } from './widgets/inputs.js';
+export { ArrayControl, ObjectLayout } from './widgets/containers.js';
+export { createDefaultRegistry } from './widgets/default-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACxF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { useStore } from './use-store.js';
+export { useForm } from './use-form.js';
+export { FormRuntimeKey, RendererRegistryKey, provideFormRuntime, provideRendererRegistry, useFormRuntime, useRendererRegistry, } from './context.js';
+export { useField } from './use-field.js';
+export { useFieldArray } from './use-field-array.js';
+export { useFieldWidget } from './use-field-widget.js';
+export { fieldAria, fieldLabel, makeId } from './field-props.js';
+export { FormRoot } from './components/FormRoot.js';
+export { NodeRenderer } from './components/NodeRenderer.js';
+export { FieldErrors } from './widgets/FieldErrors.js';
+export { Checkbox, NumberInput, Select, Textarea, TextInput } from './widgets/inputs.js';
+export { ArrayControl, ObjectLayout } from './widgets/containers.js';
+export { createDefaultRegistry } from './widgets/default-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAGvC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIhE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACxF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/use-field-array.d.ts

@@ -0,0 +1,20 @@
+import type { MaybeRefOrGetter, Ref } from 'vue';
+import type { NodeId, StableItemId } from '@texaryn/core';
+export interface FieldArrayItem {
+    /** Survives inserts, removes and moves. The key to render this row with. */
+    id: StableItemId;
+    /** Positional, so it changes under a row that moves. Undefined when the
+     * projection emitted no per-item child pointer. */
+    nodeId: NodeId | undefined;
+}
+export interface UseFieldArrayReturn {
+    items: Ref<FieldArrayItem[]>;
+    canAdd: Ref<boolean>;
+    canRemove: Ref<boolean>;
+    canReorder: Ref<boolean>;
+    add(value?: unknown): void;
+    remove(index: number): void;
+    move(from: number, to: number): void;
+}
+export declare function useFieldArray(nodeId: MaybeRefOrGetter<NodeId>): UseFieldArrayReturn;
+//# sourceMappingURL=use-field-array.d.ts.map

package/dist/use-field-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-array.d.ts","sourceRoot":"","sources":["../src/use-field-array.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAChD,OAAO,KAAK,EAAiB,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIxE,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,EAAE,EAAE,YAAY,CAAA;IAChB;uDACmD;IACnD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAA;IAC5B,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACpB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CACrC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAwCnF"}