@jant/core 0.6.15 → 0.7.0

package/src/client/components/collection-dialog-types.ts

@@ -0,0 +1,49 @@
+/**
+ * Type definitions for the collection dialog.
+ */
+
+import type { CollectionSortOrder } from "../../types.js";
+
+/** What the dialog hands back to whoever opened it. */
+export interface CollectionDialogResult {
+  /** Whether anything was created or saved. */
+  changed: boolean;
+  /**
+   * The collection as it stands after saving.
+   *
+   * The caller needs it: a directory flags the row it just created, and a
+   * collection page has to follow its own address when the link moved.
+   */
+  collection?: {
+    id: string;
+    slug: string;
+    title: string;
+  };
+}
+
+export interface CollectionDialogLabels {
+  createHeading: string;
+  editHeading: string;
+  title: string;
+  titlePlaceholder: string;
+  /** The collection link, in the collection form's own words. */
+  link: string;
+  linkHelp: string;
+  editLink: string;
+  resetLink: string;
+  linkTaken: string;
+  linkInvalid: string;
+  linkReserved: string;
+  linkTooLong: string;
+  linkMovesWarning: string;
+  description: string;
+  descriptionPlaceholder: string;
+  orderBy: string;
+  sortOptions: Record<CollectionSortOrder, string>;
+  cancel: string;
+  save: string;
+  saved: string;
+  saveFailed: string;
+  loadFailed: string;
+  titleAndLinkRequired: string;
+}

package/src/client/components/collection-manager-types.ts

