@vhyxui/core 0.1.0-alpha.1

package/dist/Slot-CLNJSabn.cjs

@@ -0,0 +1 @@
+"use strict";const r=require("react");function a(n){return/^on[A-Z]/.test(n)}function i(n,l){const e={...n};for(const t of Object.keys(l)){const s=n[t],o=l[t];if(a(t))typeof s=="function"&&typeof o=="function"?e[t]=(...f)=>{s(...f),o(...f)}:e[t]=o??s;else if(t==="className"){const f=typeof s=="string"?s:void 0,y=typeof o=="string"?o:void 0;e[t]=[f,y].filter(Boolean).join(" ")||void 0}else t==="style"?e[t]=s!==null&&typeof s=="object"&&o!==null&&typeof o=="object"?{...s,...o}:o??s:e[t]=o}return e}function c(...n){return l=>{for(const e of n)e!=null&&(typeof e=="function"?e(l):e.current=l)}}const u=r.forwardRef(({children:n,...l},e)=>{if(!r.isValidElement(n))return null;const t=n;return r.cloneElement(t,{...i(l,t.props),ref:e!=null?c(e,t.ref):t.ref})});u.displayName="VhyxSlot";exports.Slot=u;exports.mergeProps=i;exports.mergeRefs=c;

package/dist/Slot-PvMbF2q3.js

@@ -0,0 +1,43 @@
+import i from "react";
+function c(n) {
+  return /^on[A-Z]/.test(n);
+}
+function u(n, l) {
+  const e = { ...n };
+  for (const t of Object.keys(l)) {
+    const f = n[t], o = l[t];
+    if (c(t))
+      typeof f == "function" && typeof o == "function" ? e[t] = (...s) => {
+        f(...s), o(...s);
+      } : e[t] = o ?? f;
+    else if (t === "className") {
+      const s = typeof f == "string" ? f : void 0, r = typeof o == "string" ? o : void 0;
+      e[t] = [s, r].filter(Boolean).join(" ") || void 0;
+    } else t === "style" ? e[t] = f !== null && typeof f == "object" && o !== null && typeof o == "object" ? { ...f, ...o } : o ?? f : e[t] = o;
+  }
+  return e;
+}
+function a(...n) {
+  return (l) => {
+    for (const e of n)
+      e != null && (typeof e == "function" ? e(l) : e.current = l);
+  };
+}
+const y = i.forwardRef(
+  ({ children: n, ...l }, e) => {
+    if (!i.isValidElement(n))
+      return null;
+    const t = n;
+    return i.cloneElement(t, {
+      ...u(l, t.props),
+      // Merge the Slot's forwarded ref with the child's own ref so both are satisfied.
+      ref: e != null ? a(e, t.ref) : t.ref
+    });
+  }
+);
+y.displayName = "VhyxSlot";
+export {
+  y as S,
+  a,
+  u as m
+};

package/dist/contracts.cjs

@@ -0,0 +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;

package/dist/contracts.d.ts

