@echojs-ecosystem/ui 0.1.0

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme/default-theme.ts","../src/theme/create-theme.ts","../src/theme/theme-context.ts","../src/theme/variants.ts"],"names":[],"mappings":"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","file":"theme.js","sourcesContent":["import type { UITheme } from \"./types\";\n\n/** Built-in theme used when no provider is mounted. */\nexport const defaultTheme: UITheme = {\n  prefix: \"echo\",\n  headless: false,\n  components: {\n    button: {\n      defaultVariants: {\n        variant: \"primary\",\n        size: \"md\",\n        radius: \"full\",\n      },\n    },\n    input: {\n      defaultVariants: {\n        variant: \"outline\",\n        size: \"md\",\n      },\n    },\n    inputMask: {\n      defaultVariants: {\n        variant: \"outline\",\n        size: \"md\",\n      },\n    },\n    inputOtp: {\n      defaultVariants: {\n        variant: \"outline\",\n        size: \"md\",\n      },\n    },\n    inputTags: {\n      defaultVariants: {\n        variant: \"outline\",\n        size: \"md\",\n      },\n    },\n    textarea: {\n      defaultVariants: {\n        variant: \"outline\",\n        size: \"md\",\n        resize: \"vertical\",\n      },\n    },\n    checkbox: {\n      defaultVariants: {\n        size: \"md\",\n      },\n    },\n    iconButton: {\n      defaultVariants: {\n        variant: \"ghost\",\n        size: \"md\",\n      },\n    },\n  },\n};\n","import { defaultTheme } from \"./default-theme\";\nimport type { ComponentThemeConfig, UITheme } from \"./types\";\n\nconst mergeComponentConfig = (\n  base: ComponentThemeConfig | undefined,\n  next: ComponentThemeConfig | undefined,\n): ComponentThemeConfig | undefined => {\n  if (!base && !next) return undefined;\n  if (!base) return next ? { ...next } : undefined;\n  if (!next) return { ...base };\n\n  return {\n    baseClass: next.baseClass ?? base.baseClass,\n    className: next.className ?? base.className,\n    defaultProps: { ...base.defaultProps, ...next.defaultProps },\n    defaultVariants: { ...base.defaultVariants, ...next.defaultVariants },\n    variants: { ...base.variants, ...next.variants },\n  };\n};\n\nconst mergeComponents = (\n  base: UITheme[\"components\"],\n  next: UITheme[\"components\"],\n): UITheme[\"components\"] => {\n  const keys = new Set([...Object.keys(base ?? {}), ...Object.keys(next ?? {})]);\n  const merged: Record<string, ComponentThemeConfig> = {};\n\n  for (const key of keys) {\n    const slice = mergeComponentConfig(base?.[key], next?.[key]);\n    if (slice) merged[key] = slice;\n  }\n\n  return merged;\n};\n\n/**\n * Merges partial theme config into a base theme (defaults to {@link defaultTheme}).\n */\nexport const createTheme = (input: Partial<UITheme>, base: UITheme = defaultTheme): UITheme => ({\n  prefix: input.prefix ?? base.prefix,\n  headless: input.headless ?? base.headless,\n  components: mergeComponents(base.components, input.components),\n});\n","import { createTheme } from \"./create-theme\";\nimport { defaultTheme } from \"./default-theme\";\nimport type { UITheme } from \"./types\";\n\n/** Resolved runtime configuration from {@link UIProvider}. */\nexport type UIContextValue = {\n  theme: UITheme;\n  headless: boolean;\n};\n\nconst stack: UIContextValue[] = [];\n\n/** Returns the active UI context or `undefined` outside a provider. */\nexport const getUIContext = (): UIContextValue | undefined => stack[stack.length - 1];\n\n/** Returns the active UI context, falling back to defaults. */\nexport const getUIContextOrDefault = (): UIContextValue => getUIContext() ?? createUIContextValue({});\n\nexport type CreateUIContextInput = {\n  theme?: Partial<UITheme>;\n  headless?: boolean;\n};\n\n/** Builds a fully resolved context value from partial provider props. */\nexport const createUIContextValue = (\n  input: CreateUIContextInput,\n  parent: UIContextValue | undefined = getUIContext(),\n): UIContextValue => {\n  const parentTheme = parent?.theme ?? defaultTheme;\n  const theme = createTheme(input.theme ?? {}, parentTheme);\n\n  const headless = input.headless ?? theme.headless ?? parent?.headless ?? false;\n\n  return {\n    theme: { ...theme, headless },\n    headless,\n  };\n};\n\n/** Runs `fn` with `value` pushed onto the UI context stack. */\nexport const runWithUIContext = <T>(value: UIContextValue, fn: () => T): T => {\n  stack.push(value);\n  try {\n    return fn();\n  } finally {\n    stack.pop();\n  }\n};\n\n/** @internal Resets the context stack — for tests only. */\nexport const resetUIContextStack = (): void => {\n  stack.length = 0;\n};\n","/**\n * Stage 1 note:\n * We keep a small abstraction layer around variant class resolution so we can\n * plug `tailwind-variants` later without changing component code.\n */\n\nexport type TVVariantsShape = Record<string, Record<string, string>>;\nexport type TVBooleanVariantShape = Record<string, { true?: string; false?: string }>;\n\nexport type TVCompoundVariant = Record<string, string | boolean> & { class: string };\n\nexport type TVConfig = {\n  base?: string;\n  variants?: TVVariantsShape & TVBooleanVariantShape;\n  compoundVariants?: TVCompoundVariant[];\n  defaultVariants?: Record<string, string | boolean>;\n  slots?: Record<string, string>;\n};\n\nexport type TVSlotResult<T extends TVConfig & { slots: Record<string, string> }> = {\n  [K in keyof T[\"slots\"]]: (slotOptions?: Record<string, unknown>) => string;\n} & { _config: T };\n\nexport type TVResult<T extends TVConfig> = T extends { slots: Record<string, any> }\n  ? TVSlotResult<T & { slots: Record<string, string> }>\n  : ((options?: Record<string, unknown>) => string) & { _config: T };\n\n/** Roughly compatible `tv()` subset (Stage 2). */\nexport const tv = <T extends TVConfig>(config: T): TVResult<T> => {\n  const resolve = (options?: Record<string, unknown>): string => {\n    const parts: string[] = [];\n    if (config.base) parts.push(config.base);\n\n    const resolved = { ...(config.defaultVariants ?? {}), ...(options ?? {}) } as Record<\n      string,\n      string | boolean | undefined\n    >;\n\n    const variants = config.variants ?? {};\n    for (const [variantName, map] of Object.entries(variants)) {\n      const value = resolved[variantName];\n      if (value === undefined) continue;\n\n      const key = typeof value === \"boolean\" ? (value ? \"true\" : \"false\") : String(value);\n      const cls = (map as any)[key] as string | undefined;\n      if (cls) parts.push(cls);\n    }\n\n    for (const compound of config.compoundVariants ?? []) {\n      const { class: compoundClass, ...conditions } = compound;\n      const matches = Object.entries(conditions).every(([name, value]) => resolved[name] === value);\n      if (matches && compoundClass) parts.push(compoundClass);\n    }\n\n    return parts.filter(Boolean).join(\" \");\n  };\n\n  if (config.slots) {\n    const slotFns: any = {};\n    for (const [slot, slotBase] of Object.entries(config.slots)) {\n      slotFns[slot] = (slotOptions?: Record<string, unknown>) => {\n        const composed = [slotBase, resolve(slotOptions)].filter(Boolean).join(\" \");\n        return composed.trim();\n      };\n    }\n    slotFns._config = config;\n    return slotFns as TVResult<T>;\n  }\n\n  const fn: any = (options?: Record<string, unknown>) => resolve(options);\n  fn._config = config;\n  return fn as TVResult<T>;\n};\n\nexport type VariantProps<T> = T extends { _config: infer C }\n  ? C extends { variants: infer V }\n    ? {\n        [K in keyof V]?: V[K] extends Record<infer Key, any>\n          ? Key extends \"true\" | \"false\"\n            ? boolean\n            : Key\n          : never;\n      }\n    : Record<string, never>\n  : Record<string, never>;\n\n/** Compatibility export (mirrors tailwind-variants). */\nexport const createComponentVariants = tv;\n\n/**\n * Resolves variant classes when styling is enabled.\n */\nexport const resolveVariantClasses = (\n  variantFn: ((options?: Record<string, unknown>) => string) | undefined,\n  options: Record<string, unknown> | undefined,\n  headless: boolean,\n): string | undefined => {\n  if (headless || !variantFn) return undefined;\n  return variantFn(options);\n};\n"]}