@@ -6,6 +6,13 @@ import type { CollectionFormLabels } from "./collection-types.js";
 
 export interface CollectionManagerLabels {
   collectionsTitle: string;
+  /** The kind itself, for the marker beside a smart collection's title. */
+  smartCollectionNoun: string;
+  newSmartCollection: string;
+  editSmartCollection: string;
+  deleteSmartCollection: string;
+  confirmDeleteSmartCollection: string;
+  smartCollectionDeleted: string;
   organize: string;
   done: string;
   organizeHint: string;
@@ -41,6 +48,7 @@ export interface CollectionManagerLabels {
   threadPlural: string;
   emptyState: string;
   orderSaved: string;
+  save: string;
   saved: string;
   linkCreated: string;
   linkSaved: string;
@@ -60,13 +68,36 @@ export interface ManagedCollection {
   recentActivityAt: number;
 }
 
+/**
+ * A smart collection as the directory manager sees it.
+ *
+ * `recentActivityAt` means what it means on a manual collection: the newest
+ * activity among the threads in it. Membership is what the two kinds disagree
+ * about — tagged by hand or decided by conditions — and freshness does not
+ * depend on how a thread got in.
+ */
+export interface ManagedSmartCollection {
+  id: string;
+  slug: string;
+  title: string;
+  description: string | null;
+  /** Conditions, in the shared dimension vocabulary. */
+  selection: Record<string, unknown>;
+  sort: string;
+  layout: string | null;
+  threadCount: number;
+  recentActivityAt: number;
+}
+
 export interface CollectionManagerItem {
   id: string;
-  type: "collection" | "divider" | "link";
+  type: "collection" | "smart_collection" | "divider" | "link";
   collectionId?: string | null;
+  smartCollectionId?: string | null;
   label?: string | null;
   url?: string | null;
   description?: string | null;
   position?: string;
   collection?: ManagedCollection;
+  smartCollection?: ManagedSmartCollection;
 }

package/src/client/components/collection-types.ts

@@ -1,9 +1,7 @@
 /**
- * Shared type definitions for the collection form Lit component.
+ * Shared type definitions for the collection quick-create form.
  */
 
-import type { CollectionSortOrder } from "../../types.js";
-
 export interface CollectionFormLabels {
   titleLabel: string;
   titlePlaceholder: string;
@@ -17,21 +15,12 @@ export interface CollectionFormLabels {
   quickHint: string;
   quickSubmitLabel: string;
   createdLabel: string;
-  descriptionLabel: string;
-  descriptionPlaceholder: string;
-  sortOrderLabel: string;
-  sortNewest: string;
-  sortOldest: string;
-  sortRatingDesc: string;
-  submitLabel: string;
   cancelLabel: string;
 }
 
 export interface CollectionFormInitial {
   title: string;
   slug: string;
-  description: string;
-  sortOrder: CollectionSortOrder;
 }
 
 export interface CollectionSubmitDetail {
@@ -39,8 +28,5 @@ export interface CollectionSubmitDetail {
   data: {
     title: string;
     slug: string;
-    description?: string;
-    sortOrder?: CollectionSortOrder;
   };
-  isEdit: boolean;
 }

package/src/client/components/compose-format-convert.ts

@@ -249,7 +249,11 @@ export function convertComposeFormat(
   if (prepend.length) content.unshift(...prepend);
 
   out.bodyJson = content.length ? { type: "doc", content } : null;
-  out.showTitle = to === "note" && out.title.trim().length > 0;
+  // A title carried in from another format has nowhere to show unless the note's
+  // title field is open, so opening it is the only way not to drop it. The
+  // toggle is otherwise left alone, so note → link → note keeps the user's
+  // choice instead of resetting it.
+  if (to === "note" && out.title.trim().length > 0) out.showTitle = true;
 
   return out;
 }

package/src/client/components/compose-types.ts

@@ -11,6 +11,18 @@ import type { TableControlLabels } from "../tiptap/table-control-labels.js";
 
 export type ComposeFormat = "note" | "link" | "quote";
 
+/**
+ * What one composer row says about itself. An editor owns its fields, so it
+ * owns these two answers too — the dialog reduces them over the rows it has
+ * instead of reading editors back out of the DOM while it renders.
+ */
+export interface ComposeRowStatus {
+  /** Anything worth keeping: the check behind "discard this?" and autosave. */
+  hasContent: boolean;
+  /** Enough to publish this row: its format's requirements met, fields valid. */
+  publishable: boolean;
+}
+
 export interface ComposeAttachment {
   clientId: string;
   file: File;
@@ -25,6 +37,12 @@ export interface ComposeAttachment {
   status: "pending" | "processing" | "uploading" | "done" | "error";
   progress: number | null;
   mediaId: string | null;
+  /**
+   * Server URL of the uploaded file, set when the upload completes. Unlike
+   * `previewUrl` (a blob URL revoked on editor reset) it stays valid, so
+   * draft restore can rehydrate the attachment after the dialog closed.
+   */
+  remoteUrl: string | null;
   alt: string;
   error: string | null;
   /** Text content preview for text files (first ~100 chars) */
@@ -64,6 +82,46 @@ export interface DraftItem {
   }[];
 }
 
+/**
+ * Snapshot of a media attachment whose upload completed. Stored in the local
+ * draft (and passed by the bridge on failure restore) so uploaded images
+ * survive a failed publish or a page reload — the bytes are already on the
+ * server, only the reference needs restoring.
+ */
+export interface LocalDraftMedia {
+  clientId: string;
+  mediaId: string;
+  url: string;
+  mimeType: string;
+  name?: string;
+  alt?: string;
+  summary?: string | null;
+  chars?: number | null;
+}
+
+/**
+ * Why a stored local draft did or did not reach the composer.
+ *
+ * Every exit from a restore leaves the composer looking the same — empty — so
+ * without a reported reason there is nothing to inspect when an author asks
+ * where their work went. `none` is the ordinary case (the composer opened and
+ * there was simply no draft); every other non-`restored` value means bytes
+ * existed and did not come back.
+ */
+export type DraftRestoreOutcome =
+  | "restored"
+  | "none"
+  /** The composer is already committed to an edit or a server-side draft. */
+  | "composer-busy"
+  /** The composer already holds content a restore would overwrite. */
+  | "composer-has-content"
+  /** Stored, but not parseable as a draft. */
+  | "unreadable"
+  /** Older than the retention window. */
+  | "expired"
+  /** A reply draft belonging to a different parent post. */
+  | "other-reply";
+
 export interface LocalDraft {
   format: ComposeFormat;
   title: string;
@@ -80,6 +138,13 @@ export interface LocalDraft {
   showRating: boolean;
   collectionIds: string[];
   replyToId: string | null;
+  /** Language the author picked, if they picked one. */
+  language?: string | null;
+  /**
+   * Thread root this draft is a translation of. Carried so a half-written
+   * translation picked up later still knows what it belongs to.
+   */
+  translationOfId?: string | null;
   attachedTexts: Array<{
     clientId: string;
     bodyJson: JSONContent | null;
@@ -87,14 +152,24 @@ export interface LocalDraft {
     summary: string;
   }>;
   attachmentOrder?: string[];
+  mediaAttachments?: LocalDraftMedia[];
   /** Present when the draft is a multi-post thread */
   threadItems?: Array<{
     format: ComposeFormat;
+    /** Per-post publish date; empty means "follows the thread". */
+    publishedAtInput?: string;
+    publishedAtTimeMinutes?: number | null;
+    /** Per-post permalink; empty means the server assigns a random id. */
+    slug?: string;
     title: string;
     bodyJson: JSONContent | null;
     url: string;
     quoteText: string;
     quoteAuthor: string;
+    /** Optional: drafts stored before thread posts kept these lack them. */
+    rating?: number;
+    showTitle?: boolean;
+    showRating?: boolean;
     attachedTexts: Array<{
       clientId: string;
       bodyJson: JSONContent | null;
@@ -102,12 +177,14 @@ export interface LocalDraft {
       summary: string;
     }>;
     attachmentOrder?: string[];
+    mediaAttachments?: LocalDraftMedia[];
   }>;
   savedAt: number;
 }
 
 export interface ComposeLabels {
   cancel: string;
+  close: string;
   note: string;
   link: string;
   quote: string;
@@ -146,7 +223,13 @@ export interface ComposeLabels {
   altHint: string;
   addMore: string;
   removeAttachment: string;
+  moveAttachmentEarlier: string;
+  moveAttachmentLater: string;
   uploading: string;
+  /** Toast shown while the submitted post is being published. */
+  publishing: string;
+  /** Toast shown while a draft or an edited post is being saved. */
+  saving: string;
   /** Toast when exactly one pasted remote image couldn't be rehosted. */
   imageNotRehosted?: string;
   /** Toast when several pasted remote images couldn't be rehosted (uses a {count} placeholder). */
@@ -187,14 +270,32 @@ export interface ComposeLabels {
   deleteDraft: string;
   draftDeleted: string;
   publishFailedDraft: string;
+  publishFailed: string;
+  publishFailedOffline: string;
   uploadFailedDraft: string;
   addCollection: string;
   collectionCountLabel: string;
   draftRestored: string;
+  draftStoreFailed: string;
   reply: string;
   publishHideFromLatest: string;
   publishPrivate: string;
   publishSettings: string;
+  languageLabel: string;
+  languageAuto: string;
+  languageAutoHint: string;
+  languageAutoDetected: string;
+  languageAutoPending: string;
+  languageTriggerLabel: string;
+  translationOf: string;
+  translationContext: string;
+  translationContextInLanguage: string;
+  translationContextOpen: string;
+  translationContextOriginal: string;
+  translationContextHide: string;
+  translationContextHideLong: string;
+  translationContextShow: string;
+  translationContextShowLong: string;
   publishVisibilityLabel: string;
   publishVisibilityPublic: string;
   publishVisibilityPublicHint: string;
@@ -229,9 +330,8 @@ export interface ComposeLabels {
   threadLimitReached: string;
   showMore: string;
   showLess: string;
-  newThread: string;
-  replyTitle: string;
-  editTitle: string;
+  editing: string;
+  composeDialogLabel: string;
   slashHint: string;
   tableControls: TableControlLabels;
   collectionFormLabels: CollectionFormLabels;
@@ -301,15 +401,33 @@ export interface ComposeSubmitDetail {
   collectionIds: string[];
   attachments: ComposeSubmitAttachment[];
   editPostId?: string;
+  /** Identifies an existing server draft loaded through the drafts workflow. */
+  draftSourceId?: string;
   replyToId?: string;
   quietReply?: boolean;
   replyThreadRootId?: string;
   replyRefreshKind?: "timeline-item" | "post-card" | "post-view";
   replyRefreshId?: string;
+  /**
+   * Content language chosen by the author. Absent means "nobody said" — the
+   * server reads one out of the text rather than guessing in the browser,
+   * because it sees the final text.
+   */
+  language?: string;
+  /** Thread root this post is being written as a translation of. */
+  translationOfId?: string;
   /** Present when submitting a multi-post thread; index 0 is the root */
   threadPosts?: ComposeSubmitDetail[];
 }
 
+/** One language the site publishes, as offered in the composer. */
+export interface ComposeLanguage {
+  /** Canonical BCP 47 tag. */
+  tag: string;
+  /** The language's own name for itself, e.g. "日本語". */
+  label: string;
+}
+
 export interface ComposeCollection {
   id: string;
   title: string;