@@ -0,0 +1,251 @@
+import { ComponentContract } from '@vhyxseal/core';
+
+/**
+ * Default VhyxSeal contract template for the Alert component.
+ *
+ * Expresses that an Alert is a persistent in-page notification — display only.
+ * Unlike Toast, Alert persists until explicitly dismissed by the user or application.
+ * Instance id is injected at render time: { ...alertContract, id: instanceId }
+ */
+export declare const alertContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Badge component.
+ *
+ * Expresses that a Badge is a small status indicator — display only.
+ * Agents read badge content to understand counts, states, or labels.
+ * Instance id is injected at render time: { ...badgeContract, id: instanceId }
+ */
+export declare const badgeContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Breadcrumb component.
+ *
+ * Expresses that a Breadcrumb shows the current page location within a hierarchy
+ * and provides navigation links to ancestor pages.
+ * Instance id is injected at render time: { ...breadcrumbContract, id: instanceId }
+ */
+export declare const breadcrumbContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Button component.
+ *
+ * Expresses that a Button triggers a low-safety action. The destructive variant
+ * merges safetyLevel: 'high' and destructive: true at runtime in the React component
+ * (DECISION-014). This base contract covers all non-destructive variants.
+ * Instance id is injected at render time: { ...buttonContract, id: instanceId }
+ */
+export declare const buttonContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Card component.
+ *
+ * Expresses that a Card is a content container — display only by default.
+ * When interactive=true, the developer should override intent to 'trigger-action'
+ * or 'navigate' as appropriate for the card's clickable behaviour.
+ * Instance id is injected at render time: { ...cardContract, id: instanceId }
+ */
+export declare const cardContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Checkbox component.
+ *
+ * Expresses that a Checkbox toggles a boolean or indeterminate selection state.
+ * The toggle is reversible — the user can uncheck before form submission.
+ * Instance id is injected at render time: { ...checkboxContract, id: instanceId }
+ */
+export declare const checkboxContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Dialog component.
+ *
+ * Expresses that a Dialog opens a modal overlay requiring user interaction.
+ * type 'confirmation' signals to agents that the dialog interrupts flow and
+ * must be resolved (confirmed or dismissed) before proceeding.
+ * Safety of the dialog's contents is determined by its child contracts.
+ * Instance id is injected at render time: { ...dialogContract, id: instanceId }
+ */
+export declare const dialogContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Drawer component.
+ *
+ * Expresses that a Drawer slides in a panel from a screen edge. Navigation type
+ * because drawers typically expose navigation or contextual content, not confirmations.
+ * Instance id is injected at render time: { ...drawerContract, id: instanceId }
+ */
+export declare const drawerContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Form component.
+ *
+ * Expresses that a Form collects and submits user data. Submission is not
+ * reversible — the agent must be certain fields are correct before triggering.
+ * safetyLevel medium because form submission typically writes to external systems.
+ * Instance id is injected at render time: { ...formContract, id: instanceId }
+ */
+export declare const formContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Input component.
+ *
+ * Expresses that an Input accepts user text. The field value is reversible —
+ * the user can clear or modify the input before the parent form is submitted.
+ * Instance id is injected at render time: { ...inputContract, id: instanceId }
+ */
+export declare const inputContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Pagination component.
+ *
+ * Expresses that Pagination navigates between pages of a data set.
+ * Page changes update the visible content slice — no data is mutated.
+ * Instance id is injected at render time: { ...paginationContract, id: instanceId }
+ */
+export declare const paginationContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Popover component.
+ *
+ * Expresses that a Popover opens a non-modal floating panel anchored to a trigger.
+ * Unlike Dialog, a Popover does not block the rest of the page.
+ * Instance id is injected at render time: { ...popoverContract, id: instanceId }
+ */
+export declare const popoverContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Progress component.
+ *
+ * Expresses that a Progress bar is a visual indicator of completion — display only.
+ * Agents read value and max to determine how far along an operation is.
+ * Instance id is injected at render time: { ...progressContract, id: instanceId }
+ */
+export declare const progressContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the RadioGroup component.
+ *
+ * Expresses that a RadioGroup captures a mutually exclusive selection.
+ * The selection is reversible — a different option can be chosen before form submission.
+ * Instance id is injected at render time: { ...radioContract, id: instanceId }
+ */
+export declare const radioContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Select component.
+ *
+ * Expresses that a Select allows the user to choose one option from a list.
+ * The selection is reversible — another option can be chosen before form submission.
+ * Instance id is injected at render time: { ...selectContract, id: instanceId }
+ */
+export declare const selectContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Separator component.
+ *
+ * Expresses that a Separator is a visual or semantic divider — display only.
+ * When decorative=true, it carries no semantic meaning. When decorative=false,
+ * agents can use it to understand structural grouping of adjacent content.
+ * Instance id is injected at render time: { ...separatorContract, id: instanceId }
+ */
+export declare const separatorContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Spinner component.
+ *
+ * Expresses that a Spinner signals an in-progress loading state — display only.
+ * Agents check for a Spinner's presence to detect when the application is busy.
+ * Instance id is injected at render time: { ...spinnerContract, id: instanceId }
+ */
+export declare const spinnerContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Switch component.
+ *
+ * Expresses that a Switch toggles a binary on/off state. The toggle is
+ * reversible — the user can switch back at any time.
+ * Instance id is injected at render time: { ...switchContract, id: instanceId }
+ */
+export declare const switchContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Tabs component.
+ *
+ * Expresses that a Tabs component navigates between content panels.
+ * Activating a tab changes the visible panel — no data is submitted or deleted.
+ * Instance id is injected at render time: { ...tabsContract, id: instanceId }
+ */
+export declare const tabsContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Textarea component.
+ *
+ * Expresses that a Textarea accepts multi-line text input. Reversible because
+ * the user can edit or clear the content before form submission.
+ * Instance id is injected at render time: { ...textareaContract, id: instanceId }
+ */
+export declare const textareaContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Toast component.
+ *
+ * Expresses that a Toast is a transient notification — display only,
+ * no data mutation. Agents read toast content to confirm prior actions succeeded.
+ * Instance id is injected at render time: { ...toastContract, id: instanceId }
+ */
+export declare const toastContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Tooltip component.
+ *
+ * Expresses that a Tooltip displays supplementary information on hover or focus.
+ * Display only — no user action, no data mutation.
+ * Instance id is injected at render time: { ...tooltipContract, id: instanceId }
+ */
+export declare const tooltipContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+export { }

