@llumi/design-system 1.0.1 → 2.1.0

package/dist/types/components/review/comment-dialog.element.d.ts

@@ -1,29 +0,0 @@
-import { ReferenceElement } from '@floating-ui/dom';
-import { PropertyValues } from 'lit';
-import { TailwindElement } from '../../shared/tailwind-element';
-export declare class LlumiCommentDialog extends TailwindElement {
-    targetElement: HTMLElement | null;
-    /**
-     * Optional positioning reference that overrides `targetElement` — used for
-     * text-selection comments, where the dialog must anchor to the selected
-     * range's rect rather than the whole (potentially tall) selectable element.
-     * A floating-ui virtual element (`{ getBoundingClientRect() }`) is accepted.
-     */
-    anchor: ReferenceElement | null;
-    value: string;
-    private floating;
-    private cleanup?;
-    render(): import('lit').TemplateResult<1>;
-    private onEditorChange;
-    private onCancel;
-    private onDelete;
-    private startPositioning;
-    updated(changed: PropertyValues): void;
-    private focusEditor;
-    disconnectedCallback(): void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-comment-dialog": LlumiCommentDialog;
-    }
-}

package/dist/types/components/review/custom-target.utils.d.ts

@@ -1,16 +0,0 @@
-export interface CustomTarget {
-    selector: string;
-    toId: (element: HTMLElement) => string | null;
-}
-export declare function resolveTargetId(el: HTMLElement, customTargets?: CustomTarget[]): string | null;
-export declare function findClosestTarget(from: HTMLElement, customTargets?: CustomTarget[]): {
-    element: HTMLElement;
-    targetId: string;
-} | null;
-export type TargetKind = "element" | "selectable" | "both";
-export type ResolvedTarget = {
-    element: HTMLElement;
-    targetId: string;
-    kind: TargetKind;
-};
-export declare function queryAllTargets(wrapper: HTMLElement, customTargets?: CustomTarget[]): ResolvedTarget[];

package/dist/types/components/review/default-editor.element.d.ts

@@ -1,19 +0,0 @@
-import { TailwindElement } from '../../shared/tailwind-element';
-export declare class LlumiDefaultEditor extends TailwindElement {
-    value: string;
-    autoFocus: boolean;
-    placeholder: string;
-    private textarea;
-    /** Focus the inner textarea (the element itself isn't focusable). */
-    focus(): void;
-    render(): import('lit').TemplateResult<1>;
-    private onInput;
-    private autoGrow;
-    firstUpdated(): void;
-    updated(): void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-default-editor": LlumiDefaultEditor;
-    }
-}

package/dist/types/components/review/highlight-manager.d.ts

@@ -1,21 +0,0 @@
-import { CustomTarget } from './custom-target.utils';
-export interface ObserveCallbacks {
-    editingTarget?: HTMLElement | null;
-    onTargetDisconnected: () => void;
-    onSelectableReconnected: () => void;
-    commentedIds: Set<string>;
-}
-export declare function createHighlightManager(wrapper: HTMLElement, customTargets?: CustomTarget[]): {
-    activate: (commentedIds: Set<string>) => void;
-    deactivate: () => void;
-    reveal: (flash: boolean) => void;
-    unreveal: () => void;
-    setEditing: (target: HTMLElement, isSelection: boolean) => void;
-    clearEditing: (target: HTMLElement, hasComment: boolean) => void;
-    applyHover: (element: HTMLElement, editingTargetId?: string) => void;
-    clearHover: (element: HTMLElement, editingTargetId?: string, commentedIds?: Set<string>) => void;
-    startObserving: (callbacks: ObserveCallbacks) => void;
-    stopObserving: () => void;
-    destroy: () => void;
-};
-export type HighlightManager = ReturnType<typeof createHighlightManager>;

package/dist/types/components/review/index.d.ts