package/dist/types-CSHcGa_F.d.ts

@@ -0,0 +1,13 @@
+import { Child } from '@echojs-ecosystem/hyperdom';
+import { C as ClassValue } from './cn-rGlUI2mx.js';
+
+/** Base props supported by all UI components. */
+type UIComponentBaseProps = {
+    /** Skip visual/theme classes while keeping semantics and behavior. */
+    headless?: boolean;
+    class?: ClassValue;
+    className?: ClassValue;
+    children?: Child;
+};
+
+export type { UIComponentBaseProps as U };

package/dist/utils.d.ts

@@ -0,0 +1,36 @@
+export { a as ClassDictionary, b as ClassNameMerger, C as ClassValue, c as cn, r as resetClassNameMerger, s as setClassNameMerger } from './cn-rGlUI2mx.js';
+
+type MergeableProps = Record<string, unknown>;
+/**
+ * Merges props with priority (lowest → highest): `defaultProps`, `providerProps`, `componentProps`.
+ *
+ * `class` / `className` are joined; event handlers are composed.
+ */
+declare const mergeProps: <T extends MergeableProps>(defaultProps: MergeableProps | undefined, providerProps: MergeableProps | undefined, componentProps: T) => T;
+
+type RefCallback<T> = (instance: T | null) => void;
+type RefValue<T> = RefCallback<T> | null | undefined;
+/**
+ * Merges multiple ref callbacks into one.
+ */
+declare const mergeRefs: <T>(...refs: RefValue<T>[]) => RefCallback<T> | undefined;
+
+type ComposeEventHandlersOptions = {
+    /** When true, skips `internalHandler` if `userHandler` called `preventDefault`. */
+    checkDefaultPrevented?: boolean;
+};
+type EventHandler<E extends Event = Event> = (event: E) => void;
+/**
+ * Composes two event handlers. `userHandler` runs first.
+ */
+declare const composeEventHandlers: <E extends Event>(userHandler: EventHandler<E> | undefined, internalHandler: EventHandler<E> | undefined, options?: ComposeEventHandlersOptions) => EventHandler<E> | undefined;
+
+type DataAttributeProps = Record<`data-${string}`, string | number | boolean | undefined>;
+/** `data-state` helper for styling hooks. */
+declare const dataState: (value: string) => DataAttributeProps;
+/** `data-disabled` — present when disabled. */
+declare const dataDisabled: (disabled?: boolean) => DataAttributeProps;
+/** `data-invalid` — present when invalid. */
+declare const dataInvalid: (invalid?: boolean) => DataAttributeProps;
+
+export { type ComposeEventHandlersOptions, type MergeableProps, composeEventHandlers, dataDisabled, dataInvalid, dataState, mergeProps, mergeRefs };

