@vhyxui/core 0.1.0-alpha.1 → 0.2.0-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vhyxara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @vhyxui/core
+
+Shared foundations for VhyxUI packages: agent contract templates for every
+interactive component, the `Slot` primitive and typed errors.
+
+> **Alpha** — most apps use `@vhyxui/react` and never import this package directly.
+
+## Install
+
+```bash
+npm install @vhyxui/core
+```
+
+## What's included
+
+- **Contract templates** — `buttonContract`, `dialogContract`, `tableContract` … one per
+  interactive component, describing its intent and safety level for AI agents
+  (built on `@vhyxseal/core`)
+- **`Slot`** — merges props and refs onto a child element (`asChild` pattern),
+  plus `mergeProps` and `mergeRefs`
+- **Errors** — `VhyxUIError` and `VhyxUIErrorCode`
+
+```ts
+import { Slot, mergeRefs } from "@vhyxui/core";
+```
+
+## Links
+
+- Documentation — https://vhyxui.com
+- Source — https://github.com/vhyxara/vhyxUI/tree/main/packages/core
+- License — MIT

package/dist/contracts.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./pagination-DMKZiFFW.cjs");exports.alertContract=t.alertContract;exports.badgeContract=t.badgeContract;exports.breadcrumbContract=t.breadcrumbContract;exports.buttonContract=t.buttonContract;exports.cardContract=t.cardContract;exports.checkboxContract=t.checkboxContract;exports.dialogContract=t.dialogContract;exports.drawerContract=t.drawerContract;exports.formContract=t.formContract;exports.inputContract=t.inputContract;exports.paginationContract=t.paginationContract;exports.popoverContract=t.popoverContract;exports.progressContract=t.progressContract;exports.radioContract=t.radioContract;exports.selectContract=t.selectContract;exports.separatorContract=t.separatorContract;exports.spinnerContract=t.spinnerContract;exports.switchContract=t.switchContract;exports.tabsContract=t.tabsContract;exports.textareaContract=t.textareaContract;exports.toastContract=t.toastContract;exports.tooltipContract=t.tooltipContract;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./table-THh0Ixxd.cjs");exports.accordionContract=t.accordionContract;exports.alertContract=t.alertContract;exports.badgeContract=t.badgeContract;exports.breadcrumbContract=t.breadcrumbContract;exports.buttonContract=t.buttonContract;exports.cardContract=t.cardContract;exports.checkboxContract=t.checkboxContract;exports.dialogContract=t.dialogContract;exports.drawerContract=t.drawerContract;exports.formContract=t.formContract;exports.inputContract=t.inputContract;exports.paginationContract=t.paginationContract;exports.popoverContract=t.popoverContract;exports.progressContract=t.progressContract;exports.radioContract=t.radioContract;exports.selectContract=t.selectContract;exports.separatorContract=t.separatorContract;exports.spinnerContract=t.spinnerContract;exports.switchContract=t.switchContract;exports.tableContract=t.tableContract;exports.tabsContract=t.tabsContract;exports.textareaContract=t.textareaContract;exports.toastContract=t.toastContract;exports.tooltipContract=t.tooltipContract;

package/dist/contracts.d.ts

@@ -1,5 +1,15 @@
 import { ComponentContract } from '@vhyxseal/core';
 
