@jant/core 0.6.16 → 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-types.ts

@@ -99,6 +99,29 @@ export interface LocalDraftMedia {
   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;
@@ -115,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;
@@ -136,6 +166,10 @@ export interface LocalDraft {
     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;
@@ -150,6 +184,7 @@ export interface LocalDraft {
 
 export interface ComposeLabels {
   cancel: string;
+  close: string;
   note: string;
   link: string;
   quote: string;
@@ -188,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). */
@@ -229,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;
@@ -271,7 +330,6 @@ export interface ComposeLabels {
   threadLimitReached: string;
   showMore: string;
   showLess: string;
-  closeCompose: string;
   editing: string;
   composeDialogLabel: string;
   slashHint: string;
@@ -350,10 +408,26 @@ export interface ComposeSubmitDetail {
   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;