@fusebase/fusebase-gate-sdk 2.5.1-sdk.1 → 2.5.1-sdk.2

package/dist/types/portals/portals.d.ts

@@ -180,6 +180,67 @@ export interface AddPortalBlankNoteBlockResponseContract {
      */
     staged: boolean;
 }
+export interface AddPortalKanbanBlockRequestContract {
+    /**
+     * Title of the block, its note and its board (defaults to "Kanban").
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /**
+     * Column titles of the new board, in order. 1..10 non-empty titles, each at
+     * most 100 characters. Defaults to "To do", "In progress", "Done".
+     */
+    columns?: string[];
+}
+export interface AddPortalKanbanBlockResponseContract {
+    /** Global id of the newly created Fusebase note holding the board. */
+    noteId: string;
+    /** Global id of the created Kanban board. */
+    boardId: string;
+    /** Id of the created note block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the block is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
+export interface AddPortalTaskListBlockRequestContract {
+    /**
+     * Title of the block and of its task list (defaults to "Task list"). The
+     * backing note keeps the customizer's own "New page" title.
+     * @maxLength 100
+     */
+    title?: string;
+    /** Grid placement. Default: width 6 columns and automatic height. */
+    layout?: PortalTaskListBlockLayoutContract;
+}
+export interface AddPortalTaskListBlockResponseContract {
+    /** Global id of the newly created Fusebase note holding the task list. */
+    noteId: string;
+    /** Global id of the created task list. */
+    taskListId: string;
+    /** Id of the created note block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the block is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
 export interface AddPortalNoteBlockResponseContract {
     /** Id of the created note content block. */
     blockId: string;
@@ -278,6 +339,13 @@ export type PortalDatabaseBlockAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/** Customizer Layout section of the Task list block. */
+export interface PortalTaskListBlockLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 3 | 4 | 5 | 6;
+    /** Customizer Height: null = Auto; a manual value is at least 50px. Default: null. */
+    height?: number | null;
+}
 /** Customizer Layout section. */
 export interface PortalDatabaseBlockLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -403,7 +471,867 @@ export interface AddPortalImageBlockRequestContract {
     /** Default: width 6 columns and automatic height. */
     layout?: PortalTextAndMediaLayoutContract;
 }
