@knkcs/contenthub-ui 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -57,6 +57,30 @@ export declare interface BlockReasonsSettingsProps {
 /** The longest Blueprint accessor a check names (internal/workspaceconfig.MaxBlueprintAccessor). */
 export declare const BLUEPRINT_ACCESSOR_MAX = 200;
 
+/**
+ * Why contenthub refused a Blueprint accessor a write added (ADR 0023): it
+ * names no Blueprint of the workspace, its Blueprint is archived, or it is
+ * no content Blueprint (a Title, a fieldset).
+ */
+export declare type BlueprintAccessorRefusal = "unknown" | "archived" | "not_content";
+
+/**
+ * A Required Check or editing override write named, newly, Blueprint
+ * accessors the workspace configuration may not name; nothing was written.
+ * `refused` names every one, read from the refusal's detail, never its text.
+ * An accessor the setting named already is never refused.
+ */
+export declare class BlueprintAccessorsRefusedError extends InvalidInputError {
+    readonly refused: {
+        accessor: string;
+        reason: BlueprintAccessorRefusal;
+    }[];
+    constructor(refused: {
+        accessor: string;
+        reason: BlueprintAccessorRefusal;
+    }[], message?: string);
+}
+
 /** One Blueprint's override of the workspace's editing settings. */
 export declare interface BlueprintEditingOverride {
     blueprintAccessor: string;
@@ -64,15 +88,27 @@ export declare interface BlueprintEditingOverride {
     editingMode: EditingMode | null;
     /** null follows the workspace's. */
     editingBlock: boolean | null;
+    /** The people beside the admins; null follows the workspace's, [] is the admins alone. */
+    forceGroup: string[] | null;
     /** What applies to the Blueprint's Content: this override over the workspace's. */
     effective: EditingSettings;
 }
 
-/** A content Blueprint, as the `BlueprintSource` port names it. */
+/** A Blueprint, as the `BlueprintSource` port names it. */
 export declare interface BlueprintInfo {
     id: string;
     /** What editors call it. */
     name: string;
+    /**
+     * Its accessor, unique in the workspace for good: what workspace
+     * configuration names it by (ADR 0023).
+     */
+    accessor: string;
+    /**
+     * Whether it is archived. Search never offers an archived Blueprint;
+     * naming one by id or accessor does, marked. Absent means not archived.
+     */
+    archived?: boolean;
 }
 
 /** One page of `BlueprintSource.searchBlueprints`. */
@@ -100,8 +136,8 @@ export declare interface BlueprintReleaseInfo {
 }
 
 /**
- * The workspace's content Blueprints and their Releases, for New Content and
- * the Library's Blueprint filter. contenthub serves them itself
+ * The workspace's content Blueprints and their Releases, for New Content, the
+ * Library's Blueprint filter and the configuration that names Blueprints. contenthub serves them itself
  * (`BlueprintCatalogService`, #238): blueprinthub is its direct dependency,
  * not a port a host fills (ADR 0020 as amended), so every screen builds this
  * from its `ContenthubClient` unless a host passes its own, which only tests
@@ -109,16 +145,24 @@ export declare interface BlueprintReleaseInfo {
  */
 export declare interface BlueprintSource {
     /**
-     * Unarchived content Blueprints whose name holds `query` (every one for
-     * ""), by name. `signal` aborts a search the user has moved on from.
+     * Unarchived content Blueprints with a Release whose name holds `query`
+     * (every one for ""), by name; with `includeWithoutRelease`, those
+     * without a Release too. `signal` aborts a search the user has moved on
+     * from.
      */
     searchBlueprints(input: {
         query: string;
         pageToken?: string;
+        includeWithoutRelease?: boolean;
         signal?: AbortSignal;
     }): Promise<BlueprintPage>;
     /** The Blueprints of these ids, archived ones too; an unknown id is left out. */
     getBlueprints(ids: string[]): Promise<BlueprintInfo[]>;
+    /**
+     * The Blueprints of these accessors, archived ones too; an accessor of no
+     * Blueprint is left out.
+     */
+    getBlueprintsByAccessor(accessors: string[]): Promise<BlueprintInfo[]>;
     /** Every Release of a Blueprint, newest first; empty while none has been cut. */
     listReleases(blueprintId: string): Promise<BlueprintReleaseInfo[]>;
 }
@@ -166,6 +210,13 @@ export declare interface BranchEditorProps {
 /** What a Branch is for: one an editor works on, or a Carry-forward link. */
 export declare type BranchKind = "editorial" | "carry_forward";
 
+/** Whether a Direct Edit's change carries forward into one later wording (#270). */
+export declare interface CarryForwardAnswer {
+    /** The later wording: the Release a Carry-forward link carries. */
+    releaseId: string;
+    carry: boolean;
+}
+
 /** What a Chain on Dated Content, effective on a date, would be and meet (PreviewChain). */
 export declare interface ChainPreview {
     /** The Release it would fork from; "" in a gap. */
@@ -509,6 +560,8 @@ export declare interface ContentAttributes {
     block?: ContentBlock;
     /** When it was archived, ISO 8601; absent while it is not Archived. */
     archiveTime?: string;
+    /** Its Editing Block; absent while no open Direct Edit holds one. */
+    editingBlock?: EditingBlock;
 }
 
 /**
@@ -749,11 +802,18 @@ export declare interface ContenthubClient {
     listRequiredChecks(): Promise<RequiredCheck[]>;
     /**
      * Declares a Required Check; it gates every open Change Set at once.
-     * Rejects with `NameTakenError` when another check has the name, and
-     * `InvalidInputError` for anything else the service refuses.
+     * Rejects with `NameTakenError` when another check has the name,
+     * `BlueprintAccessorsRefusedError` for accessors naming no content
+     * Blueprint taking new work, `ServiceUnavailableError` while they can't
+     * be checked, and `InvalidInputError` for anything else the service
+     * refuses.
      */
     createRequiredCheck(input: RequiredCheckInput): Promise<RequiredCheck>;
-    /** Replaces every field of a Required Check; its id stays. Rejects as create does. */
+    /**
+     * Replaces every field of a Required Check; its id stays. Rejects as
+     * create does, checking only the accessors it adds: one the check names
+     * already passes whatever its Blueprint's state now.
+     */
     updateRequiredCheck(input: RequiredCheckInput & {
         id: string;
     }): Promise<RequiredCheck>;
@@ -816,12 +876,17 @@ export declare interface ContenthubClient {
     /**
      * Replaces one Blueprint's override; admin only. A null field follows the
      * workspace's, and at least one must be set. Rejects as
-     * `setEditingSettings` does.
+     * `setEditingSettings` does, and adding an override with
+     * `BlueprintAccessorsRefusedError` for an accessor naming no content
+     * Blueprint taking new work, `ServiceUnavailableError` while it can't be
+     * checked.
      */
     setBlueprintEditingOverride(input: {
         blueprintAccessor: string;
         editingMode: EditingMode | null;
         editingBlock: boolean | null;
+        /** null follows the workspace's; [] is the admins alone. */
+        forceGroup: string[] | null;
     }): Promise<BlueprintEditingOverride>;
     /** Removes one Blueprint's override, so it follows the workspace's; admin only. */
     deleteBlueprintEditingOverride(input: {
@@ -928,12 +993,16 @@ export declare interface ContenthubClient {
     /**
      * A page of the workspace's content Blueprints Content can be made from:
      * not archived, with at least one Release, whose accessor or name holds
-     * `query`. contenthub asks blueprinthub as the caller (#238). Rejects
-     * with `ServiceUnavailableError` while blueprinthub gives no answer.
+     * `query`. With `includeWithoutRelease`, those without a Release too, for
+     * configuration that names a Blueprint before its first Release (ADR
+     * 0023); never an archived one. contenthub asks blueprinthub as the
+     * caller (#238). Rejects with `ServiceUnavailableError` while blueprinthub
+     * gives no answer.
      */
     searchBlueprints(input: {
         query: string;
         pageToken?: string;
+        includeWithoutRelease?: boolean;
         signal?: AbortSignal;
     }): Promise<BlueprintPage>;
     /**
@@ -951,6 +1020,14 @@ export declare interface ContenthubClient {
      * `ServiceUnavailableError` while blueprinthub gives no answer.
      */
     getBlueprints(ids: string[]): Promise<BlueprintInfo[]>;
+    /**
+     * Names the Blueprints of these accessors, as workspace configuration
+     * names them (ADR 0023): archived ones and ones without a Release
+     * included. An accessor of no Blueprint, or of one of another workspace,
+     * is left out. At most `MAX_BLUEPRINT_IDS`. Rejects with
+     * `ServiceUnavailableError` while blueprinthub gives no answer.
+     */
+    getBlueprintsByAccessor(accessors: string[]): Promise<BlueprintInfo[]>;
     /**
      * Creates a Content in an open Change Set, pinning a Blueprint Release,
      * with empty data: its one Chain has one Branch, opened in the Branch
@@ -1086,11 +1163,20 @@ export declare interface ContenthubClient {
      * or answers the one the caller has open on it, with `reopened`. Answers
      * the Direct Edit and the Content as read on its Branch. Rejects with
      * `EditingModeRefusedError` where the Editing Mode is "Change Sets only",
-     * `DirectEditRefusedError` where the Content is Dated, `ContentBlockedError`, `ContentArchivedError`,
-     * and `InvalidInputError` for anything else the service refuses.
+     * `DirectEditRefusedError` where another editor's Direct Edit holds its
+     * Editing Block (naming them), `ContentBlockedError`, `ContentArchivedError`,
+     * and `InvalidInputError` for anything else the service refuses (a day
+     * for undated Content among it).
      */
     openDirectEdit(input: {
         contentId: string;
+        /**
+         * Dated Content only (#270): the day the change takes effect, as
+         * YYYY-MM-DD; absent is today. Its Branch forks from the Release In
+         * Force that day: on today it corrects that Release, on a later day
+         * it is a new wording.
+         */
+        effectiveOn?: string;
         /** Makes a retry safe (CONTEXT.md, Idempotency Key). */
         idempotencyKey?: string;
     }): Promise<{
@@ -1098,17 +1184,63 @@ export declare interface ContenthubClient {
         content: Content;
         reopened: boolean;
     }>;
+    /**
+     * What a Direct Edit's Publish of Dated Content would plan (#270): its
+     * Release's Validity Period with `validityLastDay` as Publish takes it,
+     * the Release it corrects, the date-only Releases contenthub derives and
+     * the later wordings Publish asks about. Writes nothing. Rejects with
+     * `CoversReleaseError` (`changeSetRequired`) when the period would cover
+     * a Release entirely.
+     */
+    previewDirectEditPublish(input: {
+        id: string;
+        validityLastDay?: string;
+    }): Promise<DirectEditPublishPreview>;
     /**
      * Publishes a Direct Edit at `expectedHeadId`, the head of its Branch the
-     * editor saw: one Release, In Force from its Publish. Rejects as
-     * `publish` does, and with `DirectEditRefusedError` for a Change Set that
-     * is not a Direct Edit.
+     * editor saw: one Release, In Force from its Publish, carrying
+     * `releaseSpec`. Rejects as `publish` does, with `ContentRefusedError`
+     * for Release Spec values the Blueprint Release refuses (a required one
+     * missing among them), and with `DirectEditRefusedError` for a Change
+     * Set that is not a Direct Edit. On Dated Content (#270) it takes the
+     * Validity Period's last day and one carry-forward answer per later
+     * wording, and rejects with `CoversReleaseError` (`changeSetRequired`)
+     * when the period would cover a Release entirely.
      */
     publishDirectEdit(input: {
         id: string;
         expectedHeadId: string;
+        /** The Release's Release Spec values; absent is none. */
+        releaseSpec?: Record<string, unknown>;
+        /** Dated Content: the period's last day, "" for an open end; absent keeps the default. */
+        validityLastDay?: string;
+        /** Dated Content: whether the change carries into each later wording. */
+        carryForward?: CarryForwardAnswer[];
         idempotencyKey?: string;
     }): Promise<PublishOutcome>;
+    /**
+     * Saves on a Direct Edit's Branch on top of `expectedHeadId`, as
+     * `saveRevision` does, and publishes the Revision saved, as
+     * `publishDirectEdit` does, in one request (ADR 0022). Refused as a
+     * whole, with nothing saved: rejects as either does (`StaleHeadError`,
+     * `ContentRefusedError` for the data or the Release Spec values,
+     * `PublishRefusedError` with every blocker).
+     */
+    saveAndPublishDirectEdit(input: {
+        id: string;
+        expectedHeadId: string;
+        data: Record<string, unknown>;
+        /** Top-level field accessors; absent saves `data` as the whole Revision. */
+        fieldMask?: string[];
+        releaseSpec?: Record<string, unknown>;
+        /** As `publishDirectEdit`'s. */
+        validityLastDay?: string;
+        carryForward?: CarryForwardAnswer[];
+        idempotencyKey?: string;
+    }): Promise<{
+        content: Content;
+        outcome: PublishOutcome;
+    }>;
     /**
      * Discards a Direct Edit: its work is dropped, Main and the Releases stay.
      * Rejects as `discardChangeSet` does, and with `DirectEditRefusedError`
@@ -1118,6 +1250,23 @@ export declare interface ContenthubClient {
         id: string;
         idempotencyKey?: string;
     }): Promise<ChangeSet>;
+    /**
+     * Forces an Editing Block (ADR 0022): hands the Direct Edit `id` holding
+     * it, with its work and its Editing Block, to the caller. Answers it with
+     * the caller as its editor, the Content as read on its Branch, and who
+     * edited it until now. Rejects with `AccessDeniedError` outside the
+     * Force Group, `DirectEditRefusedError` where the caller has a Direct
+     * Edit of the Content of their own or it holds no Editing Block any more,
+     * and as `discardDirectEdit` does otherwise.
+     */
+    forceDirectEdit(input: {
+        id: string;
+        idempotencyKey?: string;
+    }): Promise<{
+        changeSet: ChangeSet;
+        content: Content;
+        previousEditorId: string;
+    }>;
     startEditing(input: {
         contentId: string;
         changeSetId?: string;
@@ -1278,6 +1427,7 @@ export declare const contenthubKeys: {
     pendingMerge: (branchId: string) => readonly ["contenthub", "pending-merge", string];
     blueprints: () => readonly ["contenthub", "blueprints"];
     blueprintNames: (ids: string[]) => readonly ["contenthub", "blueprints", "names", string[]];
+    blueprintNamesByAccessor: (accessors: string[]) => readonly ["contenthub", "blueprints", "names-by-accessor", string[]];
     blueprintFilterOptions: () => readonly ["contenthub", "blueprints", "filter-options"];
     blueprintReleases: (blueprintId: string) => readonly ["contenthub", "blueprints", "releases", string];
 };
@@ -1325,7 +1475,7 @@ export declare interface ContenthubPathsProviderProps {
  * and there is no header Save: nothing here is a draft. Only the active tab
  * is mounted (nav-link tabs), so no two tabs' Modals or queries live at once.
  */
-export declare function ContenthubSettings({ client }: ContenthubSettingsProps): JSX.Element;
+export declare function ContenthubSettings({ client, blueprintSource }: ContenthubSettingsProps): JSX.Element;
 
 export declare namespace ContenthubSettings {
     var displayName: string;
@@ -1339,6 +1489,12 @@ export declare function contenthubSettingsPath(paths: ContenthubPaths, tab?: Con
 
 export declare interface ContenthubSettingsProps {
     client: ContenthubClient;
+    /**
+     * Where the Blueprints configuration names are picked from and named;
+     * contenthub's own catalogue through `client` unless given (only tests
+     * need to).
+     */
+    blueprintSource?: BlueprintSource;
 }
 
 /** The settings page's tabs, as `?tab=` names them. */
@@ -1422,6 +1578,7 @@ export declare const contenthubTranslations: {
                         mode: string;
                         block: string;
                         actions: string;
+                        force: string;
                     };
                     fromWorkspace: string;
                     createOverride: string;
@@ -1436,11 +1593,10 @@ export declare const contenthubTranslations: {
                         workspaceTitle: string;
                         createOverrideTitle: string;
                         editOverrideTitle: string;
-                        accessor: string;
-                        accessorHelp: string;
-                        accessorRequired: string;
-                        accessorTooLong: string;
-                        accessorTaken: string;
+                        blueprint: string;
+                        blueprintHelp: string;
+                        blueprintPlaceholder: string;
+                        blueprintRequired: string;
                         mode: string;
                         modeHelp: string;
                         modeRequired: string;
@@ -1451,6 +1607,11 @@ export declare const contenthubTranslations: {
                         save: string;
                         denied: string;
                         failed: string;
+                        force: string;
+                        forceHelp: string;
+                        forcePeople: string;
+                        forceNobody: string;
+                        forceOwn: string;
                     };
                     removeDialog: {
                         title: string;
@@ -1458,6 +1619,10 @@ export declare const contenthubTranslations: {
                         confirm: string;
                         failed: string;
                     };
+                    force: {
+                        adminsOnly: string;
+                        adminsAnd: string;
+                    };
                 };
                 requiredChecks: {
                     create: string;
@@ -1528,7 +1693,6 @@ export declare const contenthubTranslations: {
                         accessors: string;
                         accessorsHelp: string;
                         accessorsRequired: string;
-                        accessorTooLong: string;
                         independentLabel: string;
                         independentHelp: string;
                         recorders: string;
@@ -1536,6 +1700,7 @@ export declare const contenthubTranslations: {
                         failed: string;
                         createSubmit: string;
                         editSubmit: string;
+                        accessorsPlaceholder: string;
                     };
                     removeDialog: {
                         title: string;
@@ -2379,6 +2544,18 @@ export declare const contenthubTranslations: {
                         message: string;
                         confirm: string;
                     };
+                    editingBlock: {
+                        beingEdited: string;
+                        force: string;
+                        forceConfirm: {
+                            title: string;
+                            message: string;
+                            confirm: string;
+                            failed: string;
+                            denied: string;
+                        };
+                        forced: string;
+                    };
                     directEdit: {
                         unpublished: string;
                         continue: string;
@@ -2423,13 +2600,77 @@ export declare const contenthubTranslations: {
                     refused_one: string;
                     refused_other: string;
                     refusedBecause: {
-                        dated_content: string;
                         one_branch: string;
                         not_a_direct_edit: string;
+                        editing_blocked: string;
+                        not_the_editor: string;
+                        own_direct_edit: string;
+                        no_editing_block: string;
                         unknown: string;
                     };
+                    updateFromMain: string;
+                    resolveMerge: string;
+                    behind: {
+                        title: string;
+                        message: string;
+                    };
+                    pendingMerge: {
+                        title: string;
+                        message: string;
+                    };
                     saveFirst: string;
                     changeSetsOnly: string;
+                    saveAndPublish: string;
+                    publishDialog: {
+                        title: string;
+                        publishHint: string;
+                        saveAndPublishHint: string;
+                        specHint: string;
+                        refusedValues_one: string;
+                        refusedValues_other: string;
+                        datedPublishHint: string;
+                        datedSaveAndPublishHint: string;
+                        period: string;
+                        correction: string;
+                        newWording: string;
+                        firstDay: string;
+                        lastDay: string;
+                        lastDayHelp: string;
+                        computed: string;
+                        computedHint: string;
+                        computedRow: string;
+                        noComputed: string;
+                        carryForward: string;
+                        carryForwardHint: string;
+                        wording: string;
+                        wordingUntil: string;
+                        carryYes: string;
+                        carryNo: string;
+                        unanswered: string;
+                        previewFailed: string;
+                        covers: string;
+                    };
+                    effective: {
+                        title: string;
+                        hint: string;
+                        label: string;
+                        help: string;
+                        required: string;
+                        submit: string;
+                    };
+                };
+                blueprintSelect: {
+                    archived: string;
+                    unknown: string;
+                    empty: string;
+                    failed: string;
+                    loading: string;
+                    refused: string;
+                    refusal: {
+                        unknown: string;
+                        archived: string;
+                        not_content: string;
+                    };
                 };
             };
         };
@@ -2504,6 +2745,7 @@ export declare const contenthubTranslations: {
                         mode: string;
                         block: string;
                         actions: string;
+                        force: string;
                     };
                     fromWorkspace: string;
                     createOverride: string;
@@ -2518,11 +2760,10 @@ export declare const contenthubTranslations: {
                         workspaceTitle: string;
                         createOverrideTitle: string;
                         editOverrideTitle: string;
-                        accessor: string;
-                        accessorHelp: string;
-                        accessorRequired: string;
-                        accessorTooLong: string;
-                        accessorTaken: string;
+                        blueprint: string;
+                        blueprintHelp: string;
+                        blueprintPlaceholder: string;
+                        blueprintRequired: string;
                         mode: string;
                         modeHelp: string;
                         modeRequired: string;
@@ -2533,6 +2774,11 @@ export declare const contenthubTranslations: {
                         save: string;
                         denied: string;
                         failed: string;
+                        force: string;
+                        forceHelp: string;
+                        forcePeople: string;
+                        forceNobody: string;
+                        forceOwn: string;
                     };
                     removeDialog: {
                         title: string;
@@ -2540,6 +2786,10 @@ export declare const contenthubTranslations: {
                         confirm: string;
                         failed: string;
                     };
+                    force: {
+                        adminsOnly: string;
+                        adminsAnd: string;
+                    };
                 };
                 requiredChecks: {
                     create: string;
@@ -2610,7 +2860,6 @@ export declare const contenthubTranslations: {
                         accessors: string;
                         accessorsHelp: string;
                         accessorsRequired: string;
-                        accessorTooLong: string;
                         independentLabel: string;
                         independentHelp: string;
                         recorders: string;
@@ -2618,6 +2867,7 @@ export declare const contenthubTranslations: {
                         failed: string;
                         createSubmit: string;
                         editSubmit: string;
+                        accessorsPlaceholder: string;
                     };
                     removeDialog: {
                         title: string;
@@ -3461,6 +3711,18 @@ export declare const contenthubTranslations: {
                         message: string;
                         confirm: string;
                     };
+                    editingBlock: {
+                        beingEdited: string;
+                        force: string;
+                        forceConfirm: {
+                            title: string;
+                            message: string;
+                            confirm: string;
+                            failed: string;
+                            denied: string;
+                        };
+                        forced: string;
+                    };
                     directEdit: {
                         unpublished: string;
                         continue: string;
@@ -3505,13 +3767,77 @@ export declare const contenthubTranslations: {
                     refused_one: string;
                     refused_other: string;
                     refusedBecause: {
-                        dated_content: string;
                         one_branch: string;
                         not_a_direct_edit: string;
+                        editing_blocked: string;
+                        not_the_editor: string;
+                        own_direct_edit: string;
+                        no_editing_block: string;
                         unknown: string;
                     };
+                    updateFromMain: string;
+                    resolveMerge: string;
+                    behind: {
+                        title: string;
+                        message: string;
+                    };
+                    pendingMerge: {
+                        title: string;
+                        message: string;
+                    };
                     saveFirst: string;
                     changeSetsOnly: string;
+                    saveAndPublish: string;
+                    publishDialog: {
+                        title: string;
+                        publishHint: string;
+                        saveAndPublishHint: string;
+                        specHint: string;
+                        refusedValues_one: string;
+                        refusedValues_other: string;
+                        datedPublishHint: string;
+                        datedSaveAndPublishHint: string;
+                        period: string;
+                        correction: string;
+                        newWording: string;
+                        firstDay: string;
+                        lastDay: string;
+                        lastDayHelp: string;
+                        computed: string;
+                        computedHint: string;
+                        computedRow: string;
+                        noComputed: string;
+                        carryForward: string;
+                        carryForwardHint: string;
+                        wording: string;
+                        wordingUntil: string;
+                        carryYes: string;
+                        carryNo: string;
+                        unanswered: string;
+                        previewFailed: string;
+                        covers: string;
+                    };
+                    effective: {
+                        title: string;
+                        hint: string;
+                        label: string;
+                        help: string;
+                        required: string;
+                        submit: string;
+                    };
+                };
+                blueprintSelect: {
+                    archived: string;
+                    unknown: string;
+                    empty: string;
+                    failed: string;
+                    loading: string;
+                    refused: string;
+                    refusal: {
+                        unknown: string;
+                        archived: string;
+                        not_content: string;
+                    };
                 };
             };
         };
@@ -3697,14 +4023,35 @@ export declare interface DirectEditPageProps {
     onDiscarded?: (changeSetId: string) => void;
 }
 
+/**
+ * What a Direct Edit's Publish of Dated Content would plan (#270), for its
+ * Publish dialog: nothing of it is written.
+ */
+export declare interface DirectEditPublishPreview {
+    /** Its Release's Validity Period; an empty last day is an open end. */
+    validityPeriod?: ValidityPeriod;
+    /** The Release it corrects and Supersedes; "" for a new wording. */
+    correctsReleaseId: string;
+    /** The date-only Releases contenthub derives, read-only. */
+    dateOnlyReleases: PlannedRelease[];
+    /** The later wordings Publish asks about, by first day. */
+    laterWordings: LaterWording[];
+}
+
 /** Why contenthub refused a Direct Edit (`DirectEditRefusedError.reason`). */
 export declare type DirectEditRefusal = 
-/** The Content is Dated, which a Direct Edit can't take yet. */
-"dated_content"
 /** A Direct Edit takes no second Chain, Branch, dependency or Source. */
-| "one_branch"
+"one_branch"
 /** The Change Set named is not a Direct Edit. */
 | "not_a_direct_edit"
+/** Another editor's Direct Edit holds the Content's Editing Block. */
+| "editing_blocked"
+/** The Direct Edit is someone else's: `editorId` names them. */
+| "not_the_editor"
+/** Force by a caller who has a Direct Edit of the Content of their own. */
+| "own_direct_edit"
+/** Force of a Direct Edit that holds no Editing Block any more. */
+| "no_editing_block"
 /** A reason this build doesn't know. */
 | "unknown";
 
@@ -3716,7 +4063,12 @@ export declare class DirectEditRefusedError extends Error {
     readonly reason: DirectEditRefusal;
     /** The Content it is about; "" where the refusal names none. */
     readonly contentId: string;
-    constructor(reason: DirectEditRefusal, message: string, contentId?: string);
+    /**
+     * For `editing_blocked`: the editor holding the Editing Block; for
+     * `not_the_editor`: the Direct Edit's editor; "" otherwise.
+     */
+    readonly editorId: string;
+    constructor(reason: DirectEditRefusal, message: string, contentId?: string, editorId?: string);
 }
 
 /** One edge of one Revision. */
@@ -3737,6 +4089,21 @@ export declare interface Edge {
 /** What kind of edge of the Content Graph (ADR 0009). */
 export declare type EdgeKind = "reference" | "toc" | "include" | "exclude" | "replace" | "annotate" | "link" | "footnote" | "anchor" | "media" | "blueprint" | "unspecified";
 
+/**
+ * The Block a Direct Edit sets on its Content (CONTEXT.md, Editing Block):
+ * "being edited by" its editor. It keeps out only other editors' Direct
+ * Edits, ends with its Direct Edit's Publish or Discard, and can't be
+ * lifted. It is independent of `block`: a Content can hold both.
+ */
+export declare interface EditingBlock {
+    /** The Direct Edit's editor, an odon user id. */
+    editorId: string;
+    /** The Direct Edit holding it. */
+    changeSetId: string;
+    /** ISO 8601. */
+    blockTime: string;
+}
+
 /**
  * Which ways of changing a Blueprint's Content the workspace offers (ADR
  * 0022, CONTEXT.md Editing Mode): Direct Edits only, Change Sets only, or
@@ -3762,6 +4129,12 @@ export declare interface EditingSettings {
     editingMode: EditingMode;
     /** Whether opening a Direct Edit sets an Editing Block on its Content. */
     editingBlock: boolean;
+    /**
+     * The Force Group: who may force an Editing Block (ADR 0022). The
+     * workspace's admins always may; these are the people beside them, by
+     * odon user id, sorted. Empty is the admins alone.
+     */
+    forceGroup: string[];
 }
 
 /** The editing settings in effect for one Blueprint, and which its override decides. */
@@ -3769,6 +4142,13 @@ export declare interface EffectiveEditingSettings {
     effective: EditingSettings;
     editingModeOverridden: boolean;
     editingBlockOverridden: boolean;
+    forceGroupOverridden: boolean;
+    /**
+     * Whether the caller is in the effective Force Group: an admin, or named
+     * by it. It is how a screen knows to offer Force (#269); the service
+     * asks the same when it is used.
+     */
+    callerInForceGroup: boolean;
 }
 
 /** One field that differs between two Revisions. */
@@ -3883,6 +4263,7 @@ export declare const i18nResources: {
                     mode: string;
                     block: string;
                     actions: string;
+                    force: string;
                 };
                 fromWorkspace: string;
                 createOverride: string;
@@ -3897,11 +4278,10 @@ export declare const i18nResources: {
                     workspaceTitle: string;
                     createOverrideTitle: string;
                     editOverrideTitle: string;
-                    accessor: string;
-                    accessorHelp: string;
-                    accessorRequired: string;
-                    accessorTooLong: string;
-                    accessorTaken: string;
+                    blueprint: string;
+                    blueprintHelp: string;
+                    blueprintPlaceholder: string;
+                    blueprintRequired: string;
                     mode: string;
                     modeHelp: string;
                     modeRequired: string;
@@ -3912,6 +4292,11 @@ export declare const i18nResources: {
                     save: string;
                     denied: string;
                     failed: string;
+                    force: string;
+                    forceHelp: string;
+                    forcePeople: string;
+                    forceNobody: string;
+                    forceOwn: string;
                 };
                 removeDialog: {
                     title: string;
@@ -3919,6 +4304,10 @@ export declare const i18nResources: {
                     confirm: string;
                     failed: string;
                 };
+                force: {
+                    adminsOnly: string;
+                    adminsAnd: string;
+                };
             };
             requiredChecks: {
                 create: string;
@@ -3989,7 +4378,6 @@ export declare const i18nResources: {
                     accessors: string;
                     accessorsHelp: string;
                     accessorsRequired: string;
-                    accessorTooLong: string;
                     independentLabel: string;
                     independentHelp: string;
                     recorders: string;
@@ -3997,6 +4385,7 @@ export declare const i18nResources: {
                     failed: string;
                     createSubmit: string;
                     editSubmit: string;
+                    accessorsPlaceholder: string;
                 };
                 removeDialog: {
                     title: string;
@@ -4840,6 +5229,18 @@ export declare const i18nResources: {
                     message: string;
                     confirm: string;
                 };
+                editingBlock: {
+                    beingEdited: string;
+                    force: string;
+                    forceConfirm: {
+                        title: string;
+                        message: string;
+                        confirm: string;
+                        failed: string;
+                        denied: string;
+                    };
+                    forced: string;
+                };
                 directEdit: {
                     unpublished: string;
                     continue: string;
@@ -4884,13 +5285,77 @@ export declare const i18nResources: {
                 refused_one: string;
                 refused_other: string;
                 refusedBecause: {
-                    dated_content: string;
                     one_branch: string;
                     not_a_direct_edit: string;
+                    editing_blocked: string;
+                    not_the_editor: string;
+                    own_direct_edit: string;
+                    no_editing_block: string;
                     unknown: string;
                 };
+                updateFromMain: string;
+                resolveMerge: string;
+                behind: {
+                    title: string;
+                    message: string;
+                };
+                pendingMerge: {
+                    title: string;
+                    message: string;
+                };
                 saveFirst: string;
                 changeSetsOnly: string;
+                saveAndPublish: string;
+                publishDialog: {
+                    title: string;
+                    publishHint: string;
+                    saveAndPublishHint: string;
+                    specHint: string;
+                    refusedValues_one: string;
+                    refusedValues_other: string;
+                    datedPublishHint: string;
+                    datedSaveAndPublishHint: string;
+                    period: string;
+                    correction: string;
+                    newWording: string;
+                    firstDay: string;
+                    lastDay: string;
+                    lastDayHelp: string;
+                    computed: string;
+                    computedHint: string;
+                    computedRow: string;
+                    noComputed: string;
+                    carryForward: string;
+                    carryForwardHint: string;
+                    wording: string;
+                    wordingUntil: string;
+                    carryYes: string;
+                    carryNo: string;
+                    unanswered: string;
+                    previewFailed: string;
+                    covers: string;
+                };
+                effective: {
+                    title: string;
+                    hint: string;
+                    label: string;
+                    help: string;
+                    required: string;
+                    submit: string;
+                };
+            };
+            blueprintSelect: {
+                archived: string;
+                unknown: string;
+                empty: string;
+                failed: string;
+                loading: string;
+                refused: string;
+                refusal: {
+                    unknown: string;
+                    archived: string;
+                    not_content: string;
+                };
             };
         };
     };
@@ -4965,6 +5430,7 @@ export declare const i18nResources: {
                     mode: string;
                     block: string;
                     actions: string;
+                    force: string;
                 };
                 fromWorkspace: string;
                 createOverride: string;
@@ -4979,11 +5445,10 @@ export declare const i18nResources: {
                     workspaceTitle: string;
                     createOverrideTitle: string;
                     editOverrideTitle: string;
-                    accessor: string;
-                    accessorHelp: string;
-                    accessorRequired: string;
-                    accessorTooLong: string;
-                    accessorTaken: string;
+                    blueprint: string;
+                    blueprintHelp: string;
+                    blueprintPlaceholder: string;
+                    blueprintRequired: string;
                     mode: string;
                     modeHelp: string;
                     modeRequired: string;
@@ -4994,6 +5459,11 @@ export declare const i18nResources: {
                     save: string;
                     denied: string;
                     failed: string;
+                    force: string;
+                    forceHelp: string;
+                    forcePeople: string;
+                    forceNobody: string;
+                    forceOwn: string;
                 };
                 removeDialog: {
                     title: string;
@@ -5001,6 +5471,10 @@ export declare const i18nResources: {
                     confirm: string;
                     failed: string;
                 };
+                force: {
+                    adminsOnly: string;
+                    adminsAnd: string;
+                };
             };
             requiredChecks: {
                 create: string;
@@ -5071,7 +5545,6 @@ export declare const i18nResources: {
                     accessors: string;
                     accessorsHelp: string;
                     accessorsRequired: string;
-                    accessorTooLong: string;
                     independentLabel: string;
                     independentHelp: string;
                     recorders: string;
@@ -5079,6 +5552,7 @@ export declare const i18nResources: {
                     failed: string;
                     createSubmit: string;
                     editSubmit: string;
+                    accessorsPlaceholder: string;
                 };
                 removeDialog: {
                     title: string;
@@ -5922,6 +6396,18 @@ export declare const i18nResources: {
                     message: string;
                     confirm: string;
                 };
+                editingBlock: {
+                    beingEdited: string;
+                    force: string;
+                    forceConfirm: {
+                        title: string;
+                        message: string;
+                        confirm: string;
+                        failed: string;
+                        denied: string;
+                    };
+                    forced: string;
+                };
                 directEdit: {
                     unpublished: string;
                     continue: string;
@@ -5966,13 +6452,77 @@ export declare const i18nResources: {
                 refused_one: string;
                 refused_other: string;
                 refusedBecause: {
-                    dated_content: string;
                     one_branch: string;
                     not_a_direct_edit: string;
+                    editing_blocked: string;
+                    not_the_editor: string;
+                    own_direct_edit: string;
+                    no_editing_block: string;
                     unknown: string;
                 };
+                updateFromMain: string;
+                resolveMerge: string;
+                behind: {
+                    title: string;
+                    message: string;
+                };
+                pendingMerge: {
+                    title: string;
+                    message: string;
+                };
                 saveFirst: string;
                 changeSetsOnly: string;
+                saveAndPublish: string;
+                publishDialog: {
+                    title: string;
+                    publishHint: string;
+                    saveAndPublishHint: string;
+                    specHint: string;
+                    refusedValues_one: string;
+                    refusedValues_other: string;
+                    datedPublishHint: string;
+                    datedSaveAndPublishHint: string;
+                    period: string;
+                    correction: string;
+                    newWording: string;
+                    firstDay: string;
+                    lastDay: string;
+                    lastDayHelp: string;
+                    computed: string;
+                    computedHint: string;
+                    computedRow: string;
+                    noComputed: string;
+                    carryForward: string;
+                    carryForwardHint: string;
+                    wording: string;
+                    wordingUntil: string;
+                    carryYes: string;
+                    carryNo: string;
+                    unanswered: string;
+                    previewFailed: string;
+                    covers: string;
+                };
+                effective: {
+                    title: string;
+                    hint: string;
+                    label: string;
+                    help: string;
+                    required: string;
+                    submit: string;
+                };
+            };
+            blueprintSelect: {
+                archived: string;
+                unknown: string;
+                empty: string;
+                failed: string;
+                loading: string;
+                refused: string;
+                refusal: {
+                    unknown: string;
+                    archived: string;
+                    not_content: string;
+                };
             };
         };
     };
@@ -5983,6 +6533,12 @@ export declare class InvalidInputError extends Error {
     constructor(message: string);
 }
 
+/** A later wording a Direct Edit's change may carry into (#270). */
+export declare interface LaterWording {
+    releaseId: string;
+    validityPeriod?: ValidityPeriod;
+}
+
 /**
  * The port a host fills with mediahub (ADR 0020), in fieldkit's
  * media-adapter shape: a media field's picker browses and uploads through
@@ -6285,8 +6841,18 @@ export declare interface RequiredCheck {
 export declare interface RequiredCheckInput {
     name: string;
     scope: CheckScope;
-    /** Blueprint accessors; empty for every Blueprint. */
+    /**
+     * Blueprint accessors, empty exactly when `everyBlueprint` is set. Each
+     * one the write adds must name a content Blueprint of the workspace that
+     * is not archived (ADR 0023).
+     */
     blueprintAccessors: string[];
+    /**
+     * Applies the check to every Blueprint. A switch of its own: no accessors
+     * without it is refused, so clearing the last Blueprint never widens a
+     * check to every Publish.
+     */
+    everyBlueprint: boolean;
     independent: boolean;
 }