@openwarelabs/blocks 0.9.0 → 0.10.1

package/dist/settings/Settings03/Settings03.types.d.ts

@@ -0,0 +1,132 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/** An API key, as the table lists it. The secret itself is never kept: only the public part that identifies it. */
+export interface Settings03Key {
+    /** Names it for `onRevokeKey`. */
+    id: string;
+    /** Where it's used: "CI deploys". */
+    name: string;
+    /** The public part at the front of the key, shown with the secret masked after it, and copied by its button. */
+    prefix: string;
+    /** What it can do: "Read only". */
+    access?: string;
+    /** Who made it. */
+    createdBy?: string;
+    /** When it was made: "12 Mar 2026". */
+    created: string;
+    /** When it was last used: "2 hours ago". Leave it out for a key that's never been used. */
+    lastUsed?: string;
+}
+/** A choice in the create dialog's menus. */
+export interface Settings03Option {
+    value: string;
+    label: string;
+    /** Under the menu while it's chosen. */
+    description?: string;
+}
+/** What the create dialog asks for. */
+export interface Settings03NewKey {
+    /** The name, trimmed. */
+    name: string;
+    /** The chosen access option's value. */
+    access?: string;
+    /** The chosen expiry option's value. */
+    expiry?: string;
+}
+/** A key just made: its row, and the whole key to show once. */
+export interface Settings03CreatedKey {
+    key: Settings03Key;
+    /** The full key, secret and all. It's shown in the dialog to copy, then never again. */
+    secret: string;
+}
+export interface Settings03Labels {
+    /** The button in the header and the create dialog's. @default "Create key" */
+    create?: string;
+    /** The create dialog's title. @default "Create an API key" */
+    createTitle?: string;
+    /** The line under it. @default "You'll see the key once, straight after you create it." */
+    createDescription?: string;
+    /** @default "Name" */
+    name?: string;
+    /** @default "Where it's used, so you know which one to revoke." */
+    nameHint?: string;
+    /** @default "Nightly backups" */
+    namePlaceholder?: string;
+    /** @default "Name the key after where it's used, like the service or script." */
+    nameEmpty?: string;
+    /** When another key has the name. @default `There's already a key called ${name}.` */
+    nameTaken?(name: string): string;
+    /** Shown when `onCreateKey` fails without a message of its own. @default "That didn't go through. Try again in a moment." */
+    failed?: string;
+    /** @default "Access" */
+    access?: string;
+    /** @default "Expires" */
+    expiry?: string;
+    /** @default "Cancel" */
+    cancel?: string;
+    /** The dialog's title once the key is made. @default "Copy your new key" */
+    createdTitle?: string;
+    /** The line under it. @default "This is the only time you'll see it. Put it somewhere safe, like your CI's secrets, before you close this." */
+    createdDescription?: string;
+    /** @default "Done" */
+    done?: string;
+    /** The table's caption, for screen readers. @default "API keys" */
+    table?: string;
+    /** Column headings. @default "Name", "Key", "Created", "Last used", "Actions" */
+    columns?: {
+        name?: string;
+        key?: string;
+        created?: string;
+        lastUsed?: string;
+        actions?: string;
+    };
+    /** Read out after the key's public part. @default ", then the secret, hidden" */
+    secretHidden?: string;
+    /** The copy button's name. @default `Copy the ID of ${name}` */
+    copy?(name: string): string;
+    /** For a key that's never been used. @default "Never" */
+    never?: string;
+    /** Under the name on phones. @default `used ${lastUsed.toLowerCase()}`, or "never used" */
+    used?(lastUsed: string | undefined): string;
+    /** @default "Revoke" */
+    revoke?: string;
+    /** The revoke button's name. @default `Revoke ${name}` */
+    revokeKey?(name: string): string;
+    /** The confirmation's title. @default `Revoke ${name}?` */
+    revokeTitle?(name: string): string;
+    /** The confirmation's line, given the key's public part in code. @default (prefix) => <>Anything still using {prefix} stops working straight away. You can't undo this.</> */
+    revokeDescription?(prefix: ReactNode): ReactNode;
+    /** The confirmation's button. @default "Revoke key" */
+    revokeConfirm?: string;
+    /** With no keys. @default "No API keys" */
+    emptyTitle?: string;
+    /** @default "Create one to use the API from a script or your CI." */
+    emptyDescription?: string;
+    /** Who made a key made here, when `onCreateKey` doesn't say. @default "You" */
+    you?: string;
+    /** When a key made here was made, when `onCreateKey` doesn't say. @default "Today" */
+    today?: string;
+}
+export interface Settings03Props extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** The section's heading: "API keys". */
+    title: ReactNode;
+    /** A line under it. */
+    description?: ReactNode;
+    /** The keys there are, newest first. The block keeps its own list from here, adding and removing keys as people do. */
+    keys: Settings03Key[];
+    /** The create dialog's access menu. Leave it out to not ask. */
+    accessOptions?: Settings03Option[];
+    /** The access chosen to start with. @default the first option */
+    defaultAccess?: string;
+    /** The create dialog's expiry menu. Leave it out to not ask. */
+    expiryOptions?: Settings03Option[];
+    /** The expiry chosen to start with. @default the first option */
+    defaultExpiry?: string;
+    /** Makes the key on your server and returns it, with the full secret to show once. If it throws, its message shows under the name. Without it a sample key is made here. */
+    onCreateKey?(values: Settings03NewKey): Settings03CreatedKey | Promise<Settings03CreatedKey>;
+    /** Revokes the key on your server, once it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onRevokeKey?(key: Settings03Key): void | Promise<void>;
+    /** Small print under the table, such as a link to the API guide. */
+    note?: ReactNode;
+    /** Words that aren't content (buttons, headings, messages), in English unless you pass your own. */
+    labels?: Settings03Labels;
+}