@@ -1,8 +0,0 @@
-export { LlumiCommentDialog } from './comment-dialog.element';
-export type { CustomTarget } from './custom-target.utils';
-export { LlumiDefaultEditor } from './default-editor.element';
-export { LlumiOverallCommentDialog } from './overall-comment-dialog.element';
-export { LlumiReview } from './review.element';
-export type { ReviewBarPosition, ReviewComment, ReviewEditorContract, ReviewMode, ReviewResult, SelectionRange, } from './review.type';
-export { LlumiReviewBar } from './review-bar.element';
-export { LlumiSelectionCommentIcons } from './selection-comment-icons.element';

package/dist/types/components/review/overall-comment-dialog.element.d.ts

@@ -1,22 +0,0 @@
-import { PropertyValues } from 'lit';
-import { TailwindElement } from '../../shared/tailwind-element';
-export declare class LlumiOverallCommentDialog extends TailwindElement {
-    barElement: HTMLElement | null;
-    value: string;
-    private floating;
-    private cleanup?;
-    private onDocKeydown;
-    private onDocPointerdown;
-    render(): import('lit').TemplateResult<1>;
-    private onEditorChange;
-    private emitClose;
-    private startPositioning;
-    connectedCallback(): void;
-    updated(changed: PropertyValues): void;
-    disconnectedCallback(): void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-overall-comment-dialog": LlumiOverallCommentDialog;
-    }
-}

package/dist/types/components/review/review-bar.element.d.ts

@@ -1,26 +0,0 @@
-import { TailwindElement } from '../../shared/tailwind-element';
-import { ReviewBarPosition, ReviewMode } from './review.type';
-export declare class LlumiReviewBar extends TailwindElement {
-    mode: ReviewMode;
-    commentCount: number;
-    hasOverallComment: boolean;
-    overallCommentOpen: boolean;
-    barPosition: ReviewBarPosition;
-    private bar;
-    private dragOffset;
-    private dragStart;
-    get barRoot(): HTMLElement | null;
-    render(): import('lit').TemplateResult<1>;
-    private onToggle;
-    private onOverallToggle;
-    private onSubmit;
-    private onDragStart;
-    private onDragMove;
-    private onDragEnd;
-    disconnectedCallback(): void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-review-bar": LlumiReviewBar;
-    }
-}

package/dist/types/components/review/review.element.d.ts

@@ -1,60 +0,0 @@
-import { CustomTarget } from './custom-target.utils';
-import { ReviewResult } from './review.type';
-/**
- * `<llumi-review>` — wraps light-DOM content for element- and text-selection
- * review comments. Both events bubble and are composed.
- *
- * @attr {string} persist - When set to a non-empty value, persists the review draft to
- *   localStorage under that key and restores it on load. Read once on connect.
- * @fires llumi-review-change - On every edit (comment added/edited/deleted, or overall comment changed). `detail` is a `ReviewResult`.
- * @fires llumi-review-submit - When the user clicks Submit / Approve. `detail` is `{ result: ReviewResult, clearPersisted: () => void }`; call `clearPersisted()` after a confirmed server save to discard the persisted draft.
- */
-export declare class LlumiReview extends HTMLElement {
-    static observedAttributes: string[];
-    initialData?: ReviewResult;
-    customTargets?: CustomTarget[];
-    private actor;
-    private persistence;
-    private manager;
-    private rangeMap;
-    private hoveredComment;
-    private selectionJustHandled;
-    private selectionComments;
-    private bar;
-    private commentDialog;
-    private commentDialogAnchorId;
-    private overallDialog;
-    private icons;
-    private get shortcut();
-    private get barPosition();
-    private get defaultMode();
-    private get persistKey();
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    attributeChangedCallback(): void;
-    private buildDetailResult;
-    private emitChange;
-    private emitSubmit;
-    /** Clears the persisted draft for this element. No-op when persistence is off. */
-    clearPersisted(): void;
-    private selectionAnchor;
-    private mountChrome;
-    private onIconClick;
-    private syncFromSnapshot;
-    private buildHighlightCallbacks;
-    private updateSelectionHighlights;
-    private isAnnotating;
-    private caretPosition;
-    private onPointerUp;
-    private onPointerMove;
-    private onClickCapture;
-    private onWrapperClick;
-    private currentEditingTargetId;
-    private onMouseOver;
-    private onMouseOut;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-review": LlumiReview;
-    }
-}

