@adia-ai/web-components 0.4.5 → 0.4.6

package/index.d.ts

@@ -0,0 +1,161 @@
+/**
+ * `@adia-ai/web-components` — public TypeScript declarations.
+ *
+ * Re-exports the core types + augments `HTMLElementTagNameMap` so
+ * `document.querySelector('slider-ui')` returns `UISlider` (typed),
+ * not `Element`.
+ *
+ * @see ./USAGE.md
+ */
+
+// ── Core utilities ──────────────────────────────────────────────────
+export * from './core/index.js';
+
+// ── Form-bearing primitives (typed) ─────────────────────────────────
+export type {
+  UIInput,
+  UIInputType,
+  InputChangeEvent,
+  InputInputEvent,
+  InputChangeEventDetail,
+} from './components/input/input.js';
+
+export type {
+  UISelect,
+  SelectOption,
+  SelectChangeEvent,
+  SelectActionEvent,
+  SelectChangeEventDetail,
+  SelectActionEventDetail,
+} from './components/select/select.js';
+
+export type {
+  UISlider,
+  SliderChangeEvent,
+  SliderInputEvent,
+  SliderChangeEventDetail,
+} from './components/slider/slider.js';
+
+export type {
+  UIRange,
+  RangeChangeEvent,
+  RangeInputEvent,
+  RangeChangeEventDetail,
+} from './components/range/range.js';
+
+export type {
+  UITextarea,
+  TextareaChangeEvent,
+  TextareaInputEvent,
+  TextareaChangeEventDetail,
+} from './components/textarea/textarea.js';
+
+export type {
+  UISwitch,
+  SwitchChangeEvent,
+  SwitchChangeEventDetail,
+} from './components/switch/switch.js';
+
+export type {
+  UICheck,
+  CheckChangeEvent,
+  CheckChangeEventDetail,
+} from './components/check/check.js';
+
+export type {
+  UIRadio,
+  RadioChangeEvent,
+  RadioChangeEventDetail,
+} from './components/radio/radio.js';
+
+export type {
+  UISegmented,
+  SegmentedChangeEvent,
+  SegmentedChangeEventDetail,
+} from './components/segmented/segmented.js';
+
+export type {
+  UISearch,
+  SearchInputEvent,
+  SearchEvent,
+  SearchInputEventDetail,
+  SearchEventDetail,
+} from './components/search/search.js';
+
+export type {
+  UIOtpInput,
+  OtpInputEvent,
+  OtpInputEventDetail,
+} from './components/otp-input/otp-input.js';
+
+export type {
+  UIOptionCard,
+  OptionCardChangeEvent,
+  OptionCardChangeEventDetail,
+} from './components/option-card/option-card.js';
+
+export type {
+  UIColorPicker,
+  ColorFormat,
+  ColorPickerChangeEvent,
+  ColorPickerInputEvent,
+  ColorPickerFormatChangeEvent,
+  ColorPickerChangeEventDetail,
+  ColorPickerFormatChangeEventDetail,
+} from './components/color-picker/color-picker.js';
+
+export type {
+  UIRating,
+  RatingChangeEvent,
+  RatingChangeEventDetail,
+} from './components/rating/rating.js';
+
+export type {
+  UICode,
+  CodeChangeEvent,
+  CodeInputEvent,
+  CodeChangeEventDetail,
+} from './components/code/code.js';
+
+export type {
+  UICalendarPicker,
+  CalendarPickerChangeEvent,
+  CalendarPickerChangeEventDetail,
+} from './components/calendar-picker/calendar-picker.js';
+
+export type {
+  UIUpload,
+  UploadChangeEvent,
+  UploadChangeEventDetail,
+} from './components/upload/upload.js';
+
+// ── Global HTMLElementTagNameMap augmentation ───────────────────────
+//
+// Tells TypeScript that `document.querySelector('slider-ui')` returns
+// `UISlider`, that `createElement('input-ui')` returns `UIInput`, etc.
+//
+// Note: only the typed primitives are listed here. Non-form primitives
+// (button-ui, card-ui, table-ui, etc.) will be added in subsequent
+// arcs as their .d.ts files land. Until then, querying for those tags
+// returns the base `HTMLElement` type.
+declare global {
+  interface HTMLElementTagNameMap {
+    'input-ui':           import('./components/input/input.js').UIInput;
+    'select-ui':          import('./components/select/select.js').UISelect;
+    'slider-ui':          import('./components/slider/slider.js').UISlider;
+    'range-ui':           import('./components/range/range.js').UIRange;
+    'textarea-ui':        import('./components/textarea/textarea.js').UITextarea;
+    'switch-ui':          import('./components/switch/switch.js').UISwitch;
+    'check-ui':           import('./components/check/check.js').UICheck;
+    'radio-ui':           import('./components/radio/radio.js').UIRadio;
+    'segmented-ui':       import('./components/segmented/segmented.js').UISegmented;
+    'search-ui':          import('./components/search/search.js').UISearch;
+    'otp-input-ui':       import('./components/otp-input/otp-input.js').UIOtpInput;
+    'option-card-ui':     import('./components/option-card/option-card.js').UIOptionCard;
+    'color-picker-ui':    import('./components/color-picker/color-picker.js').UIColorPicker;
+    'rating-ui':          import('./components/rating/rating.js').UIRating;
+    'code-ui':            import('./components/code/code.js').UICode;
+    'calendar-picker-ui': import('./components/calendar-picker/calendar-picker.js').UICalendarPicker;
+    'upload-ui':          import('./components/upload/upload.js').UIUpload;
+  }
+}

package/package.json

@@ -1,15 +1,28 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "AdiaUI web components — vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-runtime.",
   "type": "module",
+  "types": "./index.d.ts",
   "exports": {
-    ".": "./index.js",
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
     "./css": "./index.css",
-    "./core": "./core/index.js",
-    "./core/*": "./core/*.js",
+    "./core": {
+      "types": "./core/index.d.ts",
+      "default": "./core/index.js"
+    },
+    "./core/*": {
+      "types": "./core/*.d.ts",
+      "default": "./core/*.js"
+    },
     "./components": "./components/index.js",
-    "./components/*": "./components/*/*.js",
+    "./components/*": {
+      "types": "./components/*/*.d.ts",
+      "default": "./components/*/*.js"
+    },
     "./components/*.css": "./components/*/*.css",
     "./styles/*": "./styles/*",
     "./traits": "./traits/index.js",
@@ -29,7 +42,9 @@
     "!traits/**/*.examples.js",
     "!traits/_api-table.js",
     "index.js",
-    "index.css"
+    "index.css",
+    "index.d.ts",
+    "USAGE.md"
   ],
   "sideEffects": [
     "*.css",

package/traits/CATEGORIES.md

@@ -4,7 +4,7 @@
 
 **56 traits across 9 categories.**
 
-Traits are cross-cutting capabilities — orthogonal to the 93 primitives. Any primitive can opt into any trait by adding `data-*` attributes; traits hydrate via `defineTrait()` calls in the trait's `<name>.js`.
+Traits are cross-cutting capabilities — orthogonal to the 95 primitives. Any primitive can opt into any trait by adding `data-*` attributes; traits hydrate via `defineTrait()` calls in the trait's `<name>.js`.
 
 ## At a glance