@cloudgrid-io/ui 0.29.2 → 0.31.0

package/dist/blocks/install-content.js

@@ -0,0 +1,464 @@
+/**
+ * THE INSTALL CONTENT. Every tool, method, step, prompt and command CloudGrid's
+ * install panels show, as plain data.
+ *
+ * ## The package ships content now, and that reverses a rule (#266)
+ *
+ * Founder ruling, 2026-10-05: every install panel on every surface takes its
+ * content AND its design from this library, and from nowhere else. The previous
+ * source, a separate integrations app with its own embed script and content
+ * feed, is discontinued. The Console's `/drop` page and onboarding step, and
+ * later the landing site, assemble library pieces and fetch nothing.
+ *
+ * Until this ruling the line ran the other way: "the package ships none of this
+ * and must not start to" (the gallery fixture this file replaces), "presentation
+ * only" (`ToolSetup`), "this ships no marks" (`ToolLogo`). Those notes are
+ * updated in the same change. `ToolSetup` is still a presentational engine that
+ * renders whatever it is handed; what changed is that the library now also
+ * holds the thing it is handed, here, and composes the two in `CloudGridInstall`.
+ *
+ * ## No React, deliberately
+ *
+ * This module imports nothing. A body's emphasis is a RUN (`{ bold }`,
+ * `{ code }`), a vendor mark is a NAME (a `TOOL_MARKS` key), and a glyph is a
+ * ROLE (`"github"`, `"download"`). `CloudGridInstall` turns those into nodes.
+ * That keeps the strings importable by a consumer with no React at all, which
+ * is the Astro site: `import { INSTALL_TOOLS } from "@cloudgrid-io/ui/install-content"`.
+ *
+ * ## Verbatim, and tested to be
+ *
+ * Every title, body, prompt line, command and link is the content snapshot of
+ * 2026-10-05 (content version 36), with the shared commands substituted and
+ * `{agent}` replaced by the tool's display name. Nothing is paraphrased, and one
+ * prompt keeps its em dash, which the library's own copy canon would not write:
+ * it is the panel's string, and changing it here would make this file disagree
+ * with what every surface showed until today. `test/install-content.test.mjs`
+ * walks the committed snapshot and asserts each string below equals it, and that
+ * nothing in the snapshot is missing here.
+ *
+ * Editing a string is now a library change: edit it here, update the fixture in
+ * the same change so the test describes what ships, bump
+ * `INSTALL_CONTENT_VERSION`, and release.
+ *
+ * ## The prompt grammar
+ *
+ * A step's `prompt` is a string in `PromptBlock`'s grammar: a backticked run is
+ * a literal (a command, a JSON blob), and a line starting with `~` is the closing
+ * aside to the agent, dimmed on screen. Both marks are consumed by
+ * `PromptBlock`; the aside's words are copied with the rest (founder ruling
+ * 2026-10-05), the marks themselves are not.
+ */
+/** Which snapshot of the content this is. Bump it with any string edit. */
+export const INSTALL_CONTENT_VERSION = 36;
+/**
+ * The commands every pane shares, resolved. A command changes in one place:
+ * every step below reads it from here.
+ */
+export const INSTALL_COMMANDS = {
+    MCP_NPX: "npx -y @cloudgrid-io/mcp",
+    MCP_JSON: '{ "mcpServers": { "cloudgrid": { "command": "npx", "args": ["-y", "@cloudgrid-io/mcp"] } } }',
+    MCP_CONNECTOR_URL: "https://mcp-connected.cloudgrid.io/mcp",
+    CLI_INSTALL: "npm install -g @cloudgrid-io/cli",
+    SKILLS_REPO: "https://github.com/cloudgrid-io/skills.git",
+    SKILLS_ZIP: "https://github.com/cloudgrid-io/skills/archive/refs/heads/main.zip",
+};
+const { MCP_NPX, MCP_JSON, MCP_CONNECTOR_URL, CLI_INSTALL, SKILLS_REPO, SKILLS_ZIP } = INSTALL_COMMANDS;
+export const INSTALL_METHODS = [
+    { value: "mcp", label: "MCP" },
+    { value: "cli", label: "CLI" },
+    { value: "skills", label: "Skills" },
+];
+export const INSTALL_GROUPS = [
+    { value: "code", label: "Coding agents", icon: "terminal" },
+    { value: "chat", label: "Chat apps", icon: "chat" },
+];
+/**
+ * The panel's own heading. The title is a founder ruling of 2026-10-05; the sub
+ * is the line this library's install specimen has carried since #262.
+ *
+ * The integrations app's marketing headline ("CloudGrid MCP & CLI for any AI")
+ * and its wordmark and logo row are NOT here. They were a marketing page's hero,
+ * the library rejected them in #262, and the Console removed them in #758.
+ */
+export const INSTALL_HEADING = {
+    title: "Plug CloudGrid into your AI tool",
+    sub: "Pick how you want to connect, then the tool you work in",
+};
+/** The "Not sure?" line under the panel: one command an agent can act on. */
+export const INSTALL_FETCH_PROMPT = {
+    intro: "Not sure? Copy this prompt and paste it to your AI agent.",
+    command: "fetch https://cloudgrid.io/agents to plug",
+};
+/** The source line under the panel. */
+export const INSTALL_FOOTER = {
+    note: "Every method here connects to the same CloudGrid.",
+    links: [
+        { label: "Plugin & skills", href: "https://github.com/cloudgrid-io/skills", icon: "github" },
+        { label: "MCP server", href: "https://github.com/cloudgrid-io/mcp", icon: "github" },
+    ],
+};
+// ---- shared steps --------------------------------------------------------
+//
+// Helpers only where the snapshot itself repeats a string word for word across
+// tools. Each one takes exactly the parts that differ.
+/** The CLI pane's prompt. Only step 3 (and Claude Code's step 4) differ by tool. */
+const cliPrompt = (skillsSteps) => [
+    "Set up CloudGrid for me so I can build and plug apps from here.",
+    `1. Install the CLI: run \`${CLI_INSTALL}\`.`,
+    "2. Authenticate: run `grid login` and complete the sign-in in the browser it opens.",
+    skillsSteps,
+    "~Once that's done, let me know when it's ready.",
+].join("\n");
+const cliRecommended = (agent, skillsSteps) => ({
+    label: "Recommended",
+    title: `Copy and send this to ${agent}`,
+    body: ["It sets up the CLI and the skills together, the pair we recommend."],
+    prompt: cliPrompt(skillsSteps),
+});
+/** The `Or` column of every CLI pane: the same for every tool. */
+const cliManual = {
+    label: "Or",
+    title: "Do it yourself",
+    body: ["Paste this in your terminal, then ", { code: "grid login" }, " to sign in."],
+    code: CLI_INSTALL,
+};
+/** The one-prompt skills pane the four `npx skills` tools share. */
+const skillsRecommended = (agent, skillsAgent) => ({
+    label: "Recommended",
+    title: `Copy and send this to ${agent}`,
+    body: ["One prompt. It installs the skills for you."],
+    prompt: [
+        `Run this command to install the CloudGrid skills: \`npx skills add cloudgrid-io/skills -g -a ${skillsAgent}\`.`,
+        "~Show me what was installed when it's done.",
+    ].join("\n"),
+});
+/** The `Or` column of every skills pane: clone the repo, or take the zip. */
+const skillsManual = (agent, folder) => ({
+    label: "Or",
+    title: "Clone or download",
+    body: [
+        "Drop every folder containing a SKILL.md into ",
+        { bold: folder },
+        `, then restart ${agent}.`,
+    ],
+    code: `git clone ${SKILLS_REPO}`,
+    link: { label: "Download skills", href: SKILLS_ZIP, icon: "download", primary: true },
+});
+const mcpTellMe = "~Tell me when CloudGrid is connected, then ask me what to build.";
+/**
+ * The seven tools, in the snapshot's order: five coding agents, then the two
+ * chat apps. The chat apps are MCP only, because there is no terminal to run a
+ * CLI in and nowhere to put skill files.
+ */
+export const INSTALL_TOOLS = [
+    {
+        value: "claude-code",
+        label: "Claude Code",
+        mark: "Claude Code",
+        group: "code",
+        steps: {
+            mcp: [
+                {
+                    label: "Easiest",
+                    title: "Copy and send this to Claude Code",
+                    body: ["Claude Code can install it for you. Nothing to type in the terminal."],
+                    prompt: [
+                        "Install the CloudGrid MCP server for me.",
+                        "Add an MCP server called cloudgrid that runs this command:",
+                        `\`${MCP_NPX}\``,
+                        "Then restart yourself so it loads.",
+                        mcpTellMe,
+                    ].join("\n"),
+                },
+                {
+                    label: "Or",
+                    title: "Do it yourself",
+                    body: [
+                        "Add an MCP server in Claude Code and paste this as the command. If your terminal knows the ",
+                        { bold: "claude" },
+                        " command, ",
+                        { bold: `claude mcp add cloudgrid -- ${MCP_NPX}` },
+                        " does the same.",
+                    ],
+                    code: MCP_NPX,
+                },
+            ],
+            cli: [
+                cliRecommended("Claude Code", [
+                    "3. Install the companion skills: run `claude plugin marketplace add cloudgrid-io/skills`, then `claude plugin install cloudgrid@cloudgrid-skills`.",
+                    `4. If the \`claude\` command isn't available, clone ${SKILLS_REPO} to a temp folder instead, copy every folder containing a SKILL.md into ~/.claude/skills/, and clean up.`,
+                ].join("\n")),
+                cliManual,
+            ],
+            skills: [
+                {
+                    label: "Recommended",
+                    title: "Copy and send this to Claude Code",
+                    body: ["It installs the skills, with a fallback if the plugin route isn't available."],
+                    prompt: [
+                        "Install the CloudGrid skills for Claude Code:",
+                        "1. Run `claude plugin marketplace add cloudgrid-io/skills`, then `claude plugin install cloudgrid@cloudgrid-skills`.",
+                        `2. If the \`claude\` command isn't available, clone ${SKILLS_REPO} to a temp folder instead, copy every folder containing a SKILL.md into ~/.claude/skills/, and clean up.`,
+                        // The em dash is the snapshot's. Verbatim beats the copy canon here;
+                        // see the module docblock.
+                        "3. Show me what was installed, then remind me to start a NEW conversation — skills only load when a session starts.",
+                    ].join("\n"),
+                },
+                skillsManual("Claude Code", "~/.claude/skills"),
+            ],
+        },
+    },
+    {
+        value: "cursor",
+        label: "Cursor",
+        mark: "Cursor",
+        group: "code",
+        steps: {
+            mcp: [
+                {
+                    label: "Easiest",
+                    title: "Copy and send this to Cursor",
+                    body: ["Cursor can install it for you. No settings to open."],
+                    prompt: [
+                        "Install the CloudGrid MCP server for me.",
+                        "Add this to my MCP config, keeping anything already in there:",
+                        `\`${MCP_JSON}\``,
+                        "Then reload the MCP servers.",
+                        mcpTellMe,
+                    ].join("\n"),
+                },
+                {
+                    label: "Or",
+                    title: "Do it yourself",
+                    body: ["Click ", { bold: "Settings → MCP → Add new server" }, ", paste this in, then save."],
+                    code: MCP_JSON,
+                },
+            ],
+            cli: [
+                cliRecommended("Cursor", "3. Install the companion skills: run `npx skills add cloudgrid-io/skills -g -a cursor`."),
+                cliManual,
+            ],
+            skills: [skillsRecommended("Cursor", "cursor"), skillsManual("Cursor", "~/.cursor/skills")],
+        },
+    },
+    {
+        value: "codex",
+        label: "Codex",
+        mark: "Codex",
+        group: "code",
+        steps: {
+            mcp: [
+                {
+                    label: "Easiest",
+                    title: "Copy and send this to Codex",
+                    body: ["Codex can install it for you. Nothing to type in the terminal."],
+                    prompt: [
+                        "Install the CloudGrid MCP server for me.",
+                        "Run this for me:",
+                        `\`codex mcp add cloudgrid -- ${MCP_NPX}\``,
+                        mcpTellMe,
+                    ].join("\n"),
+                },
+                {
+                    label: "Or",
+                    title: "Do it yourself",
+                    body: ["Paste this in your terminal. Codex saves it for you."],
+                    code: `codex mcp add cloudgrid -- ${MCP_NPX}`,
+                },
+            ],
+            cli: [
+                cliRecommended("Codex", "3. Install the companion skills: run `npx skills add cloudgrid-io/skills -g -a codex`."),
+                cliManual,
+            ],
+            skills: [skillsRecommended("Codex", "codex"), skillsManual("Codex", "~/.codex/skills")],
+        },
+    },
+    {
+        value: "antigravity",
+        label: "Antigravity",
+        mark: "Antigravity",
+        group: "code",
+        steps: {
+            mcp: [
+                {
+                    label: "Easiest",
+                    title: "Copy and send this to Antigravity",
+                    body: ["Antigravity can install it for you. No settings to open."],
+                    prompt: [
+                        "Install the CloudGrid MCP server for me.",
+                        "Add this to my mcp_config.json, keeping anything already in there:",
+                        `\`${MCP_JSON}\``,
+                        "Then refresh the MCP servers.",
+                        mcpTellMe,
+                    ].join("\n"),
+                },
+                {
+                    label: "Or",
+                    title: "Do it yourself",
+                    body: [
+                        "Click ",
+                        { bold: "Settings → Customizations → Open MCP Config" },
+                        ", paste this in, then hit Refresh.",
+                    ],
+                    code: MCP_JSON,
+                },
+            ],
+            cli: [
+                cliRecommended("Antigravity", "3. Install the companion skills: run `npx skills add cloudgrid-io/skills -g -a antigravity`."),
+                cliManual,
+            ],
+            skills: [
+                skillsRecommended("Antigravity", "antigravity"),
+                skillsManual("Antigravity", "~/.gemini/antigravity/skills"),
+            ],
+        },
+    },
+    {
+        value: "gemini",
+        label: "Gemini CLI",
+        mark: "Google Gemini",
+        group: "code",
+        steps: {
+            mcp: [
+                {
+                    label: "Easiest",
+                    title: "Copy and send this to Gemini CLI",
+                    body: ["Gemini can install it for you. Nothing to type in the terminal."],
+                    prompt: [
+                        "Install the CloudGrid MCP server for me.",
+                        "Run this for me:",
+                        `\`gemini mcp add cloudgrid ${MCP_NPX}\``,
+                        mcpTellMe,
+                    ].join("\n"),
+                },
+                {
+                    label: "Or",
+                    title: "Do it yourself",
+                    body: ["Paste this in your terminal. Gemini saves it for you."],
+                    code: `gemini mcp add cloudgrid ${MCP_NPX}`,
+                },
+            ],
+            cli: [
+                // `gemini-cli` is the skills installer's agent name, not this tool's
+                // value. The value is `gemini`.
+                cliRecommended("Gemini CLI", "3. Install the companion skills: run `npx skills add cloudgrid-io/skills -g -a gemini-cli`."),
+                cliManual,
+            ],
+            skills: [
+                skillsRecommended("Gemini CLI", "gemini-cli"),
+                skillsManual("Gemini CLI", "~/.gemini/skills"),
+            ],
+        },
+    },
+    {
+        value: "chatgpt",
+        label: "ChatGPT",
+        mark: "ChatGPT",
+        group: "chat",
+        steps: {
+            mcp: [
+                {
+                    title: "Turn on Developer Mode",
+                    body: [
+                        "Click ",
+                        { bold: "Settings → Apps and Connectors → Advanced" },
+                        ". Needs a paid plan.",
+                    ],
+                },
+                {
+                    title: "Paste this link in",
+                    body: ["Click ", { bold: "Connectors → Create" }, ", paste it, then sign in."],
+                    code: MCP_CONNECTOR_URL,
+                },
+            ],
+        },
+    },
+    {
+        value: "claude-web",
+        label: "Claude",
+        mark: "Claude",
+        group: "chat",
+        steps: {
+            mcp: [
+                {
+                    title: "Open your connectors",
+                    body: ["Click ", { bold: "Customize → Connectors → Add custom connector" }, "."],
+                    link: {
+                        label: "Take me there",
+                        href: "https://claude.ai/settings/connectors",
+                        icon: "external",
+                    },
+                },
+                {
+                    title: "Paste this link in",
+                    body: ["Sign in when it asks, so your work is saved to you."],
+                    code: MCP_CONNECTOR_URL,
+                },
+            ],
+        },
+    },
+];
+const ALL_TOOLS = INSTALL_TOOLS.map((t) => t.value);
+const ALL_METHODS = INSTALL_METHODS.map((m) => m.value);
+const CODING_AGENTS = INSTALL_TOOLS.filter((t) => t.group === "code").map((t) => t.value);
+const CHAT_APPS = INSTALL_TOOLS.filter((t) => t.group === "chat").map((t) => t.value);
+/** Everything, which is also what `CloudGridInstall` renders with no props. */
+const EVERYTHING = {
+    tools: ALL_TOOLS,
+    methods: ALL_METHODS,
+    defaultTool: "claude-code",
+    defaultMethod: "mcp",
+    showFetchPrompt: true,
+    showFooter: true,
+};
+/**
+ * The named configurations, one per former panel block. The block each one
+ * replaces is named beside it so a surface migrating off the old embed can find
+ * its own.
+ */
+export const INSTALL_PRESETS = {
+    /** Block `integrations-hub`, which the old panel titled "Onboarding". The full panel. */
+    hub: EVERYTHING,
+    /** The Console's onboarding install step. It read `integrations-hub`, so it is `hub`. */
+    onboarding: EVERYTHING,
+    /** Block `console-new`: the Console's `/drop` page. The same seven tools, every method. */
+    console: EVERYTHING,
+    /** Block `make-game`: every tool and method, fetch prompt and footer. */
+    makeGame: EVERYTHING,
+    /** Block `make-app-agent`: the five coding agents only. */
+    makeAppAgent: { ...EVERYTHING, tools: CODING_AGENTS },
+    /** Block `make-deck-page`: the two chat apps, MCP only, no footer. */
+    makeDeckPage: {
+        tools: CHAT_APPS,
+        methods: ["mcp"],
+        defaultTool: "chatgpt",
+        defaultMethod: "mcp",
+        showFetchPrompt: true,
+        showFooter: false,
+    },
+};
+/**
+ * A single tool's panel: blocks `install-claude-code`, `install-cursor`,
+ * `install-codex`, `install-antigravity`, `install-gemini`, `install-chatgpt`
+ * and `install-claude` (whose tool is `claude-web`).
+ *
+ * The methods are the ones the tool has steps for, so ChatGPT and Claude get MCP
+ * alone, and a single method draws no method control. No fetch prompt and no
+ * footer: the old single-tool blocks had neither.
+ *
+ * The fetch-prompt block, the thirteenth, is not a panel at all. It is
+ * `CloudGridFetchPrompt` with `showIntro={false}`.
+ */
+export function installToolPreset(tool) {
+    const entry = INSTALL_TOOLS.find((t) => t.value === tool);
+    const methods = ALL_METHODS.filter((m) => (entry?.steps[m]?.length ?? 0) > 0);
+    return {
+        tools: [tool],
+        methods,
+        defaultTool: tool,
+        defaultMethod: methods[0],
+        showFetchPrompt: false,
+        showFooter: false,
+    };
+}
+//# sourceMappingURL=install-content.js.map

