@kine-design/core 0.0.1-beta.11 → 0.0.1-beta.13

package/dist/compositions/contextMenu/useContextMenu.d.ts

@@ -0,0 +1,52 @@
+import { MenuItem } from './types';
+export declare function useContextMenu(): {
+    isOpen: import('vue').Ref<boolean, boolean>;
+    position: import('vue').Ref<{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    } | {
+        x: number;
+        y: number;
+    }>;
+    items: import('vue').Ref<{
+        key: string;
+        label: string;
+        icon?: (() => import('vue').VNode) | undefined;
+        action: () => void;
+        visible?: boolean | undefined;
+        disabled?: boolean | undefined;
+        danger?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        separator?: boolean | undefined;
+    }[], MenuItem[] | {
+        key: string;
+        label: string;
+        icon?: (() => import('vue').VNode) | undefined;
+        action: () => void;
+        visible?: boolean | undefined;
+        disabled?: boolean | undefined;
+        danger?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        separator?: boolean | undefined;
+    }[]>;
+    activeIndex: import('vue').Ref<number, number>;
+    visibleItems: import('vue').ComputedRef<{
+        key: string;
+        label: string;
+        icon?: (() => import('vue').VNode) | undefined;
+        action: () => void;
+        visible?: boolean | undefined;
+        disabled?: boolean | undefined;
+        danger?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        separator?: boolean | undefined;
+    }[]>;
+    open: (event: MouseEvent, menuItems: MenuItem[]) => void;
+    close: () => void;
+    moveUp: () => void;
+    moveDown: () => void;
+    executeCurrent: () => void;
+};

package/dist/compositions/editor/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description Editor composition barrel export
+ * @author kine-design
+ * @date 2026/5/22
+ * @version v1.0.0
+ *
+ * Headless editor composable — provides logic, no rendering.
+ */
+export { useEditor } from './useEditor';
+export type { UseEditorOptions, EditorConfig, EditorToolbarConfig, EditorExtensionConfig, EditorToolbarActions, EditorActiveState, UseEditorReturn, } from './types';

package/dist/compositions/editor/types.d.ts

@@ -0,0 +1,132 @@
+import { Editor } from '@tiptap/core';
+import { ShallowRef, Ref, ComputedRef } from 'vue';
+/**
+ * Toolbar feature toggle. Each key controls visibility of a toolbar group.
+ * All default to true when omitted.
+ */
+export interface EditorToolbarConfig {
+    bold?: boolean;
+    italic?: boolean;
+    strike?: boolean;
+    code?: boolean;
+    heading?: boolean;
+    bulletList?: boolean;
+    orderedList?: boolean;
+    blockquote?: boolean;
+    codeBlock?: boolean;
+    link?: boolean;
+    image?: boolean;
+    textAlign?: boolean;
+    undo?: boolean;
+}
+/**
+ * Extension-level configuration that is forwarded to individual tiptap extensions.
+ */
+export interface EditorExtensionConfig {
+    link?: {
+        openOnClick?: boolean;
+        HTMLAttributes?: Record<string, string>;
+    };
+    image?: {
+        allowBase64?: boolean;
+        HTMLAttributes?: Record<string, string>;
+    };
+    placeholder?: {
+        text?: string;
+    };
+}
+/**
+ * Top-level editor configuration passed via props.
+ */
+export interface EditorConfig {
+    toolbar?: EditorToolbarConfig;
+    extensions?: EditorExtensionConfig;
+}
+/**
+ * Options accepted by the useEditor composable.
+ */
+export interface UseEditorOptions {
+    /** Initial HTML or plain-text content */
+    content?: string;
+    /** When true the editor is not editable */
+    readonly?: boolean;
+    /** Placeholder text shown when the editor is empty */
+    placeholder?: string;
+    /** Feature configuration */
+    config?: EditorConfig;
+    /** Callback fired when content changes (HTML string) */
+    onUpdate?: (html: string) => void;
+    /** Callback fired when the editor is ready */
+    onReady?: () => void;
+    /** Callback fired on focus */
+    onFocus?: () => void;
+    /** Callback fired on blur */
+    onBlur?: () => void;
+}
+/**
+ * Toolbar action functions returned by the composable.
+ */
+export interface EditorToolbarActions {
+    toggleBold: () => void;
+    toggleItalic: () => void;
+    toggleStrike: () => void;
+    toggleCode: () => void;
+    setParagraph: () => void;
+    setHeading: (level: 1 | 2 | 3) => void;
+    toggleBulletList: () => void;
+    toggleOrderedList: () => void;
+    toggleBlockquote: () => void;
+    toggleCodeBlock: () => void;
+    setLink: (href: string) => void;
+    unsetLink: () => void;
+    setImage: (src: string, alt?: string) => void;
+    setTextAlign: (alignment: 'left' | 'center' | 'right') => void;
+    undo: () => void;
+    redo: () => void;
+    focus: () => void;
+    blur: () => void;
+    clear: () => void;
+}
+/**
+ * Active-state flags for toolbar highlighting.
+ */
+export interface EditorActiveState {
+    bold: boolean;
+    italic: boolean;
+    strike: boolean;
+    code: boolean;
+    paragraph: boolean;
+    heading1: boolean;
+    heading2: boolean;
+    heading3: boolean;
+    bulletList: boolean;
+    orderedList: boolean;
+    blockquote: boolean;
+    codeBlock: boolean;
+    link: boolean;
+}
+/**
+ * Return type of the useEditor composable.
+ */
+export interface UseEditorReturn {
+    /** The raw tiptap Editor instance (may be null before creation) */
+    editor: ShallowRef<Editor | undefined>;
+    /** Whether the editor has been created and is ready */
+    isReady: Ref<boolean>;
+    /** Toolbar action methods */
+    actions: ComputedRef<EditorToolbarActions | null>;
+    /** Active formatting state */
+    activeState: ComputedRef<EditorActiveState>;
+    /** Update editor content programmatically */
+    setContent: (html: string) => void;
+    /** Toggle the editable state */
+    setEditable: (editable: boolean) => void;
+    /** Get current content as HTML */
+    getHTML: () => string;
+    /** Get current content as plain text */
+    getText: () => string;
+    /** Whether undo is available */
+    canUndo: ComputedRef<boolean>;
+    /** Whether redo is available */
+    canRedo: ComputedRef<boolean>;
+}

