use-chisel 0.1.0 → 0.1.2

package/dist/persistence.d.ts

@@ -0,0 +1,30 @@
+export declare const STORAGE_SCHEMA_VERSION: 1;
+export type StoredElementChange = {
+    selector: string;
+    sourceHint?: string;
+    text?: string;
+    styles: Partial<Record<string, string>>;
+    asset?: {
+        fileName: string;
+        mimeType: string;
+        size: number;
+    };
+};
+export type StoredVersion = {
+    id: string;
+    name: string;
+    elements: Record<string, StoredElementChange>;
+};
+export type VersionEnvelope = {
+    schemaVersion: typeof STORAGE_SCHEMA_VERSION;
+    activeVersionId: string;
+    versions: StoredVersion[];
+};
+export type StorageResult = {
+    envelope?: VersionEnvelope;
+    warning?: string;
+    migrated: boolean;
+};
+export declare function createVersionEnvelope(versions: StoredVersion[], activeVersionId: string): VersionEnvelope;
+export declare function parseVersionStorage(raw: string | null): StorageResult;
+export declare function isVersionEnvelope(value: unknown): value is VersionEnvelope;

package/dist/theme.d.ts

@@ -0,0 +1 @@
+export declare const themeCSS = "\n:is(.chisel-root,.feedback-shell,.chisel-sign-in,.chisel-color-picker,.comment-box) :focus{outline:none}\n.chisel-root,.feedback-shell,.chisel-sign-in,.chisel-color-picker,.comment-box{color-scheme:light;--chisel-ui-panel-shadow:0 4px 20px rgba(0,0,0,.08);--chisel-ui-canvas:#f7f7f7;--chisel-ui-surface:#ffffff;--chisel-ui-raised:#f5f5f5;--chisel-ui-inset:#eeeeee;--chisel-ui-hover:#f0f0f0;--chisel-ui-selected:#eaeaea;--chisel-ui-border:#e2e2e2;--chisel-ui-border-strong:#c4c4c4;--chisel-ui-text:#242424;--chisel-ui-secondary:#626262;--chisel-ui-muted:#686868;--chisel-ui-focus:#2468d3;--chisel-ui-accent-text:#2468d3;--chisel-ui-accent-surface:#edf4ff;--chisel-ui-action:#242424;--chisel-ui-action-text:#ffffff;--chisel-ui-danger:#b33737;--chisel-ui-avatar:#ededed;--chisel-ui-avatar-text:#565656;--chisel-ui-scrollbar:#c2c2c2;--chisel-ui-checker-light:#e5e5e5;--chisel-ui-checker-dark:#c7c7c7;}\n@media(prefers-color-scheme:dark){.chisel-root,.feedback-shell,.chisel-sign-in,.chisel-color-picker,.comment-box{color-scheme:dark;--chisel-ui-panel-shadow:0 4px 20px #0003;--chisel-ui-canvas:#171717;--chisel-ui-surface:#222222;--chisel-ui-raised:#2a2a2a;--chisel-ui-inset:#191919;--chisel-ui-hover:#303030;--chisel-ui-selected:#383838;--chisel-ui-border:#3c3c3c;--chisel-ui-border-strong:#555555;--chisel-ui-text:#ededed;--chisel-ui-secondary:#b7b7b7;--chisel-ui-muted:#a5a5a5;--chisel-ui-focus:#8bb9ff;--chisel-ui-accent-text:#8bb9ff;--chisel-ui-accent-surface:#253447;--chisel-ui-action:#ededed;--chisel-ui-action-text:#111111;--chisel-ui-danger:#ffa5a5;--chisel-ui-avatar:#383838;--chisel-ui-avatar-text:#cccccc;--chisel-ui-scrollbar:#50504d;--chisel-ui-checker-light:#555555;--chisel-ui-checker-dark:#333333;}\n}\n\n.chisel-root,.feedback-shell,.chisel-sign-in,.chisel-color-picker,.comment-box{--chisel-ui-font:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;--chisel-ui-space:4px;--chisel-ui-control:40px;--chisel-ui-radius:8px;--chisel-ui-text-size:13px;--chisel-ui-small:12px;--chisel-ui-motion:120ms cubic-bezier(.2,0,0,1);--chisel-ui-popover-shadow:0 2px 6px #0000000f,0 12px 36px #0000001f;}\n@media(prefers-color-scheme:dark){.chisel-root,.feedback-shell,.chisel-sign-in,.chisel-color-picker,.comment-box{--chisel-ui-popover-shadow:0 0 0 1px #ffffff0d,0 4px 12px #0003,0 16px 40px #0004;}}\n";

