@adia-ai/web-components 0.8.42 → 0.8.43

package/components/color-picker/color-picker.yaml

@@ -1,175 +0,0 @@
-# Generated by scripts/migrate-yamls-to-v1.mjs — migrated to v1 contract.
-# Edit this file; run `npm run build:components` to regenerate a2ui.json.
-$schema: ../../../../scripts/schemas/component.yaml.schema.json
-name: UIColorPicker
-tag: color-picker-ui
-status: deprecated
-component: ColorPicker
-category: input
-version: 2
-description: >-
-  DEPRECATED (ADR-0063, gh#1563, gh#1377 B11) — `-picker` is reserved for
-  the outer, trigger + popover, form-associated composite shape
-  (`calendar-picker-ui` / `date-range-picker-ui` / `datetime-picker-ui` /
-  `time-picker-ui`); `color-picker-ui` was the sole violator, playing
-  `calendar-grid-ui`'s inline-substrate role under a `-picker` name.
-  `<color-picker-ui>` is now a thin `UIColorArea` subclass (see
-  color-picker.class.js) rather than an independent implementation — every
-  prop/event/token is inherited unchanged from `<color-area-ui>`. Existing
-  markup keeps working, but new markup should reach for `<color-area-ui>`
-  directly. See `<color-area-ui>` for the full contract.
-# Per ADR-0027 — primitives that programmatically create other primitives
-# do NOT auto-import them. Consumer (or demo shell) must explicitly import
-# the slider-ui module (same one <color-area-ui> itself needs — this alias
-# inherits its render(), not just its class).
-composes:
-  - slider-ui
-props:
-  # Every prop below is inherited VERBATIM from <color-area-ui> —
-  # documented here too (not just "see the base class") because a
-  # consumer scanning THIS tag's own catalog entry, or the a2ui pipeline
-  # generating THIS tag by name, needs the full contract without a second
-  # hop. audit-static-properties-vs-yaml.mjs's component-extends-component
-  # exemption (gh#1372/gh#1563) resolves this against <color-area-ui>'s
-  # own yaml, so re-declaring the inherited names here is documentation,
-  # not a second runtime contract. Nothing overrides a default here (the
-  # alias is byte-identical behavior; only the class/tag/component names
-  # differ), unlike datetime-picker-ui's own two overridden defaults.
-  name:
-    description: Form field name
-    type: string
-    default: ""
-  disabled:
-    description: Disables all interaction
-    type: boolean
-    default: false
-    reflect: true
-  format:
-    description: Output format for the value property
-    type: string
-    default: hex
-    enum:
-      - hex
-      - oklch
-  value:
-    description: Current color as hex string
-    type: string
-    default: "#3b82f6"
-  maxChroma:
-    description: |
-      Generation constraint (v0.4.9 §99h, FEEDBACK-02 #7) — clamp the
-      OKLCH chroma channel to at most this value before commit. Out-of-
-      bound mutations round-trip to the nearest in-bound equivalent +
-      fire `constraint-clamp`. Default Infinity (no constraint).
-    type: number
-    default: Infinity
-    reflect: true
-  maxL:
-    description: Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint).
-    type: number
-    default: 1
-    reflect: true
-  minL:
-    description: Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint).
-    type: number
-    default: 0
-    reflect: true
-  hueDriftMax:
-    description: |
-      Generation constraint — maximum allowed signed-shortest-path hue
-      deviation (degrees) from [base-hue] (or the first-committed hue
-      if [base-hue] is unset). Default NaN (no constraint). Wrap-aware
-      so a drift of 350 degrees resolves as -10.
-    type: number
-    default: NaN
-    reflect: true
-  baseHue:
-    description: |
-      Reference hue (degrees) for the [hue-drift-max] constraint. Default
-      NaN — falls back to the picker's hue at first commit so the consumer
-      can pre-seed the picker and constrain drift from that initial value.
-    type: number
-    default: NaN
-    reflect: true
-events:
-  change:
-    description: Fired on every color change
-  input:
-    description: Fired during continuous interaction (drag)
-  constraint-clamp:
-    description: |
-      Fired immediately before `change` / `input` when one or more
-      consumer-declared constraints (max-chroma / max-l / min-l /
-      hue-drift-max) clamped a channel away from the user-requested
-      value. detail.clamps is an array of axis-specific clamp records.
-    detail:
-      clamps:
-        type: array
-        description: |
-          Array of `{ axis, requested, clamped, reason }` objects. axis is
-          one of "l" / "c" / "h". reason names the triggering constraint
-          prop. Empty arrays are never emitted.
-slots: {}
-states:
-  - name: idle
-    description: Default, ready for interaction.
-  - name: disabled
-    description: Non-interactive; dimmed.
-    attribute: disabled
-traits: []
-tokens: {}  # No component-owned tokens — styling flows entirely through
-            # <color-area-ui>'s own --color-area-* custom properties.
-requiredIcons:
-  - copy
-  - check
-  - warning
-a2ui:
-  rules:
-    - rule: 'DEPRECATED — prefer `{"component": "ColorArea"}` over `{"component": "ColorPicker"}`. Both render and behave identically; ColorPicker is a thin compatibility alias.'
-      reason: 'ADR-0063/gh#1377 B11 fold — steer new generation at the canonical primitive.'
-    - rule: 'For simple color swatches (read-only display) use <swatch-ui>; for hex/rgb text input use <color-input-ui>.'
-      reason: 'Surface boundary.'
-anti_patterns:
-  - wrong: |
-      {"component": "ColorPicker", "name": "brand"}
-    why: |
-      ColorPicker is deprecated (ADR-0063, gh#1563) — new generation should
-      reach for ColorArea instead.
-    fix: |
-      {"component": "ColorArea", "name": "brand"}
-examples:
-  - name: color-picker-legacy
-    description: Deprecated tag — prefer ColorArea's own "color-area-demo" example for NEW markup.
-    a2ui: >-
-      [
-        {
-          "id": "root",
-          "component": "Card",
-          "children": [
-            "sec"
-          ]
-        },
-        {
-          "id": "sec",
-          "component": "Section",
-          "children": [
-            "cp"
-          ]
-        },
-        {
-          "id": "cp",
-          "component": "ColorPicker",
-          "value": "#3b82f6"
-        }
-      ]
-keywords:
-  - colorpicker
-  - color-picker
-  - color
-  - picker
-synonyms:
-  color-picker: [color-canvas, color-surface, swatch-picker, color-area]
-related:
-  - color-area
-  - grid
-  - button

package/components/datetime-picker/datetime-picker.a2ui.json

@@ -1,256 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://adiaui.dev/a2ui/v0_9/components/DatetimePicker.json",
-  "title": "DatetimePicker",
-  "description": "DEPRECATED (gh#1372, #1363 C3c) — folded into <calendar-picker-ui>'s widened `precision` axis. `<datetime-picker-ui>` is now a thin `UICalendarPicker` subclass (see datetime-picker.class.js) rather than an independent implementation: `precision` defaults to `\"minute\"` (not `\"date\"`) and `placeholder` defaults to `\"Select date and time\"`; every other prop/event/token is inherited unchanged from <calendar-picker-ui>. Existing markup keeps working, but new markup should reach for `<calendar-picker-ui precision=\"minute\">` (or `precision=\"second\"`) directly. See <calendar-picker-ui> for the full contract.",
-  "type": "object",
-  "allOf": [
-    {
-      "$ref": "common_types.json#/$defs/ComponentCommon"
-    },
-    {
-      "$ref": "common_types.json#/$defs/CatalogComponentCommon"
-    }
-  ],
-  "properties": {
-    "required": {
-      "description": "Required for validation when inside a `<form>`.",
-      "type": "boolean",
-      "default": false
-    },
-    "component": {
-      "const": "DatetimePicker"
-    },
-    "disabled": {
-      "description": "Block all interaction. Trigger remains rendered but does not open the popover.",
-      "type": "boolean",
-      "default": false
-    },
-    "format": {
-      "description": "Trigger button date format. `short`: `Jan 1, 2026 14:30`; `long`: `January 1, 2026 14:30`; `iso`: full ISO string.",
-      "type": "string",
-      "enum": [
-        "short",
-        "long",
-        "iso"
-      ],
-      "default": "short"
-    },
-    "hourcycle": {
-      "description": "Hour cycle for the time pane. Empty (default) derives from the\ndocument locale. `h12` forces a 12-hour cycle with an AM/PM\n(meridiem) segment; `h23` forces 24-hour cycle.\n",
-      "type": "string",
-      "enum": [
-        "",
-        "h12",
-        "h23"
-      ],
-      "default": ""
-    },
-    "locale": {
-      "description": "BCP-47 locale tag used to derive hour-cycle when `hour-cycle` is empty. Falls back to `<html lang>` then to browser default.",
-      "type": "string",
-      "default": ""
-    },
-    "max": {
-      "description": "Latest selectable ISO 8601 datetime (inclusive). Days after are disabled in the calendar pane; times after are rejected by the time pane on the same day.",
-      "type": "string",
-      "default": ""
-    },
-    "min": {
-      "description": "Earliest selectable ISO 8601 datetime (inclusive). Days before are disabled in the calendar pane; times before are rejected by the time pane on the same day.",
-      "type": "string",
-      "default": ""
-    },
-    "name": {
-      "description": "Form field name. The ISO 8601 datetime is submitted under this key when the picker is inside a `<form>`.",
-      "type": "string",
-      "default": ""
-    },
-    "open": {
-      "description": "Whether the popover is currently open.",
-      "type": "boolean",
-      "default": false
-    },
-    "placeholder": {
-      "description": "Text shown in the trigger when the value is empty. Defaults to \"Select date and time\" HERE (vs. \"Select date...\" on the base `<calendar-picker-ui>`).",
-      "type": "string",
-      "default": "Select date and time"
-    },
-    "placement": {
-      "description": "Popover placement relative to the trigger. Default `bottom` centers the calendar+time panel under the trigger (ADR-0034 Rule 2 — ~600px panel >> trigger).",
-      "type": "string",
-      "enum": [
-        "top",
-        "bottom",
-        "left",
-        "right",
-        "top-start",
-        "top-end",
-        "bottom-start",
-        "bottom-end"
-      ],
-      "default": "bottom"
-    },
-    "precision": {
-      "description": "Time-pane precision. `minute` (default HERE — `date` on the base `<calendar-picker-ui>`) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`; `date` drops the time pane entirely (identical to the base class's own default).",
-      "type": "string",
-      "enum": [
-        "date",
-        "minute",
-        "second"
-      ],
-      "default": "minute"
-    },
-    "readonly": {
-      "description": "Block edits; allow keyboard navigation for screen-reader inspection.",
-      "type": "boolean",
-      "default": false
-    },
-    "step": {
-      "description": "Per-Arrow-keypress increment in seconds for the time pane. 60 = minute precision (default), 900 = 15-minute, 1 = second precision.",
-      "type": "number",
-      "default": 60
-    },
-    "value": {
-      "description": "Current value as ISO 8601 datetime (\"YYYY-MM-DDTHH:mm\" or \"YYYY-MM-DDTHH:mm:ss\"). Empty when no value selected.",
-      "$ref": "common_types.json#/$defs/DynamicString"
-    }
-  },
-  "required": [
-    "component"
-  ],
-  "unevaluatedProperties": false,
-  "x-adiaui": {
-    "anti_patterns": [
-      {
-        "fix": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24T00:00\"}\n",
-        "why": "`value` is a date-only string — no time component. The contract requires\na full ISO 8601 datetime including the `T` and time segment.\n",
-        "wrong": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24\"}\n"
-      },
-      {
-        "fix": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\", \"name\": \"appointment\"}\n",
-        "why": "DatetimePicker is deprecated (gh#1372) — new generation should reach\nfor CalendarPicker's widened precision axis instead.\n",
-        "wrong": "{\"component\": \"DatetimePicker\", \"name\": \"appointment\"}\n"
-      }
-    ],
-    "category": "input",
-    "composes": [
-      "calendar-grid-ui",
-      "time-picker-ui",
-      "divider-ui"
-    ],
-    "events": {
-      "change": {
-        "description": "Fired when the value commits (date picked + time edited, OR Apply clicked in explicit-commit mode).",
-        "detail": {
-          "value": "string"
-        }
-      },
-      "close": {
-        "description": "Popover closed (without commit, or after commit).",
-        "detail": {
-          "reason": "string"
-        }
-      },
-      "input": {
-        "description": "Fired during partial selection (date picked but time still pending, or vice versa).",
-        "detail": {
-          "value": "string"
-        }
-      },
-      "invalid": {
-        "description": "A constraint failed (out of range, parse error).",
-        "detail": {
-          "reason": "string",
-          "value": "string"
-        }
-      },
-      "open": {
-        "description": "Popover opened (user clicked the trigger or pressed Enter / Space).",
-        "detail": {
-          "trigger": "string"
-        }
-      }
-    },
-    "examples": [
-      {
-        "description": "Form-field-wrapped picker with min/max bounds. Prefer the CalendarPicker[precision] form for NEW markup — see calendar-picker-ui's own \"datetime-picker\" example.",
-        "a2ui": "[\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Appointment\",\n    \"children\": [\"dt\"]\n  },\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"name\": \"appointment\",\n    \"min\": \"2026-01-01T00:00\",\n    \"max\": \"2026-12-31T23:59\"\n  }\n]\n",
-        "name": "canonical"
-      }
-    ],
-    "keywords": [
-      "datetimepicker",
-      "datetime-picker",
-      "datetime",
-      "date-time",
-      "dateandtime",
-      "appointment",
-      "schedule",
-      "timestamp"
-    ],
-    "name": "UIDatetimePicker",
-    "parts": {},
-    "related": [
-      "calendar-picker",
-      "time-picker",
-      "date-range-picker",
-      "popover",
-      "field",
-      "button"
-    ],
-    "slots": {
-      "footer": {
-        "description": "Optional Apply / Cancel buttons for explicit-commit flows. Spans both panes below the calendar + time area."
-      },
-      "trigger": {
-        "description": "Custom trigger replacement. When omitted, a default trigger is stamped (a plain clickable span, per the base `<calendar-picker-ui>` — NOT the old standalone datetime-picker's `<button-ui>` trigger; see the Consequences note below)."
-      }
-    },
-    "states": [
-      {
-        "description": "Closed, no pending selection.",
-        "name": "idle"
-      },
-      {
-        "description": "Popover open.",
-        "attribute": "open",
-        "name": "open"
-      },
-      {
-        "description": "Non-interactive; dimmed.",
-        "attribute": "disabled",
-        "name": "disabled"
-      },
-      {
-        "description": "Read-only; trigger keyboard-focusable but popover does not open.",
-        "attribute": "readonly",
-        "name": "readonly"
-      }
-    ],
-    "status": "deprecated",
-    "synonyms": {
-      "appointment": [
-        "datetime",
-        "meeting",
-        "schedule"
-      ],
-      "datetime": [
-        "date-time",
-        "timestamp",
-        "appointment",
-        "schedule"
-      ],
-      "tags": [
-        "DateTimePicker",
-        "DateTimeInput",
-        "DatetimeInput",
-        "Timestamp"
-      ]
-    },
-    "tag": "datetime-picker-ui",
-    "tokens": {},
-    "traits": [],
-    "version": 2
-  }
-}