package/dist/compositions/editor/useEditor.d.ts

@@ -0,0 +1,13 @@
+import { UseEditorOptions, EditorToolbarActions, EditorActiveState } from './types';
+export declare function useEditor(options?: UseEditorOptions): {
+    editor: import('vue').ShallowRef<import('@tiptap/vue-3').Editor | undefined, import('@tiptap/vue-3').Editor | undefined>;
+    isReady: import('vue').Ref<boolean, boolean>;
+    actions: import('vue').ComputedRef<EditorToolbarActions | null>;
+    activeState: import('vue').ComputedRef<EditorActiveState>;
+    setContent: (html: string) => void;
+    setEditable: (editable: boolean) => void;
+    getHTML: () => string;
+    getText: () => string;
+    canUndo: import('vue').ComputedRef<boolean>;
+    canRedo: import('vue').ComputedRef<boolean>;
+};

package/dist/compositions/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @description compositions barrel export
+ * @author kine-design
+ * @date 2026/5/22 00:00
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export * from './overlay';
+export * from './contextMenu';
+export * from './peekView';
+export * from './commandPalette';
+export * from './tooltip';
+export * from './editor';
+export * from './theme';

package/dist/compositions/overlay/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description overlay composables barrel export
+ * @author kine-design
+ * @date 2026/5/22 00:00
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { useOverlayStackStore, useOverlayStack, useOverlayItem, } from './useOverlayStack';
+export type { OverlayItem, OverlayType } from './useOverlayStack';

package/dist/compositions/overlay/useOverlayStack.d.ts