package/dist/workspace/color-picker.d.ts

@@ -0,0 +1,6 @@
+export default function ColorPicker({ label, value, onChange, disabled }: {
+    label: string;
+    value: string;
+    onChange(value: string): void;
+    disabled: boolean;
+}): import("react").JSX.Element;

package/dist/workspace/color.d.ts

@@ -0,0 +1,9 @@
+export type HSV = {
+    h: number;
+    s: number;
+    v: number;
+    a: number;
+};
+export declare function rgbToHsv(r: number, g: number, b: number, a?: number): HSV;
+export declare function hsvToHex({ h, s, v, a }: HSV): string;
+export declare function readColor(value: string): HSV;

package/dist/workspace/comment-box.d.ts

@@ -0,0 +1,28 @@
+import { type CSSProperties, type ReactNode } from "react";
+import { type StyleChange } from "./style-changes";
+import type { WorkspaceAttachment } from "./comments";
+export type { StyleChange } from "./style-changes";
+export type WorkspaceComposerProps = {
+    text: string;
+    onText(value: string): void;
+    disabled: boolean;
+    commentId?: string;
+    onAttachmentDraftChange?(hasDraft: boolean): void;
+    onSubmit(text: string, body?: unknown, attachmentTokens?: string[], attachments?: WorkspaceAttachment[]): Promise<boolean>;
+    renderContent(editor: ReactNode, hasAttachments?: boolean, uploading?: boolean, actions?: ReactNode): ReactNode;
+};
+export default function CommentBox({ target, text, onText, onCancel, onPost, style, changes, editing, commentId, renderComposer, hasExistingAttachments, onDraftChange, hidden }: {
+    target: Element;
+    text: string;
+    onText(value: string): void;
+    onCancel(): void;
+    onPost(changes: StyleChange[], text: string, body?: unknown, attachmentTokens?: string[], attachments?: WorkspaceAttachment[]): Promise<boolean>;
+    style: CSSProperties;
+    hidden?: boolean;
+    changes?: StyleChange[];
+    hasExistingAttachments?: boolean;
+    editing?: boolean;
+    commentId?: string;
+    renderComposer?: (props: WorkspaceComposerProps) => ReactNode;
+    onDraftChange?(hasDraft: boolean): void;
+}): import("react").JSX.Element;

package/dist/workspace/comment-drag-handle.d.ts

@@ -0,0 +1,3 @@
+export default function CommentDragHandle({ onMoveStart }: {
+    onMoveStart?: () => void;
+}): import("react").JSX.Element;

package/dist/workspace/comments.d.ts