-export interface PortalTextAndMediaBlockResponseContract {
+export interface PortalTextAndMediaBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer background picker. Colours are palette tokens; an image is one of
+ * the five built-in presets.
+ */
+export type PortalCardBackgroundContract = {
+    type: "color";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color: PortalColorToken;
+} | {
+    type: "gradient";
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    from: PortalColorToken;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    to: PortalColorToken;
+    /** Default: `to-t`. */
+    direction?: "to-t" | "to-r" | "to-b" | "to-l";
+} | {
+    type: "image";
+    preset: PortalBackgroundImagePreset;
+    /** Default: false. */
+    blur?: boolean;
+};
+/** The four Card Types of the Customizer's Card tile. `compact` is legacy and rejected. */
+export type PortalCardViewContract = "top-image" | "left-image" | "right-image" | "fill-image";
+/**
+ * Customizer Appearance section of a Card. Omitting `appearance` keeps the
+ * Card's canonical `bare` wrapper, which is not a selectable backdrop.
+ */
+export type PortalCardAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: false. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Card. */
+export interface PortalCardLayoutContract {
+    /** Customizer Width. Default: 3. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/**
+ * A hidden Card item carries ONLY `visible: false`: sending text or styles next
+ * to it would silently drop settings the caller believes they applied.
+ */
+export type PortalCardHeadingContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+};
+export type PortalCardDescriptionContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     * @maxLength 2000
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+};
+export type PortalCardButtonContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text; the Button label supports no dynamic variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+};
+/** The Card always uses the template image: no source field is accepted. */
+export interface PortalCardImageContract {
+    /** Default: true. */
+    visible?: boolean;
+}
+/** Semantic Destination of the whole Card (and of its Button). */
+export type PortalCardDestinationContract = {
+    type: "portalPage";
+    /** Exact id of an existing page in the SAME portal. */
+    pageId: string;
+} | {
+    type: "external";
+    /**
+     * Absolute https:// URL. `javascript:`, `data:`, a protocol-relative URL
+     * and embedded credentials are rejected.
+     * @maxLength 2048
+     */
+    url: string;
+} | {
+    type: "email";
+    /**
+     * Address only; portal-service adds the `mailto:` scheme.
+     * @maxLength 254
+     */
+    email: string;
+};
+/** Customizer Content section of a Card. */
+export interface PortalCardContentContract {
+    image?: PortalCardImageContract;
+    /** Default: "Helpful Resources", bold. */
+    heading?: PortalCardHeadingContract;
+    /** Default: the Customizer's Card copy. */
+    description?: PortalCardDescriptionContract;
+    /** Default: "Explore". */
+    button?: PortalCardButtonContract;
+    /**
+     * Omitted keeps the Customizer default link; `null` leaves the Card without
+     * any destination.
+     */
+    destination?: PortalCardDestinationContract | null;
+}
+export interface AddPortalCardBlockRequestContract {
+    /** Card Type. Default: `top-image`. */
+    view?: PortalCardViewContract;
+    content?: PortalCardContentContract;
+    /** Omitted keeps the Card's canonical bare wrapper. */
+    appearance?: PortalCardAppearanceContract;
+    /** Default: width 3 columns and automatic height. */
+    layout?: PortalCardLayoutContract;
+}
+export interface AddPortalCardBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/** Customizer Layout section of a Carousel. */
+export interface PortalCarouselLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/**
+ * One Carousel slide. The image is always a built-in one, and the index comes
+ * from the array order: neither is accepted from the caller.
+ */
+export interface PortalCarouselItemContract {
+    /**
+     * Plain text; the caption supports no dynamic variables.
+     * @minLength 1
+     */
+    caption?: string;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     */
+    description?: string;
+    /** `null` or omitted leaves the slide without a Button. */
+    button?: {
+        /**
+         * Plain label; the Button supports no dynamic variables.
+         * @minLength 1
+         */
+        text: string;
+    } | null;
+    /**
+     * Destination of both the slide surface and its Button. `null` or omitted
+     * leaves the slide without a link.
+     */
+    destination?: PortalCardDestinationContract | null;
+}
+/** Customizer Content section of a Carousel. */
+export interface PortalCarouselContentContract {
+    /**
+     * The full desired slide list in visual order, not a patch. Omitting it keeps
+     * the three factory slides (Deliberation, Elaboration, Presentation).
+     * Server-side limits: 1 to 6 slides.
+     */
+    items?: PortalCarouselItemContract[];
+}
+export interface AddPortalCarouselBlockRequestContract {
+    content?: PortalCarouselContentContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalCarouselLayoutContract;
+}
+export interface AddPortalCarouselBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer Appearance section of a Countdown. Omitting `appearance` keeps the
+ * Countdown's canonical `blank` backdrop with the block title shown.
+ */
+export type PortalCountdownAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Countdown. */
+export interface PortalCountdownLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+/** Customizer Content section of a Countdown. */
+export interface PortalCountdownContentContract {
+    /**
+     * The moment the countdown ends, as an absolute RFC 3339 date-time carrying
+     * `Z` or an explicit UTC offset, for example `2026-08-15T09:00:00+07:00`.
+     * Never epoch seconds/milliseconds and never a timezone-less local date.
+     * Default: 30 days after creation. Server-side limits: not in the past and at
+     * most 99 days after creation.
+     * @format date-time
+     */
+    targetAt?: string;
+}
+export interface AddPortalCountdownBlockRequestContract {
+    /**
+     * Block title shown above the countdown. Plain text; only `{{ClientName}}`
+     * and `{{ClientLastName}}` are variables. Default: `Countdown`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalCountdownContentContract;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalCountdownAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalCountdownLayoutContract;
+}
+export interface AddPortalCountdownBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/** One block a Linked block may point at. */
+export interface PortalLinkableBlockContract {
+    /** Exact id to send as `source.blockId`. Never invent one. */
+    blockId: string;
+    /** Canonical portal block type, e.g. `flexible`. */
+    type: string;
+    /** Flexible template behind the block (e.g. `info-card`); null for other types. */
+    templateType: string | null;
+    /** Block title as shown in the customizer. */
+    title: string;
+    /**
+     * The block exists only in this portal's customizer draft. Such a block can
+     * be linked only from a page in the SAME portal.
+     */
+    draftOnly: boolean;
+}
+export interface ListPortalLinkableBlocksResponseContract {
+    /** Blocks of the page in display order; Linked blocks are excluded. */
+    blocks: PortalLinkableBlockContract[];
+}
+/** Exact identity of the block the Linked block mirrors. */
+export interface PortalLinkedBlockSourceContract {
+    /** Portal holding the source block. Must be in the same organization. */
+    portalId: string;
+    /** Page holding the source block, from listPortalContent. */
+    pageId: string;
+    /** Exact block id from listPortalLinkableBlocks. Never invent one. */
+    blockId: string;
+}
+export interface AddPortalLinkedBlockRequestContract {
+    source: PortalLinkedBlockSourceContract;
+}
+export interface AddPortalLinkedBlockResponseContract {
+    /** Id of the created Linked block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer Appearance section of a Form. Omitting `appearance` keeps the
+ * Form's canonical `blank` backdrop with the block title shown.
+ */
+export type PortalFormAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Form. */
+export interface PortalFormLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export type PortalFormDescriptionContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * @minLength 1
+     * @maxLength 2000
+     */
+    text?: string;
+    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
+    color?: PortalColorToken;
+    /** Default: `m`. */
+    size?: PortalTextSize;
+    /** Set semantics: a duplicate value is rejected with 400. */
+    styles?: PortalTextStyle[];
+    align?: PortalTextAlign;
+};
+/** The nine field types the Customizer's "Add field" menu offers. */
+export type PortalFormFieldTypeContract = "text" | "textarea" | "number" | "phone" | "email" | "checkbox" | "select" | "file" | "date";
+/** Customizer Field width. The persisted column count is internal. */
+export type PortalFormFieldWidthContract = "half" | "full";
+/** One Form field. Its id, index and persisted column count are server-owned. */
+export interface PortalFormFieldContract {
+    type: PortalFormFieldTypeContract;
+    /**
+     * Customizer "Field name". Plain text, no dynamic variables. Default: the
+     * field type's own label, e.g. `Email Address` for `email`.
+     * @minLength 1
+     * @maxLength 200
+     */
+    label?: string;
+    /**
+     * Available only for `text`, `textarea`, `number`, `phone`, `email` and
+     * `select` — the Customizer shows no placeholder control for the other three.
+     * Plain text, no dynamic variables. Empty clears the Customizer's input.
+     * @maxLength 500
+     */
+    placeholder?: string;
+    /** Customizer "Required field". Default: false. */
+    required?: boolean;
+    /** Default: the field type's own width, e.g. `half` for `select` and `date`. */
+    width?: PortalFormFieldWidthContract;
+    /**
+     * `select` only, one entry per option. Never the persisted newline-separated
+     * string. Default: `["Option 1", "Option 2", "Option 3"]`.
+     */
+    options?: string[];
+}
+export type PortalFormSubmitContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * Customizer "Button text". Plain text, no dynamic variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+};
+export type PortalFormContentBrickContract = {
+    visible: false;
+} | {
+    /** Default: true. */
+    visible?: true;
+    /**
+     * The complete visual-order list. Omitted keeps the five default fields;
+     * `[]` creates a Form without fields.
+     */
+    fields?: PortalFormFieldContract[];
+    submit?: PortalFormSubmitContract;
+    /**
+     * Customizer "Reusable form": true lets the same portal user submit again,
+     * false leaves the form disabled after its first response. Default: true.
+     */
+    reusable?: boolean;
+};
+/** Customizer Content section of a Form. */
+export interface PortalFormBlockContentContract {
+    /** Default: the Customizer's Form copy. */
+    description?: PortalFormDescriptionContract;
+    form?: PortalFormContentBrickContract;
+}
+export interface AddPortalFormBlockRequestContract {
+    /**
+     * Block title shown above the form. Plain text; only `{{ClientName}}` and
+     * `{{ClientLastName}}` are variables. Default: `Form`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalFormBlockContentContract;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalFormAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalFormLayoutContract;
+}
+export interface AddPortalFormBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/** The four built-in tile images of the Customizer's Card group. */
+export type PortalCardGroupImageContract = "calendar" | "book" | "pen" | "briefcase";
+/** One card of a Card group. */
+export interface PortalCardGroupItemContract {
+    /**
+     * Caption under the image. Plain text; dynamic variables are not supported.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title: string;
+    /** Default: the template image of this position. */
+    image?: PortalCardGroupImageContract;
+    /**
+     * Omitted keeps the template link of this position; `null` leaves the card
+     * without any link.
+     */
+    destination?: PortalCardDestinationContract | null;
+}
+/** Customizer Content section of a Card group. */
+export interface PortalCardGroupContentContract {
+    /** Default: the Customizer's Card group copy. */
+    description?: PortalCardDescriptionContract;
+    /**
+     * The cards: between 1 and 6, the same range the Customizer allows. The count
+     * is enforced by portal-service — the schema generator drops `@minItems` /
+     * `@maxItems`, so declaring them here would read as shipped and be inert.
+     */
+    items?: PortalCardGroupItemContract[];
+}
+/**
+ * Customizer Appearance section of a Card group. Omitting `appearance` keeps the
+ * Card group's canonical `blank` wrapper, with the title shown. Separate from the
+ * Card's contract: a `$ref` would publish the Card's opposite defaults.
+ */
+export type PortalCardGroupAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+export interface AddPortalCardGroupBlockRequestContract {
+    /**
+     * Wrapper title, shown above the cards. Default: "Card group".
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalCardGroupContentContract;
+    appearance?: PortalCardGroupAppearanceContract;
+    /** Default: width 4 columns and automatic height. */
+    layout?: PortalCardGroupLayoutContract;
+}
+/** Customizer Layout section of a Card group. */
+export interface PortalCardGroupLayoutContract {
+    /** Customizer Width: the control offers 2 to 6 columns. Default: 4. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalCardGroupBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * One entry of the Info block icon catalog. `id` is the only value
+ * addPortalInfoBlock accepts; the renderer's internal IconKey is never exposed.
+ */
+export interface PortalInfoIconContract {
+    id: string;
+    /** Human-readable name, for showing the choices to the user. */
+    label: string;
+}
+export interface SearchPortalInfoBlockIconsResponseContract {
+    items: PortalInfoIconContract[];
+    /**
+     * Total number of matching icons across all pages.
+     * @TJS-type integer
+     */
+    total: number;
+    /** Opaque cursor for the next page; absent when there are no more results. */
+    nextCursor?: string;
+}
+/**
+ * The image of an Info block, as one semantic variant. The persisted
+ * `emoji#...`/`icon#...`/`url#...` form is built by portal-service and is never
+ * accepted here.
+ */
+export type PortalInfoImageContract = {
+    type: "emoji";
+    /** Exactly one visible Unicode emoji, e.g. "🥳". Text and several emoji are rejected. */
+    emoji: string;
+} | {
+    type: "icon";
+    /** Exact `items[].id` from searchPortalInfoBlockIcons. */
+    iconId: string;
+} | {
+    type: "custom";
+    /**
+     * Absolute https:// URL of an image the user already has. This operation
+     * uploads nothing; credentials and a `#` fragment are rejected, and so is
+     * a loopback or private host.
+     * @maxLength 2048
+     */
+    url: string;
+};
+/** Semantic Destination the whole Info block links to. */
+export type PortalInfoDestinationContract = {
+    type: "portalPage";
+    /** Exact id of an existing page in the SAME portal. */
+    pageId: string;
+} | {
+    type: "external";
+    /**
+     * Absolute https:// URL. `javascript:`, `data:`, a protocol-relative URL
+     * and embedded credentials are rejected.
+     * @maxLength 2048
+     */
+    url: string;
+};
+/** Customizer Layout section of an Info block. */
+export interface PortalInfoLayoutContract {
+    /** Customizer Width. Default: 1. */
+    colspan?: 1 | 2 | 3;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalInfoBlockRequestContract {
+    /**
+     * Text shown inside the tile.
+     * @minLength 1
+     * @maxLength 255
+     */
+    title: string;
+    image: PortalInfoImageContract;
+    destination: PortalInfoDestinationContract;
+    /** Whether the destination opens in a new tab. Default: true. */
+    openInNewTab?: boolean;
+    /** Default: width 1 column, one row and automatic height. */
+    layout?: PortalInfoLayoutContract;
+}
+export interface AddPortalInfoBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/** Semantic Destination of one Custom widget Link or Button brick. */
+export type PortalCustomWidgetDestinationContract = {
+    type: "portalPage";
+    /** Exact id of an existing page in the SAME portal. */
+    pageId: string;
+} | {
+    type: "external";
+    /**
+     * Absolute https:// URL. `javascript:`, `data:`, a protocol-relative URL
+     * and embedded credentials are rejected.
+     * @maxLength 2048
+     */
+    url: string;
+} | {
+    type: "email";
+    /**
+     * Address only; portal-service adds the `mailto:` scheme.
+     * @maxLength 254
+     */
+    email: string;
+};
+/**
+ * One brick of a Custom widget, in the shape the Customizer's "Add block"
+ * palette inserts. The brick image, index and CSS classes are canonical and are
+ * not accepted from the caller.
+ */
+export type PortalCustomWidgetBrickContract = {
+    type: "heading";
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * Default: "Heading".
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+} | {
+    type: "text";
+    /**
+     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * Default: the Customizer's lorem ipsum paragraph.
+     * @minLength 1
+     * @maxLength 2000
+     */
+    text?: string;
+} | {
+    /** Always the built-in widget image; no source field is accepted. */
+    type: "image";
+} | {
+    type: "avatar";
+    /**
+     * Default: "Amelia Wells". The avatar picture is always the built-in one.
+     * No dynamic variables — the avatar is never substituted, so a variable
+     * would be shown to the portal visitor verbatim.
+     * @minLength 1
+     * @maxLength 100
+     */
+    name?: string;
+    /**
+     * Default: "Your Personal Assistant". No dynamic variables.
+     * @minLength 1
+     * @maxLength 200
+     */
+    description?: string;
+    /** Default: `ring`. */
+    style?: "ring" | "square";
+} | {
+    type: "rating";
+    /**
+     * Filled marks, a whole number 1 to 5. Default: 5. The Customizer's own
+     * control clamps to this range, so 0 is not a reachable state.
+     * @minimum 1
+     * @maximum 5
+     */
+    value?: number;
+    /** Default: `star`. */
+    style?: "star" | "heart";
+    /** Default: true. */
+    colored?: boolean;
+} | {
+    type: "link";
+    /**
+     * Visible label. An internal page contributes its own title; anything else
+     * defaults to "Custom link". No dynamic variables.
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+    destination: PortalCustomWidgetDestinationContract;
+} | {
+    type: "button";
+    /**
+     * Plain label; the Button supports no dynamic variables. Default: "Explore".
+     * @minLength 1
+     * @maxLength 100
+     */
+    text?: string;
+    /**
+     * Omitted creates the Button unlinked; the user can still add the link in
+     * the Customizer afterwards.
+     */
+    destination?: PortalCustomWidgetDestinationContract;
+};
+/** Customizer Content section of a Custom widget. */
+export interface PortalCustomWidgetContentContract {
+    /**
+     * The full desired brick list in visual order, not a patch. Omitting it keeps
+     * the nine factory bricks of the "Your Consultant" widget. Server-side limit:
+     * at least 1 brick.
+     */
+    bricks?: PortalCustomWidgetBrickContract[];
+}
+/**
+ * Customizer Appearance section of a Custom widget. Omitting `appearance` keeps
+ * the widget's canonical `blank` wrapper with the block title shown.
+ */
+export type PortalCustomWidgetAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Custom widget. */
+export interface PortalCustomWidgetLayoutContract {
+    /** Customizer Width. Default: 2. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalCustomWidgetBlockRequestContract {
+    /**
+     * Block title, shown by the `blank` and `custom` backdrops.
+     * Default: "Your Consultant".
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalCustomWidgetContentContract;
+    appearance?: PortalCustomWidgetAppearanceContract;
+    /** Default: width 2 columns and automatic height. */
+    layout?: PortalCustomWidgetLayoutContract;
+}
+export interface AddPortalCustomWidgetBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer Content section of an HTML/CSS block. Omitting it on the request
+ * creates the Customizer's demo "Sales Distribution" pie chart; sending it
+ * replaces that demo entirely, so an omitted field below is empty rather than
+ * the demo value.
+ */
+export interface PortalHtmlCssContentContract {
+    /**
+     * Customizer "Edit HTML". Markup only — it is inserted into the block as-is.
+     * Omitted or empty means no markup.
+     * @maxLength 50000
+     */
+    html?: string;
+    /**
+     * Customizer "Edit Style". Raw CSS WITHOUT a `<style>` tag; the portal injects
+     * it globally, so scope the rules with your own class names.
+     * @maxLength 50000
+     */
+    style?: string;
+    /**
+     * Customizer "Edit Script". Raw JavaScript WITHOUT a `<script>` tag, run on
+     * every visit of the published page. Omitted or empty means no script.
+     * @maxLength 50000
+     */
+    script?: string;
+}
+/** Customizer Layout section of an HTML/CSS block. Default: width 3, Auto height. */
+export interface PortalHtmlCssLayoutContract {
+    /** Customizer Width. Default: 3. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalHtmlCssBlockRequestContract {
+    /**
+     * Block title. The block's wrapper hides it BY DEFAULT, so it normally only
+     * labels the block in the Customizer — but the owner can turn on Appearance
+     * "Show title", and then it is visitor-facing. May contain the dynamic
+     * variables {{ClientName}} and {{ClientLastName}} and no others.
+     * Default: "HTML/CSS Block".
+     * @minLength 1
+     * @maxLength 200
+     */
+    title?: string;
+    content?: PortalHtmlCssContentContract;
+    layout?: PortalHtmlCssLayoutContract;
+}
+export interface AddPortalHtmlCssBlockResponseContract {
     /** Id of the created block. */
     blockId: string;
     /** Id of the page the block was added to. */
@@ -415,77 +1343,29 @@ export interface PortalTextAndMediaBlockResponseContract {
     /** Always true: the block is staged in the customizer draft, not yet live. */
     staged: boolean;
 }
+/** The two Timeline views of the Customizer's Timeline tile. */
+export type PortalTimelineViewContract = "horizontal" | "vertical";
 /**
- * Customizer background picker. Colours are palette tokens; an image is one of
- * the five built-in presets.
- */
-export type PortalCardBackgroundContract = {
-    type: "color";
-    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
-    color: PortalColorToken;
-} | {
-    type: "gradient";
-    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
-    from: PortalColorToken;
-    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
-    to: PortalColorToken;
-    /** Default: `to-t`. */
-    direction?: "to-t" | "to-r" | "to-b" | "to-l";
-} | {
-    type: "image";
-    preset: PortalBackgroundImagePreset;
-    /** Default: false. */
-    blur?: boolean;
-};
-/** The four Card Types of the Customizer's Card tile. `compact` is legacy and rejected. */
-export type PortalCardViewContract = "top-image" | "left-image" | "right-image" | "fill-image";
-/**
- * Customizer Appearance section of a Card. Omitting `appearance` keeps the
- * Card's canonical `bare` wrapper, which is not a selectable backdrop.
+ * One step of the Step group. The Customizer keeps completion sequential, so
+ * `completed` steps must form a prefix of the list.
  */
-export type PortalCardAppearanceContract = {
-    backdrop: "none" | "blank";
-} | {
-    backdrop: "custom";
-    background: PortalCardBackgroundContract;
-    /** Default: `s`. */
-    padding?: "none" | "s" | "m" | "l";
-    /** Default: false. */
-    showTitle?: boolean;
-};
-/** Customizer Layout section of a Card. */
-export interface PortalCardLayoutContract {
-    /** Customizer Width. Default: 3. */
-    colspan?: 2 | 3 | 4 | 5 | 6;
+export interface PortalTimelineStepContract {
     /**
-     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
-     * @minimum 50
+     * Plain text; the step caption supports no dynamic variables. The Customizer
+     * allows an empty caption.
+     * @maxLength 25
      */
-    height?: number | null;
+    title: string;
+    /** Default: false. */
+    completed?: boolean;
+    /** Omitted or `null` both leave the step without a link. */
+    destination?: PortalCardDestinationContract | null;
 }
 /**
- * A hidden Card item carries ONLY `visible: false`: sending text or styles next
- * to it would silently drop settings the caller believes they applied.
+ * A hidden Timeline item carries ONLY `visible: false`: sending text or styles
+ * next to it would silently drop settings the caller believes they applied.
  */
-export type PortalCardHeadingContract = {
-    visible: false;
-} | {
-    /** Default: true. */
-    visible?: true;
-    /**
-     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
-     * @minLength 1
-     * @maxLength 100
-     */
-    text?: string;
-    /** @pattern ^(transparent|white|black|(slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-(50|100|200|300|400|500|600|700|800|900|950))$ */
-    color?: PortalColorToken;
-    size?: PortalTextSize;
-    /** Set semantics: a duplicate value is rejected with 400. */
-    styles?: PortalTextStyle[];
-    align?: PortalTextAlign;
-};
-export type PortalCardDescriptionContract = {
+export type PortalTimelineDescriptionContract = {
     visible: false;
 } | {
     /** Default: true. */
@@ -503,7 +1383,7 @@ export type PortalCardDescriptionContract = {
     styles?: PortalTextStyle[];
     align?: PortalTextAlign;
 };
-export type PortalCardButtonContract = {
+export type PortalTimelineButtonContract = {
     visible: false;
 } | {
     /** Default: true. */
@@ -514,71 +1394,52 @@ export type PortalCardButtonContract = {
      * @maxLength 100
      */
     text?: string;
+    /**
+     * Omitted keeps the Customizer's own Project link; `null` leaves the
+     * Button without any destination.
+     */
+    destination?: PortalCardDestinationContract | null;
 };
-/** The Card always uses the template image: no source field is accepted. */
-export interface PortalCardImageContract {
+/** The Timeline always uses the built-in image: no source field is accepted. */
+export interface PortalTimelineImageContract {
     /** Default: true. */
     visible?: boolean;
 }
-/** Semantic Destination of the whole Card (and of its Button). */
-export type PortalCardDestinationContract = {
-    type: "portalPage";
-    /** Exact id of an existing page in the SAME portal. */
-    pageId: string;
-} | {
-    type: "external";
+/** Customizer Content section of a Timeline. */
+export interface PortalTimelineContentContract {
+    image?: PortalTimelineImageContract;
+    /** Default: the Customizer's Timeline copy. */
+    description?: PortalTimelineDescriptionContract;
     /**
-     * Absolute https:// URL. `javascript:`, `data:`, a protocol-relative URL
-     * and embedded credentials are rejected.
-     * @maxLength 2048
+     * The FULL desired step list in visual order, not a patch. Omitted keeps the
+     * three factory steps (Vision and Arrangements completed, Launch not).
+     *
+     * The generator drops both tags today (NIM-42761 tracks the same gap for
+     * `@uniqueItems`), so the 1..6 bound is ENFORCED by portal-service and stated
+     * in this op's description and MCP prompt.
+     * @minItems 1
+     * @maxItems 6
      */
-    url: string;
+    steps?: PortalTimelineStepContract[];
+    /** Default: "View project" linking to the Customizer's Project page. */
+    button?: PortalTimelineButtonContract;
+}
+/**
+ * Customizer Appearance section of a Timeline. Omitting `appearance` keeps the
+ * factory `blank` wrapper with the block title shown.
+ */
+export type PortalTimelineAppearanceContract = {
+    backdrop: "none" | "blank";
 } | {
-    type: "email";
-    /**
-     * Address only; portal-service adds the `mailto:` scheme.
-     * @maxLength 254
-     */
-    email: string;
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
 };
-/** Customizer Content section of a Card. */
-export interface PortalCardContentContract {
-    image?: PortalCardImageContract;
-    /** Default: "Helpful Resources", bold. */
-    heading?: PortalCardHeadingContract;
-    /** Default: the Customizer's Card copy. */
-    description?: PortalCardDescriptionContract;
-    /** Default: "Explore". */
-    button?: PortalCardButtonContract;
-    /**
-     * Omitted keeps the Customizer default link; `null` leaves the Card without
-     * any destination.
-     */
-    destination?: PortalCardDestinationContract | null;
-}
-export interface AddPortalCardBlockRequestContract {
-    /** Card Type. Default: `top-image`. */
-    view?: PortalCardViewContract;
-    content?: PortalCardContentContract;
-    /** Omitted keeps the Card's canonical bare wrapper. */
-    appearance?: PortalCardAppearanceContract;
-    /** Default: width 3 columns and automatic height. */
-    layout?: PortalCardLayoutContract;
-}
-export interface AddPortalCardBlockResponseContract {
-    /** Id of the created block. */
-    blockId: string;
-    /** Id of the page the block was added to. */
-    pageId: string;
-    /** Draft branch the change was staged on. */
-    branchId: string;
-    /** Sequence numbers assigned to the staged change events (addBlock). */
-    seqs: number[];
-    /** Always true: the block is staged in the customizer draft, not yet live. */
-    staged: boolean;
-}
-/** Customizer Layout section of a Carousel. */
-export interface PortalCarouselLayoutContract {
+/** Customizer Layout section of a Timeline. */
+export interface PortalTimelineLayoutContract {
     /** Customizer Width. Default: 6. */
     colspan?: 2 | 3 | 4 | 5 | 6;
     /**
@@ -587,50 +1448,23 @@ export interface PortalCarouselLayoutContract {
      */
     height?: number | null;
 }
-/**
- * One Carousel slide. The image is always a built-in one, and the index comes
- * from the array order: neither is accepted from the caller.
- */
-export interface PortalCarouselItemContract {
-    /**
-     * Plain text; the caption supports no dynamic variables.
-     * @minLength 1
-     */
-    caption?: string;
+export interface AddPortalTimelineBlockRequestContract {
+    /** Timeline view. Default: `horizontal`. */
+    view?: PortalTimelineViewContract;
     /**
-     * Plain text. Only `{{ClientName}}` and `{{ClientLastName}}` are variables.
+     * Wrapper title. Plain text; only `{{ClientName}}` and `{{ClientLastName}}`
+     * are variables. Default: `Timeline`.
      * @minLength 1
+     * @maxLength 100
      */
-    description?: string;
-    /** `null` or omitted leaves the slide without a Button. */
-    button?: {
-        /**
-         * Plain label; the Button supports no dynamic variables.
-         * @minLength 1
-         */
-        text: string;
-    } | null;
-    /**
-     * Destination of both the slide surface and its Button. `null` or omitted
-     * leaves the slide without a link.
-     */
-    destination?: PortalCardDestinationContract | null;
-}
-/** Customizer Content section of a Carousel. */
-export interface PortalCarouselContentContract {
-    /**
-     * The full desired slide list in visual order, not a patch. Omitting it keeps
-     * the three factory slides (Deliberation, Elaboration, Presentation).
-     * Server-side limits: 1 to 6 slides.
-     */
-    items?: PortalCarouselItemContract[];
-}
-export interface AddPortalCarouselBlockRequestContract {
-    content?: PortalCarouselContentContract;
+    title?: string;
+    content?: PortalTimelineContentContract;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalTimelineAppearanceContract;
     /** Default: width 6 columns and automatic height. */
-    layout?: PortalCarouselLayoutContract;
+    layout?: PortalTimelineLayoutContract;
 }
-export interface AddPortalCarouselBlockResponseContract {
+export interface AddPortalTimelineBlockResponseContract {
     /** Id of the created block. */
     blockId: string;
     /** Id of the page the block was added to. */
@@ -642,57 +1476,37 @@ export interface AddPortalCarouselBlockResponseContract {
     /** Always true: the block is staged in the customizer draft, not yet live. */
     staged: boolean;
 }
-/**
- * Customizer Appearance section of a Countdown. Omitting `appearance` keeps the
- * Countdown's canonical `blank` backdrop with the block title shown.
- */
-export type PortalCountdownAppearanceContract = {
-    backdrop: "none" | "blank";
-} | {
-    backdrop: "custom";
-    background: PortalCardBackgroundContract;
-    /** Default: `s`. */
-    padding?: "none" | "s" | "m" | "l";
-    /** Default: true. */
-    showTitle?: boolean;
-};
-/** Customizer Layout section of a Countdown. */
-export interface PortalCountdownLayoutContract {
-    /** Customizer Width. Default: 6. */
-    colspan?: 2 | 3 | 4 | 5 | 6;
+/** Customizer Layout section of a File uploader. */
+export interface PortalFileUploaderLayoutContract {
+    /** Customizer Width. Default: 3. */
+    colspan?: 3 | 4 | 6;
     /**
      * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
      * @minimum 50
      */
     height?: number | null;
 }
-/** Customizer Content section of a Countdown. */
-export interface PortalCountdownContentContract {
-    /**
-     * The moment the countdown ends, as an absolute RFC 3339 date-time carrying
-     * `Z` or an explicit UTC offset, for example `2026-08-15T09:00:00+07:00`.
-     * Never epoch seconds/milliseconds and never a timezone-less local date.
-     * Default: 30 days after creation. Server-side limits: not in the past and at
-     * most 99 days after creation.
-     * @format date-time
-     */
-    targetAt?: string;
-}
-export interface AddPortalCountdownBlockRequestContract {
+export interface AddPortalFileUploaderBlockRequestContract {
     /**
-     * Block title shown above the countdown. Plain text; only `{{ClientName}}`
-     * and `{{ClientLastName}}` are variables. Default: `Countdown`.
+     * Block title rendered above the file list. Plain text — the screen has no
+     * dynamic-variable control. Default: `File uploader`.
      * @minLength 1
      * @maxLength 100
      */
     title?: string;
-    content?: PortalCountdownContentContract;
-    /** Omitted keeps the canonical blank backdrop with the title shown. */
-    appearance?: PortalCountdownAppearanceContract;
-    /** Default: width 6 columns and automatic height. */
-    layout?: PortalCountdownLayoutContract;
+    /**
+     * Short plain-text hint under the title. Default: empty.
+     * @maxLength 50
+     */
+    description?: string;
+    /** Show the uploader's Author column. Default: false. */
+    showAuthor?: boolean;
+    /** Show the Upload date column. Default: false. */
+    showUploadDate?: boolean;
+    /** Default: width 3 columns and automatic height. */
+    layout?: PortalFileUploaderLayoutContract;
 }
-export interface AddPortalCountdownBlockResponseContract {
+export interface AddPortalFileUploaderBlockResponseContract {
     /** Id of the created block. */
     blockId: string;
     /** Id of the page the block was added to. */
@@ -842,7 +1656,7 @@ export interface ListPortalChatUsersResponseContract {
  * Any other value is rejected with 400 (the reducer throws on unknown types,
  * which would otherwise fail the whole draft at publish time).
  */
-export type PortalBlockType = "note" | "content" | "info" | "docs" | "help" | "request" | "meetings" | "links" | "task-list" | "projection" | "files-dashboard" | "tasks-dashboard" | "chats-dashboard" | "files-recent" | "files-bucket" | "flexible";
+export type PortalBlockType = "note" | "content" | "docs" | "help" | "request" | "meetings" | "links" | "files-dashboard" | "tasks-dashboard" | "chats-dashboard" | "files-recent" | "flexible";
 export interface AddPortalBlockRequestContract {
     /** Id of the existing portal page node to add the block to. */
     pageId: string;
@@ -861,9 +1675,9 @@ export interface AddPortalBlockRequestContract {
     bricks?: unknown[];
     /**
      * Optional type-specific fields for the staged block, e.g. flat strings
-     * `image`/`link` for info,
-     * `sourcePortalId`/`sourcePageId`/`sourceBlockId` for projection,
-     * `taskListIds` for task-list. Also overrides scaffold defaults (colspan,
+     * `image`/`link` for docs/help/request/meetings/links,
+     * `sourcePortalId`/`sourcePageId`/`sourceBlockId` for projection.
+     * Also overrides scaffold defaults (colspan,
      * rowspan, …) when provided. Every field is validated against the block's
      * real customizer shape — an unknown field or a wrong-typed value (e.g. an
      * object where a flat string is expected) is rejected with 400.
@@ -983,8 +1797,10 @@ export interface AddPortalAppBlockResponseContract {
 }
 export interface UpdatePortalCustomCodeRequestContract {
     /**
-     * Custom CSS applied to every published portal page (portal-service
-     * `customStyle`). Pass an empty string to clear it.
+     * Custom CSS for the portal (portal-service `customStyle`). Gate nests it under
+     * the portal's root container `#main-scrolling-container` so styles stay inside
+     * the portal zone and do not leak into the customizer UI. Scope selectors
+     * accordingly and avoid `body`/`html`/`:root`. Pass an empty string to clear it.
      */
     css?: string;
     /**
@@ -1260,3 +2076,60 @@ export declare const PortalCountdownAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalFormAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalFormFieldTypeContract: {
+    readonly Text: "text";
+    readonly Textarea: "textarea";
+    readonly Number: "number";
+    readonly Phone: "phone";
+    readonly Email: "email";
+    readonly Checkbox: "checkbox";
+    readonly Select: "select";
+    readonly File: "file";
+    readonly Date: "date";
+};
+export declare const PortalFormFieldWidthContract: {
+    readonly Half: "half";
+    readonly Full: "full";
+};
+export declare const PortalCardGroupImageContract: {
+    readonly Calendar: "calendar";
+    readonly Book: "book";
+    readonly Pen: "pen";
+    readonly Briefcase: "briefcase";
+};
+export declare const PortalCardGroupAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalInfoImageContract: {
+    readonly Emoji: "emoji";
+};
+export declare const PortalInfoDestinationContract: {
+    readonly Portalpage: "portalPage";
+};
+export declare const PortalCustomWidgetDestinationContract: {
+    readonly Portalpage: "portalPage";
+};
+export declare const PortalCustomWidgetBrickContract: {
+    readonly Heading: "heading";
+};
+export declare const PortalCustomWidgetAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalTimelineViewContract: {
+    readonly Horizontal: "horizontal";
+    readonly Vertical: "vertical";
+};
+export declare const PortalTimelineAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};