package/dist/contracts.js

@@ -0,0 +1,25 @@
+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";
+export {
+  r as alertContract,
+  o as badgeContract,
+  s as breadcrumbContract,
+  c as buttonContract,
+  n as cardContract,
+  C as checkboxContract,
+  e as dialogContract,
+  p as drawerContract,
+  i as formContract,
+  b as inputContract,
+  d as paginationContract,
+  g as popoverContract,
+  l as progressContract,
+  m as radioContract,
+  u as selectContract,
+  f as separatorContract,
+  h as spinnerContract,
+  x as switchContract,
+  k as tabsContract,
+  v as textareaContract,
+  w as toastContract,
+  j as tooltipContract
+};

package/dist/errors.cjs

@@ -0,0 +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;

package/dist/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base error class for all errors thrown by VhyxUI.
+ *
+ * In development: thrown with a helpful message and suggestion.
+ * In production: caught by component boundaries, logged to console.error.
+ * The visual layer never breaks because of VhyxUI internal errors.
+ */
+export declare class VhyxUIError extends Error {
+    /** Machine readable error code — use this for programmatic error handling. */
+    readonly code: VhyxUIErrorCode;
+    /** Concrete action the developer should take to fix this error. */
+    readonly suggestion: string | undefined;
+    /** Structured context relevant to this specific error instance. */
+    readonly context: Record<string, unknown> | undefined;
+    constructor(options: VhyxUIErrorOptions);
+}
+
+/**
+ * All error codes thrown by VhyxUI.
+ *
+ * SCREAMING_SNAKE_CASE. Every code prefixed with VHYXUI_.
+ * Never remove or rename codes — components and tooling may depend on them.
+ */
+export declare enum VhyxUIErrorCode {
+    VHYXUI_MISSING_CONTEXT = "VHYXUI_MISSING_CONTEXT",
+    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"
+}
+
+/** Configuration object passed to the VhyxUIError constructor. */
+export declare interface VhyxUIErrorOptions {
+    /** Machine readable error code from VhyxUIErrorCode. */
+    code: VhyxUIErrorCode;
+    /** Human readable description of what went wrong. */
+    message: string;
+    /** Concrete action the developer should take to fix this error. */
+    suggestion?: string;
+    /** Structured context relevant to this specific error instance. */
+    context?: Record<string, unknown>;
+}
+
+export { }

package/dist/errors.js

@@ -0,0 +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 {
+  constructor(_) {
+    super(_.message), this.name = "VhyxUIError", this.code = _.code, this.suggestion = _.suggestion, this.context = _.context;
+  }
+}
+export {
+  T as VhyxUIError,
+  S as VhyxUIErrorCode
+};

package/dist/index.cjs

@@ -0,0 +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;

package/dist/index.d.ts