package/dist/settings/Settings04/Settings04.d.cts

@@ -0,0 +1,3 @@
+import type { Settings04Props } from "./Settings04.types.cjs";
+/** People with their role and a menu to change it or remove them, an invite at the top, and the invites still waiting. */
+export declare function Settings04({ title, description, members: initialMembers, invites: initialInvites, roles, defaultInviteRole, currentUserEmail, onInvite, onRoleChange, onRemove, onResendInvite, onRevokeInvite, onCopyEmail, labels, className, ...props }: Settings04Props): import("react").JSX.Element;

package/dist/settings/Settings04/Settings04.d.ts

@@ -0,0 +1,3 @@
+import type { Settings04Props } from "./Settings04.types.js";
+/** People with their role and a menu to change it or remove them, an invite at the top, and the invites still waiting. */
+export declare function Settings04({ title, description, members: initialMembers, invites: initialInvites, roles, defaultInviteRole, currentUserEmail, onInvite, onRoleChange, onRemove, onResendInvite, onRevokeInvite, onCopyEmail, labels, className, ...props }: Settings04Props): import("react").JSX.Element;

package/dist/settings/Settings04/Settings04.types.d.cts

@@ -0,0 +1,124 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/** A role someone can have. */
+export interface Settings04Role {
+    /** Kept on members and invites: "admin". */
+    value: string;
+    /** Its name: "Admin". */
+    label: string;
+    /** What it can do, under its name in the menus. */
+    description?: string;
+}
+/** Someone in the workspace. */
+export interface Settings04Member {
+    name: string;
+    /** Their address. It also tells members apart, so it must be unique. */
+    email: string;
+    /** One of the roles' values. Ignored for the owner. */
+    role: string;
+    /** The owner's role can't be changed and they can't be removed, so their row has neither. */
+    owner?: boolean;
+}
+/** An invite that hasn't been accepted yet. */
+export interface Settings04Invite {
+    email: string;
+    /** The role they'll join with: one of the roles' values. */
+    role: string;
+    /** When it was sent: "2 days ago". */
+    sent: string;
+    /** Who sent it. */
+    invitedBy?: string;
+}
+export interface Settings04Labels {
+    /** @default "Invite by email" */
+    inviteEmail?: string;
+    /** @default "The link in the invite works for 7 days." */
+    inviteHint?: string;
+    /** @default "name@example.com" */
+    invitePlaceholder?: string;
+    /** The invite's role menu, for screen readers. @default "Role for the invite" */
+    inviteRole?: string;
+    /** @default "Send invite" */
+    send?: string;
+    /** @default "Enter the email address to send the invite to." */
+    emailEmpty?: string;
+    /** @default "That doesn't look like an email address." */
+    emailInvalid?: string;
+    /** When the address belongs to a member. @default `${name} is already a member.` */
+    alreadyMember?(name: string): string;
+    /** When they're already invited. @default "They're already invited. Resend it from the list below." */
+    alreadyInvited?: string;
+    /** Shown when `onInvite` fails without a message of its own. @default "That didn't go through. Try again in a moment." */
+    failed?: string;
+    /** @default "Members" */
+    members?: string;
+    /** @default "Pending invites" */
+    invites?: string;
+    /** The badge beside your own name. @default "You" */
+    you?: string;
+    /** In place of the owner's role menu. @default "Owner" */
+    owner?: string;
+    /** A member's role menu, for screen readers. @default `Role for ${name}` */
+    roleFor?(name: string): string;
+    /** A row's menu button, for screen readers. @default `More for ${name}` */
+    moreFor?(name: string): string;
+    /** A member's menu, for screen readers. @default `Actions for ${name}` */
+    actionsFor?(name: string): string;
+    /** An invite's menu, for screen readers. @default `Actions for the invite to ${email}` */
+    inviteActionsFor?(email: string): string;
+    /** @default "Copy email address" */
+    copyEmail?: string;
+    /** @default "Remove" */
+    remove?: string;
+    /** @default "Resend invite" */
+    resend?: string;
+    /** @default "Revoke invite" */
+    revokeInvite?: string;
+    /** The badge on an invite, given its role's name. @default `${role} · pending` */
+    pending?(role: string): ReactNode;
+    /** The line under an invite's address. @default `Invited ${sent.toLowerCase()} by ${invitedBy}` */
+    invited?(invite: Settings04Invite): ReactNode;
+    /** When an invite sent here was sent. @default "Just now" */
+    justNow?: string;
+    /** The removal's title. @default `Remove ${name}?` */
+    removeTitle?(name: string): string;
+    /** The removal's line. @default "They lose access straight away." */
+    removeDescription?: string;
+    /** The removal's button. @default "Remove member" */
+    removeConfirm?: string;
+}
+export interface Settings04Props extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** The section's heading: "Members". */
+    title: ReactNode;
+    /** A line under it, given how many members and invites there are now. */
+    description?: ReactNode | ((counts: {
+        members: number;
+        invites: number;
+    }) => ReactNode);
+    /** The people in it, in order. The block keeps its own list from here, changing it as people do. */
+    members: Settings04Member[];
+    /** The invites still waiting. */
+    invites?: Settings04Invite[];
+    /** The roles, for the menus. */
+    roles: Settings04Role[];
+    /** The role an invite starts with. @default the first role */
+    defaultInviteRole?: string;
+    /** The address of the person looking, so their row says "You" and their invites say who sent them. */
+    currentUserEmail?: string;
+    /** Sends an invite, once the address is valid and new. While its promise is pending the button shows a spinner; if it throws, its message shows under the field. */
+    onInvite?(invite: {
+        email: string;
+        role: string;
+    }): void | Promise<void>;
+    /** Saves a member's new role. */
+    onRoleChange?(member: Settings04Member, role: string): void;
+    /** Removes a member, once it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onRemove?(member: Settings04Member): void | Promise<void>;
+    /** Sends an invite again. */
+    onResendInvite?(invite: Settings04Invite): void;
+    /** Revokes an invite. It goes from the list straight away, as it can be undone: call `undo` (from a toast's Undo, say) to put it back. */
+    onRevokeInvite?(invite: Settings04Invite, undo: () => void): void;
+    /** Called once a member's address is on the clipboard, to say so. */
+    onCopyEmail?(member: Settings04Member): void;
+    /** Words that aren't content (labels, buttons, menus, messages), in English unless you pass your own. */
+    labels?: Settings04Labels;
+}

