@construct-space/ui 0.2.0 → 0.3.1

package/dist/components/Autocomplete.vue.d.ts

@@ -0,0 +1,30 @@
+export interface AutocompleteOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+type __VLS_Props = {
+    modelValue?: string | number | null;
+    options?: AutocompleteOption[] | string[];
+    placeholder?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    icon?: string;
+    emptyText?: string;
+    clearable?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | number | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | number | null) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: string | number | null;
+    placeholder: string;
+    size: "xs" | "sm" | "md" | "lg";
+    options: AutocompleteOption[] | string[];
+    emptyText: string;
+    clearable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/Breadcrumbs.vue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Breadcrumbs — Construct UI
+ * Navigation breadcrumb trail with chevron separators.
+ */
+export interface BreadcrumbItem {
+    label: string;
+    to?: string;
+    icon?: string;
+}
+type __VLS_Props = {
+    items: BreadcrumbItem[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    navigate: (item: BreadcrumbItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onNavigate?: ((item: BreadcrumbItem) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/DatePicker.vue.d.ts

@@ -0,0 +1,21 @@
+type __VLS_Props = {
+    modelValue?: string | null;
+    placeholder?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    min?: string;
+    max?: string;
+    format?: 'iso' | 'locale';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: string | null;
+    placeholder: string;
+    size: "xs" | "sm" | "md" | "lg";
+    format: "iso" | "locale";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/FileInput.vue.d.ts

@@ -0,0 +1,21 @@
+type __VLS_Props = {
+    modelValue?: File | File[] | null;
+    accept?: string;
+    multiple?: boolean;
+    disabled?: boolean;
+    maxSize?: number;
+    placeholder?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: File | File[] | null) => any;
+    error: (message: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: File | File[] | null) => any) | undefined;
+    onError?: ((message: string) => any) | undefined;
+}>, {
+    disabled: boolean;
+    multiple: boolean;
+    modelValue: File | File[] | null;
+    placeholder: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/MultiSelect.vue.d.ts

@@ -0,0 +1,27 @@
+export interface MultiSelectOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+type __VLS_Props = {
+    modelValue?: string[];
+    options?: MultiSelectOption[] | string[];
+    placeholder?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    searchable?: boolean;
+    max?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: string[];
+    placeholder: string;
+    size: "xs" | "sm" | "md" | "lg";
+    options: MultiSelectOption[] | string[];
+    searchable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/Sidebar3D.vue.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Sidebar3D — Construct UI
+ * 3D rotating dock sidebar with front + side panel.
+ * 72px wide, CSS 3D cube rotation on space enter/exit.
+ */
+export interface SidebarItem {
+    id: string;
+    icon: string;
+    label: string;
+    to?: string;
+    active?: boolean;
+    badge?: string | number;
+    color?: string;
+}
+export interface SidebarSection {
+    items: SidebarItem[];
+    separator?: boolean;
+}
+type __VLS_Props = {
+    /** Main panel sections (front face) */
+    sections?: SidebarSection[];
+    /** Side panel items (right face, shown when rotated) */
+    sideItems?: SidebarItem[];
+    /** Back button label for side panel */
+    sideBackLabel?: string;
+    /** Whether the sidebar is rotated to show side panel */
+    rotated?: boolean;
+    /** Logo slot or icon name */
+    logoIcon?: string;
+    /** Avatar initials for bottom */
+    avatar?: string;
+    /** Avatar active/menu state */
+    avatarActive?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_13: {};
+type __VLS_Slots = {} & {
+    logo?: (props: typeof __VLS_1) => any;
+} & {
+    'logo-icon'?: (props: typeof __VLS_3) => any;
+} & {
+    bottom?: (props: typeof __VLS_13) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "item-click": (item: SidebarItem) => any;
+    back: () => any;
+    "logo-click": () => any;
+    "avatar-click": () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onItem-click"?: ((item: SidebarItem) => any) | undefined;
+    onBack?: (() => any) | undefined;
+    "onLogo-click"?: (() => any) | undefined;
+    "onAvatar-click"?: (() => any) | undefined;
+}>, {
+    sections: SidebarSection[];
+    sideItems: SidebarItem[];
+    sideBackLabel: string;
+    rotated: boolean;
+    avatar: string;
+    avatarActive: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ToggleGroup.vue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ToggleGroup — Construct UI
+ * Segmented control / button group for single or multi selection.
+ */
+export interface ToggleOption {
+    label: string;
+    value: string;
+    icon?: string;
+    disabled?: boolean;
+}
+type __VLS_Props = {
+    modelValue?: string | string[];
+    options: ToggleOption[] | string[];
+    multiple?: boolean;
+    size?: 'xs' | 'sm' | 'md';
+    disabled?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | string[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | string[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    multiple: boolean;
+    modelValue: string | string[];
+    size: "xs" | "sm" | "md";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/Toolbar3D.vue.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Toolbar3D — Construct UI
+ * 3D rotating toolbar that flips on page transitions.
+ * Rounded-right-only, inset margins, surface background.
+ */
+export interface ToolbarAction {
+    id: string;
+    icon: string;
+    label: string;
+    active?: boolean;
+    disabled?: boolean;
+}
+export interface BreadcrumbItem {
+    label: string;
+    to?: string;
+    icon?: string;
+}
+type __VLS_Props = {
+    /** Breadcrumb items for front panel */
+    breadcrumbs?: BreadcrumbItem[];
+    /** Action buttons on the right */
+    actions?: ToolbarAction[];
+    /** Next page breadcrumbs (bottom panel, shown during rotation) */
+    nextBreadcrumbs?: BreadcrumbItem[];
+    /** Next page actions */
+    nextActions?: ToolbarAction[];
+    /** Whether currently rotating */
+    rotating?: boolean;
+    /** Space icon to show before breadcrumbs */
+    spaceIcon?: string;
+    /** Space accent color */
+    spaceColor?: string;
+};
+declare var __VLS_1: {}, __VLS_7: {}, __VLS_9: {}, __VLS_15: {};
+type __VLS_Slots = {} & {
+    'space-icon'?: (props: typeof __VLS_1) => any;
+} & {
+    left?: (props: typeof __VLS_7) => any;
+} & {
+    center?: (props: typeof __VLS_9) => any;
+} & {
+    right?: (props: typeof __VLS_15) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "action-click": (action: ToolbarAction) => any;
+    "breadcrumb-click": (crumb: BreadcrumbItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onAction-click"?: ((action: ToolbarAction) => any) | undefined;
+    "onBreadcrumb-click"?: ((crumb: BreadcrumbItem) => any) | undefined;
+}>, {
+    breadcrumbs: BreadcrumbItem[];
+    actions: ToolbarAction[];
+    nextBreadcrumbs: BreadcrumbItem[];
+    nextActions: ToolbarAction[];
+    rotating: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/composables/useAsync.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from 'vue';
+export interface AsyncState<T> {
+    data: Ref<T | null>;
+    loading: Ref<boolean>;
+    error: Ref<string | null>;
+    execute: (...args: any[]) => Promise<T | null>;
+    reset: () => void;
+}
+export declare function useAsync<T>(fn: (...args: any[]) => Promise<T>): AsyncState<T>;

package/dist/composables/useClickOutside.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from 'vue';
+export declare function useClickOutside(target: Ref<HTMLElement | null>, handler: (e: MouseEvent) => void): void;

package/dist/composables/useClipboard.d.ts

@@ -0,0 +1,7 @@
+declare function copy(value: string): Promise<boolean>;
+export declare function useClipboard(): {
+    copied: import("vue").Ref<boolean, boolean>;
+    text: import("vue").Ref<string, string>;
+    copy: typeof copy;
+};
+export {};

package/dist/composables/useDebounce.d.ts

@@ -0,0 +1,7 @@
+import { type Ref } from 'vue';
+/** Returns a debounced ref that updates after `ms` delay */
+export declare function useDebounce<T>(source: Ref<T>, ms?: number): Ref<T>;
+/** Returns a throttled ref that updates at most once per `ms` */
+export declare function useThrottle<T>(source: Ref<T>, ms?: number): Ref<T>;
+/** Creates a debounced function */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, ms?: number): T;

package/dist/composables/useFormValidation.d.ts

@@ -0,0 +1,20 @@
+type ValidationRule = (value: any) => string | true;
+type FieldRules = Record<string, ValidationRule[]>;
+export declare function useFormValidation<T extends Record<string, any>>(initial: T, rules?: FieldRules): {
+    values: T;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    isValid: import("vue").ComputedRef<boolean>;
+    isDirty: import("vue").ComputedRef<boolean>;
+    submitting: import("vue").Ref<boolean, boolean>;
+    validate: (field?: string) => boolean;
+    touch: (field: string) => void;
+    reset: () => void;
+    handleSubmit: (fn: (values: T) => Promise<void> | void) => Promise<void>;
+};
+export declare const required: (msg?: string) => ValidationRule;
+export declare const minLength: (n: number, msg?: string) => ValidationRule;
+export declare const maxLength: (n: number, msg?: string) => ValidationRule;
+export declare const email: (msg?: string) => ValidationRule;
+export declare const pattern: (re: RegExp, msg?: string) => ValidationRule;
+export {};

package/dist/composables/useIntersectionObserver.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from 'vue';
+export declare function useIntersectionObserver(target: Ref<HTMLElement | null>, options?: IntersectionObserverInit): Ref<boolean, boolean>;

package/dist/composables/useKeyboard.d.ts

@@ -0,0 +1,16 @@
+export interface KeyBinding {
+    key: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    handler: (e: KeyboardEvent) => void;
+    prevent?: boolean;
+}
+export declare function useKeyboard(bindings: KeyBinding[]): void;
+/** Register a single keyboard shortcut */
+export declare function useHotkey(key: string, handler: () => void, modifiers?: {
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+}): void;

package/dist/composables/useLocalStorage.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from 'vue';
+export declare function useLocalStorage<T>(key: string, defaultValue: T): Ref<T>;

package/dist/composables/useMediaQuery.d.ts

@@ -0,0 +1,11 @@
+export declare function useMediaQuery(query: string): import("vue").Ref<boolean, boolean>;
+/** Preset breakpoints matching Tailwind defaults */
+export declare function useBreakpoints(): {
+    sm: import("vue").Ref<boolean, boolean>;
+    md: import("vue").Ref<boolean, boolean>;
+    lg: import("vue").Ref<boolean, boolean>;
+    xl: import("vue").Ref<boolean, boolean>;
+    xxl: import("vue").Ref<boolean, boolean>;
+    preferseDark: import("vue").Ref<boolean, boolean>;
+    prefersReducedMotion: import("vue").Ref<boolean, boolean>;
+};

package/dist/composables/{useToast.d.ts → useNotification.d.ts}

@@ -1,4 +1,4 @@
-export interface Toast {
+export interface Notification {
     id: string;
     title: string;
     description?: string;
@@ -9,11 +9,11 @@ export interface Toast {
         onClick: () => void;
     };
 }
-declare function add(toast: Omit<Toast, 'id'>): string;
+declare function add(notification: Omit<Notification, 'id'>): string;
 declare function remove(id: string): void;
 declare function clear(): void;
-export declare function useToast(): {
-    toasts: import("vue").Ref<{
+export declare function useNotification(): {
+    notifications: import("vue").Ref<{
         id: string;
         title: string;
         description?: string | undefined;
@@ -23,7 +23,7 @@ export declare function useToast(): {
             label: string;
             onClick: () => void;
         } | undefined;
-    }[], Toast[] | {
+    }[], Notification[] | {
         id: string;
         title: string;
         description?: string | undefined;
@@ -37,10 +37,12 @@ export declare function useToast(): {
     add: typeof add;
     remove: typeof remove;
     clear: typeof clear;
-    toast: {
+    notification: {
         add: typeof add;
         remove: typeof remove;
         clear: typeof clear;
     };
 };
+/** Quick notification helper — `notify('Saved!')` or `notify('Error', 'error')` */
+export declare function notify(title: string, color?: Notification['color'], description?: string): string;
 export {};

package/dist/composables/useSearch.d.ts

@@ -0,0 +1,15 @@
+import { type Ref } from 'vue';
+export interface UseSearchOptions<T> {
+    /** Fields to search in (dot notation supported) */
+    keys?: string[];
+    /** Debounce delay in ms */
+    debounce?: number;
+    /** Case sensitive */
+    caseSensitive?: boolean;
+}
+export declare function useSearch<T>(items: Ref<T[]>, options?: UseSearchOptions<T>): {
+    query: Ref<string, string>;
+    results: import("vue").ComputedRef<T[]>;
+    isEmpty: import("vue").ComputedRef<boolean>;
+    clear: () => void;
+};

package/dist/composables/useTheme.d.ts

@@ -0,0 +1,25 @@
+export interface Theme {
+    id: string;
+    name: string;
+    mode: 'light' | 'dark';
+    bg: string;
+    fg: string;
+    muted: string;
+    accent: string;
+    accentFg: string;
+}
+declare function applyTheme(theme: Theme): void;
+declare function setTheme(id: string): void;
+declare function registerTheme(theme: Theme): void;
+declare function init(): void;
+export declare function useTheme(): {
+    themes: import("vue").ComputedRef<Theme[]>;
+    currentTheme: import("vue").ComputedRef<Theme>;
+    currentThemeId: import("vue").Ref<string, string>;
+    isDark: import("vue").ComputedRef<boolean>;
+    setTheme: typeof setTheme;
+    applyTheme: typeof applyTheme;
+    registerTheme: typeof registerTheme;
+    init: typeof init;
+};
+export {};

package/dist/composables/useToggle.d.ts

@@ -0,0 +1,12 @@
+import { type Ref } from 'vue';
+export declare function useToggle(initial?: boolean): [Ref<boolean>, (value?: boolean) => void];
+export declare function useCounter(initial?: number, options?: {
+    min?: number;
+    max?: number;
+}): {
+    count: Ref<number, number>;
+    increment: (delta?: number) => void;
+    decrement: (delta?: number) => void;
+    reset: () => void;
+    set: (value: number) => void;
+};