@kitn.ai/ui 0.27.0 → 0.29.0

package/src/elements/menu.tsx

@@ -1,241 +0,0 @@
-import { For, Show } from 'solid-js';
-import { MoreHorizontal } from 'lucide-solid';
-import {
-  Dropdown, DropdownTrigger, DropdownContent, DropdownItem,
-  DropdownSeparator, DropdownLabel, DropdownCheckboxItem, DropdownRadioItem,
-  DropdownSub, DropdownSubTrigger, DropdownSubContent,
-  type DropdownController,
-} from '../ui/dropdown';
-import { renderIcon } from '../ui/icon';
-import { Kbd } from '../ui/kbd';
-import { cn } from '../utils/cn';
-import { defineWebComponent } from './define';
-import { wireDisclosure } from './disclosure';
-import type { KaiMenuItem } from './element-data-types';
-
-// The item shape lives in ./element-data-types so the ROOT entry can re-export it
-// (a per-element module's shipped .d.ts is `export {};`). Re-exported here so
-// `import type { KaiMenuItem } from './menu'` keeps working.
-export type { KaiMenuItem } from './element-data-types';
-
-interface Props extends Record<string, unknown> {
-  /** Tree of menu items. Set as a JS property, not an HTML attribute. */
-  items?: KaiMenuItem[];
-  /** Optional placement hint (unused by the underlying Dropdown which always
-   *  positions bottom-start, kept for future extension). */
-  placement?: string;
-  /** Built-in trigger: leading icon (a named icon like `"plus"`, an image
-   *  URL/data-URI, or text). Use this instead of slotting `slot="trigger"` for
-   *  the common case; a slotted trigger overrides it. */
-  triggerIcon?: string;
-  /** Built-in trigger: a text label (e.g. `"High"`). This is the trigger's
-   *  VISIBLE text, so it is also its accessible name, and `label` does not
-   *  override it: an accessible name that does not contain the visible text is
-   *  unreachable by speech input, which is what WCAG 2.5.3 (Label in Name)
-   *  exists for. A slotted `slot="trigger"` replaces this built-in trigger
-   *  entirely and is named differently; see `label`. */
-  triggerLabel?: string;
-  /** Built-in trigger: a trailing icon (e.g. `"chevron-down"` for a select look). */
-  triggerIconTrailing?: string;
-  /** Accessible name for a trigger with no visible label. Ignored when
-   *  `triggerLabel` is set, which is already the visible name.
-   *
-   *  It DOES name a slotted `slot="trigger"`, and that is a difference in what
-   *  the two slots MEAN, not a limitation. `<kai-button>`'s slot IS the button's
-   *  label, so text slotted there is the name and `label` steps aside. This slot
-   *  is VISUAL content, a `+` or an `<svg>`, with the name supplied separately:
-   *  decoration beside a name, never a second name competing with one. So
-   *  `label` names the trigger here by design.
-   *
-   *  Slotting a real WORD rather than a glyph makes that word a visible label,
-   *  and an accessible name has to contain the visible text. Then either drop
-   *  `label` or make it contain the word you slotted. */
-  label?: string;
-  /** Stretch the trigger to the full width of the menu's container (a block
-   *  row), e.g. a sidebar-footer account row. Same affordance as
-   *  `<kai-button full>`. Attribute: `full`. */
-  full?: boolean;
-  /** Drive/observe open state (Shoelace-style: settable + reflected to the `open`
-   *  attribute, the menu still self-manages on click/keyboard). Set `el.open = true`,
-   *  or `<kai-menu open>`; listen for `kai-open-change`. */
-  open?: boolean;
-  /** Initial open state on mount (uncontrolled seed). */
-  defaultOpen?: boolean;
-  /** Disable the trigger: click/keyboard and `show()` no longer open the menu. */
-  disabled?: boolean;
-}
-
-interface Events {
-  /**
-   * Fired when the user selects a leaf item.
-   * - Plain items: `{ id }`.
-   * - Checkbox items: `{ id, checked }` where `checked` is the NEW state.
-   * - Radio items: `{ id, radioGroup }`, where the consumer marks `id` as the
-   *   selected one in `radioGroup` and clears the others.
-   */
-  'kai-select': { id: string; checked?: boolean; radioGroup?: string };
-  /** The menu opened or closed (by click, keyboard, Escape, outside-click, or a method). */
-  'kai-open-change': { open: boolean };
-}
-
-/**
- * `<kai-menu>` — a cascading action menu driven by a JSON items-tree.
- *
- * Set the `items` property in JavaScript (array, not attribute). The menu
- * provides its own trigger button (accessible + keyboard-wired); slot only the
- * VISUAL content into `slot="trigger"` (an icon, text, an `<svg>`) — never your
- * own `<button>`/`<a>`, which would nest interactive elements. Set the
- * accessible name with the `label` attribute (for an icon-only trigger):
- *
- * ```html
- * <kai-menu label="Open menu">
- *   <span slot="trigger">+</span>
- * </kai-menu>
- * <script type="module">
- *   import '@kitn.ai/ui/elements';
- *   const menu = document.querySelector('kai-menu');
- *   menu.items = [
- *     { heading: true, label: 'Actions' },
- *     { id: 'attach', label: 'Add files', icon: 'paperclip', shortcut: 'Mod+U' },
- *   ];
- *   menu.addEventListener('kai-select', (e) => console.log(e.detail));
- * </script>
- * ```
- */
-defineWebComponent<Props, Events>('kai-menu', {
-  items: undefined,
-  placement: undefined,
-  triggerIcon: undefined,
-  triggerLabel: undefined,
-  triggerIconTrailing: undefined,
-  label: undefined,
-  full: false,
-  open: undefined,
-  defaultOpen: undefined,
-  disabled: undefined,
-}, (props, ctx) => {
-  const { dispatch, flag } = ctx;
-  let api: DropdownController | undefined;
-
-  // The standard overlay surface: settable+reflecting `open`, kai-open-change,
-  // show/hide/toggle, disabled-gating. See ./disclosure.
-  wireDisclosure(ctx, () => api, () => props.open);
-
-  function renderItems(items: KaiMenuItem[]) {
-    return (
-      <For each={items}>
-        {(item) => {
-          if (item.separator) {
-            return <DropdownSeparator />;
-          }
-          if (item.heading) {
-            return <DropdownLabel>{item.label}</DropdownLabel>;
-          }
-          if (item.items && item.items.length > 0) {
-            return (
-              <DropdownSub>
-                <DropdownSubTrigger>
-                  <Show when={item.icon}>{renderIcon(item.icon, { imgClass: 'mr-2 size-4 shrink-0', spanClass: 'mr-2 flex h-4 w-4 shrink-0 items-center justify-center text-sm' })}</Show>
-                  {item.label}
-                </DropdownSubTrigger>
-                <DropdownSubContent>
-                  {renderItems(item.items)}
-                </DropdownSubContent>
-              </DropdownSub>
-            );
-          }
-          if (item.radioGroup !== undefined) {
-            return (
-              <DropdownRadioItem
-                checked={item.checked}
-                disabled={item.disabled}
-                onSelect={() => {
-                  if (item.id) dispatch('kai-select', { id: item.id, radioGroup: item.radioGroup });
-                }}
-              >
-                <Show when={item.icon}>{renderIcon(item.icon, { imgClass: 'mr-2 size-4 shrink-0', spanClass: 'mr-2 flex h-4 w-4 shrink-0 items-center justify-center text-sm' })}</Show>
-                {item.label}
-              </DropdownRadioItem>
-            );
-          }
-          if (item.checked !== undefined) {
-            return (
-              <DropdownCheckboxItem
-                checked={item.checked}
-                disabled={item.disabled}
-                onSelect={() => {
-                  if (item.id) dispatch('kai-select', { id: item.id, checked: !item.checked });
-                }}
-              >
-                <Show when={item.icon}>{renderIcon(item.icon, { imgClass: 'mr-2 size-4 shrink-0', spanClass: 'mr-2 flex h-4 w-4 shrink-0 items-center justify-center text-sm' })}</Show>
-                {item.label}
-              </DropdownCheckboxItem>
-            );
-          }
-          return (
-            <DropdownItem
-              disabled={item.disabled}
-              onSelect={() => { if (item.id) dispatch('kai-select', { id: item.id }); }}
-            >
-              <Show when={item.icon}>{renderIcon(item.icon, { imgClass: 'mr-2 size-4 shrink-0', spanClass: 'mr-2 flex h-4 w-4 shrink-0 items-center justify-center text-sm' })}</Show>
-              {item.label}
-              <Show when={item.shortcut}>
-                <span part="shortcut" class="ml-auto pl-4 text-muted-foreground">
-                  <Kbd keys={item.shortcut!} platform="auto" size="sm" />
-                </span>
-              </Show>
-            </DropdownItem>
-          );
-        }}
-      </For>
-    );
-  }
-
-  return (
-    <>
-      {/* The host shrinks to the trigger by default (UA inline); `full` makes it
-          a block whose trigger button fills the width — the kai-button pattern
-          (`:host([full])`), for sidebar-footer account rows and other stretched
-          placements. */}
-      <style>{':host([full]){display:block}'}</style>
-    <Dropdown
-      defaultOpen={flag('defaultOpen')}
-      disabled={flag('disabled')}
-      controllerRef={(a) => (api = a)}
-    >
-      <DropdownTrigger
-        class={cn(
-          'inline-flex items-center rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring',
-          props.triggerLabel
-            ? 'gap-1.5 px-2 py-1.5 text-sm font-medium text-muted-foreground hover:bg-accent hover:text-foreground'
-            : 'justify-center p-1.5 text-foreground hover:bg-muted',
-          flag('full') && 'w-full',
-        )}
-        // A visible `triggerLabel` IS the name (name-from-contents reaches the
-        // slotted/shadow text), so `label` must not be layered over it: aria-label
-        // REPLACES the computed name, and a trigger reading "High" that answers to
-        // "Reasoning effort" locks speech-input users out (WCAG 2.5.3). Same rule
-        // kai-checkpoint and kai-button follow.
-        //
-        // A SLOTTED trigger keeps `label`, and that is the contract rather than a
-        // gap: kai-button's slot IS the label, so text there is the name; this
-        // slot is visual content with the name supplied separately. Two slots,
-        // two meanings, so the same rule should not apply to both. See `label`.
-        aria-label={props.triggerLabel ? undefined : (props.label ?? 'Open menu')}
-      >
-        {/* Slotted trigger wins; otherwise build one from the trigger* props;
-            otherwise fall back to a "more" glyph. */}
-        <slot name="trigger">
-          <Show when={props.triggerIcon}>{renderIcon(props.triggerIcon, { class: 'size-4 shrink-0' })}</Show>
-          <Show when={props.triggerLabel}>{props.triggerLabel}</Show>
-          <Show when={props.triggerIconTrailing}>{renderIcon(props.triggerIconTrailing, { class: 'size-3.5 shrink-0 opacity-60' })}</Show>
-          <Show when={!props.triggerIcon && !props.triggerLabel}><MoreHorizontal class="size-4" /></Show>
-        </slot>
-      </DropdownTrigger>
-      <DropdownContent class="min-w-[15rem]">
-        {renderItems((props.items as KaiMenuItem[] | undefined) ?? [])}
-      </DropdownContent>
-    </Dropdown>
-    </>
-  );
-});