package/dist/settings/Settings04/Settings04.types.d.ts

@@ -0,0 +1,124 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/** A role someone can have. */
+export interface Settings04Role {
+    /** Kept on members and invites: "admin". */
+    value: string;
+    /** Its name: "Admin". */
+    label: string;
+    /** What it can do, under its name in the menus. */
+    description?: string;
+}
+/** Someone in the workspace. */
+export interface Settings04Member {
+    name: string;
+    /** Their address. It also tells members apart, so it must be unique. */
+    email: string;
+    /** One of the roles' values. Ignored for the owner. */
+    role: string;
+    /** The owner's role can't be changed and they can't be removed, so their row has neither. */
+    owner?: boolean;
+}
+/** An invite that hasn't been accepted yet. */
+export interface Settings04Invite {
+    email: string;
+    /** The role they'll join with: one of the roles' values. */
+    role: string;
+    /** When it was sent: "2 days ago". */
+    sent: string;
+    /** Who sent it. */
+    invitedBy?: string;
+}
+export interface Settings04Labels {
+    /** @default "Invite by email" */
+    inviteEmail?: string;
+    /** @default "The link in the invite works for 7 days." */
+    inviteHint?: string;
+    /** @default "name@example.com" */
+    invitePlaceholder?: string;
+    /** The invite's role menu, for screen readers. @default "Role for the invite" */
+    inviteRole?: string;
+    /** @default "Send invite" */
+    send?: string;
+    /** @default "Enter the email address to send the invite to." */
+    emailEmpty?: string;
+    /** @default "That doesn't look like an email address." */
+    emailInvalid?: string;
+    /** When the address belongs to a member. @default `${name} is already a member.` */
+    alreadyMember?(name: string): string;
+    /** When they're already invited. @default "They're already invited. Resend it from the list below." */
+    alreadyInvited?: string;
+    /** Shown when `onInvite` fails without a message of its own. @default "That didn't go through. Try again in a moment." */
+    failed?: string;
+    /** @default "Members" */
+    members?: string;
+    /** @default "Pending invites" */
+    invites?: string;
+    /** The badge beside your own name. @default "You" */
+    you?: string;
+    /** In place of the owner's role menu. @default "Owner" */
+    owner?: string;
+    /** A member's role menu, for screen readers. @default `Role for ${name}` */
+    roleFor?(name: string): string;
+    /** A row's menu button, for screen readers. @default `More for ${name}` */
+    moreFor?(name: string): string;
+    /** A member's menu, for screen readers. @default `Actions for ${name}` */
+    actionsFor?(name: string): string;
+    /** An invite's menu, for screen readers. @default `Actions for the invite to ${email}` */
+    inviteActionsFor?(email: string): string;
+    /** @default "Copy email address" */
+    copyEmail?: string;
+    /** @default "Remove" */
+    remove?: string;
+    /** @default "Resend invite" */
+    resend?: string;
+    /** @default "Revoke invite" */
+    revokeInvite?: string;
+    /** The badge on an invite, given its role's name. @default `${role} · pending` */
+    pending?(role: string): ReactNode;
+    /** The line under an invite's address. @default `Invited ${sent.toLowerCase()} by ${invitedBy}` */
+    invited?(invite: Settings04Invite): ReactNode;
+    /** When an invite sent here was sent. @default "Just now" */
+    justNow?: string;
+    /** The removal's title. @default `Remove ${name}?` */
+    removeTitle?(name: string): string;
+    /** The removal's line. @default "They lose access straight away." */
+    removeDescription?: string;
+    /** The removal's button. @default "Remove member" */
+    removeConfirm?: string;
+}
+export interface Settings04Props extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** The section's heading: "Members". */
+    title: ReactNode;
+    /** A line under it, given how many members and invites there are now. */
+    description?: ReactNode | ((counts: {
+        members: number;
+        invites: number;
+    }) => ReactNode);
+    /** The people in it, in order. The block keeps its own list from here, changing it as people do. */
+    members: Settings04Member[];
+    /** The invites still waiting. */
+    invites?: Settings04Invite[];
+    /** The roles, for the menus. */
+    roles: Settings04Role[];
+    /** The role an invite starts with. @default the first role */
+    defaultInviteRole?: string;
+    /** The address of the person looking, so their row says "You" and their invites say who sent them. */
+    currentUserEmail?: string;
+    /** Sends an invite, once the address is valid and new. While its promise is pending the button shows a spinner; if it throws, its message shows under the field. */
+    onInvite?(invite: {
+        email: string;
+        role: string;
+    }): void | Promise<void>;
+    /** Saves a member's new role. */
+    onRoleChange?(member: Settings04Member, role: string): void;
+    /** Removes a member, once it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onRemove?(member: Settings04Member): void | Promise<void>;
+    /** Sends an invite again. */
+    onResendInvite?(invite: Settings04Invite): void;
+    /** Revokes an invite. It goes from the list straight away, as it can be undone: call `undo` (from a toast's Undo, say) to put it back. */
+    onRevokeInvite?(invite: Settings04Invite, undo: () => void): void;
+    /** Called once a member's address is on the clipboard, to say so. */
+    onCopyEmail?(member: Settings04Member): void;
+    /** Words that aren't content (labels, buttons, menus, messages), in English unless you pass your own. */
+    labels?: Settings04Labels;
+}