@@ -0,0 +1,188 @@
+export type OverlayType = 'popover' | 'alert-dialog' | 'context-menu' | 'command-palette';
+export interface OverlayItem {
+    id: string;
+    type: OverlayType;
+    close: () => void;
+    zIndex: number;
+}
+export declare const useOverlayStackStore: import('pinia').StoreDefinition<"overlayStack", Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "overlayStack">, Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "isEmpty" | "topItem">, Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "pop" | "push" | "remove" | "attachEscListener" | "detachEscListener">>;
+export declare function useOverlayStack(): import('pinia').Store<"overlayStack", Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "overlayStack">, Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "isEmpty" | "topItem">, Pick<{
+    overlayStack: import('vue').Ref<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[], OverlayItem[] | {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    }[]>;
+    isEmpty: import('vue').ComputedRef<boolean>;
+    topItem: import('vue').ComputedRef<{
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined>;
+    push: (item: Omit<OverlayItem, "zIndex">) => OverlayItem;
+    pop: () => {
+        id: string;
+        type: OverlayType;
+        close: () => void;
+        zIndex: number;
+    } | undefined;
+    remove: (id: string) => void;
+    attachEscListener: () => void;
+    detachEscListener: () => void;
+}, "pop" | "push" | "remove" | "attachEscListener" | "detachEscListener">>;
+export declare function useOverlayItem(type: OverlayType): {
+    register: (closeFn: () => void) => OverlayItem;
+    unregister: () => void;
+    currentZIndex: import('vue').ComputedRef<number | undefined>;
+};

package/dist/compositions/peekView/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description peekView composables barrel export
+ * @author kine-design
+ * @date 2026/5/22
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { usePeekView } from './usePeekView';
+export type { PeekViewMode, UsePeekViewOptions } from './usePeekView';

package/dist/compositions/peekView/usePeekView.d.ts

@@ -0,0 +1,16 @@
+export type PeekViewMode = 'side' | 'modal' | 'full';
+export interface UsePeekViewOptions {
+    /** Default mode when opening without explicit mode */
+    defaultMode?: PeekViewMode;
+    /** Enable URL query param sync (?peek=<id>) */
+    urlSync?: boolean;
+}
+export declare function usePeekView(options?: UsePeekViewOptions): {
+    isOpen: import('vue').Ref<boolean, boolean>;
+    mode: import('vue').Ref<PeekViewMode, PeekViewMode>;
+    peekId: import('vue').Ref<string | undefined, string | undefined>;
+    open: (id: string, openMode?: PeekViewMode) => void;
+    close: () => void;
+    setMode: (newMode: PeekViewMode) => void;
+    handleOutsideClick: (event: MouseEvent, panelEl: HTMLElement | null) => void;
+};

package/dist/compositions/theme/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @description theme composables barrel export
+ * @author kine-design
+ * @date 2026/5/22
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { useThemeStore } from './useTheme';
+export type { ThemeDefinition, ThemeTokens, ThemeTokenCategory, ThemeOverrides, PersistedThemeState, } from './types';
+export { lightTheme, darkTheme, compactTheme } from './presets';

package/dist/compositions/theme/presets/compact.d.ts

@@ -0,0 +1,6 @@
+import { ThemeDefinition } from '../types';
+/**
+ * Compact theme inherits light colors but scales spacing/radius/font down by ~0.75.
+ * Shadow and motion stay unchanged.
+ */
+export declare const compactTheme: ThemeDefinition;

package/dist/compositions/theme/presets/dark.d.ts

@@ -0,0 +1,2 @@
+import { ThemeDefinition } from '../types';
+export declare const darkTheme: ThemeDefinition;

package/dist/compositions/theme/presets/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @description built-in theme presets barrel export
+ * @author kine-design
+ * @date 2026/5/22
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { lightTheme } from './light';
+export { darkTheme } from './dark';
+export { compactTheme } from './compact';

package/dist/compositions/theme/presets/light.d.ts

@@ -0,0 +1,2 @@
+import { ThemeDefinition } from '../types';
+export declare const lightTheme: ThemeDefinition;

package/dist/compositions/theme/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @description theme system type definitions
+ * @author kine-design
+ * @date 2026/5/22
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+/** Token category map: flat key-value pairs per category */
+export interface ThemeTokens {
+    /** e.g. 'bg-primary': '#f5f5f5', 'neutral-3': '#d4d4d4', 'accent-light': '#e8f5ef' */
+    color: Record<string, string>;
+    /** e.g. '1': '2px', '2': '4px' */
+    spacing: Record<string, string>;
+    /** e.g. 'xs': '2px', 'sm': '6px' */
+    radius: Record<string, string>;
+    /** e.g. 'size-sm': '12px', 'family-system': 'system-ui, ...' */
+    font: Record<string, string>;
+    /** e.g. 'sm': '0px 1px 2px ...', 'glow-radius': '8px' */
+    shadow: Record<string, string>;
+    /** e.g. 'duration-fast': '200ms', 'easing-default': 'ease-in-out' */
+    motion: Record<string, string>;
+    /** e.g. 'hover-intensity': '15%', 'transition-duration': '150ms' */
+    interaction: Record<string, string>;
+}
+/** All supported token category names */
+export type ThemeTokenCategory = keyof ThemeTokens;
+/** A registered theme definition */
+export interface ThemeDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    tokens: Partial<ThemeTokens>;
+}
+/** User-level per-token overrides (sparse) */
+export type ThemeOverrides = Partial<ThemeTokens>;
+/** Serialized state persisted to localStorage */
+export interface PersistedThemeState {
+    currentTheme: string;
+    overrides: ThemeOverrides;
+}