package/dist/blocks/install-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-content.js","sourceRoot":"","sources":["../../src/blocks/install-content.ts"],"names":[],"mappings":"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"}

package/dist/blocks/logo.d.ts

@@ -1,3 +1,17 @@
+/**
+ * THE SOCKET GLYPH: the "o" of the wordmark, drawn as a three-pin socket face.
+ *
+ * One string, and the only copy of it in this repo. `Logo` draws it as the
+ * wordmark's sixth letter and `LogoMark` draws it alone inside a rounded square
+ * (#267), so the sign and the wordmark can never disagree about its shape. The
+ * favicon files under `src/brand/` are generated FROM this constant by
+ * `scripts/generate-brand-mark.mjs`, which reads it out of this file; keep it a
+ * single plain string literal on one line, or the generator cannot find it.
+ *
+ * VERBATIM from the brand asset, like every path in `Logo`. Never redraw it and
+ * never hand-edit it: if the glyph changes, replace it from the source SVG.
+ */
+declare const SOCKET_GLYPH_PATH = "M73.507 15.918C79.2174 15.918 83.9637 17.7685 87.6718 21.3962C91.4541 25.0239 93.3088 29.6883 93.3088 35.4631C93.3088 41.2378 91.454 45.9761 87.6718 49.6038C85.0356 52.1829 81.8742 53.8602 78.215 54.6154C77.054 54.855 76.0252 53.9204 76.0252 52.7349V47.5482C76.0252 46.6336 76.6575 45.8569 77.493 45.4848C81.0368 43.9067 83.2962 40.1577 83.2962 35.4872C83.2962 34.0556 83.0947 32.7167 82.7167 31.5015C82.5932 31.1043 82.2168 30.8479 81.8008 30.8479H80.8927V27.1501C80.8923 25.785 79.7842 24.6784 78.4167 24.6783C77.0492 24.6783 75.941 25.785 75.9407 27.1501V30.8479H71.3901V27.1501C71.3897 25.785 70.2801 24.6783 68.9126 24.6783C67.5454 24.6787 66.4369 25.7852 66.4366 27.1501V30.8479H65.2899C64.88 30.8479 64.5075 31.0968 64.381 31.4867C63.9866 32.7028 63.7916 34.0384 63.7916 35.4872C63.7916 38.5967 64.6821 41.188 66.5362 43.261C67.4434 44.239 68.4572 44.9856 69.5949 45.4935C70.4337 45.868 71.0717 46.6457 71.0717 47.5643V52.7493C71.0717 53.9323 70.0469 54.8663 68.8877 54.6302C65.2186 53.8826 62.07 52.2003 59.416 49.6038C55.708 45.9761 53.8545 41.2377 53.8545 35.4631C53.8545 29.6884 55.708 25.0239 59.416 21.3962C63.1241 17.7685 67.7966 15.918 73.507 15.918Z";
 /**
  * The CloudGrid wordmark.
  *
@@ -20,5 +34,60 @@ declare function Logo({ height, label, className, ...props }: Omit<React.Compone
     /** Accessible name. Set to "" when an adjacent text label already names it. */
     label?: string;
 }): import("react").JSX.Element;
