@lostgradient/cinder 0.8.0 → 0.9.0

package/dist/components/chat/input/chat-attachment-serialization.d.ts

@@ -0,0 +1,9 @@
+import type { ChatAttachment } from './chat-attachment.ts';
+export interface SerializedChatAttachment {
+    name: string;
+    mimeType: string;
+    kind: ChatAttachment['kind'];
+    content: string;
+}
+export declare function serializeChatAttachment(attachment: ChatAttachment): Promise<SerializedChatAttachment>;
+export declare function serializeChatAttachments(attachments: readonly ChatAttachment[]): Promise<SerializedChatAttachment[]>;

package/dist/components/chat/input/chat-input.svelte.d.ts

@@ -12,6 +12,16 @@ export type ChatInputProps = Omit<HTMLFormAttributes, 'onsubmit' | 'class'> & {
     placeholder?: string;
     /** Accessible label passed to the inner message editor */
     composerLabel?: string;
+    /** Explicit role for the inner message editor, for overlay patterns such as ARIA comboboxes. */
+    composerRole?: string | undefined;
+    /** `aria-expanded` passed to the inner message editor for composer overlays. */
+    composerAriaExpanded?: boolean | 'true' | 'false' | undefined;
+    /** `aria-controls` passed to the inner message editor for composer overlays. */
+    composerAriaControls?: string | undefined;
+    /** `aria-activedescendant` passed to the inner message editor for composer overlays. */
+    composerAriaActiveDescendant?: string | undefined;
+    /** `aria-autocomplete` passed to the inner message editor for composer overlays. */
+    composerAriaAutocomplete?: 'none' | 'inline' | 'list' | 'both' | undefined;
     /** Whether the input is disabled */
     disabled?: boolean;
     /** Whether a submission is in progress */
@@ -37,7 +47,17 @@ export type ChatInputProps = Omit<HTMLFormAttributes, 'onsubmit' | 'class'> & {
     /** Called when stop is requested (transforms send button into stop button when sending=true) */
     onstop?: (() => void) | undefined;
     /** Called with the composer's current plain-text value on every input event. */
-    oncomposerinput?: ((value: string) => void) | undefined;
+    oncomposerinput?: ((value: string, event?: Event) => void) | undefined;
+    /**
+     * Called before ChatInput's internal Enter-to-send handling when a keydown
+     * originates from the composer textarea. Calling `preventDefault()` skips
+     * the internal key handling for that event.
+     */
+    oncomposerkeydown?: ((event: KeyboardEvent) => void) | undefined;
+    /** Called after pointer or selection activity may have moved the composer caret. */
+    oncomposerselectionchange?: ((event: Event) => void) | undefined;
+    /** Called when focus leaves the composer textarea. */
+    oncomposerblur?: ((event: FocusEvent) => void) | undefined;
     /** Called when an attachment is added */
     onattachmentadd?: ((attachment: ChatAttachment) => void) | undefined;
     /** Called when an attachment is removed */
@@ -52,6 +72,7 @@ declare const ChatInput: import("svelte").Component<ChatInputProps, {
     clear: () => void;
     getAttachments: () => ChatAttachment[];
     getValue: () => string;
+    getEditorElement: () => HTMLTextAreaElement | null;
     addFiles: (files: File[]) => void;
 }, "value">;
 type ChatInput = ReturnType<typeof ChatInput>;

package/dist/components/chat/input/index.d.ts

@@ -1,4 +1,5 @@
 export { deriveAttachmentKind, type AttachmentKind } from './attachment-kind.js';
 export { default as ChatAttachmentPreview } from './chat-attachment-preview.svelte';
+export { serializeChatAttachment, serializeChatAttachments, type SerializedChatAttachment, } from './chat-attachment-serialization.ts';
 export type { ChatAttachment } from './chat-attachment.ts';
 export { default as ChatInput } from './chat-input.svelte';

package/dist/components/chat-composer-popover/chat-composer-popover-filter.d.ts

@@ -0,0 +1,11 @@
+export type FuzzyFilterItem = {
+    value: string;
+    label: string;
+    keywords?: readonly string[] | undefined;
+};
+export type FuzzyFilterResult<TItem extends FuzzyFilterItem> = {
+    item: TItem;
+    score: number;
+};
+export declare function fuzzySubsequenceScore(candidate: string, query: string): number | null;
+export declare function filterFuzzySubsequence<TItem extends FuzzyFilterItem>(items: readonly TItem[], query: string): TItem[];

package/dist/components/chat-composer-popover/chat-composer-popover.css

@@ -0,0 +1,7 @@
+@layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
+/* ChatComposerPopover renders CommandMenu and CommandItem internally. Pull in
+ * the command menu family so the wrapper is styled through its own styles path. */
+@import '../command-menu/command-menu.css';
+
+@layer cinder.components {
+}

package/dist/components/chat-composer-popover/chat-composer-popover.css.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/chat-composer-popover/chat-composer-popover.schema.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentSchema } from '../../schema-types';
+declare const _default: ComponentSchema;
+export default _default;

package/dist/components/chat-composer-popover/chat-composer-popover.schema.js

@@ -0,0 +1,150 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/chat-composer-popover/chat-composer-popover.schema.ts
+var schema = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  type: "object",
+  properties: {
+    id: {
+      type: "string",
+      description: "Unique identifier used for the listbox and item ids."
+    },
+    value: {
+      type: "string",
+      description: "Current composer value. Bind this to the same value as ChatInput."
+    },
+    triggers: {
+      type: "array",
+      items: {
+        type: "string"
+      },
+      description: "Trigger characters that open the popover. Default `['/', '@']`."
+    },
+    label: {
+      type: "string",
+      description: "Accessible listbox label. Default `'Composer suggestions'`."
+    },
+    placement: {
+      enum: [
+        "top",
+        "bottom",
+        "left",
+        "right",
+        "top-start",
+        "top-end",
+        "bottom-start",
+        "bottom-end"
+      ],
+      description: "Caret-relative placement. Default `'bottom-start'`."
+    },
+    offset: {
+      type: "number",
+      description: "Distance in px between the caret and popover. Default `6`."
+    }
+  },
+  additionalProperties: false,
+  required: ["id"],
+  metadata: {
+    unsupportedProps: [
+      {
+        name: "composer",
+        reason: "function-or-snippet",
+        required: true,
+        description: "Render the ChatInput or compatible composer with the provided overlay props."
+      },
+      {
+        name: "detectTrigger",
+        reason: "function-or-snippet",
+        description: "Override trigger detection."
+      },
+      {
+        name: "empty",
+        reason: "function-or-snippet",
+        description: "Optional empty state rendered when filtering produces no matching rows."
+      },
+      {
+        name: "filter",
+        reason: "function-or-snippet",
+        description: "Override filtering."
+      },
+      {
+        name: "item",
+        reason: "function-or-snippet",
+        description: "Optional custom row contents. Defaults to the item label and description."
+      },
+      {
+        name: "items",
+        reason: "generic-type-parameter",
+        required: true,
+        description: "Consumer-owned command or mention definitions."
+      },
+      {
+        name: "ondismiss",
+        reason: "function-or-snippet",
+        description: "Invoked when Escape, trigger loss, or outside pointerdown dismisses the popover."
+      },
+      {
+        name: "onselect",
+        reason: "function-or-snippet",
+        description: "Invoked when an enabled item is selected by keyboard or pointer."
+      }
+    ]
+  }
+};
+var chat_composer_popover_schema_default = schema;
+export {
+  chat_composer_popover_schema_default as default
+};
+
+//# debugId=92206E0DCC723B1864756E2164756E21