package/components/datetime-picker/datetime-picker.class.js

@@ -1,58 +0,0 @@
-/**
- * Non-side-effect class export for `<datetime-picker-ui>`.
- *
- * Importing this file gives you the class without auto-registering the tag.
- * Useful for test isolation, subclassing with tag-name override, or selective
- * composition.
- *
- * The auto-register path stays at `@adia-ai/web-components/components/datetime-picker`
- * (which imports this file + calls `defineIfFree()`).
- *
- * @see ../../USAGE.md#registration--auto-vs-explicit
- */
-
-/**
- * <datetime-picker-ui> — DEPRECATED (gh#1372, #1363 C3c).
- *
- * `<datetime-picker-ui>`'s full surface — trigger + popover, a
- * `<calendar-grid-ui>` date pane + `<divider-ui>` + `<time-picker-ui>` time
- * pane, form participation, constraint validation, the
- * open/close/input/invalid event set — folded into `<calendar-picker-ui>`
- * behind its widened `precision` axis (`date` | `minute` | `second`).
- * `<datetime-picker-ui>` is now a thin compatibility alias per ADR-0057
- * (`status: deprecated`): it subclasses `UICalendarPicker` directly rather
- * than re-implementing any of that behavior, and only overrides the two
- * defaults that made it feel like a distinct primitive — `precision`
- * defaults to `"minute"` (not `"date"`) and `placeholder` defaults to
- * `"Select date and time"`.
- *
- * Migrate: `<datetime-picker-ui>` → `<calendar-picker-ui precision="minute">`
- * (or `precision="second"` for the former second-precision mode). This tag
- * keeps working — it IS `<calendar-picker-ui>` under the hood — but will be
- * removed in a future major; new markup should reach for
- * `<calendar-picker-ui>` directly.
- *
- * @see ../calendar-picker/calendar-picker.class.js
- */
-
-import { UICalendarPicker } from '../calendar-picker/calendar-picker.class.js';
-
-export class UIDatetimePicker extends UICalendarPicker {
-  // static labelDeprecated is inherited unchanged from UICalendarPicker —
-  // this subclass adds no authored [label] attribute handling of its own.
-
-  // Same value as UICalendarPicker's — the alias stamps no icon of its own —
-  // but restated literally because scripts/release/check-required-icons.mjs
-  // text-scans each component's own class.js and cannot resolve inheritance
-  // (gh#1503).
-  static requiredIcons = ['calendar'];
-
-  static properties = {
-    ...UICalendarPicker.properties,
-    // The only two defaults that differ from the folded-into base class —
-    // everything else (min/max/step/hourcycle/locale/open/format/
-    // placement/readonly/etc.) is inherited unchanged.
-    precision: { type: String, default: 'minute', reflect: true },
-    placeholder: { type: String, default: 'Select date and time', reflect: true },
-  };
-}

