@cloudgrid-io/ui 0.30.0 → 0.31.0

package/README.md

@@ -93,6 +93,29 @@ what `text-ink` is doing above. Borders and backgrounds flip on their own. Text
 There is no dark mode here, and this is not a substitute for one. Dark surfaces are a
 property of a container, never a page-level theme.
 
+## The install panel
+
+Every CloudGrid install panel comes from this package, content and design both. Nothing is
+fetched.
+
+```tsx
+import { CloudGridInstall, INSTALL_PRESETS, installToolPreset } from "@cloudgrid-io/ui"
+
+<CloudGridInstall />                                    // the whole panel
+<CloudGridInstall preset={INSTALL_PRESETS.onboarding} onValueChange={recordTool} />
+<CloudGridInstall preset={installToolPreset("cursor")} />
+```
+
+There are no props for the words. A page chooses what is on screen (`tools`, `methods`,
+`defaultTool`, `defaultMethod`, `showFetchPrompt`, `showFooter`, or a `preset`) and what only
+it can know (the selected tool and method, the heading level, a Continue action). Tool values
+are stable identifiers, safe to record: `claude-code`, `cursor`, `codex`, `antigravity`,
+`gemini`, `chatgpt`, `claude-web`.
+
+`CloudGridFetchPrompt` and `CloudGridInstallFooter` render on their own. Without React, take the
+strings from `@cloudgrid-io/ui/install-content` (`INSTALL_TOOLS`, `INSTALL_COMMANDS` and the
+rest).
+
 ## Entry points
 
 | | |
@@ -104,9 +127,49 @@ property of a container, never a page-level theme.
 | `@cloudgrid-io/ui/fonts.css` | the three self-hosted families |
 | `@cloudgrid-io/ui/prose.css` | long-form text |
 | `@cloudgrid-io/ui/tokens.json` | the same values, machine-readable |
+| `@cloudgrid-io/ui/install-content` | the install content as plain data, no React |
 
 The JSON sets under `tokens/` are DTCG and are the source the CSS is compiled from.
 