@@ -0,0 +1,80 @@
+import type { StyleChange } from "./style-changes";
+export type CommentAnchor = {
+    x: number;
+    y: number;
+    selector?: string;
+    offsetX?: number;
+    offsetY?: number;
+    tag?: string;
+};
+export type WorkspaceAttachment = {
+    id: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    previewUrl?: string;
+};
+export type WorkspaceReply = {
+    id?: string;
+    text: string;
+    author: string;
+    authorId: string;
+    authorImage?: string | null;
+    attachments?: WorkspaceAttachment[];
+    body?: unknown;
+    date?: string;
+    pending?: boolean;
+};
+export type WorkspaceComment = CommentAnchor & {
+    id: string;
+    path: string;
+    text: string;
+    author: string;
+    authorId?: string;
+    authorImage?: string | null;
+    date: string;
+    resolved: boolean;
+    replies: (string | WorkspaceReply)[];
+    changes?: StyleChange[];
+    attachments?: WorkspaceAttachment[];
+    body?: unknown;
+    pending?: boolean;
+};
+export type CommentMutation = {
+    type: "create";
+    comment: WorkspaceComment;
+    body?: unknown;
+    attachmentTokens?: string[];
+} | {
+    type: "edit";
+    id: string;
+    text: string;
+    changes: StyleChange[];
+    body?: unknown;
+    attachmentTokens?: string[];
+} | {
+    type: "reply";
+    id: string;
+    reply: WorkspaceReply;
+    body?: unknown;
+    attachmentTokens?: string[];
+} | {
+    type: "resolve";
+    id: string;
+    resolved: boolean;
+};
+export type CommentStore = {
+    list(): Promise<WorkspaceComment[]>;
+    mutate(change: CommentMutation): Promise<WorkspaceComment>;
+    delete?(id: string): Promise<void>;
+    subscribe?(onChange: () => void): () => void;
+};
+export declare function applyCommentMutation(comments: WorkspaceComment[], change: CommentMutation): WorkspaceComment;
+export declare function mergeComment(comments: WorkspaceComment[], comment: WorkspaceComment): WorkspaceComment[];
+export declare function removeComment(comments: WorkspaceComment[], id: string): WorkspaceComment[];
+export declare function commentParticipants(comment: WorkspaceComment): {
+    author: string;
+    authorImage?: string | null;
+}[];
+export declare function filterComments(comments: WorkspaceComment[], filter: string, search: string): WorkspaceComment[];
+export declare function commentAge(date: string, now?: number): string;

package/dist/workspace/composer-position.d.ts

@@ -0,0 +1,13 @@
+type Size = {
+    width: number;
+    height: number;
+};
+export declare function composerPosition(pin: {
+    x: number;
+    y: number;
+}, card: Size, viewport: Size): {
+    left: number;
+    top: number;
+    maxHeight: number;
+};
+export {};

package/dist/workspace/confirmation.d.ts

@@ -0,0 +1,11 @@
+type Confirmation = {
+    title: string;
+    description: string;
+    action: string;
+    danger?: boolean;
+};
+export declare function useConfirmation(): {
+    confirm: (next: Confirmation) => Promise<boolean>;
+    dialog: import("react").JSX.Element | null;
+};
+export {};

package/dist/workspace/hover-dismiss.d.ts

@@ -0,0 +1,4 @@
+export declare function createHoverDismiss(onClose: () => void): {
+    cancel: () => void;
+    schedule(): void;
+};

package/dist/workspace/mode-shortcuts.d.ts

@@ -0,0 +1 @@
+export declare function modeShortcut(event: KeyboardEvent): "comment" | "edit" | "view" | "toggle-comments" | undefined;

package/dist/workspace/page-control.d.ts

@@ -0,0 +1,7 @@
+export default function PageControl({ path, routes, disabled, onNavigate, onOpen }: {
+    path: string;
+    routes: string[];
+    disabled: boolean;
+    onNavigate(input: string): Promise<boolean>;
+    onOpen?(): void;
+}): import("react").JSX.Element;

package/dist/workspace/preview-navigation.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizePreviewPath(input: string, origin: string, currentPath?: string): string | null;
+export declare function previewPagePath(path: string): string;
+export declare function previewPath(win: Pick<Window, "location">): string | null;
+export declare function observePreviewNavigation(win: Window, onNavigate: (path: string) => void): () => void;

package/dist/workspace/preview.d.ts

