@vhyxseal/react 0.1.0

package/dist/components/Button/index.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Props for the Button component.
+ * Extends all standard HTML button attributes.
+ */
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+    children: React.ReactNode;
+}
+/**
+ * Headless action button with optional VhyxSeal contract registration.
+ * Renders a native <button> element. All standard HTML button attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const orderContract = defineContract({ id: 'place-order-btn', intent: 'place-order', ... });
+ * <Button contract={orderContract} onClick={handleOrder}>Place Order</Button>
+ */
+export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Button/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,uFASlB,CAAC"}

package/dist/components/Button/index.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless action button with optional VhyxSeal contract registration.
+ * Renders a native <button> element. All standard HTML button attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const orderContract = defineContract({ id: 'place-order-btn', intent: 'place-order', ... });
+ * <Button contract={orderContract} onClick={handleOrder}>Place Order</Button>
+ */
+export const Button = React.forwardRef(function Button({ contract, children, ...rest }, ref) {
+    useContractRegistration(contract);
+    return (_jsx("button", { ref: ref, ...rest, children: children }));
+});
+Button.displayName = "Button";
+//# sourceMappingURL=index.js.map

package/dist/components/Button/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Button/index.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAa/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CACpC,SAAS,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IAClD,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CACL,iBAAQ,GAAG,EAAE,GAAG,KAAM,IAAI,YACvB,QAAQ,GACF,CACV,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC"}

package/dist/components/Confirmation/index.d.ts

@@ -0,0 +1,55 @@
+import { type ReactNode } from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * State and handlers exposed to the Confirmation render prop.
+ */
+export interface ConfirmationState {
+    /** True once the user has confirmed the action. */
+    confirmed: boolean;
+    /** True while the confirmation UI is being presented to the user. */
+    isPending: boolean;
+    /** Request confirmation — transitions to pending state. */
+    requestConfirmation: () => void;
+    /** User confirmed — sets confirmed true and clears pending. */
+    confirm: () => void;
+    /** User cancelled — clears pending, leaves confirmed unchanged. */
+    cancel: () => void;
+    /** Reset to initial state (confirmed false, isPending false). */
+    reset: () => void;
+}
+/**
+ * Props for the Confirmation component.
+ */
+export interface ConfirmationProps {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+    /**
+     * Render prop. Receives the current confirmation state and handlers.
+     * The component renders nothing itself — the caller provides the UI.
+     */
+    children: (state: ConfirmationState) => ReactNode;
+}
+/**
+ * Headless confirmation gate component with optional VhyxSeal contract registration.
+ * Manages confirmation lifecycle state and exposes it via render prop.
+ * The component renders no DOM elements of its own — developers bring their own UI.
+ * Does not require a SealProvider.
+ *
+ * @example
+ * <Confirmation contract={deleteContract}>
+ *   {({ confirmed, isPending, requestConfirmation, confirm, cancel }) => (
+ *     <>
+ *       <button onClick={requestConfirmation}>Delete</button>
+ *       {isPending && (
+ *         <dialog open>
+ *           <p>Are you sure?</p>
+ *           <button onClick={confirm}>Yes</button>
+ *           <button onClick={cancel}>No</button>
+ *         </dialog>
+ *       )}
+ *     </>
+ *   )}
+ * </Confirmation>
+ */
+export declare function Confirmation({ contract, children, }: ConfirmationProps): ReactNode;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Confirmation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Confirmation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,SAAS,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,GACT,EAAE,iBAAiB,GAAG,SAAS,CAgC/B"}

package/dist/components/Confirmation/index.js