package/dist/types/components/review/review.machine.d.ts

@@ -1,234 +0,0 @@
-import { ReviewPersistence } from './review.persistence';
-import { ReviewComment, ReviewResult, SelectionRange } from './review.type';
-export interface HighlightCallbacks {
-    activate: (commentedIds: Set<string>) => void;
-    deactivate: () => void;
-    reveal: (flash: boolean) => void;
-    unreveal: () => void;
-    setEditing: (target: HTMLElement, isSelection: boolean) => void;
-    clearEditing: (target: HTMLElement, hasComment: boolean) => void;
-}
-type ReviewMachineContext = {
-    comments: ReviewComment[];
-    overallComment: string;
-    editingCommentId: string | null;
-    targetElement: HTMLElement | null;
-    selectionRange: SelectionRange | null;
-    shortcut: string;
-    defaultMode: "idle" | "annotating";
-    highlights: HighlightCallbacks;
-    persistence: ReviewPersistence;
-};
-type ReviewMachineEvents = {
-    type: "TOGGLE";
-} | {
-    type: "HOLD_ANNOTATE";
-} | {
-    type: "RELEASE_ANNOTATE";
-} | {
-    type: "CLICK";
-    targetId?: string;
-    element?: HTMLElement;
-    selectionCommentId?: string;
-} | {
-    type: "SELECT_TEXT";
-    targetId: string;
-    targetElement: HTMLElement;
-    selectionRange: SelectionRange;
-} | {
-    type: "COMMENT_CHANGE";
-    content: string;
-} | {
-    type: "DELETE";
-} | {
-    type: "CLOSE";
-} | {
-    type: "SUBMIT";
-} | {
-    type: "TARGET_DISCONNECTED";
-} | {
-    type: "OPEN_OVERALL";
-} | {
-    type: "MOUNTED";
-};
-export type ReviewMachineEmitted = {
-    type: "REVIEW_CHANGED";
-    result: ReviewResult;
-} | {
-    type: "REVIEW_SUBMITTED";
-    result: ReviewResult;
-};
-type ReviewMachineInput = {
-    shortcut: string;
-    initialData?: ReviewResult;
-    defaultMode: "idle" | "annotating";
-    highlights: HighlightCallbacks;
-    persistence: ReviewPersistence;
-};
-export declare function buildReviewResult(context: Pick<ReviewMachineContext, "comments" | "overallComment">): ReviewResult;
-export declare function createReviewMachine(): import('xstate').StateMachine<ReviewMachineContext, {
-    type: "TOGGLE";
-} | {
-    type: "HOLD_ANNOTATE";
-} | {
-    type: "RELEASE_ANNOTATE";
-} | {
-    type: "CLICK";
-    targetId?: string;
-    element?: HTMLElement;
-    selectionCommentId?: string;
-} | {
-    type: "SELECT_TEXT";
-    targetId: string;
-    targetElement: HTMLElement;
-    selectionRange: SelectionRange;
-} | {
-    type: "COMMENT_CHANGE";
-    content: string;
-} | {
-    type: "DELETE";
-} | {
-    type: "CLOSE";
-} | {
-    type: "SUBMIT";
-} | {
-    type: "TARGET_DISCONNECTED";
-} | {
-    type: "OPEN_OVERALL";
-} | {
-    type: "MOUNTED";
-}, {
-    [x: string]: import('xstate').ActorRefFromLogic<import('xstate').CallbackActorLogic<ReviewMachineEvents, {
-        targetElement: HTMLElement;
-        wrapperElement: HTMLElement;
-    }, import('xstate').EventObject>> | undefined;
-    keyboard?: import('xstate').ActorRefFromLogic<import('xstate').CallbackActorLogic<ReviewMachineEvents, {
-        shortcut: string;
-    }, import('xstate').EventObject>> | undefined;
-}, {
-    src: "keyboardActor";
-    logic: import('xstate').CallbackActorLogic<ReviewMachineEvents, {
-        shortcut: string;
-    }, import('xstate').EventObject>;
-    id: "keyboard";
-} | {
-    src: "mutationObserverActor";
-    logic: import('xstate').CallbackActorLogic<ReviewMachineEvents, {
-        targetElement: HTMLElement;
-        wrapperElement: HTMLElement;
-    }, import('xstate').EventObject>;
-    id: string | undefined;
-}, {
-    type: "openElementComment";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "openSelectionComment";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "createSelectionComment";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "updateContent";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "deleteComment";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "cleanup";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "emitChanged";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "persistSave";
-    params: unknown;
-} | {
-    type: "emitSubmitted";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "highlightsActivate";
-    params: unknown;
-} | {
-    type: "highlightsDeactivate";
-    params: unknown;
-} | {
-    type: "highlightsRevealFlash";
-    params: unknown;
-} | {
-    type: "highlightsReveal";
-    params: unknown;
-} | {
-    type: "highlightsUnreveal";
-    params: unknown;
-} | {
-    type: "editingTargetSet";
-    params: unknown;
-} | {
-    type: "editingTargetCleared";
-    params: unknown;
-}, {
-    type: "isCommentingEditing";
-    params: import('xstate').NonReducibleUnknown;
-} | {
-    type: "hasSelectionCommentId";
-    params: unknown;
-} | {
-    type: "hasTargetId";
-    params: unknown;
-} | {
-    type: "hasNoTarget";
-    params: unknown;
-} | {
-    type: "isSameComment";
-    params: unknown;
-}, "flashDuration", {
-    commenting: "idle" | {
-        editing: "element" | "selection";
-    };
-    annotating: "waitingForMount" | "inactive" | {
-        toggled: "flashing" | "ready" | "revealing";
-    } | {
-        held: "revealing" | "lingering";
-    };
-}, string, ReviewMachineInput, import('xstate').NonReducibleUnknown, {
-    type: "REVIEW_CHANGED";
-    result: ReviewResult;
-} | {
-    type: "REVIEW_SUBMITTED";
-    result: ReviewResult;
-}, import('xstate').MetaObject, {
-    id: "review";
-    states: {
-        readonly annotating: {
-            states: {
-                readonly waitingForMount: {};
-                readonly inactive: {};
-                readonly toggled: {
-                    states: {
-                        readonly flashing: {};
-                        readonly ready: {};
-                        readonly revealing: {};
-                    };
-                };
-                readonly held: {
-                    states: {
-                        readonly revealing: {};
-                        readonly lingering: {};
-                    };
-                };
-            };
-        };
-        readonly commenting: {
-            states: {
-                readonly idle: {};
-                readonly editing: {
-                    states: {
-                        readonly element: {};
-                        readonly selection: {};
-                    };
-                };
-            };
-        };
-    };
-}>;
-export {};

