feat: bilingual support (FA/EN), IRANSans typography, RTL layout, and interactive product detail pages

2026-10-04 07:11:52 +03:30
commit a001fa5d5f
302 changed files with 35491 additions and 0 deletions
@@ -0,0 +1,78 @@
+import type { Delta, IsoDate, Ref, UseQueryOptions, UseQueryResult } from "./core";
+
+export declare const COMMENT_TYPES: readonly ["message", "ai", "activity"];
+/**
+ * `name` is a one-line preview of the body. The last ancestor is the task,
+ * or for a reply the comment it replies to.
+ */
+export interface Comment extends Ref<"comment"> {
+    ancestors: Array<Ref<"space" | "folder" | "list" | "task" | "comment">>;
+    createdAt: IsoDate;
+    updatedAt: IsoDate;
+    type: (typeof COMMENT_TYPES)[number];
+    /** The body; render it with `RichText`. */
+    body: Delta;
+    creator: Ref<"user">;
+    assignee?: Ref<"user">;
+    /** Set once the comment is resolved; there is no separate resolved flag. */
+    resolvedBy?: Ref<"user">;
+    /** One entry per emoji, with the workspace members who reacted. */
+    reactions: Array<{
+        emoji: string;
+        users: Ref<"user">[];
+    }>;
+}
+/**
+ * `resolved` resolves or reopens the comment (read it back through
+ * `resolvedBy`), `assignee: null` unassigns, and `myReactions` replaces the
+ * viewer's reactions, leaving everyone else's.
+ */
+export interface CommentPatch {
+    /** Replaces the body; read it back as `body`. */
+    bodyMarkdown?: string;
+    assignee?: Ref<"user"> | null;
+    resolved?: boolean;
+    myReactions?: string[];
+}
+/** `parent` is the task to comment on, or the comment to reply to. */
+export interface CreateCommentInput {
+    parent: Ref<"task" | "comment">;
+    /** The body, as markdown. */
+    bodyMarkdown: string;
+    assignee?: Ref<"user">;
+}
+export declare const COMMENT_ORDERS: readonly ["createdAt"];
+/**
+ * Needs `parent` or `ancestor`. The other fields filter and sort on the
+ * server before `limit` applies.
+ * @example
+ * useComments({ ancestor: task, resolved: false, assignee: "me" });
+ */
+export interface CommentSelector {
+    /** A task, for its top-level comments; or a comment from `useComments`, for its replies. */
+    parent?: Ref<"task" | "comment">;
+    /** A task, for all its comments including replies. */
+    ancestor?: Ref<"task"> | string;
+    /** Defaults to 100, at most 500. */
+    limit?: number;
+    resolved?: boolean;
+    /** `"me"` is the viewer. */
+    assignee?: Ref<"user"> | "me";
+    creator?: Ref<"user"> | "me";
+    body?: {
+        contains: string;
+    };
+    /** Oldest first when omitted; `direction` defaults to `"asc"`. */
+    orderBy?: {
+        field: (typeof COMMENT_ORDERS)[number];
+        direction?: "asc" | "desc";
+    };
+}
+export interface CommentsApi {
+    list(selector: CommentSelector): Promise<Comment[]>;
+    /** Comments on tasks; ids from chats or docs are left out. */
+    get(targets: Array<Ref<"comment"> | string>): Promise<Comment[]>;
+    create(input: CreateCommentInput): Promise<Ref<"comment">>;
+    update(comment: Ref<"comment"> | string, patch: CommentPatch): Promise<void>;
+}
+export declare function useComments(selector: CommentSelector | Array<Ref<"comment"> | string>, options?: UseQueryOptions<Comment[]>): UseQueryResult<Comment[]>;