package/dist/settings/Settings05/Settings05.d.cts

@@ -0,0 +1,3 @@
+import type { Settings05Props } from "./Settings05.types.cjs";
+/** A project's danger zone on a card edged in red: transfer it, archive it, or delete it after typing its name. */
+export declare function Settings05({ title, description, project, owner: initialOwner, currentUserName, admins, contents, defaultArchived, onTransfer, onArchiveChange, onDelete, onBack, labels, className, ...props }: Settings05Props): import("react").JSX.Element;

package/dist/settings/Settings05/Settings05.d.ts

@@ -0,0 +1,3 @@
+import type { Settings05Props } from "./Settings05.types.js";
+/** A project's danger zone on a card edged in red: transfer it, archive it, or delete it after typing its name. */
+export declare function Settings05({ title, description, project, owner: initialOwner, currentUserName, admins, contents, defaultArchived, onTransfer, onArchiveChange, onDelete, onBack, labels, className, ...props }: Settings05Props): import("react").JSX.Element;

package/dist/settings/Settings05/Settings05.types.d.cts

@@ -0,0 +1,94 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/** Someone the project can be handed to. */
+export interface Settings05Admin {
+    /** Passed to `onTransfer`, and shown as the owner afterwards: their name. */
+    value: string;
+    label: string;
+    /** Under the name in the menu: "Admin · tomas@example.com". */
+    description?: string;
+}
+/** Something that's deleted with the project, listed in the confirmation. */
+export interface Settings05Content {
+    /** How many: "214". */
+    count: ReactNode;
+    /** Of what: "deploys, with their logs and preview URLs". */
+    what: ReactNode;
+}
+export interface Settings05Labels {
+    /** @default "Transfer ownership" */
+    transferTitle?: string;
+    /** Under it, while you own it. @default "You own it now. Hand it to another admin and stay on as a member." */
+    transferYou?: string;
+    /** Under it, once someone else does. @default `${owner} owns it now. They can hand it back at any time.` */
+    transferOther?(owner: string): string;
+    /** @default "Transfer" */
+    transfer?: string;
+    /** The confirmation's title. @default `Transfer ${project}?` */
+    transferConfirmTitle?(project: string): string;
+    /** @default "The new owner can rename, transfer or delete it. You'll stay on as a member." */
+    transferConfirmDescription?: string;
+    /** @default "Transfer ownership" */
+    transferConfirm?: string;
+    /** @default "New owner" */
+    newOwner?: string;
+    /** @default "Choose an admin" */
+    newOwnerPlaceholder?: string;
+    /** @default "Archive project" */
+    archiveTitle?: string;
+    /** @default "Pauses the project and hides it from the sidebar. You can restore it at any time." */
+    archiveDescription?: string;
+    /** @default "Archive" */
+    archive?: string;
+    /** @default "Restore project" */
+    restoreTitle?: string;
+    /** @default "It's archived: it's paused and hidden from the sidebar." */
+    archivedDescription?: string;
+    /** @default "Restore" */
+    restore?: string;
+    /** The last row's title, and its button. @default "Delete project" */
+    deleteTitle?: string;
+    /** @default "Deletes it for good, with everything in it. This can't be undone." */
+    deleteDescription?: string;
+    /** The confirmation's title. @default `Delete ${project}?` */
+    deleteConfirmTitle?(project: string): string;
+    /** The confirmation's line, before the list of what goes. @default "This deletes the project for everyone. Along with it go:" */
+    deleteConfirmDescription?: string;
+    /** The field's label, given the name to type in code. @default (project) => <>Type {project} to confirm</> */
+    typeToConfirm?(project: ReactNode): ReactNode;
+    /** The confirmation's button. @default "Delete project" */
+    deleteConfirm?: string;
+    /** What shows once it's gone. @default `${project} was deleted` */
+    deletedTitle?(project: string): string;
+    /** @default "Its data and settings are gone." */
+    deletedDescription?: string;
+    /** The button under it. @default "Back to projects" */
+    back?: string;
+}
+export interface Settings05Props extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** The section's heading: "Danger zone". */
+    title: ReactNode;
+    /** A line under it: what these change, and who can use them. */
+    description?: ReactNode;
+    /** The project's name: in the confirmations, and what has to be typed to delete it. */
+    project: string;
+    /** Who owns it now, by name. */
+    owner: string;
+    /** The name of the person looking, so the transfer row can say "You own it now". */
+    currentUserName?: string;
+    /** Who it can be handed to. */
+    admins: Settings05Admin[];
+    /** What goes with it, listed in the delete confirmation. */
+    contents?: Settings05Content[];
+    /** Whether it starts archived. */
+    defaultArchived?: boolean;
+    /** Hands it to someone, once it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onTransfer?(owner: string): void | Promise<void>;
+    /** Archives or restores it. It happens straight away, as it can be undone: call `undo` (from a toast's Undo, say) to switch it back. */
+    onArchiveChange?(archived: boolean, undo: () => void): void;
+    /** Deletes it, once the name is typed and it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onDelete?(): void | Promise<void>;
+    /** The button once it's gone, which usually goes to the project list. Without it the button brings the section back. */
+    onBack?(): void;
+    /** Words that aren't content (row titles, buttons, confirmations), in English unless you pass your own. */
+    labels?: Settings05Labels;
+}

