@realiizlabs/admin 0.11.2 → 0.13.0

package/dist/studio-ui/index.d.cts

@@ -0,0 +1,375 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { C as ContentTypeEntry } from '../types-D46UjOfv.cjs';
+import { c as SiteBranding, d as SiteMember } from '../members-nhbRSYyr.cjs';
+import { S as ShellUser, N as NavItem } from '../Sidebar-CNuphww6.cjs';
+import { a as PullRequestStatus } from '../types-BP5G1myE.cjs';
+import 'zod';
+import '@supabase/supabase-js';
+
+/**
+ * The serialisable shapes that cross from a site's server pages into these
+ * client components, and the exact set of server actions a site must provide.
+ */
+
+type ActionResult = {
+    ok: true;
+    message?: string;
+} | {
+    ok: false;
+    error: string;
+};
+type PublishResult = {
+    ok: false;
+    error: string;
+};
+type MergeOutcome = {
+    state: "merged";
+    sha: string;
+} | {
+    state: "pending";
+} | {
+    state: "stale";
+} | {
+    state: "red";
+    failingCheck: string | null;
+} | {
+    state: "error";
+    message: string;
+};
+type DiscardOutcome = {
+    state: "discarded";
+} | {
+    state: "already-published";
+} | {
+    state: "error";
+    message: string;
+};
+type TeamState = {
+    ok: true;
+    members: SiteMember[];
+    canInvite: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+interface ImagePayload {
+    path: string;
+    base64: string;
+}
+interface PublishInput {
+    type: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    existing?: {
+        number: number;
+        branch: string;
+    } | null;
+    images?: ImagePayload[];
+}
+/** Exactly what a site's "use server" wrapper file must export. */
+interface StudioActions {
+    publishContent: (input: PublishInput) => Promise<PublishResult | never>;
+    removeContent: (input: {
+        type: string;
+        slug: string;
+    }) => Promise<PublishResult | never>;
+    mergeContentPr: (number: number) => Promise<MergeOutcome>;
+    discardChange: (number: number, branch: string) => Promise<DiscardOutcome>;
+    previewBody: (markdown: string) => Promise<{
+        html: string;
+    } | {
+        error: string;
+    }>;
+    saveProfile: (input: {
+        name: string;
+        displayName: string;
+    }) => Promise<ActionResult>;
+    saveAvatar: (input: {
+        base64: string;
+    } | null) => Promise<ActionResult>;
+    changePassword: (input: {
+        password: string;
+        confirm: string;
+    }) => Promise<ActionResult>;
+    loadBranding: () => Promise<SiteBranding | null>;
+    saveBranding: (input: {
+        name: string;
+        businessEmail: string;
+        businessPhone: string;
+    }) => Promise<ActionResult>;
+    saveBrandingPicture: (input: {
+        kind: "logo" | "favicon";
+        base64: string | null;
+    }) => Promise<ActionResult>;
+    loadMe: () => Promise<{
+        email: string;
+        role: string;
+        name: string | null;
+        displayName: string | null;
+        avatarUrl: string | null;
+    }>;
+    loadTeam: () => Promise<TeamState>;
+    invite: (input: {
+        email: string;
+        role: "owner" | "editor";
+    }) => Promise<ActionResult>;
+    changeRole: (input: {
+        userId: string;
+        role: "owner" | "editor";
+    }) => Promise<ActionResult>;
+    resend: (input: {
+        email: string;
+    }) => Promise<ActionResult>;
+    remove: (input: {
+        userId: string;
+    }) => Promise<ActionResult>;
+}
+declare const ACTION_NAMES: readonly ["publishContent", "removeContent", "mergeContentPr", "discardChange", "previewBody", "saveProfile", "saveAvatar", "changePassword", "loadBranding", "saveBranding", "saveBrandingPicture", "loadMe", "loadTeam", "invite", "changeRole", "resend", "remove"];
+/** One row of a content list, as the site page loads it from Studio.readers.listItems. */
+interface ListRow {
+    slug: string;
+    title: string;
+    date: string | null;
+    needsAttention: boolean;
+    isNew: boolean;
+    /** Where the live item is on the public site, or null when the type has no page. */
+    liveUrl: string | null;
+    pending: {
+        number: number;
+        state: "checking" | "ready" | "failed";
+        removal: boolean;
+    } | null;
+}
+type PendingSummary = {
+    number: number;
+    branch: string;
+    state: "checking" | "ready" | "failed";
+    failingCheck: string | null;
+    removal: boolean;
+};
+
+interface StudioContextValue {
+    contentTypes: Record<string, ContentTypeEntry>;
+    actions: StudioActions;
+    /** Who to ask when something needs the agency — "your web team" by default. */
+    supportName: string;
+    siteName: string;
+}
+declare function StudioProvider({ contentTypes, actions, supportName, siteName, children }: {
+    contentTypes: Record<string, ContentTypeEntry>;
+    actions: StudioActions;
+    supportName?: string;
+    siteName?: string;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useStudio(): StudioContextValue;
+declare function useEntry(typeId: string): ContentTypeEntry | null;
+/** Pictures for a type live under public/<last folder segment>/. */
+declare function publicDirOf(entry: {
+    folder: string;
+}): string;
+
+/**
+ * The frame every Studio page sits in: the shell with the current path for the
+ * active nav item, plus Studio's page styles injected once. Session, nav and
+ * branding arrive as props from the site's server layout.
+ */
+declare function StudioShellFrame({ siteName, logoUrl, user, role, nav, pinnedNav, branding, children }: {
+    siteName: string;
+    logoUrl?: string | null;
+    user: ShellUser | null;
+    role: string | null;
+    nav: NavItem[];
+    pinnedNav?: NavItem[];
+    branding?: {
+        name?: string | null;
+        logoUrl?: string | null;
+    } | null;
+    children: React.ReactNode;
+}): react.JSX.Element;
+
+declare function StudioNotConfigured(): react.JSX.Element;
+declare function StudioNoAccess({ actual }: {
+    actual: string | null;
+}): react.JSX.Element;
+
+/** Home: one card per content type. `cards` is [{ typeId, count, waiting }] in registry order. */
+declare function StudioDashboard({ greeting, cards }: {
+    greeting: string;
+    cards: {
+        typeId: string;
+        count: number;
+        waiting: number;
+    }[];
+}): react.JSX.Element;
+declare function StudioList({ typeId, items }: {
+    typeId: string;
+    items: ListRow[];
+}): react.JSX.Element | null;
+declare function StudioNew({ typeId, initialValues }: {
+    typeId: string;
+    initialValues: Record<string, unknown>;
+}): react.JSX.Element | null;
+declare function StudioEdit({ typeId, slug, frontmatter, body, pending }: {
+    typeId: string;
+    slug: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    pending: PendingSummary | null;
+}): react.JSX.Element | null;
+declare function StudioPullRequest({ pr, status, item }: {
+    pr: {
+        number: number;
+        title: string;
+        html_url: string;
+        merged: boolean;
+        state: "open" | "closed";
+        branch: string;
+        removal: boolean;
+        mergeCommitSha: string | null;
+    };
+    status: PullRequestStatus | null;
+    item: {
+        noun: string;
+        label: string;
+        typeId: string;
+        slug: string;
+        liveUrl: string | null;
+    } | null;
+}): react.JSX.Element;
+declare function StudioHelp(): react.JSX.Element;
+declare function StudioSignIn({ url, anonKey, redirectTo, siteName, error }: {
+    url: string;
+    anonKey: string;
+    redirectTo: string;
+    siteName: string;
+    error?: string | null;
+}): react.JSX.Element;
+declare function StudioAcceptInvite({ url, anonKey }: {
+    url: string;
+    anonKey: string;
+}): react.JSX.Element;
+
+/** Account — My Profile · Change Password · Team · Business. Data is loaded by the site page; the tabs are client forms. */
+declare function StudioAccount({ me, manages, team, branding, myUserId, myRole }: {
+    me: {
+        email: string;
+        name: string | null;
+        displayName: string | null;
+        avatarUrl: string | null;
+    };
+    manages: boolean;
+    team: {
+        ok: true;
+        members: SiteMember[];
+        canInvite: boolean;
+    } | {
+        ok: false;
+        error: string;
+    } | null;
+    branding: SiteBranding | null;
+    myUserId: string;
+    myRole: string;
+}): react.JSX.Element;
+
+/**
+ * Client wrapper for any registered content type: ContentForm (client) →
+ * publishContent (server action). The registry entry holds functions and a
+ * zod schema, so it can't cross the server→client boundary — the page passes
+ * the type id and this component looks the entry up on the client.
+ */
+declare function ContentEditor({ typeId, initialValues, initialBody, existing, isNew, footer }: {
+    typeId: string;
+    initialValues?: Record<string, unknown>;
+    /** A brand-new item: the web address follows the title until it's edited by hand. */
+    isNew?: boolean;
+    initialBody?: string;
+    /** An open change for this file; saves go onto its branch (05c). */
+    existing?: {
+        number: number;
+        branch: string;
+        state: "checking" | "ready" | "failed";
+    } | null;
+    /** Rendered under the fields, above the save bar (e.g. Remove this post). */
+    footer?: React.ReactNode;
+}): react.JSX.Element;
+
+/**
+ * Take an item down. Quiet link → inline confirm → one change that deletes the
+ * file, reviewed and published like any other. Nothing disappears until Publish.
+ */
+declare function RemoveItem({ typeId, slug }: {
+    typeId: string;
+    slug: string;
+}): react.JSX.Element | null;
+
+/**
+ * Saved → Checking → Live, as a tracker, with one sentence of plain language
+ * under it and the Publish button that unlocks when the checks pass. Refreshes
+ * itself while checks are pending. Copy is load-bearing (see the brief).
+ */
+declare function PublishPanel({ number, htmlUrl, merged, closed, branch, removal, mergedSha, status, item }: {
+    number: number;
+    htmlUrl: string;
+    merged: boolean;
+    /** Closed without publishing — discarded here or on GitHub. */
+    closed?: boolean;
+    branch: string;
+    /** The change deletes the post instead of editing it. */
+    removal?: boolean;
+    /** Merge commit once published; lets the page confirm the deploy rather than guess. */
+    mergedSha?: string | null;
+    status: PullRequestStatus | null;
+    /** The item this change is about, resolved by the site page (Studio.readers.locate); null when it can't be. */
+    item: {
+        noun: string;
+        label: string;
+        typeId: string;
+        slug: string;
+        liveUrl: string | null;
+    } | null;
+}): react.JSX.Element;
+
+declare function StudioTerm({ children, definition }: {
+    children: ReactNode;
+    definition: string;
+}): react.JSX.Element;
+/** Studio's jargon, defined once. */
+declare const GLOSSARY: {
+    readonly pullRequest: "The safety step between you and the live website. When you save, your edit is set aside on GitHub (the service that stores your site) and the site is test-built with it first. Only when that passes can you press Publish and make it live. GitHub calls this a pull request — you never need to go there yourself.";
+    readonly repository: "Where your website actually lives: a private, backed-up folder on GitHub that keeps every version of every page. This list is read straight from it, so it's always current — even for items added outside Studio.";
+    readonly change: "Your edit while it's on its way to the live site. You save it, it gets checked, then you publish it. An item can have one change in progress at a time, and you can come back to it whenever you like.";
+    readonly checks: "A practice run. The whole website is rebuilt with your edit in it, to make sure nothing broke — a missing field, a picture that isn't there. If something's wrong you find out here, not on the live site.";
+    readonly publish: "Makes your checked edit live for everyone. Takes about two minutes to appear on the website.";
+};
+declare function Jargon({ term, children }: {
+    term: keyof typeof GLOSSARY;
+    children: ReactNode;
+}): react.JSX.Element;
+
+/**
+ * The words a list and editor use for a content type. Posts keep the exact
+ * strings Studio shipped with; any other type reads from its registry label
+ * and singular so a new type needs no new copy.
+ */
+declare function copyFor(entry: Pick<ContentTypeEntry, "id" | "label" | "singular">): {
+    newItem: string;
+    empty: string;
+    first: string;
+    removeLink: string;
+    removeConfirm: string;
+    removing: string;
+    newSubtitle: string;
+};
+
+/** Studio's page styles (lists, account tabs, drop zones) — injected once by StudioShellFrame. */
+declare const STUDIO_CSS = "\n/*\n * /admin \u2014 overrides only. Layout, colour and components come from\n * @realiizlabs/admin/shell (SHELL_CSS, injected by AdminShell). The Realiiz\n * palette is the package default, so this file just maps the shell's font\n * hooks onto the site's loaded fonts. To rebrand, redeclare tokens here:\n *   .rz-admin { --signal: #0a58ca; }\n */\n.rz-admin {\n  --rz-font: var(--font-inter), system-ui, sans-serif;\n  --rz-font-display: var(--font-space-grotesk), system-ui, sans-serif;\n  --rz-font-mono: var(--font-jetbrains-mono), ui-monospace, monospace;\n}\n\n/* Posts table: one wide column for the post (title, slug beneath in small mono) and\n   tight fixed columns for the known-width bits. Nothing wraps; the title and slug end in\n   an ellipsis with the full text as tooltip. The title opens the live post; the outbound\n   arrow sits inline after it and appears on hover (the shell's a:hover .rz-arrow motion). */\n.rz-admin .rz-table--posts { table-layout: fixed; width: 100%; }\n.rz-admin .rz-table--posts td, .rz-admin .rz-table--posts th { white-space: nowrap; overflow: hidden; }\n.rz-admin .rz-col-title { width: auto; }\n.rz-admin .rz-col-date { width: 7.5rem; }\n.rz-admin .rz-col-status { width: 11.5rem; }\n.rz-admin .rz-col-actions { width: 8.5rem; }\n.rz-admin .rz-title-text { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }\n.rz-admin .rz-slug { font-family: var(--rz-font-mono); font-size: .78rem; margin-top: .2rem; }\n.rz-admin [data-slugs=\"off\"] .rz-slug { display: none; }\n.rz-admin .rz-toolbar { display: flex; justify-content: flex-end; margin: 0 0 .6rem; }\n.rz-admin .rz-switch { display: inline-flex; align-items: center; gap: .55rem; font-size: .8rem; color: var(--text-secondary); cursor: pointer; user-select: none; }\n.rz-admin .rz-switch input { position: absolute; opacity: 0; width: 1px; height: 1px; }\n.rz-admin .rz-switch__track { position: relative; width: 30px; height: 18px; border-radius: 999px; background: var(--surface-3); transition: background .15s; }\n.rz-admin .rz-switch__thumb { position: absolute; top: 2px; left: 2px; width: 14px; height: 14px; border-radius: 50%; background: #fff; box-shadow: 0 1px 2px rgba(0,0,0,.25); transition: transform .15s; }\n.rz-admin .rz-switch input:checked + .rz-switch__track { background: var(--signal); }\n.rz-admin .rz-switch input:checked + .rz-switch__track .rz-switch__thumb { transform: translateX(12px); }\n.rz-admin .rz-switch input:focus-visible + .rz-switch__track { outline: 2px solid var(--signal); outline-offset: 2px; }\n.rz-admin .rz-switch:hover .rz-switch__label { color: var(--text-primary); }\n.rz-admin .rz-title-link { display: flex; align-items: center; gap: .35em; max-width: 100%; color: inherit; text-decoration: none; }\n.rz-admin .rz-title-link .rz-arrow { opacity: 0; }\n.rz-admin .rz-title-link:hover { color: var(--signal); }\n.rz-admin .rz-title-link:hover .rz-arrow { opacity: 1; }\n@media (max-width: 720px) {\n  .rz-admin .rz-col-status { width: 9rem; }\n  .rz-admin .rz-col-actions { width: 6rem; }\n}\n\n/* Dashboard card for a section that isn't built yet: the real card, faded, buttons disabled. */\n/* Account page (05b): tracker-style \u2014 H1, email, underlined tabs, stacked form cards. */\n.rz-admin .acct-h1 { font-size: 1.25rem; font-weight: 600; margin: 0 0 .25rem; color: var(--text-primary); }\n.rz-admin .acct-email { font-size: .875rem; color: var(--text-muted); margin: 0 0 1.25rem; }\n.rz-admin .acct-stack { display: flex; flex-direction: column; gap: 1rem; max-width: 560px; }\n.rz-admin .acct-stack:has(.acct-team) { max-width: none; }\n.rz-admin .acct-card { display: flex; flex-direction: column; gap: .9rem; }\n.rz-admin .acct-title { font-size: 1rem; font-weight: 600; margin: 0; color: var(--text-primary); }\n.rz-admin .acct-blurb { font-size: .875rem; color: var(--text-secondary); margin: -.4rem 0 0; line-height: 1.5; }\n.rz-admin .acct-field { display: flex; flex-direction: column; gap: .35rem; }\n.rz-admin .acct-label { font-size: .85rem; font-weight: 500; color: var(--text-primary); }\n.rz-admin .acct-hint { font-size: .78rem; color: var(--text-muted); }\n.rz-admin .acct-input { font: inherit; font-size: .9rem; color: var(--text-primary); background: var(--surface-0); border: 1px solid var(--border); border-radius: 6px; padding: 9px 11px; min-height: 40px; width: 100%; }\n.rz-admin .acct-input:read-only { color: var(--text-secondary); background: var(--surface-2); }\n.rz-admin .acct-input:focus-visible { outline: 2px solid var(--signal); outline-offset: 1px; }\n.rz-admin .acct-select { width: auto; padding-right: 2rem; }\n.rz-admin .acct-select--sm { min-height: 32px; padding: 4px 28px 4px 8px; font-size: .8rem; }\n.rz-admin .acct-actions { display: flex; align-items: center; gap: 1rem; flex-wrap: wrap; }\n.rz-admin .acct-ok { font-size: .85rem; color: var(--signal); }\n.rz-admin .acct-link { font: inherit; font-size: .82rem; background: none; border: 0; padding: 0; color: var(--text-secondary); text-decoration: underline; text-underline-offset: 3px; cursor: pointer; }\n.rz-admin .acct-link:hover { color: var(--signal); }\n.rz-admin .acct-link--danger:hover { color: #c0392b; }\n.rz-admin .acct-link:disabled { opacity: .5; cursor: default; }\n.rz-admin .acct-team-head { display: flex; align-items: center; justify-content: space-between; gap: 1rem; flex-wrap: wrap; }\n.rz-admin .acct-invite__row { display: flex; gap: .6rem; align-items: center; flex-wrap: wrap; }\n.rz-admin .acct-invite__row .acct-input[type=\"email\"] { flex: 1 1 220px; width: auto; }\n.rz-admin .acct-person { display: flex; align-items: center; gap: .7rem; }\n.rz-admin .acct-person__avatar { width: 32px; height: 32px; border-radius: 50%; background: var(--surface-3); border: 1px solid var(--border); display: inline-flex; align-items: center; justify-content: center; font-size: .7rem; font-weight: 600; overflow: hidden; flex-shrink: 0; }\n.rz-admin .acct-person__avatar img { width: 100%; height: 100%; object-fit: cover; }\n.rz-admin .acct-person__text { display: flex; flex-direction: column; line-height: 1.25; }\n.rz-admin .acct-person__email { font-size: .78rem; }\n.rz-admin .acct-row-actions { display: flex; gap: .8rem; align-items: center; white-space: nowrap; min-height: 34px; }\n.rz-admin .acct-help-list { margin: 0; padding-left: 1.2rem; color: var(--text-secondary); line-height: 1.7; }\n\n/* Sign-in: the password option under the magic-link form. */\n.rz-admin .pwsi-toggle { margin: 1.1rem 0 0; text-align: center; }\n.rz-admin .pwsi { display: flex; flex-direction: column; gap: .9rem; margin-top: 1.25rem; padding-top: 1.25rem; border-top: 1px solid var(--separator); }\n\n/* Password boxes: eye toggle + the requirement checklist that lights up as each rule passes. */\n.rz-admin .acct-pw { position: relative; }\n.rz-admin .acct-pw .acct-input { padding-right: 2.6rem; }\n.rz-admin .acct-pw__eye { position: absolute; right: .5rem; top: 50%; transform: translateY(-50%); background: none; border: 0; padding: .35rem; color: var(--text-muted); cursor: pointer; display: inline-flex; border-radius: 4px; }\n.rz-admin .acct-pw__eye:hover, .rz-admin .acct-pw__eye[aria-pressed=\"true\"] { color: var(--text-secondary); }\n.rz-admin .acct-rules { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: .5rem; }\n.rz-admin .acct-rule { display: flex; align-items: center; gap: .5rem; font-size: .8125rem; color: var(--text-muted); transition: color .15s; }\n.rz-admin .acct-rule--met { color: var(--signal); }\n\n/* Picture uploader (avatar, logo, favicon): one grid everywhere \u2014 preview | buttons row, hint under the buttons. */\n.rz-admin .acct-pic { border: 1px dashed var(--border); border-radius: 8px; padding: 16px 18px; background: var(--surface-0); outline: none; transition: border-color .15s; }\n.rz-admin .acct-pic:focus-visible, .rz-admin .acct-pic--over { border-color: var(--signal); border-style: solid; }\n.rz-admin .acct-pic--busy { opacity: .7; }\n.rz-admin .acct-pic__file { display: none; }\n.rz-admin .acct-pic__empty { display: flex; align-items: center; gap: 14px; flex-wrap: wrap; color: var(--text-muted); }\n.rz-admin .acct-pic__fallback { width: 44px; height: 44px; flex-shrink: 0; display: inline-flex; align-items: center; justify-content: center; border-radius: 8px; background: var(--surface-3); color: var(--text-muted); font-size: .9rem; font-weight: 600; letter-spacing: .04em; }\n.rz-admin .acct-pic__fallback--circle { border-radius: 50%; }\n.rz-admin .acct-pic__or { font-size: .8125rem; }\n.rz-admin .acct-pic__has { display: flex; align-items: flex-start; gap: 16px; }\n.rz-admin .acct-pic__thumb { display: block; width: 96px; height: 96px; object-fit: cover; border-radius: 8px; border: 1px solid var(--border); background: var(--surface-3); flex-shrink: 0; }\n.rz-admin .acct-pic__thumb--circle { border-radius: 50%; }\n.rz-admin .acct-pic__meta { display: flex; flex-direction: column; gap: 10px; min-width: 0; }\n.rz-admin .acct-pic__actions { display: flex; align-items: center; gap: 14px; }\n.rz-admin .acct-pic__remove { font: inherit; font-size: .8125rem; background: none; border: 0; padding: 0; color: var(--text-muted); text-decoration: underline; text-underline-offset: 3px; cursor: pointer; }\n.rz-admin .acct-pic__remove:hover { color: #c0392b; }\n.rz-admin .acct-pic__remove:disabled { cursor: default; opacity: .6; }\n.rz-admin .acct-pic__hint { margin: 10px 0 0; font-size: .75rem; color: var(--text-muted); line-height: 1.4; }\n.rz-admin .acct-pic__has .acct-pic__hint { margin-top: 0; }\n.rz-admin .acct-pic__note { margin: 8px 0 0; }\n.rz-admin .acct-pic__error { margin: 8px 0 0; font-size: .8rem; color: #c0392b; }\n\n/* Branded dropdown (role pickers): a bordered button that opens the shell's menu, checkmark on the current choice. */\n.rz-admin .acct-dd { position: relative; display: inline-block; }\n.rz-admin .acct-dd__btn { display: inline-flex; align-items: center; gap: .5rem; font: inherit; font-size: .85rem; color: var(--text-primary); background: var(--surface-0); border: 1px solid var(--border); border-radius: 6px; padding: 0 .7rem; height: 34px; cursor: pointer; }\n.rz-admin .acct-dd__btn:hover { border-color: var(--text-muted); }\n.rz-admin .acct-dd__btn:focus-visible { outline: 2px solid var(--signal); outline-offset: 1px; }\n.rz-admin .acct-dd__btn:disabled { opacity: .6; cursor: default; }\n.rz-admin .acct-dd__menu { left: 0; right: auto; min-width: 15rem; padding: .3rem 0; }\n.rz-admin .acct-dd__item { align-items: flex-start; }\n.rz-admin .acct-dd__check { width: 1rem; flex-shrink: 0; color: var(--signal); font-weight: 700; }\n.rz-admin .acct-dd__text { display: flex; flex-direction: column; line-height: 1.3; }\n.rz-admin .acct-dd__hint { font-size: .74rem; color: var(--text-muted); }\n/* Team table: everything on one centre line, and the role menu may overflow the table (the shell\n   clips .rz-table for rounded corners, so round the header cells by hand instead). */\n.rz-admin .acct-team { overflow: visible; }\n.rz-admin .acct-team thead th:first-child { border-top-left-radius: 8px; }\n.rz-admin .acct-team thead th:last-child { border-top-right-radius: 8px; }\n.rz-admin .acct-team tbody tr:last-child td { border-bottom: 0; }\n.rz-admin .acct-team td { vertical-align: middle; }\n.rz-admin .acct-team td > * { vertical-align: middle; }\n.rz-admin .acct-team .rz-pill { position: relative; top: 0; }\n.rz-admin .acct-dd__menu { z-index: 60; }\n.rz-admin .acct-invite__row .acct-dd__btn { height: 40px; }\n\n.rz-admin .rz-term { position: relative; display: inline; }\n.rz-admin .rz-term__word { cursor: help; text-decoration: underline dotted; text-underline-offset: 4px; text-decoration-color: color-mix(in srgb, currentColor 50%, transparent); }\n.rz-admin .rz-term__word:hover, .rz-admin .rz-term__word:focus-visible { text-decoration-color: var(--signal); outline: none; }\n.rz-admin .rz-term__tip { position: absolute; left: 0; top: calc(100% + 8px); z-index: 70; width: 272px; max-width: 80vw; padding: 12px 14px; border-radius: 8px; background: var(--text-primary); color: var(--surface-0); font-size: .8125rem; line-height: 1.4; font-weight: 400; box-shadow: 0 8px 24px rgba(14,23,38,.18); opacity: 0; pointer-events: none; transition: opacity .15s; }\n.rz-admin .rz-term__tip--open { opacity: 1; }\n";
+
+/**
+ * Plain-English facts about how Studio works — the same text a site's help
+ * assistant reads. Generic: no site or agency names.
+ */
+declare const STUDIO_FACTS = "\nHOW REALIIZ STUDIO WORKS (the publishing dashboard at /admin)\n\nThe big picture: your website is stored as files in a private \"repository\" on GitHub (think: a version-controlled folder in the cloud that keeps every change ever made). Studio is a friendly front end over that folder. You never need to open GitHub \u2014 every action you take in Studio is one of these steps:\n\n1. SAVE. You edit a post and click \"Save and continue\" (or \"Save changes\"). Studio writes your post as a file and opens a \"change\" \u2014 GitHub calls this a pull request, or PR. Nothing on the live site changes yet. Think of it as a draft submitted for checking.\n2. CHECKS. The moment a change exists, the site builds a private test copy with your change in it, to make sure nothing breaks (a broken link tag, a missing required field, an image path that doesn't exist). This usually takes a minute or two. The change page shows a tracker: Saved \u2192 Checks \u2192 Published \u2192 Live, and refreshes itself.\n3. PUBLISH. When the checks pass the status becomes \"Ready to publish\" and the Publish button unlocks. A \"Preview the change\" button also appears: it opens a private copy of the website with your edit in it, so you can see exactly how the post will look before anyone else does. Clicking Publish sends your change to the live site.\n4. LIVE. The website then rebuilds itself with your change \u2014 usually about two minutes. The Live step keeps spinning until the rebuild is really done, and \"View the post\" unlocks at that moment. If you look at the website before the Live step turns green you will still see the old version; that's normal, not a failure.\n\nCONTENT TYPES: the sidebar lists every kind of content this site publishes \u2014 Blog posts and Speaking & Media (talks, panels, podcasts; shown at realiiz.com/speaking, upcoming first). Speaking items have a date, optional start/end time and time zone, a kind, a host, a place, links for details, the recording and slides, and \u2014 for Ed's own events \u2014 an RSVP link, capacity, \u201Csign-ups closed\u201D and \u201Cprivate\u201D (invited guests only; the event still shows but has no RSVP button). Each works the same way \u2014 a list, a New button, a form, Save, checks, Publish.\n\nSTATUSES you'll see in each list and on each item:\n- Live: what's on the website right now, no change waiting.\n- Checking\u2026: you saved; the test build is running. Wait a minute or two.\n- Ready to publish: checks passed; open the change and click Publish.\n- Needs fixing: the test build failed. Nothing was published. Open the post, fix the problem the message names, save again \u2014 the same change re-runs its checks.\n- New \u00B7 \u2026: a brand-new post that exists only in a change; it isn't on the live site until you publish.\n\nRULES OF THUMB:\n- One open change per post. Saving again while a change is waiting updates that same change (it doesn't create a second one). The sticky bar at the bottom of the editor tells you which change you're updating.\n- You can leave and come back: the posts table's Status column links to the change, and the post page shows a notice with a Publish button when a change is waiting.\n- Changed your mind? On the change page, \"Discard this change\" (with a confirm step) throws the unpublished edits away. The live site is untouched and the post goes back to Live.\n- \"View on GitHub\" opens the raw change for the curious; you never need it.\n- Only signed-in editors and owners can save or publish. Sign-in is by email link (no password).\n- If two people edit the same post, the second to publish is told the file changed first and asked to redo their edit on the latest version \u2014 nothing is silently overwritten.\n\nFIELDS on a blog post:\n- Title (H1): the headline at the top of the post. Can be long.\n- Web address (slug): the last part of the post's URL, e.g. my-first-post \u2192 realiiz.com/blog/my-first-post. Lowercase words joined by hyphens.\n- Excerpt: the short teaser shown on the blog listing page.\n- Publish date / Last updated: shown on the post and used for ordering; Last updated is optional, for revisions.\n- Author, Tags (exactly 3, lowercase-hyphenated), Header image (choose or drop a picture \u2014 see PICTURES below), Header image description (alt text for accessibility), Featured (pins the post).\n- Search & social group: Search title (what Google and the browser tab show \u2014 aim for 50\u201360 characters including the site name; blank means same as Title), Meta description (the snippet under the title in Google \u2014 aim for 120\u2013155 characters), Focus keyword (the phrase the post targets; used for SEO reporting, never shown), Social share image (the picture for social cards; blank reuses the hero image), Canonical (advanced; leave blank unless the article was published elsewhere first).\n- Post content: Markdown. The toolbar buttons toggle formatting on and off; Preview shows exactly how the blog will render it; the tooltip button wraps a selected term in a definition that appears on hover; Expand fills the window (Esc to come back).\n- Length gauges under the search fields: the green band is the target range; the fill turns green when you're inside it and red when you're over.\n\nPICTURES:\n- Choose a picture (or drag one in, or paste) for the header image, the social share image, or anywhere in the post content via the toolbar's picture button. JPG, PNG or WebP up to 10 MB; Studio shrinks it in your browser to a web-friendly WebP (about 1600 pixels wide, usually 100\u2013400 KB) before sending.\n- Nothing is uploaded when you pick \u2014 the pictures are saved together with the post when you press Save, into the same change, and go live with it when you Publish. Discarding a change discards its pictures too.\n- Pictures are named after the post's web address (slug), so fill that in first: the header image becomes /blog/<slug>.webp and pictures in the text go under /blog/<slug>/.\n- Preview shows new pictures before they're saved. The \"Preview the change\" link after the checks shows them on the real site design.\n\nACCOUNT (avatar menu \u2192 Account, or Settings in the sidebar):\n- My Profile: your photo, your name (shown in the greeting and to teammates) and \u201CName on blog posts\u201D \u2014 how you're credited as the author; blank means your full name. Your email is your login and can't be changed here \u2014 ask your web team.\n- Change Password: optional. Email links always work; a password is a second way in. At least 10 characters. On the sign-in page, \"Have a password? Sign in with it instead\" reveals the password form. Forgot your password? There's nothing to reset \u2014 sign in with an email link and set a new one under Settings \u2192 Change Password.\n- Team (owners only): who can sign in to this site. \"+ Invite someone\" sends an email link \u2014 no password needed. Editors write and publish; owners also manage the team and the business details. Pending invites can be resent or revoked; active people can be removed from this site (their login survives for any other site). A site always keeps at least one owner. Support staff aren't listed in a site's team \u2014 they can reach every site without being a member.\n- Business (owners only): your business name, contact email/phone, logo and favicon. Saving puts your name and logo at the top of Studio for everyone who signs in to your site \u2014 it never changes the public website.\n- Help (avatar menu): the help centre. For now it points here, to the Ask bubble; a full browsable guide is coming.\n";
+
+export { ACTION_NAMES, type ActionResult, ContentEditor, type DiscardOutcome, GLOSSARY, type ImagePayload, Jargon, type ListRow, type MergeOutcome, type PendingSummary, type PublishInput, PublishPanel, RemoveItem, STUDIO_CSS, STUDIO_FACTS, StudioAcceptInvite, StudioAccount, type StudioActions, type StudioContextValue, StudioDashboard, StudioEdit, StudioHelp, StudioList, StudioNew, StudioNoAccess, StudioNotConfigured, StudioProvider, StudioPullRequest, StudioShellFrame, StudioSignIn, StudioTerm, type TeamState, copyFor, publicDirOf, useEntry, useStudio };