@vraxis/osx-components 0.11.3

package/types/index.d.ts

@@ -0,0 +1,248 @@
+import type { DefineComponent } from "vue";
+
+export type OsxIconName = "activity" | "book" | "bot" | "boxes" | "check" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up" | "circle" | "circle-dashed" | "clock" | "code" | "command" | "copy" | "corner-down-left" | "download" | "ellipsis" | "external" | "eye" | "eye-off" | "file" | "file-code" | "file-text" | "flask" | "folder" | "folder-open" | "git-branch" | "grid" | "inbox" | "info" | "dashboard" | "list-checks" | "loader" | "lock" | "unlock" | "menu" | "minus" | "palette" | "panel" | "pencil" | "play" | "plus" | "refresh" | "search" | "send" | "settings" | "sparkle" | "square" | "stop" | "terminal" | "trash" | "warning" | "upload" | "user" | "close";
+export type OsxFormValueEvent<T> = CustomEvent<[value: T]>;
+export interface OsxFormAssociatedElement extends HTMLElement {
+  readonly form: HTMLFormElement | null;
+  readonly labels: NodeList;
+  readonly validity: ValidityState;
+  readonly validationMessage: string;
+  readonly willValidate: boolean;
+  checkValidity(): boolean;
+  reportValidity(): boolean;
+  setCustomValidity(message: string): void;
+}
+
+export type OsxAgentApprovalProps = {
+  title?: string;
+  description?: string;
+  risk?: "low" | "medium" | "high";
+  scope?: string;
+  approveLabel?: string;
+  rejectLabel?: string;
+  disabled?: boolean;
+};
+export type OsxAgentComposerProps = { value?: string; placeholder?: string; model?: string; busy?: boolean; disabled?: boolean; rows?: number };
+export type OsxAgentMessageProps = { messageRole?: "user" | "assistant" | "system"; author?: string; model?: string; timestamp?: string; status?: "complete" | "streaming" | "error" };
+export type OsxAgentRunStatusProps = { phase?: "planning" | "working" | "verifying" | "complete" | "error"; label?: string; detail?: string };
+export type OsxAlertProps = { tone?: "info" | "success" | "warning" | "error"; title?: string; description?: string; dismissible?: boolean; label?: string };
+export type OsxArtifactProps = { title?: string; description?: string; kind?: "file" | "document" | "code"; filename?: string; version?: string; language?: string; content?: string; href?: string; copyable?: boolean; downloadable?: boolean; openable?: boolean; status?: "draft" | "ready" | "updated" };
+export type OsxAvatarProps = { name?: string; src?: string; alt?: string; size?: number; status?: "none" | "online" | "busy" | "offline" };
+export type OsxBadgeProps = { tone?: "neutral" | "info" | "success" | "warning" | "danger"; size?: "small" | "medium"; label?: string; dot?: boolean };
+export type OsxAppShellProps = { appTitle?: string; sidebarWidth?: string; inspectorWidth?: string; inspectorOpen?: boolean; label?: string; resizable?: boolean; sidebarMinWidth?: number; sidebarMaxWidth?: number; inspectorMinWidth?: number; inspectorMaxWidth?: number };
+
+export type OsxButtonProps = {
+  variant?: "default" | "primary" | "danger";
+  size?: "small" | "medium";
+  type?: "button" | "submit" | "reset";
+  disabled?: boolean;
+  loading?: boolean;
+  icon?: OsxIconName;
+  iconPosition?: "leading" | "trailing";
+};
+
+export type OsxCheckboxProps = { checked?: boolean; label?: string; name?: string; value?: string; disabled?: boolean; required?: boolean; indeterminate?: boolean };
+export type OsxCopyProps = { as?: "p" | "span" | "div"; size?: "small" | "medium" | "large"; tone?: "default" | "muted" | "accent"; weight?: "regular" | "medium" | "bold"; measure?: "none" | "narrow" | "default" | "wide"; align?: "left" | "center" | "right" };
+export type OsxCitationProps = { index?: string | number; label?: string; title?: string; sourceId?: string; href?: string; selected?: boolean; disabled?: boolean };
+export type OsxDataTableColumn = { key: string; label: string; align?: "left" | "center" | "right"; sortable?: boolean; searchable?: boolean; width?: string };
+export type OsxDataTableRow = Record<string, string | number | boolean | null | undefined>;
+export type OsxDataTableProps = {
+  columns?: string | OsxDataTableColumn[];
+  rows?: string | OsxDataTableRow[];
+  caption?: string;
+  label?: string;
+  searchable?: boolean;
+  searchPlaceholder?: string;
+  query?: string;
+  compact?: boolean;
+  striped?: boolean;
+  stickyHeader?: boolean;
+  loading?: boolean;
+  loadingLabel?: string;
+  sortKey?: string;
+  sortDirection?: "ascending" | "descending";
+  page?: number;
+  pageSize?: number;
+  pageSizes?: string | number[];
+  serverMode?: boolean;
+  totalRows?: number;
+  selectable?: boolean;
+  selectedKeys?: string | Array<string | number>;
+  rowKey?: string;
+  activatable?: boolean;
+  emptyMessage?: string;
+  noResultsMessage?: string;
+};
+export type OsxDiffViewerProps = { file?: string; patch?: string; view?: "unified" | "split"; language?: string; additions?: number; deletions?: number; label?: string };
+export type OsxDialogProps = { open?: boolean; title?: string; description?: string; size?: "small" | "medium" | "large"; dismissible?: boolean; confirmLabel?: string; cancelLabel?: string };
+export type OsxEcosystemCardProps = { name?: string; category?: string; description?: string; href?: string; actionLabel?: string; mark?: string; provenance?: string; trackingId?: string; tone?: "neutral" | "info" | "success" | "warning"; compact?: boolean; external?: boolean };
+export type OsxEmptyStateProps = { title?: string; description?: string; actionLabel?: string; icon?: OsxIconName };
+export type OsxFileTreeProps = { files?: string; selected?: string; statuses?: string; label?: string; filterable?: boolean };
+export type OsxIconProps = { name?: OsxIconName; size?: number; label?: string; strokeWidth?: number; absoluteStrokeWidth?: boolean };
+export type OsxIconButtonProps = { icon?: OsxIconName; label: string; size?: "small" | "medium" | "large"; variant?: "default" | "primary" | "danger"; disabled?: boolean; pressed?: boolean };
+export type OsxHeadingProps = { level?: 1 | 2 | 3 | 4 | 5 | 6; variant?: "display" | "title" | "section" | "label"; align?: "left" | "center" | "right"; tone?: "default" | "muted" | "accent" };
+export type OsxLinkProps = { href?: string; target?: "_self" | "_blank" | "_parent" | "_top"; rel?: string; external?: boolean; download?: boolean | string; underline?: "always" | "hover" | "none"; disabled?: boolean };
+export type OsxMenuProps = { open?: boolean; label?: string; placement?: "start" | "end" };
+export type OsxMenuItemProps = { label?: string; shortcut?: string; disabled?: boolean; checked?: boolean; type?: "action" | "checkbox" };
+export type OsxMarkdownProps = { content?: string; streaming?: boolean; label?: string; codeCopy?: boolean };
+export type OsxPlanStep = { id?: string; title: string; detail?: string; state?: "pending" | "active" | "done" | "failed" | "skipped" };
+export type OsxPlanProps = { steps?: string | OsxPlanStep[]; title?: string; label?: string; compact?: boolean; showProgress?: boolean };
+export type OsxPopoverProps = { open?: boolean; placement?: "top" | "right" | "bottom" | "left"; label?: string; dismissible?: boolean };
+export type OsxProgressProps = { value?: number; max?: number; indeterminate?: boolean; label?: string };
+export type OsxRadioOption = { value: string; label: string; description?: string; disabled?: boolean };
+export type OsxRadioGroupProps = { options?: string | OsxRadioOption[]; value?: string; label?: string; name?: string; disabled?: boolean; required?: boolean; invalid?: boolean; hint?: string; error?: string; orientation?: "horizontal" | "vertical"; variant?: "default" | "cards" };
+export type OsxSegmentedControlProps = { items?: string; value?: string; label?: string; disabled?: boolean };
+export type OsxSelectOption = { value: string; label: string; disabled?: boolean };
+export type OsxSelectProps = { options?: string | OsxSelectOption[]; value?: string; label?: string; name?: string; disabled?: boolean; required?: boolean; invalid?: boolean; hint?: string; error?: string };
+export type OsxSheetProps = { open?: boolean; title?: string; description?: string; dismissible?: boolean };
+export type OsxShimmerProps = { width?: string; height?: string; radius?: string; paused?: boolean; label?: string };
+export type OsxSkeletonProps = { variant?: "text" | "card" | "profile"; lines?: number; animated?: boolean; label?: string };
+export type OsxSpinnerProps = { size?: "small" | "medium" | "large"; tone?: "default" | "accent" | "inverse"; label?: string; showLabel?: boolean; paused?: boolean };
+export type OsxSourceListProps = { items?: string; value?: string; label?: string; heading?: string; compact?: boolean; icons?: string };
+export type OsxSourceItem = { id: string; title: string; url?: string; domain?: string; snippet?: string };
+export type OsxSourcePanelProps = { sources?: string | OsxSourceItem[]; title?: string; label?: string; selected?: string; compact?: boolean };
+export type OsxSplitViewProps = { orientation?: "horizontal" | "vertical"; primarySize?: string; label?: string };
+export type OsxStatusBarProps = { label?: string; status?: "ready" | "working" | "offline"; detail?: string };
+export type OsxTableColumn = { key: string; label: string; align?: "left" | "center" | "right"; sortable?: boolean; width?: string };
+export type OsxTableRow = Record<string, string | number | boolean | null | undefined>;
+export type OsxTableProps = { columns?: string | OsxTableColumn[]; rows?: string | OsxTableRow[]; caption?: string; label?: string; compact?: boolean; striped?: boolean; stickyHeader?: boolean; sortKey?: string; sortDirection?: "ascending" | "descending"; emptyMessage?: string };
+export type OsxTextAreaProps = { value?: string; label?: string; placeholder?: string; name?: string; rows?: number; maxlength?: number; disabled?: boolean; readonly?: boolean; required?: boolean; invalid?: boolean; hint?: string; error?: string; resize?: "none" | "vertical" | "horizontal" | "both" };
+export type OsxTextFieldProps = {
+  value?: string;
+  label?: string;
+  placeholder?: string;
+  type?: "text" | "email" | "password" | "search" | "tel" | "url";
+  name?: string;
+  autocomplete?: string;
+  maxlength?: number;
+  disabled?: boolean;
+  readonly?: boolean;
+  required?: boolean;
+  invalid?: boolean;
+  hint?: string;
+  error?: string;
+  icon?: OsxIconName;
+  iconPosition?: "leading" | "trailing";
+};
+export type OsxThinkingProps = { title?: string; summary?: string; status?: "idle" | "streaming" | "complete" | "error"; open?: boolean; label?: string };
+export type OsxTerminalProps = { title?: string; command?: string; output?: string; cwd?: string; status?: "idle" | "running" | "success" | "error"; duration?: string; label?: string };
+export type OsxTabsProps = { items?: string; value?: string; label?: string; orientation?: "horizontal" | "vertical" };
+export type OsxToolbarProps = { label?: string; compact?: boolean };
+export type OsxToggleProps = { checked?: boolean; label?: string; description?: string; name?: string; value?: string; disabled?: boolean; required?: boolean };
+export type OsxToastProps = { open?: boolean; tone?: "info" | "success" | "warning" | "error"; title?: string; message?: string; duration?: number; placement?: "top-right" | "top-left" | "bottom-right" | "bottom-left"; dismissible?: boolean; contained?: boolean };
+export type OsxTooltipProps = { text?: string; placement?: "top" | "right" | "bottom" | "left"; open?: boolean; delay?: number };
+export type OsxToolCallProps = { name?: string; status?: "queued" | "running" | "success" | "error"; summary?: string; duration?: string; open?: boolean };
+export type OsxWindowProps = { title?: string; subtitle?: string; active?: boolean; closeable?: boolean; minimizable?: boolean; zoomable?: boolean };
+
+export const OsxAgentApprovalComponent: DefineComponent<OsxAgentApprovalProps>;
+export const OsxAgentComposerComponent: DefineComponent<OsxAgentComposerProps>;
+export const OsxAgentMessageComponent: DefineComponent<OsxAgentMessageProps>;
+export const OsxAgentRunStatusComponent: DefineComponent<OsxAgentRunStatusProps>;
+export const OsxAlertComponent: DefineComponent<OsxAlertProps>;
+export const OsxArtifactComponent: DefineComponent<OsxArtifactProps>;
+export const OsxAvatarComponent: DefineComponent<OsxAvatarProps>;
+export const OsxBadgeComponent: DefineComponent<OsxBadgeProps>;
+export const OsxAppShellComponent: DefineComponent<OsxAppShellProps>;
+export const OsxButtonComponent: DefineComponent<OsxButtonProps>;
+export const OsxCheckboxComponent: DefineComponent<OsxCheckboxProps>;
+export const OsxCopyComponent: DefineComponent<OsxCopyProps>;
+export const OsxCitationComponent: DefineComponent<OsxCitationProps>;
+export const OsxDataTableComponent: DefineComponent<OsxDataTableProps>;
+export const OsxDiffViewerComponent: DefineComponent<OsxDiffViewerProps>;
+export const OsxDialogComponent: DefineComponent<OsxDialogProps>;
+export const OsxEcosystemCardComponent: DefineComponent<OsxEcosystemCardProps>;
+export const OsxEmptyStateComponent: DefineComponent<OsxEmptyStateProps>;
+export const OsxFileTreeComponent: DefineComponent<OsxFileTreeProps>;
+export const OsxIconComponent: DefineComponent<OsxIconProps>;
+export const OsxIconButtonComponent: DefineComponent<OsxIconButtonProps>;
+export const OsxHeadingComponent: DefineComponent<OsxHeadingProps>;
+export const OsxLinkComponent: DefineComponent<OsxLinkProps>;
+export const OsxMenuComponent: DefineComponent<OsxMenuProps>;
+export const OsxMenuItemComponent: DefineComponent<OsxMenuItemProps>;
+export const OsxMarkdownComponent: DefineComponent<OsxMarkdownProps>;
+export const OsxPlanComponent: DefineComponent<OsxPlanProps>;
+export const OsxPopoverComponent: DefineComponent<OsxPopoverProps>;
+export const OsxProgressComponent: DefineComponent<OsxProgressProps>;
+export const OsxRadioGroupComponent: DefineComponent<OsxRadioGroupProps>;
+export const OsxSegmentedControlComponent: DefineComponent<OsxSegmentedControlProps>;
+export const OsxSelectComponent: DefineComponent<OsxSelectProps>;
+export const OsxSheetComponent: DefineComponent<OsxSheetProps>;
+export const OsxShimmerComponent: DefineComponent<OsxShimmerProps>;
+export const OsxSkeletonComponent: DefineComponent<OsxSkeletonProps>;
+export const OsxSpinnerComponent: DefineComponent<OsxSpinnerProps>;
+export const OsxSourceListComponent: DefineComponent<OsxSourceListProps>;
+export const OsxSourcePanelComponent: DefineComponent<OsxSourcePanelProps>;
+export const OsxSplitViewComponent: DefineComponent<OsxSplitViewProps>;
+export const OsxStatusBarComponent: DefineComponent<OsxStatusBarProps>;
+export const OsxTableComponent: DefineComponent<OsxTableProps>;
+export const OsxTextAreaComponent: DefineComponent<OsxTextAreaProps>;
+export const OsxTextFieldComponent: DefineComponent<OsxTextFieldProps>;
+export const OsxThinkingComponent: DefineComponent<OsxThinkingProps>;
+export const OsxTerminalComponent: DefineComponent<OsxTerminalProps>;
+export const OsxTabsComponent: DefineComponent<OsxTabsProps>;
+export const OsxToolbarComponent: DefineComponent<OsxToolbarProps>;
+export const OsxToggleComponent: DefineComponent<OsxToggleProps>;
+export const OsxToastComponent: DefineComponent<OsxToastProps>;
+export const OsxTooltipComponent: DefineComponent<OsxTooltipProps>;
+export const OsxToolCallComponent: DefineComponent<OsxToolCallProps>;
+export const OsxWindowComponent: DefineComponent<OsxWindowProps>;
+
+export const componentDefinitions: {
+  "osx-agent-approval": typeof OsxAgentApprovalComponent;
+  "osx-agent-composer": typeof OsxAgentComposerComponent;
+  "osx-agent-message": typeof OsxAgentMessageComponent;
+  "osx-agent-run-status": typeof OsxAgentRunStatusComponent;
+  "osx-alert": typeof OsxAlertComponent;
+  "osx-artifact": typeof OsxArtifactComponent;
+  "osx-avatar": typeof OsxAvatarComponent;
+  "osx-badge": typeof OsxBadgeComponent;
+  "osx-app-shell": typeof OsxAppShellComponent;
+  "osx-button": typeof OsxButtonComponent;
+  "osx-checkbox": typeof OsxCheckboxComponent;
+  "osx-copy": typeof OsxCopyComponent;
+  "osx-citation": typeof OsxCitationComponent;
+  "osx-data-table": typeof OsxDataTableComponent;
+  "osx-diff-viewer": typeof OsxDiffViewerComponent;
+  "osx-dialog": typeof OsxDialogComponent;
+  "osx-ecosystem-card": typeof OsxEcosystemCardComponent;
+  "osx-empty-state": typeof OsxEmptyStateComponent;
+  "osx-file-tree": typeof OsxFileTreeComponent;
+  "osx-icon": typeof OsxIconComponent;
+  "osx-icon-button": typeof OsxIconButtonComponent;
+  "osx-heading": typeof OsxHeadingComponent;
+  "osx-link": typeof OsxLinkComponent;
+  "osx-menu": typeof OsxMenuComponent;
+  "osx-menu-item": typeof OsxMenuItemComponent;
+  "osx-markdown": typeof OsxMarkdownComponent;
+  "osx-plan": typeof OsxPlanComponent;
+  "osx-popover": typeof OsxPopoverComponent;
+  "osx-progress": typeof OsxProgressComponent;
+  "osx-radio-group": typeof OsxRadioGroupComponent;
+  "osx-segmented-control": typeof OsxSegmentedControlComponent;
+  "osx-select": typeof OsxSelectComponent;
+  "osx-sheet": typeof OsxSheetComponent;
+  "osx-shimmer": typeof OsxShimmerComponent;
+  "osx-skeleton": typeof OsxSkeletonComponent;
+  "osx-spinner": typeof OsxSpinnerComponent;
+  "osx-source-list": typeof OsxSourceListComponent;
+  "osx-source-panel": typeof OsxSourcePanelComponent;
+  "osx-split-view": typeof OsxSplitViewComponent;
+  "osx-status-bar": typeof OsxStatusBarComponent;
+  "osx-table": typeof OsxTableComponent;
+  "osx-textarea": typeof OsxTextAreaComponent;
+  "osx-text-field": typeof OsxTextFieldComponent;
+  "osx-thinking": typeof OsxThinkingComponent;
+  "osx-terminal": typeof OsxTerminalComponent;
+  "osx-tabs": typeof OsxTabsComponent;
+  "osx-toolbar": typeof OsxToolbarComponent;
+  "osx-toggle": typeof OsxToggleComponent;
+  "osx-toast": typeof OsxToastComponent;
+  "osx-tooltip": typeof OsxTooltipComponent;
+  "osx-tool-call": typeof OsxToolCallComponent;
+  "osx-window": typeof OsxWindowComponent;
+};
+
+export type OsxComponentName = keyof typeof componentDefinitions;
+export function registerOsxComponents(): void;
+export const iconNames: OsxIconName[];
+export const iconRegistry: Record<OsxIconName, DefineComponent>;