package/dist/settings/Settings05/Settings05.types.d.ts

@@ -0,0 +1,94 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/** Someone the project can be handed to. */
+export interface Settings05Admin {
+    /** Passed to `onTransfer`, and shown as the owner afterwards: their name. */
+    value: string;
+    label: string;
+    /** Under the name in the menu: "Admin · tomas@example.com". */
+    description?: string;
+}
+/** Something that's deleted with the project, listed in the confirmation. */
+export interface Settings05Content {
+    /** How many: "214". */
+    count: ReactNode;
+    /** Of what: "deploys, with their logs and preview URLs". */
+    what: ReactNode;
+}
+export interface Settings05Labels {
+    /** @default "Transfer ownership" */
+    transferTitle?: string;
+    /** Under it, while you own it. @default "You own it now. Hand it to another admin and stay on as a member." */
+    transferYou?: string;
+    /** Under it, once someone else does. @default `${owner} owns it now. They can hand it back at any time.` */
+    transferOther?(owner: string): string;
+    /** @default "Transfer" */
+    transfer?: string;
+    /** The confirmation's title. @default `Transfer ${project}?` */
+    transferConfirmTitle?(project: string): string;
+    /** @default "The new owner can rename, transfer or delete it. You'll stay on as a member." */
+    transferConfirmDescription?: string;
+    /** @default "Transfer ownership" */
+    transferConfirm?: string;
+    /** @default "New owner" */
+    newOwner?: string;
+    /** @default "Choose an admin" */
+    newOwnerPlaceholder?: string;
+    /** @default "Archive project" */
+    archiveTitle?: string;
+    /** @default "Pauses the project and hides it from the sidebar. You can restore it at any time." */
+    archiveDescription?: string;
+    /** @default "Archive" */
+    archive?: string;
+    /** @default "Restore project" */
+    restoreTitle?: string;
+    /** @default "It's archived: it's paused and hidden from the sidebar." */
+    archivedDescription?: string;
+    /** @default "Restore" */
+    restore?: string;
+    /** The last row's title, and its button. @default "Delete project" */
+    deleteTitle?: string;
+    /** @default "Deletes it for good, with everything in it. This can't be undone." */
+    deleteDescription?: string;
+    /** The confirmation's title. @default `Delete ${project}?` */
+    deleteConfirmTitle?(project: string): string;
+    /** The confirmation's line, before the list of what goes. @default "This deletes the project for everyone. Along with it go:" */
+    deleteConfirmDescription?: string;
+    /** The field's label, given the name to type in code. @default (project) => <>Type {project} to confirm</> */
+    typeToConfirm?(project: ReactNode): ReactNode;
+    /** The confirmation's button. @default "Delete project" */
+    deleteConfirm?: string;
+    /** What shows once it's gone. @default `${project} was deleted` */
+    deletedTitle?(project: string): string;
+    /** @default "Its data and settings are gone." */
+    deletedDescription?: string;
+    /** The button under it. @default "Back to projects" */
+    back?: string;
+}
+export interface Settings05Props extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** The section's heading: "Danger zone". */
+    title: ReactNode;
+    /** A line under it: what these change, and who can use them. */
+    description?: ReactNode;
+    /** The project's name: in the confirmations, and what has to be typed to delete it. */
+    project: string;
+    /** Who owns it now, by name. */
+    owner: string;
+    /** The name of the person looking, so the transfer row can say "You own it now". */
+    currentUserName?: string;
+    /** Who it can be handed to. */
+    admins: Settings05Admin[];
+    /** What goes with it, listed in the delete confirmation. */
+    contents?: Settings05Content[];
+    /** Whether it starts archived. */
+    defaultArchived?: boolean;
+    /** Hands it to someone, once it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onTransfer?(owner: string): void | Promise<void>;
+    /** Archives or restores it. It happens straight away, as it can be undone: call `undo` (from a toast's Undo, say) to switch it back. */
+    onArchiveChange?(archived: boolean, undo: () => void): void;
+    /** Deletes it, once the name is typed and it's confirmed. The confirmation waits for its promise and shows its error if it throws. */
+    onDelete?(): void | Promise<void>;
+    /** The button once it's gone, which usually goes to the project list. Without it the button brings the section back. */
+    onBack?(): void;
+    /** Words that aren't content (row titles, buttons, confirmations), in English unless you pass your own. */
+    labels?: Settings05Labels;
+}