package/dist/components/chat-composer-popover/chat-composer-popover.svelte.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @cinder
+ * @category overlay
+ * @status beta
+ * @purpose Chat composer-bound slash-command and mention listbox primitive.
+ * @tag chat
+ * @tag command
+ * @tag overlay
+ * @useWhen Adding slash commands, mentions, or autocomplete to ChatInput without re-implementing combobox ARIA.
+ * @useWhen Composer suggestions should stay anchored to the active token and leave command definitions in application code.
+ * @avoidWhen Opening a global command launcher detached from the composer — use command-palette instead.
+ * @avoidWhen Anchoring a generic command menu to an arbitrary input — use command-menu instead.
+ * @related chat, command-menu, command-item, command-palette
+ * @a11yPattern WAI-ARIA Combobox with Listbox Popup
+ * @keyboardShortcut ArrowUp / ArrowDown | Moves the active suggestion.
+ * @keyboardShortcut Enter | Selects the active suggestion.
+ * @keyboardShortcut Escape | Dismisses the suggestion popover.
+ * @a11yNote Passes combobox role and aria-expanded, aria-controls, aria-activedescendant, and aria-autocomplete through to ChatInput's composer overlay API.
+ */
+export type { ChatComposerPopoverComposerProps, ChatComposerPopoverItem, ChatComposerPopoverItemSnippetContext, ChatComposerPopoverProps, ChatComposerPopoverSelection, ChatComposerPopoverTriggerMatch, } from './chat-composer-popover.types.ts';
+export { filterFuzzySubsequence, fuzzySubsequenceScore, type FuzzyFilterItem, type FuzzyFilterResult, } from './chat-composer-popover-filter.ts';
+import type { ChatComposerPopoverItem, ChatComposerPopoverProps } from './chat-composer-popover.types.ts';
+declare function $$render<TItem extends ChatComposerPopoverItem>(): {
+    props: ChatComposerPopoverProps<TItem>;
+    exports: {};
+    bindings: "value";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<TItem extends ChatComposerPopoverItem> {
+    props(): ReturnType<typeof $$render<TItem>>['props'];
+    events(): ReturnType<typeof $$render<TItem>>['events'];
+    slots(): ReturnType<typeof $$render<TItem>>['slots'];
+    bindings(): "value";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TItem extends ChatComposerPopoverItem>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TItem>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TItem>['props']>, ReturnType<__sveltets_Render<TItem>['events']>, ReturnType<__sveltets_Render<TItem>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TItem>['bindings']>;
+    } & ReturnType<__sveltets_Render<TItem>['exports']>;
+    <TItem extends ChatComposerPopoverItem>(internal: unknown, props: ReturnType<__sveltets_Render<TItem>['props']> & {}): ReturnType<__sveltets_Render<TItem>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const ChatComposerPopover: $$IsomorphicComponent;
+type ChatComposerPopover<TItem extends ChatComposerPopoverItem> = InstanceType<typeof ChatComposerPopover<TItem>>;
+export default ChatComposerPopover;

package/dist/components/chat-composer-popover/chat-composer-popover.types.d.ts

@@ -0,0 +1,77 @@
+import type { Snippet } from 'svelte';
+import type { PopoverPlacement } from '../popover/popover.types.ts';
+export type ChatComposerPopoverItem = {
+    /** Stable submitted value surfaced through onselect. */
+    value: string;
+    /** Default visible and accessible label for the command row. */
+    label: string;
+    /** Optional secondary text for the command row. */
+    description?: string | undefined;
+    /** Optional fuzzy-search aliases. */
+    keywords?: readonly string[] | undefined;
+    /** Whether this row is skipped by keyboard navigation and activation. */
+    disabled?: boolean | undefined;
+};
+export type ChatComposerPopoverTriggerMatch = {
+    active: true;
+    trigger: string;
+    query: string;
+    start: number;
+    end: number;
+};
+export type ChatComposerPopoverSelection<TItem extends ChatComposerPopoverItem> = {
+    item: TItem;
+    value: string;
+    query: string;
+    trigger: string;
+    range: {
+        start: number;
+        end: number;
+    };
+};
+export type ChatComposerPopoverComposerProps = {
+    composerRole: 'combobox';
+    composerAriaExpanded: boolean;
+    composerAriaControls: string | undefined;
+    composerAriaActiveDescendant: string | undefined;
+    composerAriaAutocomplete: 'list';
+    oncomposerinput: (value: string, event?: Event) => void;
+    oncomposerkeydown: (event: KeyboardEvent) => void;
+    oncomposerselectionchange: (event: Event) => void;
+    oncomposerblur: (event: FocusEvent) => void;
+};
+export type ChatComposerPopoverItemSnippetContext<TItem extends ChatComposerPopoverItem> = {
+    item: TItem;
+    query: string;
+    trigger: string;
+};
+export type ChatComposerPopoverProps<TItem extends ChatComposerPopoverItem> = {
+    /** Unique identifier used for the listbox and item ids. */
+    id: string;
+    /** Current composer value. Bind this to the same value as ChatInput. */
+    value?: string;
+    /** Consumer-owned command or mention definitions. */
+    items: readonly TItem[];
+    /** Trigger characters that open the popover. Default `['/', '@']`. */
+    triggers?: readonly string[];
+    /** Accessible listbox label. Default `'Composer suggestions'`. */
+    label?: string;
+    /** Caret-relative placement. Default `'bottom-start'`. */
+    placement?: PopoverPlacement;
+    /** Distance in px between the caret and popover. Default `6`. */
+    offset?: number;
+    /** Render the ChatInput or compatible composer with the provided overlay props. */
+    composer: Snippet<[ChatComposerPopoverComposerProps]>;
+    /** Optional custom row contents. Defaults to the item label and description. */
+    item?: Snippet<[ChatComposerPopoverItemSnippetContext<TItem>]>;
+    /** Optional empty state rendered when filtering produces no matching rows. */
+    empty?: Snippet;
+    /** Override trigger detection. */
+    detectTrigger?: (value: string, selectionStart: number, selectionEnd: number) => ChatComposerPopoverTriggerMatch | null;
+    /** Override filtering. */
+    filter?: (items: readonly TItem[], query: string, trigger: string) => readonly TItem[];
+    /** Invoked when an enabled item is selected by keyboard or pointer. */
+    onselect?: (selection: ChatComposerPopoverSelection<TItem>) => void;
+    /** Invoked when Escape, trigger loss, or outside pointerdown dismisses the popover. */
+    ondismiss?: () => void;
+};

package/dist/components/chat-composer-popover/chat-composer-popover.variables.d.ts

@@ -0,0 +1,2 @@
+declare const variables: readonly string[];
+export default variables;

package/dist/components/chat-composer-popover/chat-composer-popover.variables.js

@@ -0,0 +1,61 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/components/chat-composer-popover/chat-composer-popover.variables.ts
+var variables = [];
+var chat_composer_popover_variables_default = variables;
+export {
+  chat_composer_popover_variables_default as default
+};
+
+//# debugId=F762A3C05DFE401A64756E2164756E21

package/dist/components/chat-composer-popover/index.d.ts

@@ -0,0 +1,6 @@
+import './chat-composer-popover.css';
+import ChatComposerPopover from './chat-composer-popover.svelte';
+export default ChatComposerPopover;
+export { filterFuzzySubsequence, fuzzySubsequenceScore, type FuzzyFilterItem, type FuzzyFilterResult, } from './chat-composer-popover-filter.ts';
+export type { ChatComposerPopoverComposerProps, ChatComposerPopoverItem, ChatComposerPopoverItemSnippetContext, ChatComposerPopoverProps, ChatComposerPopoverSelection, ChatComposerPopoverTriggerMatch, } from './chat-composer-popover.types.ts';
+export { ChatComposerPopover };