+/**
+ * Default VhyxSeal contract template for the Accordion component.
+ *
+ * Expanding or collapsing a section only changes what is visible — agents can
+ * toggle freely to read hidden content. Instance id is injected at render time.
+ */
+export declare const accordionContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
 /**
  * Default VhyxSeal contract template for the Alert component.
  *
@@ -204,6 +214,16 @@ export declare const switchContract: Readonly<Omit<ComponentContract, "id"> & {
     readonly fingerprint: string;
 }>;
 
+/**
+ * Default VhyxSeal contract template for the Table component.
+ *
+ * Tables are read-only structured data — the most valuable thing for an agent
+ * to read reliably. Instance id is injected at render time.
+ */
+export declare const tableContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
 /**
  * Default VhyxSeal contract template for the Tabs component.
  *

package/dist/contracts.js

@@ -1,25 +1,27 @@
-import { a as r, b as o, c as s, d as c, e as n, f as C, g as e, h as p, i, j as b, p as d, k as g, l, r as m, s as u, m as f, n as h, o as x, t as k, q as v, u as w, v as j } from "./pagination-BC8m1q01.js";
+import { a as r, b as o, c, d as s, e as n, f as C, g as e, h as i, i as p, j as b, k as d, p as l, l as g, m, r as u, s as x, n as f, o as h, q as w, t as k, u as v, v as j, w as q, x as y } from "./table-HKtt13kb.js";
 export {
-  r as alertContract,
-  o as badgeContract,
+  r as accordionContract,
+  o as alertContract,
+  c as badgeContract,
   s as breadcrumbContract,
-  c as buttonContract,
-  n as cardContract,
-  C as checkboxContract,
-  e as dialogContract,
+  n as buttonContract,
+  C as cardContract,
+  e as checkboxContract,
+  i as dialogContract,
   p as drawerContract,
-  i as formContract,
-  b as inputContract,
-  d as paginationContract,
+  b as formContract,
+  d as inputContract,
+  l as paginationContract,
   g as popoverContract,
-  l as progressContract,
-  m as radioContract,
-  u as selectContract,
+  m as progressContract,
+  u as radioContract,
+  x as selectContract,
   f as separatorContract,
   h as spinnerContract,
-  x as switchContract,
-  k as tabsContract,
-  v as textareaContract,
-  w as toastContract,
-  j as tooltipContract
+  w as switchContract,
+  k as tableContract,
+  v as tabsContract,
+  j as textareaContract,
+  q as toastContract,
+  y as tooltipContract
 };

package/dist/errors.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e=(I=>(I.VHYXUI_MISSING_CONTEXT="VHYXUI_MISSING_CONTEXT",I.VHYXUI_MISSING_TITLE="VHYXUI_MISSING_TITLE",I.VHYXUI_INVALID_PROP="VHYXUI_INVALID_PROP",I.VHYXUI_PROVIDER_MISSING="VHYXUI_PROVIDER_MISSING",I.VHYXUI_TOAST_LIMIT_EXCEEDED="VHYXUI_TOAST_LIMIT_EXCEEDED",I))(e||{});class t extends Error{constructor(_){super(_.message),this.name="VhyxUIError",this.code=_.code,this.suggestion=_.suggestion,this.context=_.context}}exports.VhyxUIError=t;exports.VhyxUIErrorCode=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var T=(I=>(I.VHYXUI_MISSING_CONTEXT="VHYXUI_MISSING_CONTEXT",I.VHYXUI_MISSING_TITLE="VHYXUI_MISSING_TITLE",I.VHYXUI_INVALID_PROP="VHYXUI_INVALID_PROP",I.VHYXUI_PROVIDER_MISSING="VHYXUI_PROVIDER_MISSING",I.VHYXUI_TOAST_LIMIT_EXCEEDED="VHYXUI_TOAST_LIMIT_EXCEEDED",I.VHYXUI_STRUCTURE_INVALID="VHYXUI_STRUCTURE_INVALID",I.VHYXUI_RUNTIME_INVARIANT_VIOLATION="VHYXUI_RUNTIME_INVARIANT_VIOLATION",I))(T||{});class V extends Error{constructor(_){super(_.message),this.name="VhyxUIError",this.code=_.code,this.suggestion=_.suggestion,this.context=_.context}}exports.VhyxUIError=V;exports.VhyxUIErrorCode=T;

package/dist/errors.d.ts

@@ -26,7 +26,9 @@ export declare enum VhyxUIErrorCode {
     VHYXUI_MISSING_TITLE = "VHYXUI_MISSING_TITLE",
     VHYXUI_INVALID_PROP = "VHYXUI_INVALID_PROP",
     VHYXUI_PROVIDER_MISSING = "VHYXUI_PROVIDER_MISSING",
-    VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED"
+    VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED",
+    VHYXUI_STRUCTURE_INVALID = "VHYXUI_STRUCTURE_INVALID",
+    VHYXUI_RUNTIME_INVARIANT_VIOLATION = "VHYXUI_RUNTIME_INVARIANT_VIOLATION"
 }
 
 /** Configuration object passed to the VhyxUIError constructor. */