package/dist/shared/AppWorkspaceItems.d.cts

@@ -0,0 +1,3 @@
+import type { AppWorkspaceItemsProps } from "./shared.types.cjs";
+/** The workspace menu's items: its heading, each workspace with the current one ticked, then a new one. */
+export declare function AppWorkspaceItems({ workspaces, onNewWorkspace, heading, newWorkspace, spacerClassName }: AppWorkspaceItemsProps): import("react").JSX.Element;

package/dist/shared/AppWorkspaceItems.d.ts

@@ -0,0 +1,3 @@
+import type { AppWorkspaceItemsProps } from "./shared.types.js";
+/** The workspace menu's items: its heading, each workspace with the current one ticked, then a new one. */
+export declare function AppWorkspaceItems({ workspaces, onNewWorkspace, heading, newWorkspace, spacerClassName }: AppWorkspaceItemsProps): import("react").JSX.Element;

package/dist/shared/BlockActions.d.cts

@@ -1,5 +1,5 @@
 import type { BlockActionButtonProps, BlockActionsProps } from "./shared.types.cjs";
 /** One action as a large pill: a link styled as a button when it has an href, a button otherwise. */
-export declare function BlockActionButton({ action, variant, size, className, onAfterClick, fullWidth }: BlockActionButtonProps): import("react").JSX.Element;
+export declare function BlockActionButton({ action, variant, size, shape, className, onAfterClick, fullWidth }: BlockActionButtonProps): import("react").JSX.Element;
 /** The primary action and an optional secondary one, side by side. */
 export declare function BlockActions({ primary, secondary, className }: BlockActionsProps): import("react").JSX.Element;

