@knkcs/contenthub-ui 0.3.1 → 0.5.0

package/dist/index.d.ts

@@ -57,6 +57,19 @@ export declare interface BlockReasonsSettingsProps {
 /** The longest Blueprint accessor a check names (internal/workspaceconfig.MaxBlueprintAccessor). */
 export declare const BLUEPRINT_ACCESSOR_MAX = 200;
 
+/** One Blueprint's override of the workspace's editing settings. */
+export declare interface BlueprintEditingOverride {
+    blueprintAccessor: string;
+    /** null follows the workspace's. */
+    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. */
 export declare interface BlueprintInfo {
     id: string;
@@ -155,6 +168,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. */
@@ -202,6 +222,10 @@ export declare interface ChangeSet {
      * planned. Empty in a list.
      */
     plannedReleases: PlannedRelease[];
+    /** A Direct Edit, or one editors build; absent reads as "change_set". */
+    kind?: ChangeSetKind;
+    /** A Direct Edit's editor, an odon user id; absent or "" for any other kind. */
+    editorId?: string;
 }
 
 /** One Branch of a Chain, with the head a save on it names. */
@@ -243,6 +267,12 @@ export declare class ChangeSetClosedError extends Error {
     constructor(state: ChangeSetState);
 }
 
+/**
+ * What kind of Change Set one is (ADR 0022): a Direct Edit, opened from one
+ * Content for one editor, or one editors build Chain by Chain.
+ */
+export declare type ChangeSetKind = "change_set" | "direct_edit";
+
 /** One page of `listChangeSets`. */
 export declare interface ChangeSetList {
     changeSets: ChangeSet[];
@@ -281,6 +311,11 @@ export declare interface ChangeSetPageProps {
     onPublished?: (outcome: PublishOutcome) => void;
     /** Told after a Discard from the rail; the page stays, showing it discarded. */
     onDiscarded?: (changeSetId: string) => void;
+    /**
+     * mediahub, for a Direct Edit's media fields: a Direct Edit's page is its
+     * Content's fields (ADR 0022). Without it a media field offers nothing to pick.
+     */
+    mediaSource?: MediaSource_2;
 }
 
 /**
@@ -483,6 +518,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;
 }
 
 /**
@@ -567,6 +604,10 @@ export declare interface ContenthubClient {
         assigneeId?: string;
         /** Only those with a Chain on this Content. */
         contentId?: string;
+        /** Only those of this kind: the index asks for "change_set", hiding Direct Edits. */
+        kind?: ChangeSetKind;
+        /** Only the Direct Edits of this odon user. */
+        editorId?: string;
         /** At most 200; 50 when absent. */
         pageSize?: number;
         pageToken?: string;
@@ -649,6 +690,29 @@ export declare interface ContenthubClient {
         id: string;
         reviewedHeads: Record<string, string>;
     }): Promise<PublishOutcome>;
+    /**
+     * Change validity (ADR 0022): corrects only a published Release's
+     * Validity Period, in one request and without a Direct Edit. It opens a
+     * Change Set, plans the date-only Release re-pinning the Release's
+     * Revision and superseding it, and publishes it with the proposals for
+     * the neighbouring Releases; the outcome is that Publish's. Refused as a
+     * whole, it leaves no Change Set behind: rejects with
+     * `EditingModeRefusedError` where the Content's Blueprint is "Change Sets
+     * only", `CoversReleaseError` (`changeSetRequired`) when the period would
+     * cover another Release entirely, `PublishRefusedError` with every
+     * blocker (an outstanding Required Check among them),
+     * `AccessDeniedError` for a caller who may not publish,
+     * `ContentBlockedError` and `InvalidInputError` for what else the service
+     * refuses.
+     */
+    changeValidity(input: {
+        releaseId: string;
+        validityPeriod: ValidityPeriod;
+        /** The Change Set's name; the service names it after the Content when absent. */
+        changeSetName?: string;
+        /** Makes a retry safe (CONTEXT.md, Idempotency Key). */
+        idempotencyKey?: string;
+    }): Promise<PublishOutcome>;
     /**
      * Merges what Main (and each dependency) gained since into every Chain
      * of the Change Set. A Branch whose merge has Conflicts, or fails its
@@ -741,6 +805,41 @@ export declare interface ContenthubClient {
         requiredCheckId: string;
         recorder: RecorderGrant;
     }): Promise<void>;
+    /**
+     * How the workspace's Content may be changed (ADR 0022): its own Editing
+     * Mode and Editing Block, and every per-Blueprint override with the
+     * values it makes effective. A workspace that never set them reads as
+     * "Change Sets only" without an Editing Block.
+     */
+    getEditingSettings(): Promise<WorkspaceEditingSettings>;
+    /**
+     * The editing settings in effect for the Content of the Blueprint with
+     * `blueprintAccessor`: its override over the workspace's, field by
+     * field. A host's Blueprint page reads it.
+     */
+    getEffectiveEditingSettings(blueprintAccessor: string): Promise<EffectiveEditingSettings>;
+    /**
+     * Replaces the workspace's own editing settings; admin only. It takes
+     * effect at once. Rejects with `AccessDeniedError` for a non-admin and
+     * `InvalidInputError` for what the service refuses.
+     */
+    setEditingSettings(settings: EditingSettings): Promise<EditingSettings>;
+    /**
+     * 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.
+     */
+    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: {
+        blueprintAccessor: string;
+    }): Promise<void>;
     /** Every Collection of the workspace, by name, then id: a tree by `parentId`. */
     listCollections(): Promise<Collection[]>;
     /**
@@ -995,6 +1094,115 @@ export declare interface ContenthubClient {
      * `ChangeSetClosedError`, and `InvalidInputError` for anything else the
      * service refuses (a missing or needless effective date).
      */
+    /**
+     * Opens a Direct Edit of a published Content for the caller (ADR 0022),
+     * 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 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<{
+        changeSet: ChangeSet;
+        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, 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`
+     * for a Change Set that is not a Direct Edit.
+     */
+    discardDirectEdit(input: {
+        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;
@@ -1119,9 +1327,11 @@ export declare const contenthubKeys: {
     changeSetList: (filter: {
         state?: string;
         assigneeId?: string;
+        kind?: string;
     }) => readonly ["contenthub", "change-sets", "list", {
         state?: string;
         assigneeId?: string;
+        kind?: string;
     }];
     openChangeSets: () => readonly ["contenthub", "change-sets", "list", "open-picker"];
     changeSet: (id: string) => readonly ["contenthub", "change-sets", "detail", string];
@@ -1131,6 +1341,8 @@ export declare const contenthubKeys: {
     changeSetStatuses: () => readonly ["contenthub", "change-set-statuses"];
     requiredChecks: () => readonly ["contenthub", "required-checks"];
     requiredCheckRecorders: (id: string) => readonly ["contenthub", "required-checks", "recorders", string];
+    editingSettings: () => readonly ["contenthub", "editing-settings"];
+    effectiveEditingSettings: (blueprintAccessor: string) => readonly ["contenthub", "editing-settings", "effective", string];
     collections: () => readonly ["contenthub", "collections"];
     collectionGrants: (id: string) => readonly ["contenthub", "collections", "grants", string];
     contents: () => readonly ["contenthub", "contents"];
@@ -1188,11 +1400,12 @@ export declare interface ContenthubPathsProviderProps {
 
 /**
  * contenthub's workspace configuration in one settings page (spec #56, story
- * 107): Required Checks, Block Reasons and the Collection tree with its
- * restriction and grants, each a tab chosen by `?tab=` so a host links
+ * 107): Required Checks, Block Reasons, the editing settings (ADR 0022) and
+ * the Collection tree with its restriction and grants, each a tab chosen by `?tab=` so a host links
  * straight to one.
  *
- * Every tab is a flush DataTable whose rows are changed through Modals, so
+ * Every tab is a flush DataTable whose rows are changed through Modals (the
+ * editing tab heads its table with the workspace's own settings, padded), so
  * the body is unpadded (`bodyPadding="none"`, anker's rule for table tabs)
  * 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.
@@ -1214,7 +1427,7 @@ export declare interface ContenthubSettingsProps {
 }
 
 /** The settings page's tabs, as `?tab=` names them. */
-export declare type ContenthubSettingsTab = "required-checks" | "block-reasons" | "collections";
+export declare type ContenthubSettingsTab = "required-checks" | "block-reasons" | "editing" | "collections";
 
 /**
  * The package's translations as the one `{ namespace, resources }` export a
@@ -1235,6 +1448,7 @@ export declare const contenthubTranslations: {
                     tabs: {
                         requiredChecks: string;
                         blockReasons: string;
+                        editing: string;
                         collections: string;
                     };
                 };
@@ -1273,6 +1487,73 @@ export declare const contenthubTranslations: {
                         failed: string;
                     };
                 };
+                editing: {
+                    mode: {
+                        direct_edits: string;
+                        change_sets: string;
+                        both: string;
+                    };
+                    block: {
+                        on: string;
+                        off: string;
+                    };
+                    workspace: {
+                        title: string;
+                        description: string;
+                        edit: string;
+                    };
+                    columns: {
+                        blueprint: string;
+                        mode: string;
+                        block: string;
+                        actions: string;
+                        force: string;
+                    };
+                    fromWorkspace: string;
+                    createOverride: string;
+                    editOverride: string;
+                    removeOverride: string;
+                    count_one: string;
+                    count_other: string;
+                    empty: string;
+                    emptyHint: string;
+                    loadError: string;
+                    form: {
+                        workspaceTitle: string;
+                        createOverrideTitle: string;
+                        editOverrideTitle: string;
+                        accessor: string;
+                        accessorHelp: string;
+                        accessorRequired: string;
+                        accessorTooLong: string;
+                        accessorTaken: string;
+                        mode: string;
+                        modeHelp: string;
+                        modeRequired: string;
+                        block: string;
+                        blockHelp: string;
+                        follow: string;
+                        overridesNothing: string;
+                        save: string;
+                        denied: string;
+                        failed: string;
+                        force: string;
+                        forceHelp: string;
+                        forcePeople: string;
+                        forceNobody: string;
+                        forceOwn: string;
+                    };
+                    removeDialog: {
+                        title: string;
+                        message: string;
+                        confirm: string;
+                        failed: string;
+                    };
+                    force: {
+                        adminsOnly: string;
+                        adminsAnd: string;
+                    };
+                };
                 requiredChecks: {
                     create: string;
                     columns: {
@@ -1472,6 +1753,8 @@ export declare const contenthubTranslations: {
                         assignee: string;
                         anyone: string;
                         me: string;
+                        kind: string;
+                        anyKind: string;
                     };
                     count_one: string;
                     count_other: string;
@@ -1495,6 +1778,10 @@ export declare const contenthubTranslations: {
                         createSubmit: string;
                     };
                     more: string;
+                    kind: {
+                        change_set: string;
+                        direct_edit: string;
+                    };
                 };
                 branch: {
                     loading: string;
@@ -1992,6 +2279,7 @@ export declare const contenthubTranslations: {
                         unblock: string;
                         archive: string;
                         unarchive: string;
+                        edit: string;
                     };
                     data: {
                         readOnMain: string;
@@ -2012,6 +2300,7 @@ export declare const contenthubTranslations: {
                             inForce: string;
                             changeSet: string;
                             proposed: string;
+                            actions: string;
                         };
                         kind: {
                             revision: string;
@@ -2031,6 +2320,7 @@ export declare const contenthubTranslations: {
                         proposed: string;
                         planned: string;
                         loadError: string;
+                        changeValidity: string;
                     };
                     revisions: {
                         columns: {
@@ -2115,6 +2405,7 @@ export declare const contenthubTranslations: {
                         empty: string;
                         emptyHint: string;
                         loadError: string;
+                        directEditBy: string;
                     };
                     filing: {
                         title: string;
@@ -2183,6 +2474,120 @@ 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;
+                    };
+                    changeValidity: {
+                        title: string;
+                        hint: string;
+                        release: string;
+                        firstDay: string;
+                        firstDayHelp: string;
+                        firstDayRequired: string;
+                        lastDay: string;
+                        lastDayHelp: string;
+                        lastDayBefore: string;
+                        submit: string;
+                        done: string;
+                        published_one: string;
+                        published_other: string;
+                        editingMode: string;
+                        covers: string;
+                        publishRefused: string;
+                        denied: string;
+                    };
+                };
+                directEdit: {
+                    badge: string;
+                    loading: string;
+                    notFound: string;
+                    loadError: string;
+                    publish: string;
+                    discard: string;
+                    closed: {
+                        open: string;
+                        published: string;
+                        discarded: string;
+                    };
+                    discardConfirm: {
+                        title: string;
+                        message: string;
+                        failed: string;
+                    };
+                    refused_one: string;
+                    refused_other: string;
+                    refusedBecause: {
+                        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;
+                    };
                 };
             };
         };
@@ -2198,6 +2603,7 @@ export declare const contenthubTranslations: {
                     tabs: {
                         requiredChecks: string;
                         blockReasons: string;
+                        editing: string;
                         collections: string;
                     };
                 };
@@ -2236,6 +2642,73 @@ export declare const contenthubTranslations: {
                         failed: string;
                     };
                 };
+                editing: {
+                    mode: {
+                        direct_edits: string;
+                        change_sets: string;
+                        both: string;
+                    };
+                    block: {
+                        on: string;
+                        off: string;
+                    };
+                    workspace: {
+                        title: string;
+                        description: string;
+                        edit: string;
+                    };
+                    columns: {
+                        blueprint: string;
+                        mode: string;
+                        block: string;
+                        actions: string;
+                        force: string;
+                    };
+                    fromWorkspace: string;
+                    createOverride: string;
+                    editOverride: string;
+                    removeOverride: string;
+                    count_one: string;
+                    count_other: string;
+                    empty: string;
+                    emptyHint: string;
+                    loadError: string;
+                    form: {
+                        workspaceTitle: string;
+                        createOverrideTitle: string;
+                        editOverrideTitle: string;
+                        accessor: string;
+                        accessorHelp: string;
+                        accessorRequired: string;
+                        accessorTooLong: string;
+                        accessorTaken: string;
+                        mode: string;
+                        modeHelp: string;
+                        modeRequired: string;
+                        block: string;
+                        blockHelp: string;
+                        follow: string;
+                        overridesNothing: string;
+                        save: string;
+                        denied: string;
+                        failed: string;
+                        force: string;
+                        forceHelp: string;
+                        forcePeople: string;
+                        forceNobody: string;
+                        forceOwn: string;
+                    };
+                    removeDialog: {
+                        title: string;
+                        message: string;
+                        confirm: string;
+                        failed: string;
+                    };
+                    force: {
+                        adminsOnly: string;
+                        adminsAnd: string;
+                    };
+                };
                 requiredChecks: {
                     create: string;
                     columns: {
@@ -2435,6 +2908,8 @@ export declare const contenthubTranslations: {
                         assignee: string;
                         anyone: string;
                         me: string;
+                        kind: string;
+                        anyKind: string;
                     };
                     count_one: string;
                     count_other: string;
@@ -2458,6 +2933,10 @@ export declare const contenthubTranslations: {
                         createSubmit: string;
                     };
                     more: string;
+                    kind: {
+                        change_set: string;
+                        direct_edit: string;
+                    };
                 };
                 branch: {
                     loading: string;
@@ -2955,6 +3434,7 @@ export declare const contenthubTranslations: {
                         unblock: string;
                         archive: string;
                         unarchive: string;
+                        edit: string;
                     };
                     data: {
                         readOnMain: string;
@@ -2975,6 +3455,7 @@ export declare const contenthubTranslations: {
                             inForce: string;
                             changeSet: string;
                             proposed: string;
+                            actions: string;
                         };
                         kind: {
                             revision: string;
@@ -2994,6 +3475,7 @@ export declare const contenthubTranslations: {
                         proposed: string;
                         planned: string;
                         loadError: string;
+                        changeValidity: string;
                     };
                     revisions: {
                         columns: {
@@ -3078,6 +3560,7 @@ export declare const contenthubTranslations: {
                         empty: string;
                         emptyHint: string;
                         loadError: string;
+                        directEditBy: string;
                     };
                     filing: {
                         title: string;
@@ -3146,6 +3629,120 @@ 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;
+                    };
+                    changeValidity: {
+                        title: string;
+                        hint: string;
+                        release: string;
+                        firstDay: string;
+                        firstDayHelp: string;
+                        firstDayRequired: string;
+                        lastDay: string;
+                        lastDayHelp: string;
+                        lastDayBefore: string;
+                        submit: string;
+                        done: string;
+                        published_one: string;
+                        published_other: string;
+                        editingMode: string;
+                        covers: string;
+                        publishRefused: string;
+                        denied: string;
+                    };
+                };
+                directEdit: {
+                    badge: string;
+                    loading: string;
+                    notFound: string;
+                    loadError: string;
+                    publish: string;
+                    discard: string;
+                    closed: {
+                        open: string;
+                        published: string;
+                        discarded: string;
+                    };
+                    discardConfirm: {
+                        title: string;
+                        message: string;
+                        failed: string;
+                    };
+                    refused_one: string;
+                    refused_other: string;
+                    refusedBecause: {
+                        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;
+                    };
                 };
             };
         };
@@ -3228,7 +3825,11 @@ export declare interface ContentPageProps {
     onOpenBranch: (target: OpenBranchTarget) => void;
     /** Host navigation to another Content's page, from the References tab. */
     onOpenContent?: (target: OpenContentTarget) => void;
-    /** Host navigation to a Change Set's page, from the Change Sets tab. */
+    /**
+     * Host navigation to a Change Set's page, from the Change Sets tab, and
+     * to a Direct Edit's, which `ChangeSetPage` shows: Edit is offered only
+     * with it.
+     */
     onOpenChangeSet?: (changeSetId: string) => void;
 }
 
@@ -3276,11 +3877,14 @@ export declare type CopyFrom = {
 /**
  * A plan's Validity Period would cover these Releases of its Content
  * entirely: nothing was planned. Supersede them, or change the dates.
+ * `changeSetRequired` is set when the request could not Supersede them, as
+ * Change validity can't: that decision is made in a Change Set.
  */
 export declare class CoversReleaseError extends Error {
     readonly contentId: string;
     readonly coveredReleaseIds: string[];
-    constructor(contentId: string, coveredReleaseIds: string[]);
+    readonly changeSetRequired: boolean;
+    constructor(contentId: string, coveredReleaseIds: string[], changeSetRequired?: boolean);
 }
 
 /** The production `ContenthubClient`, over Connect. */
@@ -3299,6 +3903,79 @@ export declare interface CreateConnectContenthubClientOptions {
     transport?: Transport;
 }
 
+/**
+ * A Direct Edit's screen (ADR 0022, #264): the Content's fields, Save,
+ * Publish and Discard, and nothing of the Change Set it is: no Chain,
+ * Branch or Release tab, no rail. Saves go on its one Branch, as any save
+ * does; Publish cuts its one Release. `ChangeSetPage` shows it for a Change
+ * Set that is a Direct Edit, so a host needs no route of its own for it.
+ */
+export declare function DirectEditPage({ client, changeSetId, mediaSource, onPublished, onDiscarded, }: DirectEditPageProps): JSX.Element;
+
+export declare namespace DirectEditPage {
+    var displayName: string;
+}
+
+export declare interface DirectEditPageProps {
+    client: ContenthubClient;
+    /** The Direct Edit: a Change Set of kind "direct_edit". */
+    changeSetId: string;
+    /** mediahub, for media fields and images in rich text (ADR 0020). */
+    mediaSource?: MediaSource_2;
+    /** Told after Publish; the screen stays, showing it published. */
+    onPublished?: (outcome: PublishOutcome) => void;
+    /** Told after Discard; the screen stays, showing it discarded. */
+    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 = 
+/** A Direct Edit takes no second Chain, Branch, dependency or Source. */
+"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";
+
+/**
+ * A Direct Edit was refused, or a write a Direct Edit can't take. Read from
+ * the refusal's typed DirectEditRefused detail, not its text.
+ */
+export declare class DirectEditRefusedError extends Error {
+    readonly reason: DirectEditRefusal;
+    /** The Content it is about; "" where the refusal names none. */
+    readonly 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. */
 export declare interface Edge {
     sourceContentId: string;
@@ -3317,6 +3994,68 @@ 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
+ * both. Only "change_sets" is a rule: contenthub refuses a Direct Edit on
+ * such Content.
+ */
+export declare type EditingMode = "direct_edits" | "change_sets" | "both";
+
+/**
+ * The effective Editing Mode of the Content's Blueprint is "Change Sets
+ * only" (ADR 0022): the change is made in a Change Set. Nothing was written.
+ */
+export declare class EditingModeRefusedError extends Error {
+    readonly contentId: string;
+    readonly blueprintAccessor: string;
+    /** The effective Editing Mode that refused it. */
+    readonly editingMode: EditingMode;
+    constructor(contentId: string, blueprintAccessor: string, editingMode?: EditingMode);
+}
+
+/** The workspace's editing settings, or the ones in effect for a Blueprint. */
+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. */
+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. */
 export declare interface FieldChange {
     /** "/" and the field's accessor. */
@@ -3370,6 +4109,7 @@ export declare const i18nResources: {
                 tabs: {
                     requiredChecks: string;
                     blockReasons: string;
+                    editing: string;
                     collections: string;
                 };
             };
@@ -3408,6 +4148,73 @@ export declare const i18nResources: {
                     failed: string;
                 };
             };
+            editing: {
+                mode: {
+                    direct_edits: string;
+                    change_sets: string;
+                    both: string;
+                };
+                block: {
+                    on: string;
+                    off: string;
+                };
+                workspace: {
+                    title: string;
+                    description: string;
+                    edit: string;
+                };
+                columns: {
+                    blueprint: string;
+                    mode: string;
+                    block: string;
+                    actions: string;
+                    force: string;
+                };
+                fromWorkspace: string;
+                createOverride: string;
+                editOverride: string;
+                removeOverride: string;
+                count_one: string;
+                count_other: string;
+                empty: string;
+                emptyHint: string;
+                loadError: string;
+                form: {
+                    workspaceTitle: string;
+                    createOverrideTitle: string;
+                    editOverrideTitle: string;
+                    accessor: string;
+                    accessorHelp: string;
+                    accessorRequired: string;
+                    accessorTooLong: string;
+                    accessorTaken: string;
+                    mode: string;
+                    modeHelp: string;
+                    modeRequired: string;
+                    block: string;
+                    blockHelp: string;
+                    follow: string;
+                    overridesNothing: string;
+                    save: string;
+                    denied: string;
+                    failed: string;
+                    force: string;
+                    forceHelp: string;
+                    forcePeople: string;
+                    forceNobody: string;
+                    forceOwn: string;
+                };
+                removeDialog: {
+                    title: string;
+                    message: string;
+                    confirm: string;
+                    failed: string;
+                };
+                force: {
+                    adminsOnly: string;
+                    adminsAnd: string;
+                };
+            };
             requiredChecks: {
                 create: string;
                 columns: {
@@ -3607,6 +4414,8 @@ export declare const i18nResources: {
                     assignee: string;
                     anyone: string;
                     me: string;
+                    kind: string;
+                    anyKind: string;
                 };
                 count_one: string;
                 count_other: string;
@@ -3630,6 +4439,10 @@ export declare const i18nResources: {
                     createSubmit: string;
                 };
                 more: string;
+                kind: {
+                    change_set: string;
+                    direct_edit: string;
+                };
             };
             branch: {
                 loading: string;
@@ -4127,6 +4940,7 @@ export declare const i18nResources: {
                     unblock: string;
                     archive: string;
                     unarchive: string;
+                    edit: string;
                 };
                 data: {
                     readOnMain: string;
@@ -4147,6 +4961,7 @@ export declare const i18nResources: {
                         inForce: string;
                         changeSet: string;
                         proposed: string;
+                        actions: string;
                     };
                     kind: {
                         revision: string;
@@ -4166,6 +4981,7 @@ export declare const i18nResources: {
                     proposed: string;
                     planned: string;
                     loadError: string;
+                    changeValidity: string;
                 };
                 revisions: {
                     columns: {
@@ -4250,6 +5066,7 @@ export declare const i18nResources: {
                     empty: string;
                     emptyHint: string;
                     loadError: string;
+                    directEditBy: string;
                 };
                 filing: {
                     title: string;
@@ -4318,6 +5135,120 @@ 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;
+                };
+                changeValidity: {
+                    title: string;
+                    hint: string;
+                    release: string;
+                    firstDay: string;
+                    firstDayHelp: string;
+                    firstDayRequired: string;
+                    lastDay: string;
+                    lastDayHelp: string;
+                    lastDayBefore: string;
+                    submit: string;
+                    done: string;
+                    published_one: string;
+                    published_other: string;
+                    editingMode: string;
+                    covers: string;
+                    publishRefused: string;
+                    denied: string;
+                };
+            };
+            directEdit: {
+                badge: string;
+                loading: string;
+                notFound: string;
+                loadError: string;
+                publish: string;
+                discard: string;
+                closed: {
+                    open: string;
+                    published: string;
+                    discarded: string;
+                };
+                discardConfirm: {
+                    title: string;
+                    message: string;
+                    failed: string;
+                };
+                refused_one: string;
+                refused_other: string;
+                refusedBecause: {
+                    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;
+                };
             };
         };
     };
@@ -4333,6 +5264,7 @@ export declare const i18nResources: {
                 tabs: {
                     requiredChecks: string;
                     blockReasons: string;
+                    editing: string;
                     collections: string;
                 };
             };
@@ -4371,6 +5303,73 @@ export declare const i18nResources: {
                     failed: string;
                 };
             };
+            editing: {
+                mode: {
+                    direct_edits: string;
+                    change_sets: string;
+                    both: string;
+                };
+                block: {
+                    on: string;
+                    off: string;
+                };
+                workspace: {
+                    title: string;
+                    description: string;
+                    edit: string;
+                };
+                columns: {
+                    blueprint: string;
+                    mode: string;
+                    block: string;
+                    actions: string;
+                    force: string;
+                };
+                fromWorkspace: string;
+                createOverride: string;
+                editOverride: string;
+                removeOverride: string;
+                count_one: string;
+                count_other: string;
+                empty: string;
+                emptyHint: string;
+                loadError: string;
+                form: {
+                    workspaceTitle: string;
+                    createOverrideTitle: string;
+                    editOverrideTitle: string;
+                    accessor: string;
+                    accessorHelp: string;
+                    accessorRequired: string;
+                    accessorTooLong: string;
+                    accessorTaken: string;
+                    mode: string;
+                    modeHelp: string;
+                    modeRequired: string;
+                    block: string;
+                    blockHelp: string;
+                    follow: string;
+                    overridesNothing: string;
+                    save: string;
+                    denied: string;
+                    failed: string;
+                    force: string;
+                    forceHelp: string;
+                    forcePeople: string;
+                    forceNobody: string;
+                    forceOwn: string;
+                };
+                removeDialog: {
+                    title: string;
+                    message: string;
+                    confirm: string;
+                    failed: string;
+                };
+                force: {
+                    adminsOnly: string;
+                    adminsAnd: string;
+                };
+            };
             requiredChecks: {
                 create: string;
                 columns: {
@@ -4570,6 +5569,8 @@ export declare const i18nResources: {
                     assignee: string;
                     anyone: string;
                     me: string;
+                    kind: string;
+                    anyKind: string;
                 };
                 count_one: string;
                 count_other: string;
@@ -4593,6 +5594,10 @@ export declare const i18nResources: {
                     createSubmit: string;
                 };
                 more: string;
+                kind: {
+                    change_set: string;
+                    direct_edit: string;
+                };
             };
             branch: {
                 loading: string;
@@ -5090,6 +6095,7 @@ export declare const i18nResources: {
                     unblock: string;
                     archive: string;
                     unarchive: string;
+                    edit: string;
                 };
                 data: {
                     readOnMain: string;
@@ -5110,6 +6116,7 @@ export declare const i18nResources: {
                         inForce: string;
                         changeSet: string;
                         proposed: string;
+                        actions: string;
                     };
                     kind: {
                         revision: string;
@@ -5129,6 +6136,7 @@ export declare const i18nResources: {
                     proposed: string;
                     planned: string;
                     loadError: string;
+                    changeValidity: string;
                 };
                 revisions: {
                     columns: {
@@ -5213,6 +6221,7 @@ export declare const i18nResources: {
                     empty: string;
                     emptyHint: string;
                     loadError: string;
+                    directEditBy: string;
                 };
                 filing: {
                     title: string;
@@ -5281,6 +6290,120 @@ 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;
+                };
+                changeValidity: {
+                    title: string;
+                    hint: string;
+                    release: string;
+                    firstDay: string;
+                    firstDayHelp: string;
+                    firstDayRequired: string;
+                    lastDay: string;
+                    lastDayHelp: string;
+                    lastDayBefore: string;
+                    submit: string;
+                    done: string;
+                    published_one: string;
+                    published_other: string;
+                    editingMode: string;
+                    covers: string;
+                    publishRefused: string;
+                    denied: string;
+                };
+            };
+            directEdit: {
+                badge: string;
+                loading: string;
+                notFound: string;
+                loadError: string;
+                publish: string;
+                discard: string;
+                closed: {
+                    open: string;
+                    published: string;
+                    discarded: string;
+                };
+                discardConfirm: {
+                    title: string;
+                    message: string;
+                    failed: string;
+                };
+                refused_one: string;
+                refused_other: string;
+                refusedBecause: {
+                    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;
+                };
             };
         };
     };
@@ -5291,6 +6414,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
@@ -5617,6 +6746,11 @@ export declare interface RequiredCheckRecorders {
 export declare interface ResolvedBlueprintRelease {
     /** The Blueprint's name, as the released Revision holds it; "" if it holds none. */
     displayName: string;
+    /**
+     * The Blueprint's accessor, which its editing settings are keyed by;
+     * "" or absent when the Resolved Release names none.
+     */
+    accessor?: string;
     /** Whether its Content is Dated: its Releases carry a Validity Period. */
     dated: boolean;
     /** fieldkit's Resolved Spec fields, in Blueprint order. */
@@ -5803,4 +6937,10 @@ export declare class WithheldWorkError extends Error {
     constructor(message: string);
 }
 
+/** The workspace's editing settings and every per-Blueprint override, by accessor. */
+export declare interface WorkspaceEditingSettings {
+    workspace: EditingSettings;
+    overrides: BlueprintEditingOverride[];
+}
+
 export { }