@astryx-vue/lab 0.5.2 → 0.5.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { MaybeRef, VNodeChild } from "vue";
-import { FieldStatusInput, IconSize, PopoverAlignment, PopoverPlacement, SyntaxThemeDefinition, TokenLine } from "@astryx-vue/core";
+import { Component, InjectionKey, MaybeRef, VNode, VNodeChild } from "vue";
+import { ChatComposerTrigger, FieldStatusInput, IconSize, MarkdownInlinePlugin, MarkdownPlugin, PlainDate, PopoverAlignment, PopoverPlacement, SyntaxThemeDefinition, TokenColor, TokenLine } from "@astryx-vue/core";
 //#region src/Chat/types.d.ts
 interface ChatEmojiOption {
   /** 表情字符，例如 "🎉"。 */
@@ -80,24 +80,24 @@ interface ChatReactionBarEmits {
 }
 //#endregion
 //#region src/Chat/ChatEmojiPicker.vue.d.ts
-type __VLS_Slots$7 = ChatEmojiPickerSlots;
-declare const __VLS_base$7: import("vue").DefineComponent<ChatEmojiPickerProps, {
+type __VLS_Slots$11 = ChatEmojiPickerSlots;
+declare const __VLS_base$11: import("vue").DefineComponent<ChatEmojiPickerProps, {
   element: Readonly<import("vue").ShallowRef<HTMLDivElement | null>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   select: (emoji: string) => any;
 }, string, import("vue").PublicProps, Readonly<ChatEmojiPickerProps> & Readonly<{
   onSelect?: ((emoji: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$14: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
-declare const _default: typeof __VLS_export$14;
-type __VLS_WithSlots$7<T, S> = T & {
+declare const __VLS_export$21: __VLS_WithSlots$11<typeof __VLS_base$11, __VLS_Slots$11>;
+declare const _default: typeof __VLS_export$21;
+type __VLS_WithSlots$11<T, S> = T & {
   new (): {
     $slots: S;
   };
 };
 //#endregion
 //#region src/Chat/ChatReactionBar.vue.d.ts
-declare const __VLS_export$13: import("vue").DefineComponent<ChatReactionBarProps, {
+declare const __VLS_export$20: import("vue").DefineComponent<ChatReactionBarProps, {
   element: Readonly<import("vue").ShallowRef<HTMLDivElement | null>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   add: (emoji: string) => any;
@@ -106,7 +106,7 @@ declare const __VLS_export$13: import("vue").DefineComponent<ChatReactionBarProp
   onAdd?: ((emoji: string) => any) | undefined;
   onToggle?: ((emoji: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default$1: typeof __VLS_export$13;
+declare const _default$1: typeof __VLS_export$20;
 //#endregion
 //#region src/Chat/emojis.d.ts
 /**
@@ -178,10 +178,10 @@ interface CircularProgressProps {
 //#endregion
 //#region src/CircularProgress/CircularProgress.vue.d.ts
 declare var __VLS_1$1: {};
-type __VLS_Slots$6 = {} & {
+type __VLS_Slots$10 = {} & {
   default?: (props: typeof __VLS_1$1) => any;
 };
-declare const __VLS_base$6: import("vue").DefineComponent<CircularProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CircularProgressProps> & Readonly<{}>, {
+declare const __VLS_base$10: import("vue").DefineComponent<CircularProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CircularProgressProps> & Readonly<{}>, {
   value: number;
   max: number;
   isLabelHidden: boolean;
@@ -192,9 +192,9 @@ declare const __VLS_base$6: import("vue").DefineComponent<CircularProgressProps,
   isIndeterminate: boolean;
   isDisabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$12: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
-declare const _default$2: typeof __VLS_export$12;
-type __VLS_WithSlots$6<T, S> = T & {
+declare const __VLS_export$19: __VLS_WithSlots$10<typeof __VLS_base$10, __VLS_Slots$10>;
+declare const _default$2: typeof __VLS_export$19;
+type __VLS_WithSlots$10<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -222,7 +222,7 @@ interface CodeEditorEmits {
 }
 //#endregion
 //#region src/CodeEditor/CodeEditor.vue.d.ts
-declare const __VLS_export$11: import("vue").DefineComponent<CodeEditorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export$18: import("vue").DefineComponent<CodeEditorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   change: (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<CodeEditorProps> & Readonly<{
   onChange?: ((value: string) => any) | undefined;
@@ -231,7 +231,658 @@ declare const __VLS_export$11: import("vue").DefineComponent<CodeEditorProps, {}
   language: string;
   escapeHint: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default$3: typeof __VLS_export$11;
+declare const _default$3: typeof __VLS_export$18;
+//#endregion
+//#region src/CommentPin/types.d.ts
+/**
+ * Identity data for one representative shown inside a CommentPin.
+ */
+interface CommentPinParticipant {
+  /** Stable identity used to remove duplicate representatives. */
+  id: string;
+  /** Display name used by Avatar for image fallback initials. */
+  name: string;
+  /** Optional image source passed to Avatar. */
+  avatarSrc?: string;
+}
+/** Pin heights on the shared element-size scale: 28, 32, or 36px. */
+type CommentPinSize = 'sm' | 'md' | 'lg';
+interface CommentPinProps {
+  /**
+   * Accessible action name and visual hover/focus tooltip.
+   * Include grouped, unread, or resolved context when it changes the action's
+   * meaning.
+   */
+  label: string;
+  /**
+   * Ordered participants, lead first. A single marker shows the first. A
+   * grouped marker shows distinct IDs as an AvatarGroup of at most three
+   * circles: every participant when three or fewer are distinct, otherwise the
+   * first two plus an ellipsis overflow circle. Pass every distinct
+   * participant so the overflow appears only when more than three people
+   * participate.
+   */
+  participants: readonly [CommentPinParticipant, ...CommentPinParticipant[]];
+  /**
+   * Pin height on the element-size scale: `sm` 28px, `md` 32px, `lg` 36px,
+   * with 22px, 24px, and 28px participant circles.
+   * @default 'sm'
+   */
+  size?: CommentPinSize;
+  /**
+   * Total number of threads represented by this marker. Values above one use
+   * the grouped presentation and show the exact total.
+   * @default 1
+   */
+  threadCount?: number;
+  /**
+   * Number of represented threads with unread activity. When above zero, an
+   * accent status dot appears at the end of the pin: after the thread total,
+   * or after the participant on a single pin. Values above `threadCount` are
+   * capped.
+   * @default 0
+   */
+  unreadCount?: number;
+  /** Whether this pin is the currently selected annotation target. */
+  isSelected?: boolean;
+  /**
+   * Whether another pin is selected in the host. Dims this pin without
+   * disabling it, so it remains available to switch selection.
+   */
+  isDimmed?: boolean;
+  /**
+   * Whether every thread represented by this pin is resolved. A resolved pin
+   * renders nothing unless it is selected, so resolved discussion leaves the
+   * content while a thread the reader opened keeps its anchor.
+   */
+  isResolved?: boolean;
+  /** Whether activation is unavailable. */
+  isDisabled?: boolean;
+}
+interface CommentPinEmits {
+  click: [event: MouseEvent];
+}
+//#endregion
+//#region src/CommentPin/CommentPin.vue.d.ts
+declare const __VLS_export$17: import("vue").DefineComponent<CommentPinProps, {
+  element: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<CommentPinProps> & Readonly<{
+  onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+  size: CommentPinSize;
+  isDisabled: boolean;
+  threadCount: number;
+  unreadCount: number;
+  isSelected: boolean;
+  isDimmed: boolean;
+  isResolved: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default$6: typeof __VLS_export$17;
+//#endregion
+//#region src/Comments/types.d.ts
+/**
+ * The passage an inline comment discusses. The host owns anchoring; the
+ * composer quotes the selected text above the input.
+ */
+interface CommentAnchor {
+  /** The selected text, quoted above the comment. */
+  quote: string;
+  /**
+   * `orphaned` when edits removed the passage. Standalone CommentComposer
+   * still quotes it; threads will show an Outdated badge later.
+   * @default 'anchored'
+   */
+  status?: 'anchored' | 'orphaned';
+}
+/**
+ * A color of the Astryx palette, as a host highlights inline comments'
+ * passages in it. Quotes draw their rule in `--astryx-color-border-<color>`.
+ */
+type CommentHighlightColor = 'blue' | 'cyan' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow';
+/** An image the host's upload flow stored. */
+interface CommentUploadedImage {
+  /** URL of the stored image. */
+  url: string;
+  /** Description used as the image's alt text. */
+  alt: string;
+}
+/** Which composer a callback came from. */
+type CommentComposerContext = {
+  kind: 'comment';
+  /** The passage a new inline comment will attach to, when there is one. */
+  anchor?: CommentAnchor;
+} | {
+  kind: 'edit';
+  commentId: string;
+} | {
+  kind: 'reply';
+  parentCommentId: string;
+  repliedToCommentId: string;
+};
+/** What a `renderComposer` replacement receives. */
+interface CommentComposerRenderProps {
+  value: string;
+  onChange: (value: string) => void;
+  onSubmit: (value: string) => void;
+  placeholder: string;
+  isSubmitting: boolean;
+  error?: string;
+  contextLabel?: string;
+  context: CommentComposerContext;
+  onCancel?: () => void;
+}
+/**
+ * An agent a comment can address with a slash command: typing `/` in a
+ * composer offers it, and a posted comment shows the command as its chip.
+ */
+interface CommentAgentCommand {
+  /** The command after the slash: `ask` for `/ask`. Letters, digits, `-` and `_`. */
+  command: string;
+  /** The agent's name, on its chip. */
+  name: string;
+  /** What asking it does, in the `/` menu. */
+  description: string;
+  /** Square agent logo; initials without one. */
+  logoUrl?: string;
+}
+interface CommentComposerBaseProps {
+  value: string;
+  placeholder: string;
+  label?: string;
+  isSubmitting?: boolean;
+  error?: string;
+  contextLabel?: string;
+  context: CommentComposerContext;
+  anchor?: CommentAnchor;
+  highlightColor?: CommentHighlightColor;
+  triggers?: readonly ChatComposerTrigger[];
+  agentCommands?: readonly CommentAgentCommand[];
+  hasEmojiPicker?: boolean;
+  /** Focuses the input whenever it changes, e.g. when Reply opens it. */
+  focusKey?: string;
+  /** Shows Retry on the error Banner. */
+  hasRetry?: boolean;
+  /** Shows Cancel beside an edit context label. */
+  hasCancel?: boolean;
+  /** Adds Remove quoted text to the quoted passage. */
+  hasAnchorDismiss?: boolean;
+  /**
+   * Uploads images attached, pasted, or dropped in the input, and appends the
+   * stored images to the draft as Markdown. Adds the attach button.
+   */
+  onUploadImages?: (files: readonly File[]) => readonly CommentUploadedImage[] | Promise<readonly CommentUploadedImage[]>;
+  renderComposer?: (props: CommentComposerRenderProps) => VNode;
+}
+interface CommentComposerBaseEmits {
+  change: [value: string];
+  submit: [value: string];
+  retry: [];
+  cancel: [];
+  anchorDismiss: [];
+  actionPendingChange: [isPending: boolean];
+}
+interface CommentComposerProps {
+  /** The draft, controlled. Bind with `value` / `@change` or `v-model`. */
+  value?: string;
+  modelValue?: string;
+  /** Placeholder of the input. Defaults to the localized "Write a comment…". */
+  placeholder?: string;
+  /** Accessible name of the input. Defaults to the placeholder. */
+  label?: string;
+  /** Holds Post and the attach and emoji buttons while a post is in flight. */
+  isSubmitting?: boolean;
+  /** Shows an error Banner above the composer. */
+  error?: string;
+  /** The passage a new inline comment attaches to, quoted above the input. */
+  anchor?: CommentAnchor;
+  /** The palette color the host highlights passages in. @default 'yellow' */
+  highlightColor?: CommentHighlightColor;
+  /** Typeahead triggers, such as an `@` people search. */
+  triggers?: readonly ChatComposerTrigger[];
+  /** Agents the comment can address: typing `/` lists them. */
+  agentCommands?: readonly CommentAgentCommand[];
+  /** Whether the emoji picker button shows. @default true */
+  hasEmojiPicker?: boolean;
+  /**
+   * Uploads images attached, pasted, or dropped in the input, and appends the
+   * stored images to the draft as Markdown. Adds the attach button.
+   */
+  onUploadImages?: (files: readonly File[]) => readonly CommentUploadedImage[] | Promise<readonly CommentUploadedImage[]>;
+}
+interface CommentComposerEmits {
+  'change': [value: string];
+  'update:modelValue': [value: string];
+  /** Posts the draft: Enter, or the Post button. Empty drafts never post. */
+  'submit': [value: string];
+  /** Retry on the error Banner. */
+  'retry': [];
+  /** Remove quoted text on the quoted passage. */
+  'anchorDismiss': [];
+}
+interface CommentComposerSlots {
+  /** Product-owned controls after the attach and emoji buttons. Keep it to one short control. */
+  controls?: () => VNode[];
+  /** Replaces the default composer while keeping its state and context. */
+  composer?: (props: CommentComposerRenderProps) => VNode[];
+}
+interface CommentComposerBaseSlots extends CommentComposerSlots {}
+/**
+ * `interactive` enables every permitted action; `non-editable` keeps create,
+ *  reply and react but removes edit and delete; `read-only` removes every
+ *  control that changes data.
+ */
+type CommentMode = 'interactive' | 'non-editable' | 'read-only';
+/**
+ * Where a comment is in being posted, in Chat's message-status vocabulary:
+ * `sending` while the post is in flight, `sent` once it has posted, and
+ * `error` when it couldn't be posted.
+ */
+type CommentStatus = 'sending' | 'sent' | 'error';
+/** A person or agent who writes comments, reacts, or acts on the item. */
+interface CommentUser {
+  /** Stable host-owned id, used for equality ("is this my comment?"). */
+  id: string;
+  /** Full display name. Never a viewer-relative label such as "You". */
+  name: string;
+  /**
+   * An agent shows its logo (`avatarUrl`), or square-cornered initials
+   * without one, and an Agent badge beside its name.
+   * @default 'person'
+   */
+  kind?: 'person' | 'agent';
+  /** Where the author's name links, such as their profile. */
+  href?: string;
+  /** Profile picture, or an agent's square logo. Initials without one. */
+  avatarUrl?: string;
+}
+/** A selectable reaction. */
+interface CommentReactionOption {
+  /** Stable key the host stores, such as `like`. */
+  key: string;
+  /** Emoji or compact glyph shown in the picker and on the reaction. */
+  label: string;
+  /**
+   * Human-readable name, such as "Like", for the reaction's accessible label
+   * and tooltip. Optional for the keys in DEFAULT_COMMENT_REACTIONS, which
+   * take their localized names.
+   */
+  description?: string;
+}
+/** A reaction summary on a comment. */
+interface CommentReaction extends CommentReactionOption {
+  count: number;
+  /** Whether the viewer is one of the people who reacted. */
+  reactedByViewer?: boolean;
+  /** Who reacted, named in the reaction's tooltip. */
+  actors?: readonly Pick<CommentUser, 'id' | 'name'>[];
+}
+/** One version of a comment in its edit history. */
+interface CommentVersion {
+  id: string;
+  body: string;
+  editedAt: string | number;
+  author?: CommentUser;
+  isCurrent?: boolean;
+}
+/**
+ * What a comment's author, typically an agent, is doing while it still writes
+ * the comment, and where to watch the work.
+ */
+interface CommentProgress {
+  /** What the author is doing, as a reader would say it: "Reading the file…". */
+  label: string;
+  /** Where to watch the work, such as the agent's session. */
+  link?: {
+    label: string;
+    href: string;
+  };
+}
+/** A comment: a thread's first comment or one of its replies. */
+interface CommentData {
+  id: string;
+  author: CommentUser;
+  /** Markdown. */
+  body: string;
+  createdAt: string | number;
+  updatedAt?: string | number;
+  /** Shows Edited beside the time; opens the edit history when there is one. */
+  isEdited?: boolean;
+  /** Host-owned unread state. Shows a New badge that fades after five seconds. */
+  isUnread?: boolean;
+  /** Earlier versions, newest first, when the host already has them. */
+  previousVersions?: readonly CommentVersion[];
+  /**
+   * Host-controlled metadata for people who have seen this comment. Comments
+   * does not render it by default; render callbacks receive it with the comment.
+   */
+  seenBy?: readonly CommentUser[];
+  reactions?: readonly CommentReaction[];
+  /** @default 'sent' */
+  status?: CommentStatus;
+  /** Shown when `status` is `error`. */
+  errorMessage?: string;
+  /**
+   * Marks a comment its author is still writing. The label shows in place of
+   * the body. The comment takes no reactions, replies, edits or deletions
+   * until it is written.
+   */
+  progress?: CommentProgress;
+  /** Per-comment permission; the host stays authoritative. @default true */
+  canReply?: boolean;
+  /** @default true */
+  canReact?: boolean;
+  /** @default the viewer wrote it */
+  canEdit?: boolean;
+  /** @default the viewer wrote it */
+  canDelete?: boolean;
+}
+/** A thread: its first comment, which carries the thread's replies. */
+interface CommentThreadData extends CommentData {
+  /**
+   * Other people currently composing in this thread. Controlled, transient
+   * state: update it from your collaboration layer and expire stale entries
+   * there. While this thread is open, the current viewer is not shown.
+   */
+  typingUsers?: readonly CommentUser[];
+  /** One level of replies, oldest first. */
+  replies?: readonly CommentData[];
+  /** Makes this an inline comment: the passage its thread discusses. */
+  anchor?: CommentAnchor;
+  /** A resolved thread: Resolved beside the time, muted text, and Reopen. */
+  isResolved?: boolean;
+  /** Who resolved the thread, named in the Resolved label's tooltip. */
+  resolvedBy?: CommentUser;
+  /**
+   * Calls the thread out without selecting it, such as the comment a playing
+   * video has reached: it takes the selected thread's muted fill, and nothing
+   * expands, scrolls, or takes focus.
+   */
+  isHighlighted?: boolean;
+  /**
+   * Whether the viewer may resolve or reopen this thread when the host
+   * handles it. Its Resolved label shows either way.
+   * @default true
+   */
+  canResolve?: boolean;
+}
+/** A timeline row for a status change or other activity on the item. */
+interface CommentActivityEvent {
+  id: string;
+  /** What happened, as a sentence: "Status changed to Ready for review". */
+  label: string;
+  description?: string;
+  createdAt: string | number;
+  actor?: CommentUser;
+  /** Where the event's time links. */
+  href?: string;
+}
+/** Uploads images for a composer and returns where they were stored. */
+type CommentImageUploader = (files: readonly File[], context: CommentComposerContext) => readonly CommentUploadedImage[] | Promise<readonly CommentUploadedImage[]>;
+type MaybePromise = void | Promise<void>;
+/**
+ * Behavior and rendering shared by Comments and a standalone CommentThread.
+ * Inside a Comments panel, its threads take these from the Comments.
+ */
+interface CommentThreadSharedProps {
+  currentUser?: CommentUser;
+  /** @default 'interactive' */
+  mode?: CommentMode;
+  /**
+   * The parent surface. `section` renders each thread as an outlined Card;
+   * `card` renders divider-bounded Sections so cards never nest.
+   * @default 'section'
+   */
+  container?: 'section' | 'card';
+  composerPlaceholder?: string;
+  /** @default 'yellow' */
+  highlightColor?: CommentHighlightColor;
+  /** @default DEFAULT_COMMENT_REACTIONS */
+  reactionOptions?: readonly CommentReactionOption[];
+  agentCommands?: readonly CommentAgentCommand[];
+  composerTriggers?: readonly ChatComposerTrigger[];
+  markdownPlugins?: readonly MarkdownPlugin[];
+  markdownInlinePlugins?: readonly MarkdownInlinePlugin[];
+  getReplyMention?: (author: CommentUser) => string | undefined;
+  /** @default true */
+  hasEmojiPicker?: boolean;
+  isSubmitting?: boolean;
+  onComposerDraftChange?: (value: string, context: CommentComposerContext) => void;
+  onSubmit?: (content: string, parentCommentId?: string) => MaybePromise;
+  onSaveEdit?: (commentId: string, content: string) => MaybePromise;
+  onDelete?: (commentId: string) => MaybePromise;
+  onReact?: (commentId: string, reactionKey: string, option?: CommentReactionOption) => MaybePromise;
+  onRetryComment?: (commentId: string) => MaybePromise;
+  onResolveThread?: (commentId: string) => MaybePromise;
+  onReopenThread?: (commentId: string) => MaybePromise;
+  loadVersions?: (commentId: string) => Promise<readonly CommentVersion[]>;
+  onUploadImages?: CommentImageUploader;
+  renderAnchor?: (comment: CommentThreadData, defaultAnchor: VNode) => VNode;
+  renderBody?: (comment: CommentData) => VNode;
+  renderVersionBody?: (version: CommentVersion) => VNode;
+  renderAdditionalActions?: (comment: CommentData) => VNode;
+  renderComposer?: (props: CommentComposerRenderProps) => VNode;
+}
+interface CommentThreadBindProps extends CommentThreadSharedProps {
+  /** The thread: its first comment, which carries its replies. */
+  comment: CommentThreadData;
+  /**
+   * Whether the thread is open. Omit it to let the thread own selection.
+   * Host selection does not move focus or open the reply composer.
+   */
+  isSelected?: boolean;
+}
+interface CommentThreadProps extends CommentThreadBindProps {
+  /** Called when the viewer opens or closes the thread. Prefer `@selected-change`. */
+  onSelectedChange?: (isSelected: boolean) => void;
+  /**
+   * Hands the thread its anchored host's light dismissal. Prefer `@dismiss`.
+   * Pair it with `hasLightDismiss={false}` and `hasEscapeDismiss={false}` on
+   * the host Popover.
+   */
+  onDismiss?: () => void;
+}
+interface CommentThreadEmits {
+  selectedChange: [isSelected: boolean];
+  dismiss: [];
+}
+interface CommentThreadSlots {
+  anchor?: (props: {
+    comment: CommentThreadData;
+    defaultAnchor: VNode;
+  }) => VNode[];
+  body?: (props: {
+    comment: CommentData;
+  }) => VNode[];
+  versionBody?: (props: {
+    version: CommentVersion;
+  }) => VNode[];
+  additionalActions?: (props: {
+    comment: CommentData;
+  }) => VNode[];
+  composer?: (props: CommentComposerRenderProps) => VNode[];
+}
+/**
+ * The reactions a thread offers when the host passes none: Like, Love, Haha,
+ * Wow, Sad, and Celebrate, named in the viewer's language.
+ */
+export declare const DEFAULT_COMMENT_REACTIONS: readonly CommentReactionOption[];
+type CommentsComposerPosition = 'top' | 'bottom' | 'none';
+type CommentsDensity = 'compact' | 'balanced';
+type CommentsLayout = 'pane' | 'embedded';
+/** The comments on one item: threads, activity events, and a new-comment composer. */
+interface CommentsProps extends CommentThreadSharedProps {
+  comments: readonly CommentThreadData[];
+  events?: readonly CommentActivityEvent[];
+  label?: string;
+  /** @default 'bottom' */
+  composerPosition?: CommentsComposerPosition;
+  /** @default 'balanced' */
+  density?: CommentsDensity;
+  /** @default 'pane' */
+  layout?: CommentsLayout;
+  selectedThreadId?: string | null;
+  composerAnchor?: CommentAnchor;
+  onComposerAnchorDismiss?: () => void;
+  composerControls?: VNode;
+  isLoading?: boolean;
+  /** Description on the load-failure Banner. The title is the localized "Comments couldn't load". */
+  loadError?: string;
+  onRetryLoad?: () => MaybePromise;
+  hasOlderComments?: boolean;
+  isLoadingOlder?: boolean;
+  onLoadOlder?: () => MaybePromise;
+  composerError?: string;
+  emptyState?: VNode;
+  renderEvent?: (event: CommentActivityEvent) => VNode;
+}
+interface CommentsEmits {
+  selectedThreadChange: [threadId: string | null];
+}
+interface CommentsSlots {
+  emptyState?: () => VNode[];
+  event?: (props: {
+    event: CommentActivityEvent;
+  }) => VNode[];
+  composer?: (props: CommentComposerRenderProps) => VNode[];
+  composerControls?: () => VNode[];
+}
+//#endregion
+//#region src/Comments/CommentComposer.vue.d.ts
+type __VLS_Slots$9 = CommentComposerSlots;
+declare const __VLS_base$9: import("vue").DefineComponent<CommentComposerProps, {
+  element: import("vue").ComputedRef<{
+    value?: HTMLElement | null;
+  } | {
+    element?: {
+      value?: HTMLElement | null;
+    };
+  } | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:modelValue": (value: string) => any;
+  change: (value: string) => any;
+  submit: (value: string) => any;
+  retry: () => any;
+  anchorDismiss: () => any;
+}, string, import("vue").PublicProps, Readonly<CommentComposerProps> & Readonly<{
+  "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+  onChange?: ((value: string) => any) | undefined;
+  onSubmit?: ((value: string) => any) | undefined;
+  onRetry?: (() => any) | undefined;
+  onAnchorDismiss?: (() => any) | undefined;
+}>, {
+  highlightColor: CommentHighlightColor;
+  hasEmojiPicker: boolean;
+  isSubmitting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$16: __VLS_WithSlots$9<typeof __VLS_base$9, __VLS_Slots$9>;
+declare const _default$4: typeof __VLS_export$16;
+type __VLS_WithSlots$9<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Comments/CommentComposerBase.vue.d.ts
+type __VLS_Slots$8 = CommentComposerBaseSlots;
+declare const __VLS_base$8: import("vue").DefineComponent<CommentComposerBaseProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  change: (value: string) => any;
+  submit: (value: string) => any;
+  retry: () => any;
+  anchorDismiss: () => any;
+  cancel: () => any;
+  actionPendingChange: (isPending: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<CommentComposerBaseProps> & Readonly<{
+  onChange?: ((value: string) => any) | undefined;
+  onSubmit?: ((value: string) => any) | undefined;
+  onRetry?: (() => any) | undefined;
+  onAnchorDismiss?: (() => any) | undefined;
+  onCancel?: (() => any) | undefined;
+  onActionPendingChange?: ((isPending: boolean) => any) | undefined;
+}>, {
+  highlightColor: CommentHighlightColor;
+  hasEmojiPicker: boolean;
+  isSubmitting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$15: __VLS_WithSlots$8<typeof __VLS_base$8, __VLS_Slots$8>;
+declare const _default$5: typeof __VLS_export$15;
+type __VLS_WithSlots$8<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Comments/Comments.vue.d.ts
+type __VLS_Slots$7 = CommentsSlots;
+declare const __VLS_base$7: import("vue").DefineComponent<CommentsProps, {
+  element: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  selectedThreadChange: (threadId: string | null) => any;
+}, string, import("vue").PublicProps, Readonly<CommentsProps> & Readonly<{
+  onSelectedThreadChange?: ((threadId: string | null) => any) | undefined;
+}>, {
+  isLoading: boolean;
+  mode: CommentMode;
+  composerPosition: CommentsComposerPosition;
+  density: CommentsDensity;
+  layout: CommentsLayout;
+  hasOlderComments: boolean;
+  isLoadingOlder: boolean;
+  container: "section" | "card";
+  highlightColor: CommentHighlightColor;
+  hasEmojiPicker: boolean;
+  isSubmitting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$14: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
+declare const _default$8: typeof __VLS_export$14;
+type __VLS_WithSlots$7<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Comments/CommentThread.vue.d.ts
+type __VLS_Slots$6 = CommentThreadSlots;
+declare const __VLS_base$6: import("vue").DefineComponent<CommentThreadBindProps, {
+  element: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  dismiss: () => any;
+  selectedChange: (isSelected: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<CommentThreadBindProps> & Readonly<{
+  onDismiss?: (() => any) | undefined;
+  onSelectedChange?: ((isSelected: boolean) => any) | undefined;
+}>, {
+  isSelected: boolean;
+  mode: CommentMode;
+  container: "section" | "card";
+  highlightColor: CommentHighlightColor;
+  hasEmojiPicker: boolean;
+  isSubmitting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$13: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
+declare const _default$7: typeof __VLS_export$13;
+type __VLS_WithSlots$6<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/Comments/icons.d.ts
+/** Stable icon-registry keys for the Comments family's glyphs. */
+export declare const COMMENT_ICON_KEYS: {
+  readonly addReaction: "comment:addReaction";
+  readonly reply: "comment:reply";
+  readonly copyLink: "comment:copyLink";
+  readonly resolve: "comment:resolve";
+  readonly edit: "comment:edit";
+  readonly delete: "comment:delete";
+  readonly attach: "comment:attach";
+  readonly emoji: "comment:emoji";
+  readonly event: "comment:event";
+};
 //#endregion
 //#region src/DiffViewer/diffTypes.d.ts
 /**
@@ -461,8 +1112,8 @@ declare const __VLS_base$5: import("vue").DefineComponent<DiffViewerProps, {}, {
   syntaxTheme: import("@astryx-vue/core").SyntaxThemeDefinition;
   renderLineAnnotation: (ref: DiffViewerLineRef) => import("vue").VNodeChild;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$10: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
-declare const _default$4: typeof __VLS_export$10;
+declare const __VLS_export$12: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
+declare const _default$9: typeof __VLS_export$12;
 type __VLS_WithSlots$5<T, S> = T & {
   new (): {
     $slots: S;
@@ -513,6 +1164,74 @@ interface InlineDiffResult {
  */
 export declare function parseUnifiedDiff(patch: string): DiffViewerFile[];
 //#endregion
+//#region src/EmojiPicker/types.d.ts
+interface EmojiOption {
+  /** 表情字符，例如 "🎉"。 */
+  emoji: string;
+  /** 名称，用于搜索和按钮的无障碍名，例如 "Party popper"。 */
+  name: string;
+  /** 搜索时一并匹配的其他词，例如 ["celebration", "tada"]。 */
+  keywords?: readonly string[];
+}
+interface EmojiCategory {
+  /** 分组标题，例如 "Smileys & emotion"。 */
+  name: string;
+  emojis: readonly EmojiOption[];
+}
+interface EmojiPickerProps {
+  /**
+   * 列在最前面、出现在「常用」下面的表情。传入空数组则不显示这一行。
+   * @default DEFAULT_FREQUENT_EMOJIS
+   */
+  frequentEmojis?: readonly EmojiOption[];
+  /**
+   * 按组分好的表情。不传时，第一次挂载会加载内置集：Emoji 15 以内的全部表情，
+   * 带英文 CLDR 名称。要本地化或自定义时传入自己的分组。
+   */
+  categories?: readonly EmojiCategory[];
+  /**
+   * 可滚动表情列表的高度。
+   * @default 'calc(var(--astryx-spacing-8, 32px) * 10)'
+   */
+  height?: number | string;
+  /**
+   * 挂载时聚焦搜索框，适合内嵌或放在对话框里。
+   * 放在弹出层里时，应改用弹出层自己的自动聚焦。
+   * @default false
+   */
+  hasAutoFocus?: boolean;
+  /**
+   * 表情列表的无障碍名称。
+   * 不传时用 `@astryx.emojiPicker.label`。
+   */
+  label?: string;
+  /**
+   * 搜索框的占位符和隐藏标签。
+   * 不传时用 `@astryx.emojiPicker.searchLabel`。
+   */
+  searchLabel?: string;
+}
+interface EmojiPickerEmits {
+  /** 选中的表情字符和对应的选项。 */
+  select: [emoji: string, option: EmojiOption];
+}
+//#endregion
+//#region src/EmojiPicker/constants.d.ts
+/** 没有传入常用表情时，列在最前面的默认一组。 */
+export declare const DEFAULT_FREQUENT_EMOJIS: readonly EmojiOption[];
+//#endregion
+//#region src/EmojiPicker/EmojiPicker.vue.d.ts
+declare const __VLS_export$11: import("vue").DefineComponent<EmojiPickerProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  select: (emoji: string, option: EmojiOption) => any;
+}, string, import("vue").PublicProps, Readonly<EmojiPickerProps> & Readonly<{
+  onSelect?: ((emoji: string, option: EmojiOption) => any) | undefined;
+}>, {
+  hasAutoFocus: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default$10: typeof __VLS_export$11;
+//#endregion
 //#region src/InfoTip/types.d.ts
 /**
  * Size of the info icon. Maps 1:1 to core `Icon` sizes
@@ -546,8 +1265,8 @@ declare const __VLS_base$4: import("vue").DefineComponent<InfoTipProps, {}, {},
   size: import("@astryx-vue/core").IconSize;
   content: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$9: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
-declare const _default$5: typeof __VLS_export$9;
+declare const __VLS_export$10: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const _default$11: typeof __VLS_export$10;
 type __VLS_WithSlots$4<T, S> = T & {
   new (): {
     $slots: S;
@@ -663,7 +1382,7 @@ interface ListInputEmits<T> {
 }
 //#endregion
 //#region src/ListInput/ListInput.vue.d.ts
-declare const __VLS_export$8: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$3<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const __VLS_export$9: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$3<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: import("vue").PublicProps & __VLS_PrettifyLocal$3<ListInputProps<T> & {
     "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
     onChange?: ((value: T[], change: ListInputChange<T>) => any) | undefined;
@@ -677,7 +1396,7 @@ declare const __VLS_export$8: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const _default$6: typeof __VLS_export$8;
+declare const _default$12: typeof __VLS_export$9;
 type __VLS_PrettifyLocal$3<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
 //#endregion
 //#region src/LogStream/types.d.ts
@@ -762,8 +1481,8 @@ declare const __VLS_base$3: import("vue").DefineComponent<__VLS_PublicProps, {},
   maxHeight: string | number;
   hasTimestamps: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$7: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
-declare const _default$7: typeof __VLS_export$7;
+declare const __VLS_export$8: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$13: typeof __VLS_export$8;
 type __VLS_WithSlots$3<T, S> = T & {
   new (): {
     $slots: S;
@@ -837,7 +1556,7 @@ interface MobileTokenizerEmits<T extends SearchableItem = SearchableItem> {
 }
 //#endregion
 //#region src/MobileTokenizer/MobileTokenizer.vue.d.ts
-declare const __VLS_export$6: <T extends SearchableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$2<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const __VLS_export$7: <T extends SearchableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$2<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: import("vue").PublicProps & __VLS_PrettifyLocal$2<MobileTokenizerProps<T> & {
     "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
     onChange?: ((value: T[], change: MobileTokenizerChange<T>) => any) | undefined;
@@ -854,9 +1573,195 @@ declare const __VLS_export$6: <T extends SearchableItem>(__VLS_props: NonNullabl
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const _default$8: typeof __VLS_export$6;
+declare const _default$14: typeof __VLS_export$7;
 type __VLS_PrettifyLocal$2<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
 //#endregion
+//#region src/Schedule/zonedDateTime.d.ts
+interface ZonedDateTime {
+  instant: Instant;
+  timezoneID: string;
+  toPlainDate: () => PlainDate;
+  addDays: (days: number) => ZonedDateTime;
+  startOfDay: () => ZonedDateTime;
+}
+type ZonedDateTimeRange = [ZonedDateTime, ZonedDateTime];
+//#endregion
+//#region src/Schedule/types.d.ts
+/** Unix 纪元毫秒。 */
+type Instant = number;
+type ScheduleEventSource = ReadonlyArray<CalendarEvent> | ((start: Instant, end: Instant) => Promise<ReadonlyArray<CalendarEvent>>);
+type ScheduleDate = Instant;
+interface ScheduleRange {
+  startDate: PlainDate;
+  endDate: PlainDate;
+  start: Instant;
+  end: Instant;
+}
+type ScheduleViewOptions = object;
+/**
+ * 周视图和日视图画的是同一张时间格，所以小时窗口和事件浮层是同一组选项。
+ * `renderPopover` 在每个画出来的事件上调用。返回内容时该事件是按钮，打开这一视图唯一的浮层；
+ * 返回 `null` 时该事件只读。不传时整张格子只读。
+ */
+interface ScheduleTimeGridViewOptions {
+  /** 画出的第一个小时，0–23。默认 0。 */
+  minHour?: number;
+  /** 格子结束的小时，1–24，并且大于 `minHour`。默认 24。 */
+  maxHour?: number;
+  /** 一小时的像素高度。默认 100。 */
+  hourHeight?: number;
+  renderPopover?: (event: CalendarEvent) => VNodeChild;
+}
+interface ScheduleNavigationRange {
+  label: string;
+  range: ZonedDateTimeRange;
+}
+interface ScheduleViewBase {
+  getDateRange: (date: ZonedDateTime) => ZonedDateTimeRange;
+  getPreviousDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+  getNextDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+}
+interface ScheduleView<Options extends ScheduleViewOptions = ScheduleViewOptions> extends ScheduleViewBase {
+  component: Component;
+  options: Options;
+}
+interface ScheduleHeaderContent {
+  startContent: VNodeChild;
+  centerContent: VNodeChild;
+  endContent: VNodeChild;
+}
+type SchedulePluginPosition = 'start' | 'end';
+interface SchedulePlugin {
+  renderHeader?: (startContent: VNodeChild, centerContent: VNodeChild, endContent: VNodeChild) => ScheduleHeaderContent;
+}
+type ScheduleHeadingLevel = 2 | 3 | 4 | 5 | 6;
+interface ScheduleProps {
+  /** `createSchedule*View()` 返回的视图。请保持同一引用。 */
+  view: ScheduleView;
+  /** 静态事件，或用当前区间起止毫秒去拉事件的函数。 */
+  events: ScheduleEventSource;
+  /** 用 `label === event.category` 决定颜色和读屏里的分类名。 */
+  categories?: ReadonlyArray<ScheduleCategory>;
+  /** 落在要显示的那一页里的任意毫秒。完全受控。 */
+  date: Instant;
+  /** 当作「今天」高亮的毫秒。不传则取挂载时的时刻，之后不再自己往前走。 */
+  focusDate?: Instant;
+  /** 分页或 Today 时调用，参数是下一页要显示的毫秒。 */
+  onChangeDate?: (date: Instant) => void;
+  /** IANA 时区，例如 `America/Los_Angeles`。默认浏览器时区。 */
+  timezoneID?: string;
+  /** 头部插件。传入数组会换掉默认的分页按钮。 */
+  plugins?: ReadonlyArray<SchedulePlugin>;
+  /** 视图内部小标题的级别。页眉上的区间标题固定是 2 级。默认 3。 */
+  headingLevel?: ScheduleHeadingLevel;
+}
+interface ScheduleEmits {
+  /** 和 `onChangeDate` 同一个时刻。模板里写 `@change-date`。 */
+  changeDate: [date: Instant];
+}
+//#endregion
+//#region src/Schedule/CalendarEvent.d.ts
+type ScheduleEventColor = Exclude<TokenColor, 'default'>;
+interface ScheduleCategory {
+  label: string;
+  color: ScheduleEventColor;
+}
+interface CalendarEventBase {
+  id: string;
+  title: string;
+  category?: string;
+}
+interface CalendarDayEvent extends CalendarEventBase {
+  start: PlainDate;
+  end: PlainDate;
+}
+interface CalendarInstantEvent extends CalendarEventBase {
+  start: Instant;
+  end: Instant;
+}
+type CalendarEvent = CalendarDayEvent | CalendarInstantEvent;
+export declare function createEventFromISO({ id, title, category, start, end }: {
+  id: string;
+  title: string;
+  category?: CalendarEvent['category'];
+  start: string;
+  end: string;
+}): CalendarEvent;
+//#endregion
+//#region src/Schedule/context.d.ts
+interface ScheduleContextValue {
+  events: ReadonlyArray<CalendarEvent>;
+  categories: ReadonlyArray<ScheduleCategory>;
+  date: ZonedDateTime;
+  focusDate: ZonedDateTime;
+  timezoneID: string;
+  locale: string;
+  range: ScheduleRange;
+  isLoading: boolean;
+  onPreviousDate: () => void;
+  previousDateLabel: string;
+  onToday: () => void;
+  onNextDate: () => void;
+  nextDateLabel: string;
+  view: ScheduleViewBase;
+  plugins: ReadonlyArray<SchedulePlugin>;
+  headingLevel: ScheduleHeadingLevel;
+}
+export declare const ScheduleContext: InjectionKey<ScheduleContextValue>;
+export declare function useScheduleContext(): ScheduleContextValue;
+//#endregion
+//#region src/Schedule/dayView.d.ts
+type ScheduleDayViewOptions = ScheduleTimeGridViewOptions;
+export declare function createScheduleDayView({ minHour, maxHour, hourHeight, renderPopover }?: ScheduleDayViewOptions): ScheduleView<ScheduleDayViewOptions>;
+//#endregion
+//#region src/Schedule/listView.d.ts
+interface ScheduleListViewOptions extends ScheduleViewOptions {
+  days?: number;
+}
+export declare function createScheduleListView({ days: listDays }?: ScheduleListViewOptions): ScheduleView<ScheduleListViewOptions>;
+//#endregion
+//#region src/Schedule/monthlyView.d.ts
+interface ScheduleMonthlyViewOptions {
+  weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  renderPopover?: ScheduleTimeGridViewOptions['renderPopover'];
+}
+export declare function createScheduleMonthlyView({ weekStartsOn, renderPopover }?: ScheduleMonthlyViewOptions): ScheduleView<ScheduleMonthlyViewOptions>;
+//#endregion
+//#region src/Schedule/plugins.d.ts
+interface SchedulePaginationPluginOptions {
+  position?: SchedulePluginPosition;
+}
+interface ScheduleViewSelectorOption<View extends ScheduleViewBase = ScheduleView> {
+  view: View;
+  label: string;
+}
+interface ScheduleViewSelectorPluginOptions<View extends ScheduleViewBase = ScheduleView> {
+  onChangeView?: (view: View) => void;
+  position?: SchedulePluginPosition;
+}
+export declare const defaultSchedulePlugins: ReadonlyArray<SchedulePlugin>;
+export declare function useSchedulePaginationPlugin({ position }?: SchedulePaginationPluginOptions): SchedulePlugin;
+export declare function useScheduleViewSelectorPlugin<View extends ScheduleViewBase>(options: ReadonlyArray<ScheduleViewSelectorOption<View>>, pluginOptions?: ScheduleViewSelectorPluginOptions<View>): SchedulePlugin;
+//#endregion
+//#region src/Schedule/Schedule.vue.d.ts
+declare const __VLS_export$6: import("vue").DefineComponent<ScheduleProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  changeDate: (date: number) => any;
+}, string, import("vue").PublicProps, Readonly<ScheduleProps> & Readonly<{
+  onChangeDate?: ((date: number) => any) | undefined;
+}>, {
+  categories: readonly ScheduleCategory[];
+  plugins: readonly SchedulePlugin[];
+  headingLevel: ScheduleHeadingLevel;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default$16: typeof __VLS_export$6;
+//#endregion
+//#region src/Schedule/weeklyView.d.ts
+interface ScheduleWeeklyViewOptions extends ScheduleTimeGridViewOptions {
+  /** 一周从哪天开始，0 是周日。默认 0。 */
+  weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+}
+export declare function createScheduleWeeklyView({ weekStartsOn, minHour, maxHour, hourHeight, renderPopover }?: ScheduleWeeklyViewOptions): ScheduleView<ScheduleWeeklyViewOptions>;
+//#endregion
 //#region src/Stat/types.d.ts
 /** Trend direction of a delta; picks the glyph (up/down arrow, flat dash). */
 type StatDeltaDirection = 'up' | 'down' | 'flat';
@@ -906,7 +1811,7 @@ declare const __VLS_base$2: import("vue").DefineComponent<StatProps, {}, {}, {},
   description: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$5: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
-declare const _default$10: typeof __VLS_export$5;
+declare const _default$17: typeof __VLS_export$5;
 type __VLS_WithSlots$2<T, S> = T & {
   new (): {
     $slots: S;
@@ -1054,7 +1959,7 @@ declare const __VLS_export$4: import("vue").DefineComponent<SVGIconProps, {}, {}
   variation: SVGIconVariation;
   color: SVGIconColor;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default$9: typeof __VLS_export$4;
+declare const _default$15: typeof __VLS_export$4;
 //#endregion
 //#region src/SVGIcon/types-xif.d.ts
 /**
@@ -1238,7 +2143,7 @@ declare const __VLS_base$1: import("vue").DefineComponent<TourProps, {}, {}, {},
   isStepCountShown: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$3: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
-declare const _default$11: typeof __VLS_export$3;
+declare const _default$18: typeof __VLS_export$3;
 type __VLS_WithSlots$1<T, S> = T & {
   new (): {
     $slots: S;
@@ -1249,7 +2154,7 @@ type __VLS_WithSlots$1<T, S> = T & {
 type __VLS_Slots = TourStepSlots;
 declare const __VLS_base: any;
 declare const __VLS_export$2: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default$12: typeof __VLS_export$2;
+declare const _default$19: typeof __VLS_export$2;
 type __VLS_WithSlots<T, S> = T & {
   new (): {
     $slots: S;
@@ -1351,7 +2256,7 @@ declare const __VLS_export$1: <T extends string>(__VLS_props: NonNullable<Awaite
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const _default$13: typeof __VLS_export$1;
+declare const _default$20: typeof __VLS_export$1;
 type __VLS_PrettifyLocal$1<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
 //#endregion
 //#region src/TransferList/TransferListSelector.vue.d.ts
@@ -1407,7 +2312,7 @@ declare const __VLS_export: <T extends string>(__VLS_props: NonNullable<Awaited<
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const _default$14: typeof __VLS_export;
+declare const _default$21: typeof __VLS_export;
 type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
 //#endregion
-export { type ChatEmojiOption, _default as ChatEmojiPicker, type ChatEmojiPickerEmits, type ChatEmojiPickerProps, type ChatEmojiPickerSlots, type ChatReaction, _default$1 as ChatReactionBar, type ChatReactionBarEmits, type ChatReactionBarProps, _default$2 as CircularProgress, type CircularProgressProps, type CircularProgressSize, type CircularProgressVariant, type CircularProgressVariantMap, _default$3 as CodeEditor, type CodeEditorEmits, type CodeEditorProps, type CreateDiffFileOptions, _default$4 as DiffViewer, type DiffViewerChangeIndicator, type DiffViewerEmits, type DiffViewerFile, type DiffViewerFileStatus, type DiffViewerHunk, type DiffViewerInlineHighlight, type DiffViewerLine, type DiffViewerLineKind, type DiffViewerLineRef, type DiffViewerProps, type DiffViewerSide, type DiffViewerSlots, type DiffViewerViewMode, type IconShape, type IconShapeRole, _default$5 as InfoTip, type InfoTipProps, type InfoTipSize, type InlineDiffGranularity, type InlineDiffResult, type InlineRange, _default$6 as ListInput, type ListInputChange, type ListInputColumn, type ListInputColumnWidth, type ListInputEmits, type ListInputProps, type ListInputRenderContext, type ListInputValueContext, type LogEntry, _default$7 as LogStream, type LogStreamEmits, type LogStreamLevel, type LogStreamProps, _default$8 as MobileTokenizer, type MobileTokenizerChange, type MobileTokenizerEmits, type MobileTokenizerProps, type PanelGroup, type PanelRow, type PathPersonality, _default$9 as SVGIcon, type SVGIconColor, type SVGIconDef, type SVGIconProps, type SVGIconSize, type SVGIconVariation, type SearchSource, type SearchableItem, _default$10 as Stat, type StatDelta, type StatDeltaDirection, type StatDeltaSentiment, type StatProps, type StatSize, _default$11 as Tour, type TourDismissSource, type TourEmits, type TourProps, type TourSlots, _default$12 as TourStep, type TourStepProps, type TourStepSlots, _default$13 as TransferList, type TransferListEmits, type TransferListOption, type TransferListProps, _default$14 as TransferListSelector, type TransferListSlots, type UseTourReturn, type XIFAnimate, type XIFIcon, type XIFPath, type XIFPersonality, type XIFSlot };
+export { type CalendarDayEvent, type CalendarEvent, type CalendarEventBase, type CalendarInstantEvent, type ChatEmojiOption, _default as ChatEmojiPicker, type ChatEmojiPickerEmits, type ChatEmojiPickerProps, type ChatEmojiPickerSlots, type ChatReaction, _default$1 as ChatReactionBar, type ChatReactionBarEmits, type ChatReactionBarProps, _default$2 as CircularProgress, type CircularProgressProps, type CircularProgressSize, type CircularProgressVariant, type CircularProgressVariantMap, _default$3 as CodeEditor, type CodeEditorEmits, type CodeEditorProps, type CommentActivityEvent, type CommentAgentCommand, type CommentAnchor, _default$4 as CommentComposer, _default$5 as CommentComposerBase, type CommentComposerBaseEmits, type CommentComposerBaseProps, type CommentComposerBaseSlots, type CommentComposerContext, type CommentComposerEmits, type CommentComposerProps, type CommentComposerRenderProps, type CommentComposerSlots, type CommentData, type CommentHighlightColor, type CommentImageUploader, type CommentMode, _default$6 as CommentPin, type CommentPinEmits, type CommentPinParticipant, type CommentPinProps, type CommentPinSize, type CommentProgress, type CommentReaction, type CommentReactionOption, type CommentStatus, _default$7 as CommentThread, type CommentThreadData, type CommentThreadEmits, type CommentThreadProps, type CommentThreadSharedProps, type CommentThreadSlots, type CommentUploadedImage, type CommentUser, type CommentVersion, _default$8 as Comments, type CommentsComposerPosition, type CommentsDensity, type CommentsEmits, type CommentsLayout, type CommentsProps, type CommentsSlots, type CreateDiffFileOptions, _default$9 as DiffViewer, type DiffViewerChangeIndicator, type DiffViewerEmits, type DiffViewerFile, type DiffViewerFileStatus, type DiffViewerHunk, type DiffViewerInlineHighlight, type DiffViewerLine, type DiffViewerLineKind, type DiffViewerLineRef, type DiffViewerProps, type DiffViewerSide, type DiffViewerSlots, type DiffViewerViewMode, type EmojiCategory, type EmojiOption, _default$10 as EmojiPicker, type EmojiPickerEmits, type EmojiPickerProps, type IconShape, type IconShapeRole, _default$11 as InfoTip, type InfoTipProps, type InfoTipSize, type InlineDiffGranularity, type InlineDiffResult, type InlineRange, type Instant, _default$12 as ListInput, type ListInputChange, type ListInputColumn, type ListInputColumnWidth, type ListInputEmits, type ListInputProps, type ListInputRenderContext, type ListInputValueContext, type LogEntry, _default$13 as LogStream, type LogStreamEmits, type LogStreamLevel, type LogStreamProps, _default$14 as MobileTokenizer, type MobileTokenizerChange, type MobileTokenizerEmits, type MobileTokenizerProps, type PanelGroup, type PanelRow, type PathPersonality, _default$15 as SVGIcon, type SVGIconColor, type SVGIconDef, type SVGIconProps, type SVGIconSize, type SVGIconVariation, _default$16 as Schedule, type ScheduleCategory, type ScheduleContextValue, type ScheduleDate, type ScheduleEmits, type ScheduleEventColor, type ScheduleEventSource, type ScheduleHeaderContent, type SchedulePaginationPluginOptions, type SchedulePlugin, type SchedulePluginPosition, type ScheduleProps, type ScheduleRange, type ScheduleTimeGridViewOptions, type ScheduleView, type ScheduleViewBase, type ScheduleViewOptions, type ScheduleViewSelectorOption, type ScheduleViewSelectorPluginOptions, type SearchSource, type SearchableItem, _default$17 as Stat, type StatDelta, type StatDeltaDirection, type StatDeltaSentiment, type StatProps, type StatSize, _default$18 as Tour, type TourDismissSource, type TourEmits, type TourProps, type TourSlots, _default$19 as TourStep, type TourStepProps, type TourStepSlots, _default$20 as TransferList, type TransferListEmits, type TransferListOption, type TransferListProps, _default$21 as TransferListSelector, type TransferListSlots, type UseTourReturn, type XIFAnimate, type XIFIcon, type XIFPath, type XIFPersonality, type XIFSlot, type ZonedDateTime, type ZonedDateTimeRange };