package/src/elements/message-skills.tsx

@@ -1,83 +0,0 @@
-import { createSignal, onCleanup, onMount } from 'solid-js';
-import { defineWebComponent } from './define';
-// The badge shape is the Solid component's own `Skill` — one declaration, so the
-// element and `<MessageSkills>` cannot drift, and the ROOT entry re-exports it.
-import { MessageSkills, type Skill } from '../components/message-skills';
-
-
-interface Props extends Record<string, unknown> {
-  /** The active skills to badge. Set as a JS property. Omit to supply them as
-   *  `<kai-skill>` light-DOM children instead; when both are present the
-   *  property's skills come first. Nothing renders when there are none. */
-  skills?: Skill[];
-}
-
-/**
- * Parse a single light-DOM `<kai-skill>` element into a `Skill` descriptor.
- *
- * Attribute / content mapping:
- * - `id`          → Skill.id   (falls back to `name` when absent)
- * - `textContent` → Skill.name (the human-readable badge label)
- *
- * Example: `<kai-skill id="web-search">Web Search</kai-skill>`
- */
-export function parseKaiSkillElement(n: Element): Skill {
-  const name = n.textContent?.trim() ?? '';
-  const id = n.getAttribute('id') ?? name;
-  return { id, name };
-}
-
-/**
- * `<kai-skills>` — badges showing which skills were active for a
- * message. Data via the `skills` property **or** declarative `<kai-skill>`
- * children.
- *
- * **Property API** — set a JS array on the element:
- * ```html
- * <kai-skills id="skills"></kai-skills>
- * <script type="module">
- *   import '@kitn.ai/ui/elements';
- *   document.getElementById('skills').skills = [
- *     { id: 'web-search', name: 'Web Search' },
- *     { id: 'code',       name: 'Code' },
- *   ];
- * </script>
- * ```
- *
- * **Declarative API** — compose `<kai-skill>` children (light-DOM data
- * carriers hidden by Shadow DOM — no visible output of their own):
- * ```html
- * <kai-skills>
- *   <kai-skill id="web-search">Web Search</kai-skill>
- *   <kai-skill id="code">Code</kai-skill>
- * </kai-skills>
- * <script type="module">
- *   import '@kitn.ai/ui/elements';
- * </script>
- * ```
- *
- * When both are provided, `skills` prop items render first and declarative
- * children are appended after.
- */
-defineWebComponent<Props>('kai-skills', {
-  skills: [],
-}, (props, { element }) => {
-  // Read declarative <kai-skill> children from light DOM.
-  // The shadow root has no <slot>, so they are invisible — pure data carriers.
-  const [slottedSkills, setSlottedSkills] = createSignal<Skill[]>([]);
-  onMount(() => {
-    const read = () => {
-      const nodes = [...element.querySelectorAll('kai-skill')];
-      setSlottedSkills(nodes.map(parseKaiSkillElement));
-    };
-    read();
-    const observer = new MutationObserver(read);
-    observer.observe(element, { childList: true, attributes: true, subtree: true });
-    onCleanup(() => observer.disconnect());
-  });
-
-  // Prop skills (first) merged with declarative children (after).
-  const allSkills = () => [...(props.skills ?? []), ...slottedSkills()];
-
-  return <MessageSkills skills={allSkills()} />;
-});