package/dist/types/components/review/review.persistence.d.ts

@@ -1,16 +0,0 @@
-import { ReviewResult } from './review.type';
-/**
- * Storage engine for `<llumi-review>` drafts. Injected into the review machine
- * via input (mirrors `HighlightCallbacks`). All access is best-effort: it never
- * throws into the component.
- */
-export interface ReviewPersistence {
-    /** Read + parse + validate. Returns undefined on miss or corruption. */
-    load(): ReviewResult | undefined;
-    /** Write JSON. An empty/`approved` result removes the key instead. */
-    save(result: ReviewResult): void;
-    /** Remove the stored draft. */
-    clear(): void;
-}
-export declare const noopPersistence: ReviewPersistence;
-export declare function createReviewPersistence(key: string): ReviewPersistence;

package/dist/types/components/review/review.type.d.ts

@@ -1,37 +0,0 @@
-export interface SelectionRange {
-    startOffset: number;
-    endOffset: number;
-    selectedText: string;
-    matchIndex: number;
-}
-export interface ReviewComment {
-    commentId: string;
-    targetId: string;
-    content: string;
-    createdAt: string;
-    selection?: SelectionRange;
-}
-export type ReviewResult = {
-    status: "approved";
-} | {
-    status: "commented";
-    comments: ReviewComment[];
-    overallComment?: string;
-};
-export interface ReviewSubmitDetail {
-    result: ReviewResult;
-    /** Clears the persisted draft for this element. No-op when persistence is off. */
-    clearPersisted: () => void;
-}
-export type ReviewBarPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
-export type ReviewMode = "idle" | "commenting" | "editing";
-/**
- * Contract a slotted custom editor must honor:
- * - receives the current `value` as a property
- * - emits `change` (detail: string), `cancel`, and `delete` CustomEvents (bubbling, composed)
- */
-export interface ReviewEditorContract extends HTMLElement {
-    value: string;
-    autoFocus?: boolean;
-    placeholder?: string;
-}