@@ -0,0 +1,52 @@
+import { useState, useCallback } from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless confirmation gate component with optional VhyxSeal contract registration.
+ * Manages confirmation lifecycle state and exposes it via render prop.
+ * The component renders no DOM elements of its own — developers bring their own UI.
+ * Does not require a SealProvider.
+ *
+ * @example
+ * <Confirmation contract={deleteContract}>
+ *   {({ confirmed, isPending, requestConfirmation, confirm, cancel }) => (
+ *     <>
+ *       <button onClick={requestConfirmation}>Delete</button>
+ *       {isPending && (
+ *         <dialog open>
+ *           <p>Are you sure?</p>
+ *           <button onClick={confirm}>Yes</button>
+ *           <button onClick={cancel}>No</button>
+ *         </dialog>
+ *       )}
+ *     </>
+ *   )}
+ * </Confirmation>
+ */
+export function Confirmation({ contract, children, }) {
+    useContractRegistration(contract);
+    const [confirmed, setConfirmed] = useState(false);
+    const [isPending, setIsPending] = useState(false);
+    const requestConfirmation = useCallback(() => {
+        setIsPending(true);
+    }, []);
+    const confirm = useCallback(() => {
+        setConfirmed(true);
+        setIsPending(false);
+    }, []);
+    const cancel = useCallback(() => {
+        setIsPending(false);
+    }, []);
+    const reset = useCallback(() => {
+        setConfirmed(false);
+        setIsPending(false);
+    }, []);
+    return children({
+        confirmed,
+        isPending,
+        requestConfirmation,
+        confirm,
+        cancel,
+        reset,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/components/Confirmation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Confirmation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAkB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAiC/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,GACU;IAClB,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAElC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,mBAAmB,GAAG,WAAW,CAAC,GAAS,EAAE;QACjD,YAAY,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CAAC,GAAS,EAAE;QACpC,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAS,EAAE;QACnC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,QAAQ,CAAC;QACd,SAAS;QACT,SAAS;QACT,mBAAmB;QACnB,OAAO;QACP,MAAM;QACN,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/components/Display/index.d.ts

@@ -0,0 +1,26 @@
+import React from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Props for the Display component.
+ * Extends all standard HTML div attributes.
+ */
+export interface DisplayProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+    children: React.ReactNode;
+    /** ARIA live region behavior. Defaults to "polite". */
+    live?: "off" | "polite" | "assertive";
+}
+/**
+ * Headless read-only state display component with optional VhyxSeal contract registration.
+ * Renders a <div> with an ARIA live region for accessible dynamic content updates.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const statusContract = defineContract({ id: 'order-status', type: 'display', ... });
+ * <Display contract={statusContract} live="polite">
+ *   Order confirmed — shipping in 2 days
+ * </Display>
+ */
+export declare const Display: React.ForwardRefExoticComponent<DisplayProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Display/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Display/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,qFASnB,CAAC"}

package/dist/components/Display/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless read-only state display component with optional VhyxSeal contract registration.
+ * Renders a <div> with an ARIA live region for accessible dynamic content updates.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const statusContract = defineContract({ id: 'order-status', type: 'display', ... });
+ * <Display contract={statusContract} live="polite">
+ *   Order confirmed — shipping in 2 days
+ * </Display>
+ */
+export const Display = React.forwardRef(function Display({ contract, children, live, ...rest }, ref) {
+    useContractRegistration(contract);
+    return (_jsx("div", { ref: ref, "aria-live": live ?? "polite", ...rest, children: children }));
+});
+Display.displayName = "Display";
+//# sourceMappingURL=index.js.map

package/dist/components/Display/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Display/index.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAc/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CACrC,SAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IACzD,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CACL,cAAK,GAAG,EAAE,GAAG,eAAa,IAAI,IAAI,QAAQ,KAAM,IAAI,YACjD,QAAQ,GACL,CACP,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC"}

package/dist/components/Form/index.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Props for the Form component.
+ * Extends all standard HTML form attributes.
+ */
+export interface FormProps extends React.FormHTMLAttributes<HTMLFormElement> {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+    children: React.ReactNode;
+}
+/**
+ * Headless form wrapper with optional VhyxSeal contract registration.
+ * Renders a native <form> element. All standard HTML form attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const loginContract = defineContract({ id: 'login-form', intent: 'authenticate', ... });
+ * <Form contract={loginContract} onSubmit={handleSubmit}>
+ *   <Input type="email" /><Button type="submit">Sign In</Button>
+ * </Form>
+ */
+export declare const Form: React.ForwardRefExoticComponent<FormProps & React.RefAttributes<HTMLFormElement>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Form/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC;IAC1E,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,mFAShB,CAAC"}

package/dist/components/Form/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless form wrapper with optional VhyxSeal contract registration.
+ * Renders a native <form> element. All standard HTML form attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const loginContract = defineContract({ id: 'login-form', intent: 'authenticate', ... });
+ * <Form contract={loginContract} onSubmit={handleSubmit}>
+ *   <Input type="email" /><Button type="submit">Sign In</Button>
+ * </Form>
+ */
+export const Form = React.forwardRef(function Form({ contract, children, ...rest }, ref) {
+    useContractRegistration(contract);
+    return (_jsx("form", { ref: ref, ...rest, children: children }));
+});
+Form.displayName = "Form";
+//# sourceMappingURL=index.js.map

package/dist/components/Form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Form/index.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAY/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAClC,SAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IAChD,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CACL,eAAM,GAAG,EAAE,GAAG,KAAM,IAAI,YACrB,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC"}

package/dist/components/Input/index.d.ts

@@ -0,0 +1,21 @@
+import React from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Props for the Input component.
+ * Extends all standard HTML input attributes.
+ */
+export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+}
+/**
+ * Headless input component with optional VhyxSeal contract registration.
+ * Renders a native <input> element. All standard HTML input attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const searchContract = defineContract({ id: 'search-input', intent: 'search', ... });
+ * <Input contract={searchContract} type="search" placeholder="Search..." />
+ */
+export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Input/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IAC7E,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,qFAKjB,CAAC"}

package/dist/components/Input/index.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless input component with optional VhyxSeal contract registration.
+ * Renders a native <input> element. All standard HTML input attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const searchContract = defineContract({ id: 'search-input', intent: 'search', ... });
+ * <Input contract={searchContract} type="search" placeholder="Search..." />
+ */
+export const Input = React.forwardRef(function Input({ contract, ...rest }, ref) {
+    useContractRegistration(contract);
+    return _jsx("input", { ref: ref, ...rest });
+});
+Input.displayName = "Input";
+//# sourceMappingURL=index.js.map

package/dist/components/Input/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Input/index.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAW/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CACnC,SAAS,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IACvC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,gBAAO,GAAG,EAAE,GAAG,KAAM,IAAI,GAAI,CAAC;AACvC,CAAC,CACF,CAAC;AAEF,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC"}

package/dist/components/Nav/index.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Props for the Nav component.
+ * Extends all standard HTML element attributes.
+ */
+export interface NavProps extends React.HTMLAttributes<HTMLElement> {
+    /** Optional VhyxSeal contract. When provided, registers with the nearest SealProvider. */
+    contract?: Readonly<ComponentContract>;
+    children: React.ReactNode;
+}
+/**
+ * Headless navigation wrapper with optional VhyxSeal contract registration.
+ * Renders a native <nav> element. All standard HTML attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const navContract = defineContract({ id: 'main-nav', intent: 'navigate', ... });
+ * <Nav contract={navContract}>
+ *   <a href="/home">Home</a>
+ * </Nav>
+ */
+export declare const Nav: React.ForwardRefExoticComponent<NavProps & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Nav/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Nav/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACjE,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,8EASf,CAAC"}

package/dist/components/Nav/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { useContractRegistration } from "../shared/useContractRegistration.js";
+/**
+ * Headless navigation wrapper with optional VhyxSeal contract registration.
+ * Renders a native <nav> element. All standard HTML attributes are forwarded.
+ * Supports ref forwarding. Degrades gracefully when no SealProvider is present.
+ *
+ * @example
+ * const navContract = defineContract({ id: 'main-nav', intent: 'navigate', ... });
+ * <Nav contract={navContract}>
+ *   <a href="/home">Home</a>
+ * </Nav>
+ */
+export const Nav = React.forwardRef(function Nav({ contract, children, ...rest }, ref) {
+    useContractRegistration(contract);
+    return (_jsx("nav", { ref: ref, ...rest, children: children }));
+});
+Nav.displayName = "Nav";
+//# sourceMappingURL=index.js.map

package/dist/components/Nav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Nav/index.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAY/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CACjC,SAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG;IAC/C,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CACL,cAAK,GAAG,EAAE,GAAG,KAAM,IAAI,YACpB,QAAQ,GACL,CACP,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,13 @@
+export { Button } from "./Button/index.js";
+export type { ButtonProps } from "./Button/index.js";
+export { Input } from "./Input/index.js";
+export type { InputProps } from "./Input/index.js";
+export { Form } from "./Form/index.js";
+export type { FormProps } from "./Form/index.js";
+export { Nav } from "./Nav/index.js";
+export type { NavProps } from "./Nav/index.js";
+export { Display } from "./Display/index.js";
+export type { DisplayProps } from "./Display/index.js";
+export { Confirmation } from "./Confirmation/index.js";
+export type { ConfirmationProps, ConfirmationState, } from "./Confirmation/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,7 @@
+export { Button } from "./Button/index.js";
+export { Input } from "./Input/index.js";
+export { Form } from "./Form/index.js";
+export { Nav } from "./Nav/index.js";
+export { Display } from "./Display/index.js";
+export { Confirmation } from "./Confirmation/index.js";
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/components/shared/useContractRegistration.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Internal hook. Registers a contract with the nearest SealProvider on mount and
+ * unregisters on unmount. No-ops gracefully when no SealProvider is present or
+ * when contract is undefined.
+ *
+ * @param contract - The contract to register, or undefined for no-op.
+ * @internal — not exported from the package public API.
+ */
+export declare function useContractRegistration(contract: Readonly<ComponentContract> | undefined): void;
+//# sourceMappingURL=useContractRegistration.d.ts.map

package/dist/components/shared/useContractRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContractRegistration.d.ts","sourceRoot":"","sources":["../../../src/components/shared/useContractRegistration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,SAAS,GAChD,IAAI,CAeN"}

package/dist/components/shared/useContractRegistration.js

@@ -0,0 +1,27 @@
+import { useContext, useEffect } from "react";
+import { SealContext } from "../../provider/context.js";
+/**
+ * Internal hook. Registers a contract with the nearest SealProvider on mount and
+ * unregisters on unmount. No-ops gracefully when no SealProvider is present or
+ * when contract is undefined.
+ *
+ * @param contract - The contract to register, or undefined for no-op.
+ * @internal — not exported from the package public API.
+ */
+export function useContractRegistration(contract) {
+    const ctx = useContext(SealContext);
+    useEffect(() => {
+        if (!contract || !ctx)
+            return;
+        ctx.registerContract(contract);
+        return () => {
+            ctx.unregisterContract(contract.id);
+        };
+        // contract.id and contract.fingerprint as deps — re-register when contract identity or
+        // content changes. ctx intentionally omitted: registerContract / unregisterContract are
+        // stable useCallback references from SealProvider; including ctx causes infinite render
+        // loops (Session 012 finding: "never put [ctx] in useEffect deps").
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [contract?.id, contract?.fingerprint]);
+}
+//# sourceMappingURL=useContractRegistration.js.map

package/dist/components/shared/useContractRegistration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContractRegistration.js","sourceRoot":"","sources":["../../../src/components/shared/useContractRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAiD;IAEjD,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEpC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG;YAAE,OAAO;QAC9B,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC;QACF,uFAAuF;QACvF,wFAAwF;QACxF,wFAAwF;QACxF,oEAAoE;QACpE,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/hoc/index.d.ts

@@ -0,0 +1,2 @@
+export { withAgentContract } from "./withAgentContract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hoc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hoc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hoc/index.js

@@ -0,0 +1,2 @@
+export { withAgentContract } from "./withAgentContract.js";
+//# sourceMappingURL=index.js.map

package/dist/hoc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hoc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hoc/withAgentContract.d.ts

@@ -0,0 +1,32 @@
+import { type ComponentType } from "react";
+import type { ComponentContract } from "@vhyxseal/core";
+/**
+ * Wraps any React component with a VhyxSeal contract without modifying the original.
+ *
+ * The contract is registered in SealContext on mount and unregistered on unmount.
+ * When rendered outside a SealProvider the component still renders — the contract
+ * is silently skipped and a console.warn is emitted in non-production environments.
+ * This follows the "errors never crash the visual layer" principle.
+ *
+ * For stable behavior, define the contract outside the render function using
+ * defineContract() from @vhyxseal/core. Inline contract objects will trigger
+ * re-registration on every render.
+ *
+ * @param WrappedComponent - Any React component. Receives all its original props unchanged.
+ * @param contract - A complete ComponentContract. Use defineContract() for fingerprinting.
+ * @returns A new component with the same props interface.
+ * @example
+ * import { withAgentContract } from '@vhyxseal/react';
+ * import { defineContract } from '@vhyxseal/core';
+ *
+ * const orderContract = defineContract({ id: 'checkout-btn', intent: 'place-order', ... });
+ *
+ * const PlaceOrderButton = withAgentContract(
+ *   ({ onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>Place Order</button>
+ *   ),
+ *   orderContract,
+ * );
+ */
+export declare function withAgentContract<P extends object>(WrappedComponent: ComponentType<P>, contract: Readonly<ComponentContract>): ComponentType<P>;
+//# sourceMappingURL=withAgentContract.d.ts.map

package/dist/hoc/withAgentContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAgentContract.d.ts","sourceRoot":"","sources":["../../src/hoc/withAgentContract.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC,EAClC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACpC,aAAa,CAAC,CAAC,CAAC,CAiClB"}

package/dist/hoc/withAgentContract.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useContext, useEffect, } from "react";
+import { SealContext } from "../provider/context.js";
+/**
+ * Wraps any React component with a VhyxSeal contract without modifying the original.
+ *
+ * The contract is registered in SealContext on mount and unregistered on unmount.
+ * When rendered outside a SealProvider the component still renders — the contract
+ * is silently skipped and a console.warn is emitted in non-production environments.
+ * This follows the "errors never crash the visual layer" principle.
+ *
+ * For stable behavior, define the contract outside the render function using
+ * defineContract() from @vhyxseal/core. Inline contract objects will trigger
+ * re-registration on every render.
+ *
+ * @param WrappedComponent - Any React component. Receives all its original props unchanged.
+ * @param contract - A complete ComponentContract. Use defineContract() for fingerprinting.
+ * @returns A new component with the same props interface.
+ * @example
+ * import { withAgentContract } from '@vhyxseal/react';
+ * import { defineContract } from '@vhyxseal/core';
+ *
+ * const orderContract = defineContract({ id: 'checkout-btn', intent: 'place-order', ... });
+ *
+ * const PlaceOrderButton = withAgentContract(
+ *   ({ onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>Place Order</button>
+ *   ),
+ *   orderContract,
+ * );
+ */
+export function withAgentContract(WrappedComponent, contract) {
+    const WithAgentContract = (props) => {
+        const ctx = useContext(SealContext);
+        useEffect(() => {
+            if (ctx === null) {
+                if (process.env["NODE_ENV"] !== "production") {
+                    console.warn(`[VhyxSeal] withAgentContract: component "${contract.id}" rendered ` +
+                        `outside SealProvider. Contract not registered.`);
+                }
+                return;
+            }
+            ctx.registerContract(contract);
+            return () => {
+                ctx.unregisterContract(contract.id);
+            };
+            // contract.fingerprint as sole dep: re-register when fingerprint changes, not on every
+            // render. ctx.registerContract / unregisterContract are stable useCallback references
+            // from SealProvider — intentionally omitted to avoid [ctx] infinite-render issues.
+            // eslint-disable-next-line react-hooks/exhaustive-deps
+        }, [contract.fingerprint]);
+        return _jsx(WrappedComponent, { ...props });
+    };
+    WithAgentContract.displayName = `WithAgentContract(${WrappedComponent.displayName || WrappedComponent.name || "Component"})`;
+    return WithAgentContract;
+}
+//# sourceMappingURL=withAgentContract.js.map

package/dist/hoc/withAgentContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAgentContract.js","sourceRoot":"","sources":["../../src/hoc/withAgentContract.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,UAAU,EACV,SAAS,GAIV,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAkC,EAClC,QAAqC;IAErC,MAAM,iBAAiB,GAAyB,CAAC,KAAQ,EAAa,EAAE;QACtE,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAEpC,SAAS,CAAC,GAAG,EAAE;YACb,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CACV,4CAA4C,QAAQ,CAAC,EAAE,aAAa;wBAClE,gDAAgD,CACnD,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;YAED,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE/B,OAAO,GAAG,EAAE;gBACV,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC,CAAC;YACF,uFAAuF;YACvF,sFAAsF;YACtF,mFAAmF;YACnF,uDAAuD;QACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAE3B,OAAO,KAAC,gBAAgB,OAAK,KAAK,GAAI,CAAC;IACzC,CAAC,CAAC;IAEF,iBAAiB,CAAC,WAAW,GAAG,qBAC9B,gBAAgB,CAAC,WAAW,IAAI,gBAAgB,CAAC,IAAI,IAAI,WAC3D,GAAG,CAAC;IACJ,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { useContract } from "./useContract.js";
+export { useCapability } from "./useCapability.js";
+export type { CapabilityMap } from "./useCapability.js";
+export { useAgentAction } from "./useAgentAction.js";
+export type { AgentActionStatus, AgentActionRecord, UseAgentActionReturn, } from "./useAgentAction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,4 @@
+export { useContract } from "./useContract.js";
+export { useCapability } from "./useCapability.js";
+export { useAgentAction } from "./useAgentAction.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}