package/dist/errors.js

@@ -1,10 +1,10 @@
-var S = /* @__PURE__ */ ((I) => (I.VHYXUI_MISSING_CONTEXT = "VHYXUI_MISSING_CONTEXT", I.VHYXUI_MISSING_TITLE = "VHYXUI_MISSING_TITLE", I.VHYXUI_INVALID_PROP = "VHYXUI_INVALID_PROP", I.VHYXUI_PROVIDER_MISSING = "VHYXUI_PROVIDER_MISSING", I.VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED", I))(S || {});
-class T extends Error {
+var T = /* @__PURE__ */ ((I) => (I.VHYXUI_MISSING_CONTEXT = "VHYXUI_MISSING_CONTEXT", I.VHYXUI_MISSING_TITLE = "VHYXUI_MISSING_TITLE", I.VHYXUI_INVALID_PROP = "VHYXUI_INVALID_PROP", I.VHYXUI_PROVIDER_MISSING = "VHYXUI_PROVIDER_MISSING", I.VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED", I.VHYXUI_STRUCTURE_INVALID = "VHYXUI_STRUCTURE_INVALID", I.VHYXUI_RUNTIME_INVARIANT_VIOLATION = "VHYXUI_RUNTIME_INVARIANT_VIOLATION", I))(T || {});
+class N extends Error {
   constructor(_) {
     super(_.message), this.name = "VhyxUIError", this.code = _.code, this.suggestion = _.suggestion, this.context = _.context;
   }
 }
 export {
-  T as VhyxUIError,
-  S as VhyxUIErrorCode
+  N as VhyxUIError,
+  T as VhyxUIErrorCode
 };

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./errors.cjs"),r=require("./Slot-CLNJSabn.cjs"),t=require("./pagination-DMKZiFFW.cjs");exports.VhyxUIError=o.VhyxUIError;exports.VhyxUIErrorCode=o.VhyxUIErrorCode;exports.Slot=r.Slot;exports.mergeProps=r.mergeProps;exports.mergeRefs=r.mergeRefs;exports.alertContract=t.alertContract;exports.badgeContract=t.badgeContract;exports.breadcrumbContract=t.breadcrumbContract;exports.buttonContract=t.buttonContract;exports.cardContract=t.cardContract;exports.checkboxContract=t.checkboxContract;exports.dialogContract=t.dialogContract;exports.drawerContract=t.drawerContract;exports.formContract=t.formContract;exports.inputContract=t.inputContract;exports.paginationContract=t.paginationContract;exports.popoverContract=t.popoverContract;exports.progressContract=t.progressContract;exports.radioContract=t.radioContract;exports.selectContract=t.selectContract;exports.separatorContract=t.separatorContract;exports.spinnerContract=t.spinnerContract;exports.switchContract=t.switchContract;exports.tabsContract=t.tabsContract;exports.textareaContract=t.textareaContract;exports.toastContract=t.toastContract;exports.tooltipContract=t.tooltipContract;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./errors.cjs"),r=require("./Slot-CLNJSabn.cjs"),t=require("./table-THh0Ixxd.cjs");exports.VhyxUIError=o.VhyxUIError;exports.VhyxUIErrorCode=o.VhyxUIErrorCode;exports.Slot=r.Slot;exports.mergeProps=r.mergeProps;exports.mergeRefs=r.mergeRefs;exports.accordionContract=t.accordionContract;exports.alertContract=t.alertContract;exports.badgeContract=t.badgeContract;exports.breadcrumbContract=t.breadcrumbContract;exports.buttonContract=t.buttonContract;exports.cardContract=t.cardContract;exports.checkboxContract=t.checkboxContract;exports.dialogContract=t.dialogContract;exports.drawerContract=t.drawerContract;exports.formContract=t.formContract;exports.inputContract=t.inputContract;exports.paginationContract=t.paginationContract;exports.popoverContract=t.popoverContract;exports.progressContract=t.progressContract;exports.radioContract=t.radioContract;exports.selectContract=t.selectContract;exports.separatorContract=t.separatorContract;exports.spinnerContract=t.spinnerContract;exports.switchContract=t.switchContract;exports.tableContract=t.tableContract;exports.tabsContract=t.tabsContract;exports.textareaContract=t.textareaContract;exports.toastContract=t.toastContract;exports.tooltipContract=t.tooltipContract;

package/dist/index.d.ts

@@ -3,6 +3,16 @@ import { ComponentType as ContractComponentType } from '@vhyxseal/core';
 import { default as default_2 } from 'react';
 import { SafetyLevel } from '@vhyxseal/core';
 
+/**
+ * Default VhyxSeal contract template for the Accordion component.
+ *
+ * Expanding or collapsing a section only changes what is visible — agents can
+ * toggle freely to read hidden content. Instance id is injected at render time.
+ */
+export declare const accordionContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
 /**
  * Default VhyxSeal contract template for the Alert component.
  *
@@ -277,6 +287,16 @@ export declare const switchContract: Readonly<Omit<ComponentContract, "id"> & {
     readonly fingerprint: string;
 }>;
 
+/**
+ * Default VhyxSeal contract template for the Table component.
+ *
+ * Tables are read-only structured data — the most valuable thing for an agent
+ * to read reliably. Instance id is injected at render time.
+ */
+export declare const tableContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
 /**
  * Default VhyxSeal contract template for the Tabs component.
  *
@@ -349,7 +369,9 @@ export declare enum VhyxUIErrorCode {
     VHYXUI_MISSING_TITLE = "VHYXUI_MISSING_TITLE",
     VHYXUI_INVALID_PROP = "VHYXUI_INVALID_PROP",
     VHYXUI_PROVIDER_MISSING = "VHYXUI_PROVIDER_MISSING",
-    VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED"
+    VHYXUI_TOAST_LIMIT_EXCEEDED = "VHYXUI_TOAST_LIMIT_EXCEEDED",
+    VHYXUI_STRUCTURE_INVALID = "VHYXUI_STRUCTURE_INVALID",
+    VHYXUI_RUNTIME_INVARIANT_VIOLATION = "VHYXUI_RUNTIME_INVARIANT_VIOLATION"
 }
 
 /** Configuration object passed to the VhyxUIError constructor. */

package/dist/index.js

@@ -1,32 +1,34 @@
 import { VhyxUIError as r, VhyxUIErrorCode as o } from "./errors.js";
-import { S as c, m as n, a as e } from "./Slot-PvMbF2q3.js";
-import { a as p, b as i, c as m, d, e as b, f as g, g as x, h as f, i as l, j as h, p as u, k, l as v, r as w, s as y, m as E, n as I, o as S, t as U, q as V, u as j, v as q } from "./pagination-BC8m1q01.js";
+import { S as c, m as n, a as C } from "./Slot-PvMbF2q3.js";
+import { a as p, b as i, c as d, d as m, e as b, f as x, g, h as l, i as f, j as h, k as u, p as w, l as k, m as v, r as y, s as E, n as I, o as S, q as U, t as V, u as j, v as q, w as P, x as R } from "./table-HKtt13kb.js";
 export {
   c as Slot,
   r as VhyxUIError,
   o as VhyxUIErrorCode,
-  p as alertContract,
-  i as badgeContract,
+  p as accordionContract,
+  i as alertContract,
+  d as badgeContract,
   m as breadcrumbContract,
-  d as buttonContract,
-  b as cardContract,
+  b as buttonContract,
+  x as cardContract,
   g as checkboxContract,
-  x as dialogContract,
+  l as dialogContract,
   f as drawerContract,
-  l as formContract,
-  h as inputContract,
+  h as formContract,
+  u as inputContract,
   n as mergeProps,
-  e as mergeRefs,
-  u as paginationContract,
+  C as mergeRefs,
+  w as paginationContract,
   k as popoverContract,
   v as progressContract,
-  w as radioContract,
-  y as selectContract,
-  E as separatorContract,
-  I as spinnerContract,
-  S as switchContract,
-  U as tabsContract,
-  V as textareaContract,
-  j as toastContract,
-  q as tooltipContract
+  y as radioContract,
+  E as selectContract,
+  I as separatorContract,
+  S as spinnerContract,
+  U as switchContract,
+  V as tableContract,
+  j as tabsContract,
+  q as textareaContract,
+  P as toastContract,
+  R as tooltipContract
 };

package/dist/{pagination-BC8m1q01.js → table-HKtt13kb.js}

@@ -220,7 +220,7 @@ const s = e({
   requiresConfirmation: !1,
   destructive: !1,
   contractVersion: "0.0.1"
-}), b = e({
+}), h = e({
   type: "display",
   intent: "display-content",
   description: "Displays grouped content in a visually distinct container",
@@ -233,7 +233,7 @@ const s = e({
   requiresConfirmation: !1,
   destructive: !1,
   contractVersion: "0.0.1"
-}), h = e({
+}), b = e({
   type: "display",
   intent: "separate-content",
   description: "Visually or semantically separates adjacent content sections",
@@ -285,28 +285,56 @@ const s = e({
   requiresConfirmation: !1,
   destructive: !1,
   contractVersion: "0.0.1"
+}), V = e({
+  type: "navigation",
+  intent: "toggle-section",
+  description: "Expands or collapses a section of content to reveal or hide it",
+  requires: [],
+  requiredPermissions: [],
+  consequence: "Shows or hides the section content. No data changes.",
+  affects: [],
+  reversible: !0,
+  safetyLevel: "low",
+  requiresConfirmation: !1,
+  destructive: !1,
+  contractVersion: "0.0.1"
+}), L = e({
+  type: "display",
+  intent: "display-data",
+  description: "Displays structured rows and columns of data",
+  requires: [],
+  requiredPermissions: [],
+  consequence: "None — display only.",
+  affects: [],
+  reversible: !0,
+  safetyLevel: "low",
+  requiresConfirmation: !1,
+  destructive: !1,
+  contractVersion: "0.0.1"
 });
 export {
-  f as a,
-  d as b,
-  w as c,
-  s as d,
-  b as e,
-  a as f,
-  y as g,
-  m as h,
-  l as i,
-  r as j,
-  g as k,
-  p as l,
-  h as m,
-  v as n,
-  c as o,
+  V as a,
+  f as b,
+  d as c,
+  w as d,
+  s as e,
+  h as f,
+  a as g,
+  y as h,
+  m as i,
+  l as j,
+  r as k,
+  g as l,
+  p as m,
+  b as n,
+  v as o,
   P as p,
-  i as q,
+  c as q,
   o as r,
   n as s,
-  C as t,
-  u,
-  q as v
+  L as t,
+  C as u,
+  i as v,
+  u as w,
+  q as x
 };

package/dist/{pagination-DMKZiFFW.cjs → table-THh0Ixxd.cjs}

@@ -1 +1 @@
-"use strict";const e=require("@vhyxseal/core"),t=e.defineContractTemplate({type:"action",intent:"trigger-action",description:"Triggers an action or submits a form when activated by the user",requires:[],requiredPermissions:[],consequence:"Triggers the associated action",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),r=e.defineContractTemplate({type:"input",intent:"enter-text",description:"Accepts a text value entered by the user",requires:[],requiredPermissions:[],consequence:"Updates the field value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),n=e.defineContractTemplate({type:"input",intent:"enter-text",description:"Accepts multi-line text content entered by the user",requires:[],requiredPermissions:[],consequence:"Updates the multi-line field value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),s=e.defineContractTemplate({type:"input",intent:"select-option",description:"Allows the user to choose one option from a dropdown list",requires:[],requiredPermissions:[],consequence:"Updates the selected option value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),i=e.defineContractTemplate({type:"input",intent:"toggle-selection",description:"Toggles a boolean selection — checked, unchecked, or indeterminate",requires:[],requiredPermissions:[],consequence:"Updates the checked state in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),a=e.defineContractTemplate({type:"input",intent:"select-option",description:"Captures a single mutually exclusive selection from a set of radio options",requires:[],requiredPermissions:[],consequence:"Updates the selected radio value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),o=e.defineContractTemplate({type:"input",intent:"toggle-state",description:"Toggles a binary on/off state immediately upon interaction",requires:[],requiredPermissions:[],consequence:"Changes the boolean state of the controlled feature",affects:[],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),c=e.defineContractTemplate({type:"action",intent:"submit-form",description:"Collects field values and submits them to the server or handler",requires:[],requiredPermissions:[],consequence:"Sends form data to the configured handler — may create or update records",affects:["form"],reversible:!1,safetyLevel:"medium",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),l=e.defineContractTemplate({type:"display",intent:"notify",description:"Displays a transient notification message to the user",requires:[],requiredPermissions:[],consequence:"None — display only. Disappears after the configured duration.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),f=e.defineContractTemplate({type:"display",intent:"display-alert",description:"Displays a persistent contextual alert message to the user",requires:[],requiredPermissions:[],consequence:"None — display only. Persists until dismissed.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),d=e.defineContractTemplate({type:"display",intent:"display-status",description:"Displays a small status label, count, or categorical indicator",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),u=e.defineContractTemplate({type:"display",intent:"display-progress",description:"Displays the completion percentage of an ongoing operation",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),p=e.defineContractTemplate({type:"display",intent:"display-loading",description:"Indicates that an asynchronous operation is in progress",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),m=e.defineContractTemplate({type:"confirmation",intent:"open-dialog",description:"Opens a modal dialog overlay that interrupts the current workflow",requires:[],requiredPermissions:[],consequence:"Renders a blocking overlay — underlying page is inaccessible until dismissed",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),v=e.defineContractTemplate({type:"navigation",intent:"open-drawer",description:"Opens a slide-in panel from a screen edge for navigation or contextual content",requires:[],requiredPermissions:[],consequence:"Renders a side panel overlay — underlying page remains accessible",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),y=e.defineContractTemplate({type:"display",intent:"display-tooltip",description:"Shows supplementary information about a trigger element on hover or focus",requires:[],requiredPermissions:[],consequence:"None — display only. Hides on mouse leave, blur, or Escape.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),C=e.defineContractTemplate({type:"display",intent:"open-popover",description:"Opens a non-modal floating panel anchored to a trigger element",requires:[],requiredPermissions:[],consequence:"Renders a floating panel — underlying page remains fully interactive",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),q=e.defineContractTemplate({type:"display",intent:"display-content",description:"Displays grouped content in a visually distinct container",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),g=e.defineContractTemplate({type:"display",intent:"separate-content",description:"Visually or semantically separates adjacent content sections",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),b=e.defineContractTemplate({type:"navigation",intent:"navigate-tabs",description:"Switches between content panels by activating a tab trigger",requires:[],requiredPermissions:[],consequence:"Changes the active content panel — no data mutation",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),h=e.defineContractTemplate({type:"navigation",intent:"navigate-breadcrumb",description:"Displays the current page location in the site hierarchy with ancestor navigation links",requires:[],requiredPermissions:[],consequence:"Navigates to an ancestor page when a breadcrumb link is activated",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),w=e.defineContractTemplate({type:"navigation",intent:"navigate-page",description:"Navigates between pages of a paginated data set",requires:[],requiredPermissions:[],consequence:"Changes the visible page of the data set — no data mutation",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"});exports.alertContract=f;exports.badgeContract=d;exports.breadcrumbContract=h;exports.buttonContract=t;exports.cardContract=q;exports.checkboxContract=i;exports.dialogContract=m;exports.drawerContract=v;exports.formContract=c;exports.inputContract=r;exports.paginationContract=w;exports.popoverContract=C;exports.progressContract=u;exports.radioContract=a;exports.selectContract=s;exports.separatorContract=g;exports.spinnerContract=p;exports.switchContract=o;exports.tabsContract=b;exports.textareaContract=n;exports.toastContract=l;exports.tooltipContract=y;
+"use strict";const e=require("@vhyxseal/core"),t=e.defineContractTemplate({type:"action",intent:"trigger-action",description:"Triggers an action or submits a form when activated by the user",requires:[],requiredPermissions:[],consequence:"Triggers the associated action",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),n=e.defineContractTemplate({type:"input",intent:"enter-text",description:"Accepts a text value entered by the user",requires:[],requiredPermissions:[],consequence:"Updates the field value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),r=e.defineContractTemplate({type:"input",intent:"enter-text",description:"Accepts multi-line text content entered by the user",requires:[],requiredPermissions:[],consequence:"Updates the multi-line field value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),s=e.defineContractTemplate({type:"input",intent:"select-option",description:"Allows the user to choose one option from a dropdown list",requires:[],requiredPermissions:[],consequence:"Updates the selected option value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),i=e.defineContractTemplate({type:"input",intent:"toggle-selection",description:"Toggles a boolean selection — checked, unchecked, or indeterminate",requires:[],requiredPermissions:[],consequence:"Updates the checked state in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),a=e.defineContractTemplate({type:"input",intent:"select-option",description:"Captures a single mutually exclusive selection from a set of radio options",requires:[],requiredPermissions:[],consequence:"Updates the selected radio value in the parent form context",affects:["form"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),o=e.defineContractTemplate({type:"input",intent:"toggle-state",description:"Toggles a binary on/off state immediately upon interaction",requires:[],requiredPermissions:[],consequence:"Changes the boolean state of the controlled feature",affects:[],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),c=e.defineContractTemplate({type:"action",intent:"submit-form",description:"Collects field values and submits them to the server or handler",requires:[],requiredPermissions:[],consequence:"Sends form data to the configured handler — may create or update records",affects:["form"],reversible:!1,safetyLevel:"medium",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),l=e.defineContractTemplate({type:"display",intent:"notify",description:"Displays a transient notification message to the user",requires:[],requiredPermissions:[],consequence:"None — display only. Disappears after the configured duration.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),f=e.defineContractTemplate({type:"display",intent:"display-alert",description:"Displays a persistent contextual alert message to the user",requires:[],requiredPermissions:[],consequence:"None — display only. Persists until dismissed.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),d=e.defineContractTemplate({type:"display",intent:"display-status",description:"Displays a small status label, count, or categorical indicator",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),u=e.defineContractTemplate({type:"display",intent:"display-progress",description:"Displays the completion percentage of an ongoing operation",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),p=e.defineContractTemplate({type:"display",intent:"display-loading",description:"Indicates that an asynchronous operation is in progress",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),m=e.defineContractTemplate({type:"confirmation",intent:"open-dialog",description:"Opens a modal dialog overlay that interrupts the current workflow",requires:[],requiredPermissions:[],consequence:"Renders a blocking overlay — underlying page is inaccessible until dismissed",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),v=e.defineContractTemplate({type:"navigation",intent:"open-drawer",description:"Opens a slide-in panel from a screen edge for navigation or contextual content",requires:[],requiredPermissions:[],consequence:"Renders a side panel overlay — underlying page remains accessible",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),y=e.defineContractTemplate({type:"display",intent:"display-tooltip",description:"Shows supplementary information about a trigger element on hover or focus",requires:[],requiredPermissions:[],consequence:"None — display only. Hides on mouse leave, blur, or Escape.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),C=e.defineContractTemplate({type:"display",intent:"open-popover",description:"Opens a non-modal floating panel anchored to a trigger element",requires:[],requiredPermissions:[],consequence:"Renders a floating panel — underlying page remains fully interactive",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),q=e.defineContractTemplate({type:"display",intent:"display-content",description:"Displays grouped content in a visually distinct container",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),g=e.defineContractTemplate({type:"display",intent:"separate-content",description:"Visually or semantically separates adjacent content sections",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!1,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),b=e.defineContractTemplate({type:"navigation",intent:"navigate-tabs",description:"Switches between content panels by activating a tab trigger",requires:[],requiredPermissions:[],consequence:"Changes the active content panel — no data mutation",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),h=e.defineContractTemplate({type:"navigation",intent:"navigate-breadcrumb",description:"Displays the current page location in the site hierarchy with ancestor navigation links",requires:[],requiredPermissions:[],consequence:"Navigates to an ancestor page when a breadcrumb link is activated",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),w=e.defineContractTemplate({type:"navigation",intent:"navigate-page",description:"Navigates between pages of a paginated data set",requires:[],requiredPermissions:[],consequence:"Changes the visible page of the data set — no data mutation",affects:["view"],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),T=e.defineContractTemplate({type:"navigation",intent:"toggle-section",description:"Expands or collapses a section of content to reveal or hide it",requires:[],requiredPermissions:[],consequence:"Shows or hides the section content. No data changes.",affects:[],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"}),P=e.defineContractTemplate({type:"display",intent:"display-data",description:"Displays structured rows and columns of data",requires:[],requiredPermissions:[],consequence:"None — display only.",affects:[],reversible:!0,safetyLevel:"low",requiresConfirmation:!1,destructive:!1,contractVersion:"0.0.1"});exports.accordionContract=T;exports.alertContract=f;exports.badgeContract=d;exports.breadcrumbContract=h;exports.buttonContract=t;exports.cardContract=q;exports.checkboxContract=i;exports.dialogContract=m;exports.drawerContract=v;exports.formContract=c;exports.inputContract=n;exports.paginationContract=w;exports.popoverContract=C;exports.progressContract=u;exports.radioContract=a;exports.selectContract=s;exports.separatorContract=g;exports.spinnerContract=p;exports.switchContract=o;exports.tableContract=P;exports.tabsContract=b;exports.textareaContract=r;exports.toastContract=l;exports.tooltipContract=y;

package/package.json

@@ -1,9 +1,27 @@
 {
   "name": "@vhyxui/core",
-  "version": "0.1.0-alpha.1",
+  "version": "0.2.0-alpha",
+  "private": false,
   "description": "VhyxUI core — shared types, contracts, slot, and error infrastructure",
+  "keywords": [
+    "vhyxui",
+    "vhyxara",
+    "contracts",
+    "slot"
+  ],
   "license": "MIT",
-  "private": false,
+  "homepage": "https://vhyxui.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vhyxara/vhyxUI.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/vhyxara/vhyxUI/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -39,7 +57,7 @@
     "dist"
   ],
   "dependencies": {
-    "@vhyxseal/core": "1.0.0-rc.2"
+    "@vhyxseal/core": "1.0.0-rc.3"
   },
   "peerDependencies": {
     "react": ">=18",