package/dist/types/components/review/selection-comment-icons.element.d.ts

@@ -1,17 +0,0 @@
-import { TailwindElement } from '../../shared/tailwind-element';
-interface IconPosition {
-    commentId: string;
-    top: number;
-    left: number;
-}
-export declare class LlumiSelectionCommentIcons extends TailwindElement {
-    positions: IconPosition[];
-    render(): import('lit').TemplateResult<1>;
-    private onClick;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        "llumi-selection-comment-icons": LlumiSelectionCommentIcons;
-    }
-}
-export {};

package/dist/types/components/review/selection-range.utils.d.ts

@@ -1,6 +0,0 @@
-import { SelectionRange } from './review.type';
-export declare function computeSelectionRange(target: HTMLElement): SelectionRange | null;
-export declare function restoreRange(target: HTMLElement, selectionRange: SelectionRange): Range | null;
-export declare function isSelectionWithinTarget(selection: Selection, target: HTMLElement): boolean;
-export declare function findSelectableTarget(node: Node): HTMLElement | null;
-export declare function clampSelectionToTarget(selection: Selection, target: HTMLElement): Range | null;

package/dist/types/components/review/sort-comments.utils.d.ts

@@ -1,6 +0,0 @@
-import { ReviewComment } from './review.type';
-/**
- * Sort comments by their DOM position within the wrapper.
- * Falls back to original order if elements are not found.
- */
-export declare function sortCommentsByDomPosition(comments: ReviewComment[], wrapper: HTMLElement): ReviewComment[];

package/dist/types/index.d.ts

@@ -1 +0,0 @@
-export * from './components/review/index';

package/dist/types/shared/cn.d.ts

@@ -1,2 +0,0 @@
-import { ClassValue } from 'clsx';
-export declare function cn(...inputs: ClassValue[]): string;

package/dist/types/shared/icons.d.ts

@@ -1,7 +0,0 @@
-import { TemplateResult } from 'lit';
-export declare const icons: {
-    readonly check: TemplateResult;
-    readonly gripVertical: TemplateResult;
-    readonly messageSquare: TemplateResult;
-    readonly trash: TemplateResult;
-};

package/dist/types/shared/tailwind-element.d.ts

@@ -1,4 +0,0 @@
-import { CSSResultGroup, LitElement } from 'lit';
-export declare class TailwindElement extends LitElement {
-    static styles: CSSResultGroup;
-}