package/dist/utils.js

@@ -0,0 +1,101 @@
+// src/utils/cn.ts
+var defaultClassNameMerger = (...values) => {
+  const out = [];
+  const walk = (value) => {
+    if (value == null || value === false) return;
+    if (typeof value === "string") {
+      if (value) out.push(value);
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) walk(item);
+      return;
+    }
+    for (const [key, enabled] of Object.entries(value)) {
+      if (enabled) out.push(key);
+    }
+  };
+  for (const value of values) walk(value);
+  return out.join(" ");
+};
+var classNameMerger = defaultClassNameMerger;
+var setClassNameMerger = (merger) => {
+  classNameMerger = merger;
+};
+var resetClassNameMerger = () => {
+  classNameMerger = defaultClassNameMerger;
+};
+var cn = (...values) => classNameMerger(...values);
+
+// src/utils/compose-event-handlers.ts
+var composeEventHandlers = (userHandler, internalHandler, options = {}) => {
+  if (!userHandler && !internalHandler) return void 0;
+  if (!userHandler) return internalHandler;
+  if (!internalHandler) return userHandler;
+  const { checkDefaultPrevented = false } = options;
+  return (event) => {
+    userHandler(event);
+    if (checkDefaultPrevented && event?.defaultPrevented) return;
+    internalHandler(event);
+  };
+};
+
+// src/utils/merge-props.ts
+var CLASS_KEYS = /* @__PURE__ */ new Set(["class", "className"]);
+var isEventHandlerKey = (key) => key.startsWith("on") || key.startsWith("on:");
+var mergeClassValues = (...values) => {
+  const merged = cn(...values);
+  return merged || void 0;
+};
+var mergePair = (target, source) => {
+  if (!source) return;
+  for (const [key, value] of Object.entries(source)) {
+    if (value === void 0) continue;
+    if (CLASS_KEYS.has(key)) {
+      const mergedClass = mergeClassValues(target.className, value);
+      if (mergedClass !== void 0) {
+        target.className = mergedClass;
+        target.class = mergedClass;
+      }
+      continue;
+    }
+    if (isEventHandlerKey(key)) {
+      const existing = target[key];
+      target[key] = composeEventHandlers(
+        value,
+        existing,
+        { checkDefaultPrevented: true }
+      );
+      continue;
+    }
+    target[key] = value;
+  }
+};
+var mergeProps = (defaultProps, providerProps, componentProps) => {
+  const merged = {};
+  mergePair(merged, defaultProps);
+  mergePair(merged, providerProps);
+  mergePair(merged, componentProps);
+  return merged;
+};
+
+// src/utils/merge-refs.ts
+var mergeRefs = (...refs) => {
+  const filtered = refs.filter(Boolean);
+  if (filtered.length === 0) return void 0;
+  if (filtered.length === 1) return filtered[0];
+  return (instance) => {
+    for (const ref of filtered) ref(instance);
+  };
+};
+
+// src/utils/data-attributes.ts
+var dataState = (value) => ({
+  "data-state": value
+});
+var dataDisabled = (disabled) => disabled ? { "data-disabled": "" } : {};
+var dataInvalid = (invalid) => invalid ? { "data-invalid": "" } : {};
+
+export { cn, composeEventHandlers, dataDisabled, dataInvalid, dataState, mergeProps, mergeRefs, resetClassNameMerger, setClassNameMerger };
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/cn.ts","../src/utils/compose-event-handlers.ts","../src/utils/merge-props.ts","../src/utils/merge-refs.ts","../src/utils/data-attributes.ts"],"names":[],"mappings":"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","file":"utils.js","sourcesContent":["export type ClassDictionary = Record<string, boolean | null | undefined>;\nexport type ClassValue =\n  | string\n  | null\n  | undefined\n  | false\n  | ClassDictionary\n  | readonly ClassValue[];\n\n/** Optional hook to swap in tailwind-merge later. */\nexport type ClassNameMerger = (...values: ClassValue[]) => string;\n\nconst defaultClassNameMerger: ClassNameMerger = (...values) => {\n  const out: string[] = [];\n\n  const walk = (value: ClassValue): void => {\n    if (value == null || value === false) return;\n\n    if (typeof value === \"string\") {\n      if (value) out.push(value);\n      return;\n    }\n\n    if (Array.isArray(value)) {\n      for (const item of value) walk(item);\n      return;\n    }\n\n    for (const [key, enabled] of Object.entries(value)) {\n      if (enabled) out.push(key);\n    }\n  };\n\n  for (const value of values) walk(value);\n  return out.join(\" \");\n};\n\nlet classNameMerger: ClassNameMerger = defaultClassNameMerger;\n\n/** Replaces the global className merger (e.g. with tailwind-merge). */\nexport const setClassNameMerger = (merger: ClassNameMerger): void => {\n  classNameMerger = merger;\n};\n\n/** Resets the className merger to the built-in implementation. */\nexport const resetClassNameMerger = (): void => {\n  classNameMerger = defaultClassNameMerger;\n};\n\n/**\n * Joins class name fragments.\n *\n * Supports strings, arrays, conditional maps, and falsy values.\n */\nexport const cn: ClassNameMerger = (...values) => classNameMerger(...values);\n","export type ComposeEventHandlersOptions = {\n  /** When true, skips `internalHandler` if `userHandler` called `preventDefault`. */\n  checkDefaultPrevented?: boolean;\n};\n\ntype EventHandler<E extends Event = Event> = (event: E) => void;\n\n/**\n * Composes two event handlers. `userHandler` runs first.\n */\nexport const composeEventHandlers = <E extends Event>(\n  userHandler: EventHandler<E> | undefined,\n  internalHandler: EventHandler<E> | undefined,\n  options: ComposeEventHandlersOptions = {},\n): EventHandler<E> | undefined => {\n  if (!userHandler && !internalHandler) return undefined;\n  if (!userHandler) return internalHandler;\n  if (!internalHandler) return userHandler;\n\n  const { checkDefaultPrevented = false } = options;\n\n  return (event) => {\n    userHandler(event);\n    if (checkDefaultPrevented && event?.defaultPrevented) return;\n    internalHandler(event);\n  };\n};\n","import { composeEventHandlers } from \"./compose-event-handlers\";\nimport { cn, type ClassValue } from \"./cn\";\n\nexport type MergeableProps = Record<string, unknown>;\n\nconst CLASS_KEYS = new Set([\"class\", \"className\"]);\n\nconst isEventHandlerKey = (key: string): boolean =>\n  key.startsWith(\"on\") || key.startsWith(\"on:\");\n\nconst mergeClassValues = (...values: unknown[]): string | undefined => {\n  const merged = cn(...(values as ClassValue[]));\n  return merged || undefined;\n};\n\nconst mergePair = (target: MergeableProps, source: MergeableProps | undefined): void => {\n  if (!source) return;\n\n  for (const [key, value] of Object.entries(source)) {\n    if (value === undefined) continue;\n\n    if (CLASS_KEYS.has(key)) {\n      const mergedClass = mergeClassValues(target.className, value);\n      if (mergedClass !== undefined) {\n        target.className = mergedClass;\n        target.class = mergedClass;\n      }\n      continue;\n    }\n\n    if (isEventHandlerKey(key)) {\n      const existing = target[key];\n      target[key] = composeEventHandlers(\n        value as (...args: never[]) => void,\n        existing as (...args: never[]) => void,\n        { checkDefaultPrevented: true },\n      );\n      continue;\n    }\n\n    target[key] = value;\n  }\n};\n\n/**\n * Merges props with priority (lowest → highest): `defaultProps`, `providerProps`, `componentProps`.\n *\n * `class` / `className` are joined; event handlers are composed.\n */\nexport const mergeProps = <T extends MergeableProps>(\n  defaultProps: MergeableProps | undefined,\n  providerProps: MergeableProps | undefined,\n  componentProps: T,\n): T => {\n  const merged: MergeableProps = {};\n\n  mergePair(merged, defaultProps);\n  mergePair(merged, providerProps);\n  mergePair(merged, componentProps);\n\n  return merged as T;\n};\n","export type RefCallback<T> = (instance: T | null) => void;\nexport type RefValue<T> = RefCallback<T> | null | undefined;\n\n/**\n * Merges multiple ref callbacks into one.\n */\nexport const mergeRefs =\n  <T>(...refs: RefValue<T>[]): RefCallback<T> | undefined => {\n    const filtered = refs.filter(Boolean) as RefCallback<T>[];\n    if (filtered.length === 0) return undefined;\n    if (filtered.length === 1) return filtered[0];\n\n    return (instance) => {\n      for (const ref of filtered) ref(instance);\n    };\n  };\n","export type DataAttributeProps = Record<`data-${string}`, string | number | boolean | undefined>;\n\n/** `data-state` helper for styling hooks. */\nexport const dataState = (value: string): DataAttributeProps => ({\n  \"data-state\": value,\n});\n\n/** `data-disabled` — present when disabled. */\nexport const dataDisabled = (disabled?: boolean): DataAttributeProps =>\n  disabled ? { \"data-disabled\": \"\" } : {};\n\n/** `data-invalid` — present when invalid. */\nexport const dataInvalid = (invalid?: boolean): DataAttributeProps =>\n  invalid ? { \"data-invalid\": \"\" } : {};\n\n/** `data-pending` — present while async action is in progress (HeroUI-style). */\nexport const dataPending = (pending?: boolean): DataAttributeProps =>\n  pending ? { \"data-pending\": \"\" } : {};\n"]}

package/dist/variants-Bj38CFcH.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Stage 1 note:
+ * We keep a small abstraction layer around variant class resolution so we can
+ * plug `tailwind-variants` later without changing component code.
+ */
+type TVVariantsShape = Record<string, Record<string, string>>;
+type TVBooleanVariantShape = Record<string, {
+    true?: string;
+    false?: string;
+}>;
+type TVCompoundVariant = Record<string, string | boolean> & {
+    class: string;
+};
+type TVConfig = {
+    base?: string;
+    variants?: TVVariantsShape & TVBooleanVariantShape;
+    compoundVariants?: TVCompoundVariant[];
+    defaultVariants?: Record<string, string | boolean>;
+    slots?: Record<string, string>;
+};
+type TVSlotResult<T extends TVConfig & {
+    slots: Record<string, string>;
+}> = {
+    [K in keyof T["slots"]]: (slotOptions?: Record<string, unknown>) => string;
+} & {
+    _config: T;
+};
+type TVResult<T extends TVConfig> = T extends {
+    slots: Record<string, any>;
+} ? TVSlotResult<T & {
+    slots: Record<string, string>;
+}> : ((options?: Record<string, unknown>) => string) & {
+    _config: T;
+};
+/** Roughly compatible `tv()` subset (Stage 2). */
+declare const tv: <T extends TVConfig>(config: T) => TVResult<T>;
+type VariantProps<T> = T extends {
+    _config: infer C;
+} ? C extends {
+    variants: infer V;
+} ? {
+    [K in keyof V]?: V[K] extends Record<infer Key, any> ? Key extends "true" | "false" ? boolean : Key : never;
+} : Record<string, never> : Record<string, never>;
+/** Compatibility export (mirrors tailwind-variants). */
+declare const createComponentVariants: <T extends TVConfig>(config: T) => TVResult<T>;
+/**
+ * Resolves variant classes when styling is enabled.
+ */
+declare const resolveVariantClasses: (variantFn: ((options?: Record<string, unknown>) => string) | undefined, options: Record<string, unknown> | undefined, headless: boolean) => string | undefined;
+
+export { type TVConfig as T, type VariantProps as V, type TVSlotResult as a, createComponentVariants as c, resolveVariantClasses as r, tv as t };

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@echojs-ecosystem/ui",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./button": {
+      "types": "./dist/button.d.ts",
+      "import": "./dist/button.js",
+      "default": "./dist/button.js"
+    },
+    "./icon-button": {
+      "types": "./dist/icon-button.d.ts",
+      "import": "./dist/icon-button.js",
+      "default": "./dist/icon-button.js"
+    },
+    "./input": {
+      "types": "./dist/input.d.ts",
+      "import": "./dist/input.js",
+      "default": "./dist/input.js"
+    },
+    "./input-mask": {
+      "types": "./dist/input-mask.d.ts",
+      "import": "./dist/input-mask.js",
+      "default": "./dist/input-mask.js"
+    },
+    "./input-otp": {
+      "types": "./dist/input-otp.d.ts",
+      "import": "./dist/input-otp.js",
+      "default": "./dist/input-otp.js"
+    },
+    "./input-tags": {
+      "types": "./dist/input-tags.d.ts",
+      "import": "./dist/input-tags.js",
+      "default": "./dist/input-tags.js"
+    },
+    "./textarea": {
+      "types": "./dist/textarea.d.ts",
+      "import": "./dist/textarea.js",
+      "default": "./dist/textarea.js"
+    },
+    "./label": {
+      "types": "./dist/label.d.ts",
+      "import": "./dist/label.js",
+      "default": "./dist/label.js"
+    },
+    "./field": {
+      "types": "./dist/field.d.ts",
+      "import": "./dist/field.js",
+      "default": "./dist/field.js"
+    },
+    "./checkbox": {
+      "types": "./dist/checkbox.d.ts",
+      "import": "./dist/checkbox.js",
+      "default": "./dist/checkbox.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "default": "./dist/provider.js"
+    },
+    "./theme": {
+      "types": "./dist/theme.d.ts",
+      "import": "./dist/theme.js",
+      "default": "./dist/theme.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js",
+      "default": "./dist/core.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js",
+      "default": "./dist/utils.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives.d.ts",
+      "import": "./dist/primitives.js",
+      "default": "./dist/primitives.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "test:types": "tsc -p tsconfig.typing.json --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:vitest:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "storybook": "storybook dev -p 6006",
+    "storybook:build": "storybook build -o storybook-static"
+  },
+  "dependencies": {
+    "@echojs-ecosystem/hyperdom": "workspace:*"
+  },
+  "devDependencies": {
+    "@echojs-ecosystem/oxc-config": "workspace:*",
+    "@storybook/addon-a11y": "^8.6.14",
+    "@storybook/addon-essentials": "^8.6.14",
+    "@storybook/addon-links": "^8.6.14",
+    "@storybook/html": "^8.6.14",
+    "@storybook/html-vite": "^8.6.14",
+    "@tailwindcss/vite": "^4.1.8",
+    "jsdom": "^26.1.0",
+    "storybook": "^8.6.14",
+    "tailwindcss": "^4.1.8",
+    "typescript": "5.9.2",
+    "vite": "^6.0.0",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/echojs-ecosystem/echojs-core.git",
+    "directory": "packages/ui"
+  }
+}