package/components/datetime-picker/datetime-picker.css

@@ -1,11 +0,0 @@
-/* `<datetime-picker-ui>` is DEPRECATED (gh#1372, #1363 C3c) — a thin
- * `UICalendarPicker` subclass (see datetime-picker.class.js), never its own
- * independent implementation. Its visual contract lives entirely in
- * ../calendar-picker/calendar-picker.css, whose `@scope (calendar-picker-ui,
- * datetime-picker-ui)` root and `:is(calendar-picker-ui, datetime-picker-ui)`
- * popover/pane selectors already cover this tag — one styling source, not
- * two files drifting apart. This file intentionally carries no rules of its
- * own; `packages/web-components/index.css` still imports it so the barrel's
- * per-component import list stays complete and mechanical (no special-cased
- * skip for a deprecated-but-still-shipping tag).
- */

package/components/datetime-picker/datetime-picker.d.ts

@@ -1,87 +0,0 @@
-/**
- * `<datetime-picker-ui>` — DEPRECATED (gh#1372, #1363 C3c) — folded into <calendar-picker-ui>'s widened `precision` axis. `<datetime-picker-ui>` is now a thin `UICalendarPicker` subclass (see datetime-picker.class.js) rather than an independent implementation: `precision` defaults to `"minute"` (not `"date"`) and `placeholder` defaults to `"Select date and time"`; every other prop/event/token is inherited unchanged from <calendar-picker-ui>. Existing markup keeps working, but new markup should reach for `<calendar-picker-ui precision="minute">` (or `precision="second"`) directly. See <calendar-picker-ui> for the full contract.
- *
- * @see https://ui-kit.exe.xyz/site/components/datetime-picker
- *
- * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
- * run `npm run build:components`, then `npm run codegen:dts` to
- * regenerate; or hand-author this file fully if rich event types are
- * needed beyond what the yaml `events:` block can express.
- */
-
-import { UIElement } from '../../core/element.js';
-
-export interface DatetimePickerChangeEventDetail {
-  value: string;
-}
-
-export type DatetimePickerChangeEvent = CustomEvent<DatetimePickerChangeEventDetail>;
-export interface DatetimePickerCloseEventDetail {
-  reason: string;
-}
-
-export type DatetimePickerCloseEvent = CustomEvent<DatetimePickerCloseEventDetail>;
-export interface DatetimePickerInputEventDetail {
-  value: string;
-}
-
-export type DatetimePickerInputEvent = CustomEvent<DatetimePickerInputEventDetail>;
-export interface DatetimePickerInvalidEventDetail {
-  reason: string;
-  value: string;
-}
-
-export type DatetimePickerInvalidEvent = CustomEvent<DatetimePickerInvalidEventDetail>;
-export interface DatetimePickerOpenEventDetail {
-  trigger: string;
-}
-
-export type DatetimePickerOpenEvent = CustomEvent<DatetimePickerOpenEventDetail>;
-
-export class UIDatetimePicker extends UIElement {
-  /** Required for validation when inside a `<form>`. */
-  required: boolean;
-  /** Block all interaction. Trigger remains rendered but does not open the popover. */
-  disabled: boolean;
-  /** Trigger button date format. `short`: `Jan 1, 2026 14:30`; `long`: `January 1, 2026 14:30`; `iso`: full ISO string. */
-  format: 'short' | 'long' | 'iso';
-  /** Hour cycle for the time pane. Empty (default) derives from the
-document locale. `h12` forces a 12-hour cycle with an AM/PM
-(meridiem) segment; `h23` forces 24-hour cycle.
- */
-  hourcycle: '' | 'h12' | 'h23';
-  /** BCP-47 locale tag used to derive hour-cycle when `hour-cycle` is empty. Falls back to `<html lang>` then to browser default. */
-  locale: string;
-  /** Latest selectable ISO 8601 datetime (inclusive). Days after are disabled in the calendar pane; times after are rejected by the time pane on the same day. */
-  max: string;
-  /** Earliest selectable ISO 8601 datetime (inclusive). Days before are disabled in the calendar pane; times before are rejected by the time pane on the same day. */
-  min: string;
-  /** Form field name. The ISO 8601 datetime is submitted under this key when the picker is inside a `<form>`. */
-  name: string;
-  /** Whether the popover is currently open. */
-  open: boolean;
-  /** Text shown in the trigger when the value is empty. Defaults to "Select date and time" HERE (vs. "Select date..." on the base `<calendar-picker-ui>`). */
-  placeholder: string;
-  /** Popover placement relative to the trigger. Default `bottom` centers the calendar+time panel under the trigger (ADR-0034 Rule 2 — ~600px panel >> trigger). */
-  placement: 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
-  /** Time-pane precision. `minute` (default HERE — `date` on the base `<calendar-picker-ui>`) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`; `date` drops the time pane entirely (identical to the base class's own default). */
-  precision: 'date' | 'minute' | 'second';
-  /** Block edits; allow keyboard navigation for screen-reader inspection. */
-  readonly: boolean;
-  /** Per-Arrow-keypress increment in seconds for the time pane. 60 = minute precision (default), 900 = 15-minute, 1 = second precision. */
-  step: number;
-  /** Current value as ISO 8601 datetime ("YYYY-MM-DDTHH:mm" or "YYYY-MM-DDTHH:mm:ss"). Empty when no value selected. */
-  value: string;
-
-  addEventListener(type: 'change', listener: (ev: DatetimePickerChangeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'close', listener: (ev: DatetimePickerCloseEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'input', listener: (ev: DatetimePickerInputEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'invalid', listener: (ev: DatetimePickerInvalidEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'open', listener: (ev: DatetimePickerOpenEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener<K extends keyof HTMLElementEventMap>(
-    type: K,
-    listener: (this: UIDatetimePicker, ev: HTMLElementEventMap[K]) => unknown,
-    options?: boolean | AddEventListenerOptions,
-  ): void;
-}

package/components/datetime-picker/datetime-picker.examples.md

@@ -1,25 +0,0 @@
-# datetime-picker — Examples
-
-## Canonical
-
-```html
-<field-ui label="Appointment">
-  <datetime-picker-ui name="appointment" min="2026-01-01T00:00" max="2026-12-31T23:59"></datetime-picker-ui>
-</field-ui>
-```
-
-## Pre-selected
-
-```html
-<field-ui label="Meeting start">
-  <datetime-picker-ui value="2026-05-24T14:30"></datetime-picker-ui>
-</field-ui>
-```
-
-## precision
-
-```html
-<field-ui label="Minute precision">
-  <datetime-picker-ui value="2026-05-24T14:30"></datetime-picker-ui>
-</field-ui>
-```

package/components/datetime-picker/datetime-picker.js

@@ -1,17 +0,0 @@
-/**
- * `<datetime-picker-ui>` — auto-registers the tag on import.
- *
- * For non-side-effect class import (test isolation, tag override), use
- * the `class` subpath:
- *
- *   import { UIDatetimePicker } from '@adia-ai/web-components/components/datetime-picker/class';
- *
- * @see ../../USAGE.md#registration--auto-vs-explicit
- */
-
-import { defineIfFree } from '../../core/register.js';
-import { UIDatetimePicker } from './datetime-picker.class.js';
-
-defineIfFree('datetime-picker-ui', UIDatetimePicker);
-
-export { UIDatetimePicker };