-export { Logo };
+/**
+ * The two colourways of the sign. Each entry is a fill utility over a token.
+ *
+ * `brand` is the landing site's favicon: a purple square with the glyph in
+ * white. `inverted` is the Console's tab icon (#267, founder 2026-10-05): a
+ * white square with the glyph in purple.
+ *
+ * Both read `--cg-primary` and `--cg-text-on-primary`, the brand fill and the
+ * colour that sits on it. Neither is redeclared on the panel or ink surfaces,
+ * so the sign is the same picture everywhere — which is right for a brand mark,
+ * and the identity tile's rule: a picture does not flip.
+ *
+ * `inverted` also carries an EDGE, `--cg-border-control` (`stroke-line`): the
+ * brand's control border, the darkest of its light borders and the one drawn to
+ * read on a white page. The brand variant has none; a purple tile has its own
+ * edge. Unlike the two fills, the border tokens ARE redeclared per surface, so
+ * the svg declares `data-theme="default"` (see `LogoMark`) to keep the edge the
+ * same value everywhere, matching the generated file.
+ */
+declare const MARK_TONE: {
+    readonly brand: {
+        readonly square: "fill-brand";
+        readonly glyph: "fill-on-primary";
+        readonly edge: null;
+    };
+    readonly inverted: {
+        readonly square: "fill-on-primary";
+        readonly glyph: "fill-brand";
+        readonly edge: "stroke-line";
+    };
+};
+type LogoMarkTone = keyof typeof MARK_TONE;
+/**
+ * The CloudGrid sign: the wordmark's socket glyph alone in a rounded square.
+ *
+ * The same artwork as the favicon files this package ships under
+ * `@cloudgrid-io/ui/brand/*`, drawn from the same constant (`SOCKET_GLYPH_PATH`)
+ * that `Logo` draws its "o" from. Use the component inside a page; use the files
+ * where a URL is needed — a `<link rel="icon">`, a manifest, an og image.
+ *
+ * `tone` picks the colourway. `brand` (the default) is purple with a white
+ * glyph; `inverted` is white with a purple glyph, which is what the Console's
+ * browser tab wears. The inverted square carries a hairline edge inside its
+ * box (`MARK_EDGE_WIDTH`), so the white tile still reads as a tile on a white
+ * browser tab — founder ruling on review of #267.
+ */
+declare function LogoMark({ size, tone, label, className, ...props }: Omit<React.ComponentProps<"svg">, "ref"> & {
+    /** Rendered width and height in px. The sign is square. */
+    size?: number;
+    /** `brand`: purple square, white glyph. `inverted`: white square, purple glyph. */
+    tone?: LogoMarkTone;
+    /** Accessible name. Set to "" when an adjacent text label already names it. */
+    label?: string;
+}): import("react").JSX.Element;
+export { Logo, LogoMark, SOCKET_GLYPH_PATH };
+export type { LogoMarkTone };
 //# sourceMappingURL=logo.d.ts.map

package/dist/blocks/logo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/blocks/logo.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,IAAI,CAAC,EACZ,MAAW,EACX,KAAmB,EACnB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG;IAC5C,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,+BAqCA;AAED,OAAO,EAAE,IAAI,EAAE,CAAA"}
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/blocks/logo.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,iBAAiB,kpCAAkpC,CAAA;AAsBzqC;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,IAAI,CAAC,EACZ,MAAW,EACX,KAAmB,EACnB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG;IAC5C,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,+BAsCA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;CAGL,CAAA;AAEV,KAAK,YAAY,GAAG,MAAM,OAAO,SAAS,CAAA;AAE1C;;;;;;;;;;;;;GAaG;AACH,iBAAS,QAAQ,CAAC,EAChB,IAAS,EACT,IAAc,EACd,KAAmB,EACnB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG;IAC5C,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,+BAwCA;AAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,CAAA"}