@@ -0,0 +1,3 @@
+export declare function ChiselPreview({ projectName }: {
+    projectName?: string;
+}): import("react").JSX.Element | null;

package/dist/workspace/style-changes.d.ts

@@ -0,0 +1,15 @@
+export type StyleChange = {
+    property: string;
+    before: string;
+    after: string;
+};
+export declare function linkedStyleUpdates(property: string, value: string, pair: readonly string[], initial: Record<string, string>): Record<string, string>;
+export declare function commentStyleValues(current: Record<string, string>, changes: StyleChange[]): {
+    initial: {
+        [x: string]: string;
+    };
+    values: {
+        [x: string]: string;
+    };
+};
+export declare function previewStyleChanges(target: Element, changes: StyleChange[]): () => void;

package/dist/workspace/styles.d.ts

@@ -0,0 +1 @@
+export declare function ChiselWorkspaceStyles(): import("react").JSX.Element;

package/dist/workspace/thread-morph.d.ts

@@ -0,0 +1 @@
+export declare function animateThread(card: HTMLElement, closing?: boolean, previous?: Animation | null): Animation | null;

package/dist/workspace/workspace.d.ts

@@ -0,0 +1,51 @@
+import { type ReactNode } from "react";
+import { type WorkspaceComposerProps } from "./comment-box";
+import { type WorkspaceAttachment, type WorkspaceComment as Comment, type CommentStore } from "./comments";
+export type WorkspaceUser = {
+    id: string;
+    name: string;
+    email: string;
+    image?: string | null;
+};
+export type WorkspaceCollaboration = {
+    status: string;
+    participants: {
+        id: string;
+        name: string;
+        image?: string | null;
+        path: string;
+    }[];
+    unreadThreadIds: readonly string[];
+    markRead(id: string): void;
+    setPage(path: string): void;
+};
+export type WorkspaceThreadProps = {
+    comment: Comment;
+    expanded: boolean;
+    reply: string;
+    saving: boolean;
+    canResolve: boolean;
+    submittingReply?: boolean;
+    onReplyText(text: string): void;
+    onReply(text: string, body?: unknown, attachmentTokens?: string[], attachments?: WorkspaceAttachment[]): Promise<boolean>;
+    onResolve(): void;
+    onExpand(): void;
+    replyAuthor?: Pick<WorkspaceUser, "name" | "image">;
+    onAttachmentDraftChange?(hasDraft: boolean): void;
+};
+export type WorkspaceCommentUI = {
+    className?: string;
+    renderComposer(props: WorkspaceComposerProps): ReactNode;
+    renderThread(props: WorkspaceThreadProps): ReactNode;
+};
+export declare function elementSelector(element: Element): string;
+export default function ChiselWorkspace({ user, validateSession, signOut, commentStore, canManageComments, getReviewLink, collaboration, commentUI }: {
+    user: WorkspaceUser;
+    validateSession: () => Promise<boolean>;
+    signOut: () => Promise<void>;
+    commentStore?: CommentStore;
+    canManageComments?: boolean;
+    getReviewLink?: (rotate?: boolean) => Promise<string>;
+    collaboration?: WorkspaceCollaboration;
+    commentUI?: WorkspaceCommentUI;
+}): import("react").JSX.Element;

package/dist/workspace-entry.d.ts

@@ -0,0 +1,6 @@
+export { default as ChiselWorkspace } from "./workspace/workspace";
+export type { WorkspaceUser, WorkspaceCollaboration, WorkspaceCommentUI, WorkspaceThreadProps } from "./workspace/workspace";
+export { ChiselPreview } from "./workspace/preview";
+export { ChiselWorkspaceStyles } from "./workspace/styles";
+export type { CommentStore, CommentMutation, WorkspaceComment, WorkspaceReply, WorkspaceAttachment } from "./workspace/comments";
+export type { WorkspaceComposerProps } from "./workspace/comment-box";