package/dist/shared/BlockActions.d.ts

@@ -1,5 +1,5 @@
 import type { BlockActionButtonProps, BlockActionsProps } from "./shared.types.js";
 /** One action as a large pill: a link styled as a button when it has an href, a button otherwise. */
-export declare function BlockActionButton({ action, variant, size, className, onAfterClick, fullWidth }: BlockActionButtonProps): import("react").JSX.Element;
+export declare function BlockActionButton({ action, variant, size, shape, className, onAfterClick, fullWidth }: BlockActionButtonProps): import("react").JSX.Element;
 /** The primary action and an optional secondary one, side by side. */
 export declare function BlockActions({ primary, secondary, className }: BlockActionsProps): import("react").JSX.Element;

package/dist/shared/BlockMenuItems.d.cts

@@ -0,0 +1,3 @@
+import type { BlockMenuItemsProps } from "./shared.types.cjs";
+/** A menu's items, each a MenuItem, with a separator before those that start a new group. */
+export declare function BlockMenuItems({ items, onAfterSelect }: BlockMenuItemsProps): import("react").JSX.Element;

package/dist/shared/BlockMenuItems.d.ts

@@ -0,0 +1,3 @@
+import type { BlockMenuItemsProps } from "./shared.types.js";
+/** A menu's items, each a MenuItem, with a separator before those that start a new group. */
+export declare function BlockMenuItems({ items, onAfterSelect }: BlockMenuItemsProps): import("react").JSX.Element;

package/dist/shared/appShell.d.cts

@@ -0,0 +1,19 @@
+import type { Command } from "@openwarelabs/ui";
+import type { AppShellStateOptions, BlockMenuItem } from "./shared.types.cjs";
+/**
+ * What every app shell keeps: the current place (its own, unless `current` is given), the phone drawer, and the
+ * search, which ⌘K or Ctrl+K opens from anywhere when there are commands. Choosing a place closes the drawer.
+ */
+export declare function useAppShell({ current, defaultCurrent, onNavigate, commands }: AppShellStateOptions): {
+    active: string | undefined;
+    navigate: (id: string) => void;
+    navOpen: boolean;
+    setNavOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    searchOpen: boolean;
+    setSearchOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    hasSearch: boolean;
+    paletteCommands: Command[];
+    afterMenuSelect: (item: BlockMenuItem & {
+        page?: string;
+    }) => void;
+};