+## The CloudGrid sign as files
+
+The socket glyph in a rounded square, as static files for a browser tab, a home screen or
+a web manifest. Two colourways: `mark` is the brand sign (purple square, white glyph, what
+the site uses) and `mark-inverted` is white with a purple glyph (what the Console's tab uses).
+
+| | |
+|---|---|
+| `@cloudgrid-io/ui/brand/mark.svg` | SVG favicon, purple |
+| `@cloudgrid-io/ui/brand/mark-inverted.svg` | SVG favicon, white |
+| `@cloudgrid-io/ui/brand/mark-32.png`, `mark-inverted-32.png` | PNG favicon fallback |
+| `@cloudgrid-io/ui/brand/mark-180.png`, `mark-inverted-180.png` | `apple-touch-icon`, full bleed: iOS rounds it |
+| `@cloudgrid-io/ui/brand/mark-192.png`, `mark-inverted-192.png` | web manifest |
+| `@cloudgrid-io/ui/brand/mark-512.png`, `mark-inverted-512.png` | web manifest |
+
+A browser needs a URL, so copy them into your public folder or import them through your
+bundler:
+
+```tsx
+// Next.js app router, e.g. app/layout.tsx
+import favicon from "@cloudgrid-io/ui/brand/mark-inverted.svg"
+import appleTouch from "@cloudgrid-io/ui/brand/mark-inverted-180.png"
+
+export const metadata = {
+  title: "CloudGrid",
+  icons: { icon: favicon.src, apple: appleTouch.src },
+}
+```
+
+```html
+<link rel="icon" href="/mark-inverted.svg" type="image/svg+xml">
+<link rel="icon" href="/mark-inverted-32.png" sizes="32x32" type="image/png">
+<link rel="apple-touch-icon" href="/mark-inverted-180.png">
+```
+
+Inside a page, use the component instead: `<LogoMark tone="inverted" size={32} />`. It draws
+the same glyph from the same constant as `Logo`, and the files are generated from that
+constant and the brand token by `scripts/generate-brand-mark.mjs`, so the three cannot drift.
+
 ## Versioning
 
 Semver. Token value changes are minor; removals are major.

package/dist/blocks/cloudgrid-install.d.ts

@@ -0,0 +1,67 @@
+import * as React from "react";
+import { type InstallFilter, type InstallMethodValue, type InstallToolValue } from "./install-content.js";
+import { PageHeading } from "./page-heading.js";
+import { type ToolSetupGroup, type ToolSetupTool } from "./tool-setup.js";
+/**
+ * The content's tools as `ToolSetup` takes them, in the order asked for, with
+ * every vendor mark and every body rendered.
+ *
+ * Exported for a page that composes `ToolSetup` itself, which is what the
+ * library gallery's `ToolSetup` specimens do. A method missing from `methods`
+ * is dropped from each tool, so a tool with nothing left leaves the strip.
+ *
+ * 15px marks, which is what the strip draws. A mark carries no size of its own,
+ * so every call site states one.
+ */
+export declare function installSetupTools(tools?: readonly InstallToolValue[], methods?: readonly InstallMethodValue[]): ToolSetupTool[];
+/** The two runs, each drawn as its glyph and named by its words. */
+export declare function installSetupGroups(): ToolSetupGroup[];
+/**
+ * "Not sure? Copy this prompt and paste it to your AI agent." over the one
+ * command an agent can act on.
+ *
+ * The outline pill, as the Console drew it under the panel, so it reads the
+ * surface it sits on. `showIntro={false}` is the standalone pill, which is what
+ * the old `fetch-prompt` block was.
+ */
+declare function CloudGridFetchPrompt({ showIntro, ...props }: Omit<React.ComponentProps<"div">, "ref" | "children"> & {
+    /** The "Not sure?" line over the pill. */
+    showIntro?: boolean;
+}): React.JSX.Element;
+/**
+ * The source line: one sentence, then the two repositories.
+ *
+ * `text-body` and not `text-faint`: faint is large-text-legal only (#232), and
+ * this is 15px. Every colour is a token, so it flips on the panel and on ink with
+ * the rest of the block; a container that sets `data-cg-surface` still owes its
+ * own `text-ink` (rule 3).
+ */
+declare function CloudGridInstallFooter({ className, ...props }: Omit<React.ComponentProps<"footer">, "ref" | "children">): React.JSX.Element;
+declare function CloudGridInstall({ preset, tools, methods, defaultTool, defaultMethod, showFetchPrompt, showFooter, value, onValueChange, method, onMethodChange, level, headingSize, continueLabel, onContinue, canContinue, className, ...props }: Omit<React.ComponentProps<"div">, "ref" | "children" | "defaultValue" | "onChange"> & InstallFilter & {
+    /**
+     * A named configuration: `INSTALL_PRESETS.hub`, `.onboarding`, `.console`,
+     * `.makeGame`, `.makeAppAgent`, `.makeDeckPage`, or `installToolPreset(tool)`.
+     * Any filter prop passed alongside overrides that field of it.
+     */
+    preset?: InstallFilter;
+    /** The selected tool, controlled. Pair with `onValueChange`. */
+    value?: InstallToolValue;
+    /** Reports the tool on screen, in the content's slugs (`gemini`, `claude-web`). */
+    onValueChange?: (value: InstallToolValue) => void;
+    /** The selected method, controlled. Pair with `onMethodChange`. */
+    method?: InstallMethodValue;
+    onMethodChange?: (method: InstallMethodValue) => void;
+    /** `2` for a section inside a larger page. */
+    level?: 1 | 2;
+    headingSize?: React.ComponentProps<typeof PageHeading>["size"];
+    /**
+     * A Continue button under the panel, for a flow. `null`, the default, draws
+     * none: with no handler a button is a dead end, and neither surface that
+     * renders this today has anything to continue to from inside it.
+     */
+    continueLabel?: string | null;
+    onContinue?: () => void;
+    canContinue?: boolean;
+}): React.JSX.Element;
+export { CloudGridFetchPrompt, CloudGridInstall, CloudGridInstallFooter };
+//# sourceMappingURL=cloudgrid-install.d.ts.map

package/dist/blocks/cloudgrid-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudgrid-install.d.ts","sourceRoot":"","sources":["../../src/blocks/cloudgrid-install.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B,OAAO,EAQL,KAAK,aAAa,EAGlB,KAAK,kBAAkB,EAGvB,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAA;AAyGjC;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAE,SAAS,gBAAgB,EAAsC,EACtE,OAAO,GAAE,SAAS,kBAAkB,EAAwC,GAC3E,aAAa,EAAE,CAqBjB;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAMrD;AAED;;;;;;;GAOG;AACH,iBAAS,oBAAoB,CAAC,EAC5B,SAAgB,EAChB,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG;IACzD,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,qBAWA;AAED;;;;;;;GAOG;AACH,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,qBA0B1D;AAUD,iBAAS,gBAAgB,CAAC,EACxB,MAAM,EACN,KAAK,EACL,OAAO,EACP,WAAW,EACX,aAAa,EACb,eAAe,EACf,UAAU,EACV,KAAK,EACL,aAAa,EACb,MAAM,EACN,cAAc,EACd,KAAS,EACT,WAAW,EACX,aAAoB,EACpB,UAAU,EACV,WAAkB,EAClB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC,GACpF,aAAa,GAAG;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,gEAAgE;IAChE,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,mFAAmF;IACnF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACjD,mEAAmE;IACnE,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAA;IACrD,8CAA8C;IAC9C,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACb,WAAW,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;IAC9D;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,qBAqEF;AAED,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,CAAA"}

package/dist/blocks/cloudgrid-install.js

@@ -0,0 +1,192 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { AgentPrompt } from "./agent-prompt.js";
+import { Button } from "../ui/button.js";
+import { ChatAppIcon, DownloadIcon, GithubIcon, OpenLiveIcon, TerminalIcon, } from "./icons.js";
+import { INSTALL_FETCH_PROMPT, INSTALL_FOOTER, INSTALL_GROUPS, INSTALL_HEADING, INSTALL_METHODS, INSTALL_PRESETS, INSTALL_TOOLS, } from "./install-content.js";
+import { PageHeading } from "./page-heading.js";
+import { ToolLogo } from "./tool-logo.js";
+import { TOOL_MARKS } from "./tool-marks.js";
+import { ToolSetup, } from "./tool-setup.js";
+import { cn } from "../lib/cloudgrid-cn.js";
+/**
+ * THE INSTALL PANEL, COMPLETE. Content and design both from this library (#266).
+ *
+ * `<CloudGridInstall />` with no props renders the whole thing: the heading, the
+ * method pills, the grouped tool strip, every pane, the "Not sure?" fetch prompt
+ * and the source footer. Nothing is fetched and nothing is passed in, because the
+ * content is `install-content.ts` and ships in the same package.
+ *
+ * Founder ruling, 2026-10-05: every install panel on every surface takes its
+ * content and its design from here. The Console's `/drop` page and onboarding
+ * step, and later the landing site, drop this in and choose a configuration.
+ *
+ * ## Configurations, not content props
+ *
+ * What a surface MAY choose is which part of the content is on screen: the
+ * tools, the methods, the defaults, and whether the fetch prompt and footer show.
+ * Pass a named `preset` (`INSTALL_PRESETS.onboarding`, `installToolPreset("cursor")`)
+ * and override any field of it with the same-named prop.
+ *
+ * What a surface may NOT choose is the words. There is no `title`, `sub`, `tools`
+ * array or step override, deliberately: a prop that replaces content is a second
+ * source of content, and two sources is how the old panel and the library came
+ * to say different things about the same setup.
+ *
+ * ## What a page still passes
+ *
+ * The things only the page can know. Which tool is selected (`value` /
+ * `onValueChange`: onboarding records it as `tool_selected`, in the snapshot's
+ * slugs), which method (`method` / `onMethodChange`), the heading's level and
+ * size for where it sits, and a Continue action when the panel is a step.
+ *
+ * ## Not a client module, on purpose
+ *
+ * Nothing here holds state; `ToolSetup` and `AgentPrompt` carry their own
+ * `"use client"`. So a React Server Component can render this with a preset, and
+ * the gallery, which is a server module, can call `installSetupTools` below
+ * rather than keeping a second copy of the mapping.
+ */
+// Every mark name the content uses is a real key in the vendor-mark set. The
+// content module spells them out so it can stay free of React types; this is the
+// compile-time half of that bargain.
+const MARKS = TOOL_MARKS;
+const ICONS = {
+    terminal: TerminalIcon,
+    chat: ChatAppIcon,
+    github: GithubIcon,
+    download: DownloadIcon,
+    external: OpenLiveIcon,
+};
+function Glyph({ icon, className }) {
+    const Mark = ICONS[icon];
+    return _jsx(Mark, { className: className });
+}
+/**
+ * Body runs to nodes. A bold run is a menu path or a folder and reads at medium
+ * weight in the ink colour; a code run is a command typed inline and reads in
+ * the mono face at the size around it. Both are tokens, so both flip per surface.
+ */
+function Body({ runs }) {
+    return (_jsx(_Fragment, { children: runs.map((run, i) => typeof run === "string" ? (_jsx(React.Fragment, { children: run }, i)) : "bold" in run ? (_jsx("b", { className: "font-medium text-ink", children: run.bold }, i)) : (_jsx("code", { "data-slot": "cloudgrid-install-code", className: "font-mono text-ink", children: run.code }, i))) }));
+}
+function toSetupStep(step) {
+    return {
+        ...(step.label ? { label: step.label } : {}),
+        title: step.title,
+        ...(step.body ? { body: _jsx(Body, { runs: step.body }) } : {}),
+        ...(step.prompt ? { prompt: step.prompt } : {}),
+        ...(step.code ? { code: step.code } : {}),
+        ...(step.link
+            ? {
+                link: {
+                    label: step.link.label,
+                    href: step.link.href,
+                    ...(step.link.icon ? { icon: _jsx(Glyph, { icon: step.link.icon }) } : {}),
+                    ...(step.link.primary ? { primary: true } : {}),
+                },
+            }
+            : {}),
+    };
+}
+/**
+ * The content's tools as `ToolSetup` takes them, in the order asked for, with
+ * every vendor mark and every body rendered.
+ *
+ * Exported for a page that composes `ToolSetup` itself, which is what the
+ * library gallery's `ToolSetup` specimens do. A method missing from `methods`
+ * is dropped from each tool, so a tool with nothing left leaves the strip.
+ *
+ * 15px marks, which is what the strip draws. A mark carries no size of its own,
+ * so every call site states one.
+ */
+export function installSetupTools(tools = INSTALL_TOOLS.map((t) => t.value), methods = INSTALL_METHODS.map((m) => m.value)) {
+    return tools.flatMap((value) => {
+        const tool = INSTALL_TOOLS.find((t) => t.value === value);
+        if (!tool)
+            return [];
+        const steps = {};
+        for (const method of methods) {
+            const pane = tool.steps[method];
+            if (pane?.length)
+                steps[method] = pane.map(toSetupStep);
+        }
+        if (Object.keys(steps).length === 0)
+            return [];
+        const { Mark, hex } = MARKS[tool.mark];
+        return [
+            {
+                value: tool.value,
+                label: tool.label,
+                group: tool.group,
+                mark: _jsx(ToolLogo, { name: tool.mark, hex: hex, mark: _jsx(Mark, {}), size: 15 }),
+                steps,
+            },
+        ];
+    });
+}
+/** The two runs, each drawn as its glyph and named by its words. */
+export function installSetupGroups() {
+    return INSTALL_GROUPS.map((group) => ({
+        value: group.value,
+        label: group.label,
+        icon: _jsx(Glyph, { icon: group.icon }),
+    }));
+}
+/**
+ * "Not sure? Copy this prompt and paste it to your AI agent." over the one
+ * command an agent can act on.
+ *
+ * The outline pill, as the Console drew it under the panel, so it reads the
+ * surface it sits on. `showIntro={false}` is the standalone pill, which is what
+ * the old `fetch-prompt` block was.
+ */
+function CloudGridFetchPrompt({ showIntro = true, ...props }) {
+    return (_jsx(AgentPrompt, { "data-part": "cloudgrid-fetch-prompt", variant: "outline", ...(showIntro ? { label: INSTALL_FETCH_PROMPT.intro } : {}), command: INSTALL_FETCH_PROMPT.command, copyLabel: "Copy fetch prompt", ...props }));
+}
+/**
+ * The source line: one sentence, then the two repositories.
+ *
+ * `text-body` and not `text-faint`: faint is large-text-legal only (#232), and
+ * this is 15px. Every colour is a token, so it flips on the panel and on ink with
+ * the rest of the block; a container that sets `data-cg-surface` still owes its
+ * own `text-ink` (rule 3).
+ */
+function CloudGridInstallFooter({ className, ...props }) {
+    return (_jsxs("footer", { "data-slot": "cloudgrid-install-footer", className: cn("flex flex-wrap items-center justify-center gap-x-6 gap-y-2 text-body-sm text-body", className), ...props, children: [_jsx("span", { children: INSTALL_FOOTER.note }), INSTALL_FOOTER.links.map((link) => (_jsxs("a", { href: link.href, target: "_blank", rel: "noopener noreferrer", "data-slot": "cloudgrid-install-footer-link", className: "inline-flex items-center gap-1.5 text-body underline underline-offset-4 hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring", children: [link.icon ? _jsx(Glyph, { icon: link.icon, className: "size-4 shrink-0" }) : null, link.label] }, link.href)))] }));
+}
+/**
+ * Keep the caller's order and drop what does not exist, so a preset naming a
+ * method or tool this content does not have cannot put an empty tab on screen.
+ */
+function known(asked, all) {
+    return asked ? asked.filter((v) => all.includes(v)) : [...all];
+}
+function CloudGridInstall({ preset, tools, methods, defaultTool, defaultMethod, showFetchPrompt, showFooter, value, onValueChange, method, onMethodChange, level = 1, headingSize, continueLabel = null, onContinue, canContinue = true, className, ...props }) {
+    const base = { ...INSTALL_PRESETS.hub, ...preset };
+    const toolValues = known(tools ?? base.tools, INSTALL_TOOLS.map((t) => t.value));
+    const methodValues = known(methods ?? base.methods, INSTALL_METHODS.map((m) => m.value));
+    const withFetchPrompt = showFetchPrompt ?? base.showFetchPrompt ?? true;
+    const withFooter = showFooter ?? base.showFooter ?? true;
+    const setupTools = installSetupTools(toolValues, methodValues);
+    // A default the filter has removed is dropped rather than passed on. Handed
+    // through, `ToolSetup` would fall back to the first tab AND report that
+    // fallback, which would reach an analytics handler as a selection nobody made.
+    const askedTool = defaultTool ?? base.defaultTool;
+    const firstTool = setupTools.some((t) => t.value === askedTool) ? askedTool : undefined;
+    const askedMethod = defaultMethod ?? base.defaultMethod;
+    const firstMethod = askedMethod && methodValues.includes(askedMethod) ? askedMethod : undefined;
+    const setupMethods = INSTALL_METHODS.filter((m) => methodValues.includes(m.value))
+        // The caller's order, not the content's.
+        .sort((a, b) => methodValues.indexOf(a.value) - methodValues.indexOf(b.value));
+    return (_jsxs("div", { "data-slot": "cloudgrid-install", className: cn("flex flex-col gap-6", className), ...props, children: [_jsx(ToolSetup, { title: INSTALL_HEADING.title, sub: INSTALL_HEADING.sub, level: level, ...(headingSize ? { headingSize } : {}), tools: setupTools, methods: setupMethods, groups: installSetupGroups(), ...(value !== undefined ? { value } : {}), ...(firstTool ? { defaultValue: firstTool } : {}), ...(onValueChange
+                    ? { onValueChange: (next) => onValueChange(next) }
+                    : {}), ...(method !== undefined ? { method } : {}), ...(firstMethod ? { defaultMethod: firstMethod } : {}), ...(onMethodChange
+                    ? { onMethodChange: (next) => onMethodChange(next) }
+                    : {}), 
+                // The panel's own action row sits under the fetch prompt and the footer,
+                // below, so the step's primary action is the last thing on it.
+                continueLabel: null }), withFetchPrompt ? _jsx(CloudGridFetchPrompt, {}) : null, withFooter ? _jsx(CloudGridInstallFooter, {}) : null, continueLabel !== null ? (_jsx("div", { "data-slot": "cloudgrid-install-actions", className: "flex flex-col items-start gap-4", children: _jsx(Button, { type: "button", size: "lg", "data-slot": "cloudgrid-install-continue", onClick: onContinue, disabled: !canContinue, children: continueLabel }) })) : null] }));
+}
+export { CloudGridFetchPrompt, CloudGridInstall, CloudGridInstallFooter };
+//# sourceMappingURL=cloudgrid-install.js.map

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

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

package/dist/blocks/entity-card.d.ts

@@ -140,10 +140,29 @@ import * as React from "react";
  * an `sr-only` span, because "agent" is information and a decorative mark is not
  * a way to convey it.
  *
+ * ## A click opens the details page (#268)
+ *
+ * Founder, 2026-10-05: *clicking an app card on any page opens the app's page
+ * in the console*, not the live app. So when `dashboardHref` is set, the
+ * DETAILS link owns the card's one stretched hit area — the whole card,
+ * thumbnail included — whether or not the entity is live, and the live link is
+ * the small secondary arrow, still `target="_blank"`, named "Open live app".
+ * The details link is named "Details" and wears `EntityDetailsIcon`
+ * (`list-magnifying-glass`); it renders through `linkComponent` when one is
+ * passed, so a router can navigate client-side.
+ *
+ * Two things did not change. With no `dashboardHref` the live link owns the
+ * click as it always did, and `primaryAction="live"` restores the whole
+ * pre-#268 model for a consumer that wants it. Much of the history below
+ * describes the live link as "Open" and the details link as "Dashboard"; those
+ * are the same two doors under their old names, and every rule about them — the
+ * new tab, the `rel`, the #171 gating of whichever door is secondary, the #193
+ * disabled state — carries over unchanged.
+ *
  * ## The panel, and the rule it supersedes
  *
  * `reveal` puts a WHITE panel over the bottom of the card carrying the title,
- * the state dot, two real links (Open and Dashboard), the description, the
+ * the state dot, two real links (details and live), the description, the
  * creator and the card's own controls. It shows on hover and on `:focus-within`,
  * and it respects `prefers-reduced-motion` by arriving without the fade rather
  * than not at all.
@@ -154,16 +173,18 @@ import * as React from "react";
  * laid over the lower half of the picture, the type is the page's own ink, and
  * the picture above it stays a picture.
  *
- * **The second action is Dashboard, and it is not a gear.** Founder direction
+ * **The details action is not a gear.** Founder direction
  * 2026-09-08 (#182). The door it opens is the entity's page in the console,
  * which shows analytics and what runs under the hood — so what it promises is
  * "look inside", and a gear promises "change how this is configured". Those are
  * different pages and a reader who takes one for the other has been misled by
- * the icon rather than by the label. The mark is `EntityDashboardIcon`
+ * the icon rather than by the label. The mark was `EntityDashboardIcon`
  * (Phosphor `chart-line-up` since #221 — `gauge` at #182, `engine` at #200, and
  * each was unpicked by looking at it: a dial reads as a speed, an engine reads
- * as machinery, and neither is the number a person opened the page for);
- * `SettingsIcon` is still exported for the surfaces that really are settings.
+ * as machinery, and neither is the number a person opened the page for), and
+ * since #268 it is `EntityDetailsIcon`, a list under a lens, because the page
+ * is findings rather than a chart. `SettingsIcon` is still exported for the
+ * surfaces that really are settings.
  *
  * The prop is `dashboardHref`. `settingsHref` is kept as a deprecated alias for
  * this minor and maps straight to it, so no caller breaks on the rename — see
@@ -233,19 +254,23 @@ import * as React from "react";
  * instead of on a wrapper, because an `<a>` inside an `<a>` is invalid HTML and
  * browsers repair it by closing the outer one — which silently unlinks the card
  * and leaves the actions where the parser decides to put them. The panel is the
- * link surface instead: Open stretches across the whole panel with an
- * `::after`, so a click anywhere on the thumbnail opens the entity, and
- * Dashboard sits above it. Every existing caller is unaffected — `reveal`
- * defaults off and the wrapper behaves exactly as it did. (With no `href` at
- * all, Open is disabled and the stretched layer moves to Dashboard — see "The
- * reveal never depends on data" below.)
- *
- * **The panel stays clickable while it is invisible — except Dashboard.**
- * `opacity-0` is a paint state, not a pointer state, so a touch user with no
- * hover at all still gets Open by tapping the thumbnail. Gating Open's pointer
- * events on hover would make the card do nothing on a phone.
- *
- * Dashboard is the one exception, and it has to be. It is `relative`, so it
+ * link surface instead: the door that owns the click (details since #268,
+ * live without a `dashboardHref`) stretches across the whole card with an
+ * `::after`, and the other door sits above it. Until #268 that stretch covered
+ * only the panel, so the top of the thumbnail was dead; the panel now sits in a
+ * transparent full-card layer, which is what the stretch sizes to. Every
+ * existing caller is unaffected — `reveal` defaults off and the wrapper behaves
+ * exactly as it did. (With no `href` at all, the live link is disabled — see
+ * "The reveal never depends on data" below.)
+ *
+ * **The panel stays clickable while it is invisible — except the secondary
+ * door.** `opacity-0` is a paint state, not a pointer state, so a touch user
+ * with no hover at all still gets the card's door by tapping the thumbnail.
+ * Gating the stretched link's pointer events on hover would make the card do
+ * nothing on a phone.
+ *
+ * The secondary door (Dashboard, below, before #268; the live arrow since) is
+ * the one exception, and it has to be. It is `relative`, so it
  * stacks above Open's stretched hit area; live at rest, that made a pill-sized
  * region of an invisible panel go to that link on a tap — different from every
  * pixel around it, and impossible to see (#171). So it carries
@@ -445,7 +470,7 @@ declare function EntityKindBadge({ kind, size, className, ...props }: Omit<React
     kind: EntityKind;
     size?: "sm" | "md";
 }): React.JSX.Element;
-declare function EntityCard({ title, slug, description, size, titleLines, descriptionLines, status, statusDot, headerActions, stats, seed, previewUrl, kind, reveal, openDisabledReason, dashboardHref, settingsHref, creator, panelMeta, href, ariaLabel, meta, footer, className, children, ...props }: Omit<React.ComponentProps<"div">, "ref" | "title"> & {
+declare function EntityCard({ title, slug, description, size, titleLines, descriptionLines, status, statusDot, headerActions, stats, seed, previewUrl, kind, reveal, openDisabledReason, dashboardHref, settingsHref, primaryAction, linkComponent, creator, panelMeta, href, ariaLabel, meta, footer, className, children, ...props }: Omit<React.ComponentProps<"div">, "ref" | "title"> & {
     title: string;
     /** The entity's address, in the mono utility face. */
     slug?: string;
@@ -551,13 +576,17 @@ declare function EntityCard({ title, slug, description, size, titleLines, descri
      */
     openDisabledReason?: React.ReactNode;
     /**
-     * The Dashboard action's target: the entity's page in the console, where the
-     * analytics and what runs under the hood live.
+     * The details action's target: the entity's page in the console — Overview,
+     * insights, and what runs under the hood.
+     *
+     * Since #268 this is the card's CLICK. When it is set, the details link owns
+     * the stretched hit area, so a click or tap anywhere on the card, thumbnail
+     * included, goes here; the live entity becomes the small secondary icon. See
+     * `primaryAction` for the one way to keep the old live-first behaviour.
      *
      * Read wherever the action pair renders — the panel on a stacked card, the end
-     * of the cluster on a `row` (#182). It is load-bearing rather than decorative
-     * when there is no `href`: it is then the card's only door, and the one that
-     * takes the stretched hit area (#193).
+     * of the cluster on a `row` (#182). The prop keeps its #182 name: renaming it
+     * would break every caller for a word, and what it points at did not move.
      */
     dashboardHref?: string;
     /**
@@ -569,6 +598,34 @@ declare function EntityCard({ title, slug, description, size, titleLines, descri
      * next major; the fix is one word at each call site.
      */
     settingsHref?: string;
+    /**
+     * Which door the card's click opens. `"details"` by default (#268, founder
+     * 2026-10-05): a click on an entity card opens its page in the console, and
+     * the live entity is the secondary icon, still opening in a new tab.
+     *
+     * `"live"` restores the pre-#268 model for a consumer that needs it: the live
+     * link owns the stretched hit area and the details link is the lifted
+     * secondary. The console does not pass it.
+     *
+     * Only a preference between two doors that both exist. With no
+     * `dashboardHref` the live link owns the click whatever this says, and with
+     * no `href` the details link does (#193), because a card's one stretched
+     * layer always belongs to a door that can be opened.
+     */
+    primaryAction?: "details" | "live";
+    /**
+     * The element the DETAILS link renders as. A plain `<a>` by default.
+     *
+     * Pass your router's link — Next's `Link`, for the console — so a card click
+     * navigates client-side instead of reloading the page. It receives `href`,
+     * `className`, `data-*` attributes and children, which is the anchor subset
+     * every router link forwards to the `<a>` it renders.
+     *
+     * Only the details link. The live link stays a plain `<a target="_blank">`:
+     * it leaves for a tenant's own app in a new tab, which no client router can
+     * or should handle.
+     */
+    linkComponent?: React.ElementType;
     /**
      * Who made it, shown on the reveal panel. `avatar` is a node so a consumer can
      * pass its own image, initials tile or `EntityIdentity`; this card does not

package/dist/blocks/entity-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-card.d.ts","sourceRoot":"","sources":["../../src/blocks/entity-card.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"entity-card.d.ts","sourceRoot":"","sources":["../../src/blocks/entity-card.tsx"],"names":[],"mappings":"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"}