@cosmoops/connect-sdk 0.7.0 → 0.15.0

package/dist/types/ui/page-shell.d.ts

@@ -0,0 +1,39 @@
+import { type ReactNode } from "react";
+import { ConnectPageHeader } from "./page-header.js";
+export interface ConnectPageShellProps {
+    title?: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    clamp?: boolean;
+    /** Rendered above the header - a breadcrumb trail, a back link, a banner. */
+    above?: ReactNode;
+    children?: ReactNode;
+}
+/**
+ * The frame a page opens with: its vertical rhythm, its header, and the
+ * suspended regions beneath.
+ *
+ * **The header is a prop, so it renders in the static shell** - above and
+ * outside every `<Suspense>` boundary. That is the one bug this component
+ * exists to make unrepresentable: rendering the header inside the async child
+ * makes a page's own title wait on a data read, and under Next's partial
+ * prefetching the route's shared App Shell loses it as well. There is no
+ * arrangement of `children` that reaches the header slot.
+ *
+ * A detail route is the honest exception, and it has its own door:
+ * `ConnectPageShell.Header` renders the identical header from inside an async
+ * child, for a page whose title is data it does not have yet. Pair it with a
+ * skeleton header in the fallback. The rule is that a *static* title must
+ * never be made to wait, not that every title can be static.
+ *
+ * `space-y-5` is the page gap, owned here so it has exactly one definition.
+ */
+export declare function ConnectPageShell({ title, description, action, clamp, above, children, }: Readonly<ConnectPageShellProps>): import("react").JSX.Element;
+export declare namespace ConnectPageShell {
+    var Header: typeof ConnectPageHeader;
+    var Async: ({ fallback, children, }: Readonly<{
+        /** Omit where the region has nothing to draw while it waits. */
+        fallback?: ReactNode;
+        children: ReactNode;
+    }>) => import("react").JSX.Element;
+}

package/dist/types/ui/section.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+export interface ConnectSectionProps {
+    title: ReactNode;
+    /** What the block is for. Omit when the title says everything. */
+    description?: ReactNode;
+    /** Rendered opposite the title. One control - a section has one action. */
+    action?: ReactNode;
+    /** Set to reference the heading from an `aria-labelledby` in the body. */
+    titleId?: string;
+    className?: string;
+    bodyClassName?: string;
+    children?: ReactNode;
+}
+/**
+ * One titled block inside a page: a card, its heading, what it is for, and the
+ * one control that acts on it.
+ *
+ * The heading is an `h3` - `ConnectPageHeader` renders the page title as an
+ * `h2`, so a block *inside* a page is a level below it. Hand-rolled sections
+ * reliably use `h2`, which makes every settings block a sibling of the page it
+ * sits in and flattens the outline a screen reader announces.
+ *
+ * As in the page header, the action is a peer of the title rather than of the
+ * block, so its position does not move with the length of the description.
+ */
+export declare function ConnectSection({ title, description, action, titleId, className, bodyClassName, children, }: Readonly<ConnectSectionProps>): import("react").JSX.Element;

package/dist/types/ui/setting-row.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from "react";
+export interface ConnectSettingRowProps {
+    title: ReactNode;
+    description?: ReactNode;
+    /** The control this row is about - a switch, a button, a value with an edit link. */
+    action?: ReactNode;
+    /** Rendered under both, full width - a validation message, or a nested field the row reveals. */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * One labelled setting inside a `ConnectSection`.
+ *
+ * Stacks on a phone and goes side-by-side from `sm` up, rather than shrinking
+ * a two-column row until neither column is readable. The control keeps its
+ * intrinsic width so truncation lands on the description.
+ */
+export declare function ConnectSettingRow({ title, description, action, children, className, }: Readonly<ConnectSettingRowProps>): import("react").JSX.Element;

package/dist/types/ui/status-chip.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The closed set of tones a status may resolve to.
+ *
+ * Deliberately five, and deliberately narrower than HeroUI's `Chip` colour
+ * union: a status is either fine, needs attention, is broken, is in progress,
+ * or is inert. A sixth tone would have to mean one of those five again, which
+ * is where hand-written status chips start disagreeing with each other.
+ */
+export type ConnectStatusTone = "success" | "warning" | "danger" | "accent" | "default";
+/**
+ * How one domain's status union is presented: a tone and a human label per
+ * member.
+ *
+ * Both are **total** `Record`s, and that is the load-bearing property - adding
+ * a member to the status union fails the type gate until it has been given a
+ * presentation. A loose `Record<string, …>` map silently renders the new
+ * status as `undefined`.
+ */
+export interface ConnectStatusPresentation<TStatus extends string> {
+    readonly tone: Readonly<Record<TStatus, ConnectStatusTone>>;
+    readonly label: Readonly<Record<TStatus, string>>;
+}
+/**
+ * One status, rendered the way every status should be.
+ *
+ * Domain knowledge stays in the domain: each caller exports its own
+ * `ConnectStatusPresentation` next to the union it describes, and this renders
+ * it. A status whose *rendering* carries real logic - a scheduled cancellation
+ * outranking a running trial, say - keeps its own component and calls this for
+ * the final chip. A map cannot express precedence.
+ */
+export declare function ConnectStatusChip<TStatus extends string>({ status, presentation, className, }: Readonly<{
+    status: TStatus;
+    presentation: ConnectStatusPresentation<TStatus>;
+    className?: string;
+}>): import("react").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmoops/connect-sdk",
-  "version": "0.7.0",
+  "version": "0.15.0",
   "description": "Official server-side SDK for the CosmoOps Connect platform API - Login with Connect, entitlements, billing and metering.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "commonjs",
@@ -36,6 +36,11 @@
       "import": "./dist/esm/client/index.js",
       "require": "./dist/cjs/client/index.js"
     },
+    "./ui": {
+      "types": "./dist/types/ui/index.d.ts",
+      "import": "./dist/esm/ui/index.js",
+      "require": "./dist/cjs/ui/index.js"
+    },
     "./theme.css": "./dist/theme.css",
     "./package.json": "./package.json"
   },
@@ -67,12 +72,12 @@
     "verify:pack": "bun run scripts/verify-pack.ts",
     "prepublishOnly": "bun run build && bun run verify:pack",
     "test": "bun test",
-    "docs": "typedoc",
     "docs:md": "typedoc --options typedoc.markdown.json",
     "storybook": "storybook dev -p 6106",
     "build:storybook": "storybook build -o storybook-static"
   },
   "devDependencies": {
+    "@connect/ai": "workspace:*",
     "@connect/data": "workspace:*",
     "@heroui/react": "^3.2.2",
     "@heroui/styles": "^3.2.2",
@@ -87,6 +92,7 @@
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "storybook": "^10.5.10",
+    "streamdown": "^2.5.0",
     "tailwindcss": "^4.3.3",
     "typedoc": "^0.28.20",
     "typedoc-plugin-markdown": "^4.12.0",
@@ -98,7 +104,8 @@
     "lucide-react": ">=0.400.0",
     "motion": ">=12",
     "react": ">=19",
-    "react-dom": ">=19"
+    "react-dom": ">=19",
+    "streamdown": ">=2.5.0"
   },
   "peerDependenciesMeta": {
     "@heroui/react": {
@@ -115,6 +122,9 @@
     },
     "react-dom": {
       "optional": true
+    },
+    "streamdown": {
+      "optional": true
     }
   }
 }