@@ -0,0 +1,367 @@
+import { ComponentContract } from '@vhyxseal/core';
+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 Alert component.
+ *
+ * Expresses that an Alert is a persistent in-page notification — display only.
+ * Unlike Toast, Alert persists until explicitly dismissed by the user or application.
+ * Instance id is injected at render time: { ...alertContract, id: instanceId }
+ */
+export declare const alertContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/** Alignment along the cross-axis of a positioned element. */
+export declare type Align = 'start' | 'center' | 'end';
+
+/**
+ * Default VhyxSeal contract template for the Badge component.
+ *
+ * Expresses that a Badge is a small status indicator — display only.
+ * Agents read badge content to understand counts, states, or labels.
+ * Instance id is injected at render time: { ...badgeContract, id: instanceId }
+ */
+export declare const badgeContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Breadcrumb component.
+ *
+ * Expresses that a Breadcrumb shows the current page location within a hierarchy
+ * and provides navigation links to ancestor pages.
+ * Instance id is injected at render time: { ...breadcrumbContract, id: instanceId }
+ */
+export declare const breadcrumbContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Button component.
+ *
+ * Expresses that a Button triggers a low-safety action. The destructive variant
+ * merges safetyLevel: 'high' and destructive: true at runtime in the React component
+ * (DECISION-014). This base contract covers all non-destructive variants.
+ * Instance id is injected at render time: { ...buttonContract, id: instanceId }
+ */
+export declare const buttonContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Card component.
+ *
+ * Expresses that a Card is a content container — display only by default.
+ * When interactive=true, the developer should override intent to 'trigger-action'
+ * or 'navigate' as appropriate for the card's clickable behaviour.
+ * Instance id is injected at render time: { ...cardContract, id: instanceId }
+ */
+export declare const cardContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Checkbox component.
+ *
+ * Expresses that a Checkbox toggles a boolean or indeterminate selection state.
+ * The toggle is reversible — the user can uncheck before form submission.
+ * Instance id is injected at render time: { ...checkboxContract, id: instanceId }
+ */
+export declare const checkboxContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/** Semantic color variant — maps to the token color scale. */
+export declare type ColorVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';
+
+export { ComponentContract }
+
+export { ContractComponentType }
+
+/**
+ * Default VhyxSeal contract template for the Dialog component.
+ *
+ * Expresses that a Dialog opens a modal overlay requiring user interaction.
+ * type 'confirmation' signals to agents that the dialog interrupts flow and
+ * must be resolved (confirmed or dismissed) before proceeding.
+ * Safety of the dialog's contents is determined by its child contracts.
+ * Instance id is injected at render time: { ...dialogContract, id: instanceId }
+ */
+export declare const dialogContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Drawer component.
+ *
+ * Expresses that a Drawer slides in a panel from a screen edge. Navigation type
+ * because drawers typically expose navigation or contextual content, not confirmations.
+ * Instance id is injected at render time: { ...drawerContract, id: instanceId }
+ */
+export declare const drawerContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Form component.
+ *
+ * Expresses that a Form collects and submits user data. Submission is not
+ * reversible — the agent must be certain fields are correct before triggering.
+ * safetyLevel medium because form submission typically writes to external systems.
+ * Instance id is injected at render time: { ...formContract, id: instanceId }
+ */
+export declare const formContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Input component.
+ *
+ * Expresses that an Input accepts user text. The field value is reversible —
+ * the user can clear or modify the input before the parent form is submitted.
+ * Instance id is injected at render time: { ...inputContract, id: instanceId }
+ */
+export declare const inputContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Merges slot props onto child props.
+ *
+ * Rules:
+ * - Event handlers: compose — both slot and child handlers are called (slot first).
+ * - className: concatenate with a space separator.
+ * - style: merge objects — child values override slot values.
+ * - All other props: child value overrides slot value.
+ *
+ * @param slotProps - Props from the Slot component (defaults / additions).
+ * @param childProps - Props from the child element being slotted into.
+ * @returns Merged props object ready to spread onto the cloned child element.
+ */
+export declare function mergeProps(slotProps: Record<string, unknown>, childProps: Record<string, unknown>): Record<string, unknown>;
+
+/**
+ * Merges multiple React refs into a single callback ref.
+ *
+ * Handles RefObject (created by createRef/useRef) and callback refs.
+ * Null and undefined entries are skipped safely.
+ *
+ * @param refs - Any number of React refs to merge. Null and undefined are accepted.
+ * @returns A single callback ref that sets all provided refs when called.
+ */
+export declare function mergeRefs<T>(...refs: ReadonlyArray<default_2.Ref<T> | null | undefined>): default_2.RefCallback<T>;
+
+/** Layout or scroll orientation. */
+export declare type Orientation = 'horizontal' | 'vertical';
+
+/**
+ * Default VhyxSeal contract template for the Pagination component.
+ *
+ * Expresses that Pagination navigates between pages of a data set.
+ * Page changes update the visible content slice — no data is mutated.
+ * Instance id is injected at render time: { ...paginationContract, id: instanceId }
+ */
+export declare const paginationContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Popover component.
+ *
+ * Expresses that a Popover opens a non-modal floating panel anchored to a trigger.
+ * Unlike Dialog, a Popover does not block the rest of the page.
+ * Instance id is injected at render time: { ...popoverContract, id: instanceId }
+ */
+export declare const popoverContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Progress component.
+ *
+ * Expresses that a Progress bar is a visual indicator of completion — display only.
+ * Agents read value and max to determine how far along an operation is.
+ * Instance id is injected at render time: { ...progressContract, id: instanceId }
+ */
+export declare const progressContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the RadioGroup component.
+ *
+ * Expresses that a RadioGroup captures a mutually exclusive selection.
+ * The selection is reversible — a different option can be chosen before form submission.
+ * Instance id is injected at render time: { ...radioContract, id: instanceId }
+ */
+export declare const radioContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+export { SafetyLevel }
+
+/**
+ * Default VhyxSeal contract template for the Select component.
+ *
+ * Expresses that a Select allows the user to choose one option from a list.
+ * The selection is reversible — another option can be chosen before form submission.
+ * Instance id is injected at render time: { ...selectContract, id: instanceId }
+ */
+export declare const selectContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Separator component.
+ *
+ * Expresses that a Separator is a visual or semantic divider — display only.
+ * When decorative=true, it carries no semantic meaning. When decorative=false,
+ * agents can use it to understand structural grouping of adjacent content.
+ * Instance id is injected at render time: { ...separatorContract, id: instanceId }
+ */
+export declare const separatorContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/** Positional side relative to a trigger or anchor element. */
+export declare type Side = 'top' | 'right' | 'bottom' | 'left';
+
+/** Component size — xs through xl. Used across all sized components. */
+export declare type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+/**
+ * Slot — the asChild pattern implementation.
+ *
+ * Merges its own props onto its immediate child element, allowing a parent
+ * component to pass behaviour (event handlers, className, style, ARIA attributes)
+ * through to a developer-supplied element without wrapping it in an extra DOM node.
+ *
+ * Merge rules (handled by mergeProps):
+ * - Event handlers: both slot and child handlers are called (slot fires first).
+ * - className: concatenated with a space.
+ * - style: merged as objects (child values override slot values).
+ * - All other props: child value overrides slot default.
+ *
+ * Zero Radix dependency — per DECISION-012.
+ */
+export declare const Slot: default_2.ForwardRefExoticComponent<SlotProps & default_2.RefAttributes<HTMLElement>>;
+
+/** Props accepted by the Slot component. Extends all standard HTML element attributes. */
+export declare interface SlotProps extends default_2.HTMLAttributes<HTMLElement> {
+    /** The single child element whose props will be merged with the Slot's own props. */
+    children?: default_2.ReactNode;
+}
+
+/**
+ * Default VhyxSeal contract template for the Spinner component.
+ *
+ * Expresses that a Spinner signals an in-progress loading state — display only.
+ * Agents check for a Spinner's presence to detect when the application is busy.
+ * Instance id is injected at render time: { ...spinnerContract, id: instanceId }
+ */
+export declare const spinnerContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Switch component.
+ *
+ * Expresses that a Switch toggles a binary on/off state. The toggle is
+ * reversible — the user can switch back at any time.
+ * Instance id is injected at render time: { ...switchContract, id: instanceId }
+ */
+export declare const switchContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Tabs component.
+ *
+ * Expresses that a Tabs component navigates between content panels.
+ * Activating a tab changes the visible panel — no data is submitted or deleted.
+ * Instance id is injected at render time: { ...tabsContract, id: instanceId }
+ */
+export declare const tabsContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Textarea component.
+ *
+ * Expresses that a Textarea accepts multi-line text input. Reversible because
+ * the user can edit or clear the content before form submission.
+ * Instance id is injected at render time: { ...textareaContract, id: instanceId }
+ */
+export declare const textareaContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Toast component.
+ *
+ * Expresses that a Toast is a transient notification — display only,
+ * no data mutation. Agents read toast content to confirm prior actions succeeded.
+ * Instance id is injected at render time: { ...toastContract, id: instanceId }
+ */
+export declare const toastContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Default VhyxSeal contract template for the Tooltip component.
+ *
+ * Expresses that a Tooltip displays supplementary information on hover or focus.
+ * Display only — no user action, no data mutation.
+ * Instance id is injected at render time: { ...tooltipContract, id: instanceId }
+ */
+export declare const tooltipContract: Readonly<Omit<ComponentContract, "id"> & {
+    readonly fingerprint: string;
+}>;
+
+/**
+ * Base error class for all errors thrown by VhyxUI.
+ *
+ * In development: thrown with a helpful message and suggestion.
+ * In production: caught by component boundaries, logged to console.error.
+ * The visual layer never breaks because of VhyxUI internal errors.
+ */
+export declare class VhyxUIError extends Error {
+    /** Machine readable error code — use this for programmatic error handling. */
+    readonly code: VhyxUIErrorCode;
+    /** Concrete action the developer should take to fix this error. */
+    readonly suggestion: string | undefined;
+    /** Structured context relevant to this specific error instance. */
+    readonly context: Record<string, unknown> | undefined;
+    constructor(options: VhyxUIErrorOptions);
+}
+
+/**
+ * All error codes thrown by VhyxUI.
+ *
+ * SCREAMING_SNAKE_CASE. Every code prefixed with VHYXUI_.
+ * Never remove or rename codes — components and tooling may depend on them.
+ */
+export declare enum VhyxUIErrorCode {
+    VHYXUI_MISSING_CONTEXT = "VHYXUI_MISSING_CONTEXT",
+    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"
+}
+
+/** Configuration object passed to the VhyxUIError constructor. */
+export declare interface VhyxUIErrorOptions {
+    /** Machine readable error code from VhyxUIErrorCode. */
+    code: VhyxUIErrorCode;
+    /** Human readable description of what went wrong. */
+    message: string;
+    /** Concrete action the developer should take to fix this error. */
+    suggestion?: string;
+    /** Structured context relevant to this specific error instance. */
+    context?: Record<string, unknown>;
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,32 @@
+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";
+export {
+  c as Slot,
+  r as VhyxUIError,
+  o as VhyxUIErrorCode,
+  p as alertContract,
+  i as badgeContract,
+  m as breadcrumbContract,
+  d as buttonContract,
+  b as cardContract,
+  g as checkboxContract,
+  x as dialogContract,
+  f as drawerContract,
+  l as formContract,
+  h as inputContract,
+  n as mergeProps,
+  e as mergeRefs,
+  u 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
+};

package/dist/pagination-BC8m1q01.js

@@ -0,0 +1,312 @@
+import { defineContractTemplate as e } from "@vhyxseal/core";
+const s = e({
+  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({
+  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"
+}), i = e({
+  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"
+}), n = e({
+  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"
+}), a = e({
+  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"
+}), o = e({
+  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"
+}), c = e({
+  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"
+}), l = e({
+  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"
+}), u = e({
+  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({
+  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({
+  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"
+}), p = e({
+  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"
+}), v = e({
+  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"
+}), y = e({
+  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"
+}), m = e({
+  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"
+}), q = e({
+  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"
+}), g = e({
+  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"
+}), b = e({
+  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"
+}), h = e({
+  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"
+}), C = e({
+  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"
+}), w = e({
+  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"
+}), P = e({
+  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"
+});
+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,
+  P as p,
+  i as q,
+  o as r,
+  n as s,
+  C as t,
+  u,
+  q as v
+};

package/dist/pagination-DMKZiFFW.cjs

@@ -0,0 +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;

package/dist/slot.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./Slot-CLNJSabn.cjs");exports.Slot=e.Slot;exports.mergeProps=e.mergeProps;exports.mergeRefs=e.mergeRefs;

package/dist/slot.d.ts

@@ -0,0 +1,52 @@
+import { default as default_2 } from 'react';
+
+/**
+ * Merges slot props onto child props.
+ *
+ * Rules:
+ * - Event handlers: compose — both slot and child handlers are called (slot first).
+ * - className: concatenate with a space separator.
+ * - style: merge objects — child values override slot values.
+ * - All other props: child value overrides slot value.
+ *
+ * @param slotProps - Props from the Slot component (defaults / additions).
+ * @param childProps - Props from the child element being slotted into.
+ * @returns Merged props object ready to spread onto the cloned child element.
+ */
+export declare function mergeProps(slotProps: Record<string, unknown>, childProps: Record<string, unknown>): Record<string, unknown>;
+
+/**
+ * Merges multiple React refs into a single callback ref.
+ *
+ * Handles RefObject (created by createRef/useRef) and callback refs.
+ * Null and undefined entries are skipped safely.
+ *
+ * @param refs - Any number of React refs to merge. Null and undefined are accepted.
+ * @returns A single callback ref that sets all provided refs when called.
+ */
+export declare function mergeRefs<T>(...refs: ReadonlyArray<default_2.Ref<T> | null | undefined>): default_2.RefCallback<T>;
+
+/**
+ * Slot — the asChild pattern implementation.
+ *
+ * Merges its own props onto its immediate child element, allowing a parent
+ * component to pass behaviour (event handlers, className, style, ARIA attributes)
+ * through to a developer-supplied element without wrapping it in an extra DOM node.
+ *
+ * Merge rules (handled by mergeProps):
+ * - Event handlers: both slot and child handlers are called (slot fires first).
+ * - className: concatenated with a space.
+ * - style: merged as objects (child values override slot values).
+ * - All other props: child value overrides slot default.
+ *
+ * Zero Radix dependency — per DECISION-012.
+ */
+export declare const Slot: default_2.ForwardRefExoticComponent<SlotProps & default_2.RefAttributes<HTMLElement>>;
+
+/** Props accepted by the Slot component. Extends all standard HTML element attributes. */
+export declare interface SlotProps extends default_2.HTMLAttributes<HTMLElement> {
+    /** The single child element whose props will be merged with the Slot's own props. */
+    children?: default_2.ReactNode;
+}
+
+export { }

package/dist/slot.js

@@ -0,0 +1,6 @@
+import { S as s, m as a, a as m } from "./Slot-PvMbF2q3.js";
+export {
+  s as Slot,
+  a as mergeProps,
+  m as mergeRefs
+};

package/dist/types.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+/** Alignment along the cross-axis of a positioned element. */
+export declare type Align = 'start' | 'center' | 'end';
+
+/** Semantic color variant — maps to the token color scale. */
+export declare type ColorVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';
+
+/** Layout or scroll orientation. */
+export declare type Orientation = 'horizontal' | 'vertical';
+
+/** Positional side relative to a trigger or anchor element. */
+export declare type Side = 'top' | 'right' | 'bottom' | 'left';
+
+/** Component size — xs through xl. Used across all sized components. */
+export declare type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+export { }

package/dist/types.js

@@ -0,0 +1 @@
+

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@vhyxui/core",
+  "version": "0.1.0-alpha.1",
+  "description": "VhyxUI core — shared types, contracts, slot, and error infrastructure",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./contracts": {
+      "import": "./dist/contracts.js",
+      "require": "./dist/contracts.cjs",
+      "types": "./dist/contracts.d.ts"
+    },
+    "./slot": {
+      "import": "./dist/slot.js",
+      "require": "./dist/slot.cjs",
+      "types": "./dist/slot.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/errors.js",
+      "require": "./dist/errors.cjs",
+      "types": "./dist/errors.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@vhyxseal/core": "1.0.0-rc.2"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --project tsconfig.test.json --noEmit",
+    "lint": "eslint src"
+  }
+}