@xanots/sdk 0.0.2 → 0.0.3

package/dist/scaffold.js

@@ -0,0 +1,101 @@
+import {
+  DEFAULT_FRAMEWORK,
+  FRAMEWORKS,
+  allFrontendPresets,
+  findFrontendPreset,
+  renderIndexCss,
+  resolveFrameworkFlag
+} from "./chunk-YZ4GU6F5.js";
+import {
+  ACCENTS,
+  ACCENT_TOKENS,
+  BASE_COLORS,
+  BASE_TOKENS,
+  CURATED_THEMES,
+  DARK_MODES,
+  DEFAULT_BASE_COLOR,
+  DEFAULT_DARK_MODE,
+  DEFAULT_ICON_LIBRARY,
+  DEFAULT_RADIUS,
+  FONTS,
+  FONT_IDS,
+  ICON_LIBRARIES,
+  TOKEN_ORDER,
+  allIconLibraries,
+  buildTheme,
+  colorTokens,
+  curatedThemes,
+  defaultIconLibrary,
+  defaultTheme,
+  defaultThemeChoice,
+  describeFonts,
+  findFont,
+  findIconLibrary,
+  fontDependencies,
+  fontImports,
+  fontThemeVars,
+  iconLibraryOf,
+  isAccent,
+  isBaseColor,
+  normalizeRadius,
+  orderedTokens,
+  parseColor,
+  resolveDarkModeFlag,
+  resolveFontFlag,
+  resolveIconsFlag,
+  resolveThemeFlag,
+  themeFromRegistryItem,
+  themeGuidanceSection,
+  themeSwatch,
+  withRadius
+} from "./chunk-6DHJVLYP.js";
+export {
+  ACCENTS,
+  ACCENT_TOKENS,
+  BASE_COLORS,
+  BASE_TOKENS,
+  CURATED_THEMES,
+  DARK_MODES,
+  DEFAULT_BASE_COLOR,
+  DEFAULT_DARK_MODE,
+  DEFAULT_FRAMEWORK,
+  DEFAULT_ICON_LIBRARY,
+  DEFAULT_RADIUS,
+  FONTS,
+  FONT_IDS,
+  FRAMEWORKS,
+  ICON_LIBRARIES,
+  TOKEN_ORDER,
+  allFrontendPresets,
+  allIconLibraries,
+  buildTheme,
+  colorTokens,
+  curatedThemes,
+  defaultIconLibrary,
+  defaultTheme,
+  defaultThemeChoice,
+  describeFonts,
+  findFont,
+  findFrontendPreset,
+  findIconLibrary,
+  fontDependencies,
+  fontImports,
+  fontThemeVars,
+  iconLibraryOf,
+  isAccent,
+  isBaseColor,
+  normalizeRadius,
+  orderedTokens,
+  parseColor,
+  renderIndexCss,
+  resolveDarkModeFlag,
+  resolveFontFlag,
+  resolveFrameworkFlag,
+  resolveIconsFlag,
+  resolveThemeFlag,
+  themeFromRegistryItem,
+  themeGuidanceSection,
+  themeSwatch,
+  withRadius
+};
+//# sourceMappingURL=scaffold.js.map

package/dist/{test-command-BOLIU57E.js → test-command-72Y5S22H.js}

@@ -1,6 +1,6 @@
 import {
   resolveMetaTarget
-} from "./chunk-XLD4BUTF.js";
+} from "./chunk-BT2CSEC5.js";
 import "./chunk-DGSF2Q5H.js";
 import "./chunk-7DKX2SPN.js";
 import "./chunk-NDZFBZHC.js";
@@ -19,7 +19,7 @@ import {
 import "./chunk-7REDODS2.js";
 import {
   unknownSubcommand
-} from "./chunk-IZW6MK3U.js";
+} from "./chunk-6USV65XA.js";
 import {
   blank,
   detail,
@@ -28,8 +28,8 @@ import {
   success,
   warn
 } from "./chunk-EZG76F7R.js";
-import "./chunk-YYRDLFSJ.js";
 import "./chunk-GNPVYOPB.js";
+import "./chunk-DYCLVQXW.js";
 
 // src/deploy/tests.ts
 var TIMEOUT_MS = 12e4;
@@ -380,4 +380,4 @@ export {
   runSuite,
   runTestCommand
 };
-//# sourceMappingURL=test-command-BOLIU57E.js.map
+//# sourceMappingURL=test-command-72Y5S22H.js.map

package/dist/{validate-command-SYCFEYZN.js → validate-command-KDGH537H.js}

@@ -1,9 +1,10 @@
 import {
   assertBundleInput,
   loadBundleText
-} from "./chunk-ZPEY5WE4.js";
-import "./chunk-UVLVQWWF.js";
-import "./chunk-IZW6MK3U.js";
+} from "./chunk-W2G2WPTB.js";
+import "./chunk-3NFUWXOC.js";
+import "./chunk-6USV65XA.js";
+import "./chunk-HJPTWBLH.js";
 import {
   blank,
   detail,
@@ -12,13 +13,12 @@ import {
   success,
   warn
 } from "./chunk-EZG76F7R.js";
+import "./chunk-GNPVYOPB.js";
 import "./chunk-55VHDNW5.js";
-import "./chunk-YYRDLFSJ.js";
+import "./chunk-DYCLVQXW.js";
 import "./chunk-5L4X5LS6.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-HJPTWBLH.js";
-import "./chunk-GNPVYOPB.js";
 import "./chunk-4HT3BNZ7.js";
 
 // src/emit/validate-command.ts
@@ -119,4 +119,4 @@ function fmt(v) {
 export {
   runValidateCommand
 };
-//# sourceMappingURL=validate-command-SYCFEYZN.js.map
+//# sourceMappingURL=validate-command-KDGH537H.js.map

package/dist/{workspace-command-TOB2AJ6X.js → workspace-command-ICSI6PKO.js}

@@ -1,17 +1,13 @@
 import {
   fetchWorkspaceBundle,
   runCodegenCommand
-} from "./chunk-MUDLJG2O.js";
+} from "./chunk-2V4YE6QC.js";
 import "./chunk-P3TTMWUP.js";
 import {
   resolveOutputTarget
 } from "./chunk-XQ22GLYS.js";
 import "./chunk-QTNO2WD6.js";
 import "./chunk-ZUTSMMAG.js";
-import "./chunk-ODNMVJ6H.js";
-import "./chunk-VKFQJEMW.js";
-import "./chunk-47WDWMBJ.js";
-import "./chunk-X4DVXBFY.js";
 import "./chunk-7DKX2SPN.js";
 import {
   printMicroserviceSection,
@@ -21,6 +17,9 @@ import {
   isMachineOutput,
   writeJson
 } from "./chunk-NUQCEOKA.js";
+import "./chunk-HQ2CBRVI.js";
+import "./chunk-CMZLPTGW.js";
+import "./chunk-WUSKBXXD.js";
 import {
   fetchOrExplain,
   httpFailure
@@ -30,28 +29,31 @@ import {
   getAccessToken
 } from "./chunk-C56BC2FY.js";
 import "./chunk-7REDODS2.js";
+import "./chunk-X4DVXBFY.js";
 import "./chunk-F6JCFRKO.js";
 import "./chunk-LU7TRWMC.js";
+import "./chunk-YZ4GU6F5.js";
+import "./chunk-6DHJVLYP.js";
 import "./chunk-4BXJGVZ3.js";
 import "./chunk-U3G2UW65.js";
-import "./chunk-UVLVQWWF.js";
+import "./chunk-3NFUWXOC.js";
 import {
   removedSubcommand,
   unknownSubcommand
-} from "./chunk-IZW6MK3U.js";
+} from "./chunk-6USV65XA.js";
+import "./chunk-HJPTWBLH.js";
 import {
   formatFields,
   stdoutStyle,
   step,
   success
 } from "./chunk-EZG76F7R.js";
+import "./chunk-GNPVYOPB.js";
 import "./chunk-55VHDNW5.js";
-import "./chunk-YYRDLFSJ.js";
+import "./chunk-DYCLVQXW.js";
 import "./chunk-5L4X5LS6.js";
 import "./chunk-WHOJWOSV.js";
 import "./chunk-5XZ744TS.js";
-import "./chunk-HJPTWBLH.js";
-import "./chunk-GNPVYOPB.js";
 import "./chunk-4HT3BNZ7.js";
 
 // src/emit/workspace-command.ts
@@ -153,4 +155,4 @@ async function runExport(args) {
 export {
   runWorkspaceCommand
 };
-//# sourceMappingURL=workspace-command-TOB2AJ6X.js.map
+//# sourceMappingURL=workspace-command-ICSI6PKO.js.map

package/dist/workspace-export-AJMGN3CQ.js

@@ -2,8 +2,8 @@ import {
   exportWorkspaceBundle
 } from "./chunk-QTNO2WD6.js";
 import "./chunk-ZUTSMMAG.js";
-import "./chunk-X4DVXBFY.js";
 import "./chunk-3IGNIP6R.js";
+import "./chunk-X4DVXBFY.js";
 export {
   exportWorkspaceBundle
 };

package/llms/kinds-agent-mcp.md

@@ -2,10 +2,11 @@
 
 > Read when the workspace defines an `agent()` or an `mcpServer()`.
 
-- `mcpServer({ name, guid?, description?, instructions?, docs?, enabled?, canonical?, spec?, tags?, history?, tools?, llm?, output? })` — an MCP toolset. `llm?`/`output?` are the same blocks `agent()` takes and are usually absent: an MCP server and an agent are ONE stored object distinguished by `type`, so a server that carries LLM settings can say so. Returns a handle with `getPath()`/`getUrl(baseUrl)` for the Streamable-HTTP endpoint — `getUrl` is NOT idempotent, a `baseUrl` already carrying an `/x2/mcp/<…>/stream` path (an earlier result) THROWS, so resolve ONCE from the instance base URL. Fires on an ephemeral; does NOT fire in the sandbox (see Gotchas).
+- `mcpServer({ name, guid?, description?, instructions?, docs?, enabled?, canonical?, spec?, tags?, history?, tools?, llm?, output? })` — an MCP toolset. `llm?`/`output?` are the same blocks `agent()` takes and are usually absent: an MCP server and an agent are ONE stored object distinguished by `type`. Returns a handle with `getPath()`/`getUrl(baseUrl)` for the Streamable-HTTP endpoint — `getUrl` is NOT idempotent, a `baseUrl` already carrying an `/x2/mcp/<…>/stream` path THROWS, so resolve ONCE from the instance base URL. Fires on an ephemeral; not in sandbox.
   - `tools?`: a `ToolsetToolEntry[]`. Pass the `tool()` HANDLES directly (`tools: [saveNote]`), like every other collection in the SDK; use the `{ tool, enabled?, auth? }` wrapper only when a tool needs `enabled: false` or per-tool `auth`. `auth` names an auth **table** (a `table({ auth: true })` handle or its name) — Xano's ONLY MCP auth surface (per-tool; there is no server-level gate). An entry that names no tool (no handle, no `id`) THROWS at export rather than emitting the `id: 0` null reference it used to; a deliberate raw `id: 0` warns and is carried through, so a pulled workspace still round-trips.
 - `agent({ name, guid?, description?, docs?, enabled?, canonical?, tags?, history?, llm, tools?, output? })` — an LLM orchestrator. No top-level `instructions`/`prompt`/`spec` — the prompt lives under `llm`. Invoke from a stack with `s.ai.agent.run({ agent, args })`.
   - `llm` (REQUIRED): typed provider settings, a discriminated union on `type` (`"xano-free" | "anthropic" | "openai" | "google-genai"`). Shared fields: `systemPrompt?`, `maxSteps?` (default `5`), and `prompt?` XOR `messages?` (genuinely exclusive: both is a type error and throws — the engine stores ONE `prompt_type`, so one would be dropped); plus provider fields (`apiKey?`, `model?`, `temperature?`, `reasoningEffort?`, …). String fields accept Twig placeholders — `{{ $args.x }}` for run inputs (the `args` of `s.ai.agent.run`), `{{ $env.NAME }}` for env vars.
   - `tools?`: same `ToolsetToolEntry[]` as `mcpServer` — bare `tool()` handles, or a `{ tool, enabled?, auth? }` wrapper when one needs `enabled`/`auth`.
   - `output?`: `{ schema: Record<string, input.*>, enabled? }` — structured-output schema. `schema` is a named-field record authored with the `input.*` catalog, exactly like a `defineFunction`/`query` `input:` map (the stored `structuredOutputsSchema` is the same wire shape as function inputs). e.g. `output: { schema: { priority: input.enum(["low","high"]), summary: input.text() } }`. When you pass the agent *handle* to `s.ai.agent.run({ agent })`, `.result` is typed straight from this schema — no `resultShape` witness needed (the shape is declared once). `resultShape` remains only to override that, or to type an agent referenced by bare name.
   - **Run + read recipe (`s.ai.agent.run`):** bind the run to a var (`s.ai.agent.run({ agent, args, as: "run" })`) — it produces a rich envelope, and the completion is at **`.result`**. Read one structured field with a dotted ref (`response: ref("run.result.priority")`) or the whole completion (`ref("run.result")`, typed from `output.schema`); persist it in a later step the same way (`s.set_var({ name, value: ref("run.result.summary") })`). `args` is a plain object of run inputs (`{ topic: inp("topic") }` — raw literals are fine, e.g. `{ max_steps: 3 }`) surfaced to the agent as `{{ $args.topic }}`. Tool-call / per-step data (when tools ran) rides `.toolCalls` / `.steps` on the same envelope — both optional, absent or empty when no tools executed.
+  - **Marketplace:** for chat history, use `@xanots/chatbot`; for vector RAG, use `@xanots/vector` (`tools: [vector.searchTool]`). Find add-ons with `xanots marketplace search <q>`.

package/llms-full.txt

@@ -1,4 +1,4 @@
-# xanots v0.0.2
+# xanots v0.0.3
 
 > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
 
@@ -646,13 +646,14 @@ The run is isolated in ways that make a correct test fail for reasons the failur
 
 > Read when the workspace defines an `agent()` or an `mcpServer()`.
 
-- `mcpServer({ name, guid?, description?, instructions?, docs?, enabled?, canonical?, spec?, tags?, history?, tools?, llm?, output? })` — an MCP toolset. `llm?`/`output?` are the same blocks `agent()` takes and are usually absent: an MCP server and an agent are ONE stored object distinguished by `type`, so a server that carries LLM settings can say so. Returns a handle with `getPath()`/`getUrl(baseUrl)` for the Streamable-HTTP endpoint — `getUrl` is NOT idempotent, a `baseUrl` already carrying an `/x2/mcp/<…>/stream` path (an earlier result) THROWS, so resolve ONCE from the instance base URL. Fires on an ephemeral; does NOT fire in the sandbox (see Gotchas).
+- `mcpServer({ name, guid?, description?, instructions?, docs?, enabled?, canonical?, spec?, tags?, history?, tools?, llm?, output? })` — an MCP toolset. `llm?`/`output?` are the same blocks `agent()` takes and are usually absent: an MCP server and an agent are ONE stored object distinguished by `type`. Returns a handle with `getPath()`/`getUrl(baseUrl)` for the Streamable-HTTP endpoint — `getUrl` is NOT idempotent, a `baseUrl` already carrying an `/x2/mcp/<…>/stream` path THROWS, so resolve ONCE from the instance base URL. Fires on an ephemeral; not in sandbox.
   - `tools?`: a `ToolsetToolEntry[]`. Pass the `tool()` HANDLES directly (`tools: [saveNote]`), like every other collection in the SDK; use the `{ tool, enabled?, auth? }` wrapper only when a tool needs `enabled: false` or per-tool `auth`. `auth` names an auth **table** (a `table({ auth: true })` handle or its name) — Xano's ONLY MCP auth surface (per-tool; there is no server-level gate). An entry that names no tool (no handle, no `id`) THROWS at export rather than emitting the `id: 0` null reference it used to; a deliberate raw `id: 0` warns and is carried through, so a pulled workspace still round-trips.
 - `agent({ name, guid?, description?, docs?, enabled?, canonical?, tags?, history?, llm, tools?, output? })` — an LLM orchestrator. No top-level `instructions`/`prompt`/`spec` — the prompt lives under `llm`. Invoke from a stack with `s.ai.agent.run({ agent, args })`.
   - `llm` (REQUIRED): typed provider settings, a discriminated union on `type` (`"xano-free" | "anthropic" | "openai" | "google-genai"`). Shared fields: `systemPrompt?`, `maxSteps?` (default `5`), and `prompt?` XOR `messages?` (genuinely exclusive: both is a type error and throws — the engine stores ONE `prompt_type`, so one would be dropped); plus provider fields (`apiKey?`, `model?`, `temperature?`, `reasoningEffort?`, …). String fields accept Twig placeholders — `{{ $args.x }}` for run inputs (the `args` of `s.ai.agent.run`), `{{ $env.NAME }}` for env vars.
   - `tools?`: same `ToolsetToolEntry[]` as `mcpServer` — bare `tool()` handles, or a `{ tool, enabled?, auth? }` wrapper when one needs `enabled`/`auth`.
   - `output?`: `{ schema: Record<string, input.*>, enabled? }` — structured-output schema. `schema` is a named-field record authored with the `input.*` catalog, exactly like a `defineFunction`/`query` `input:` map (the stored `structuredOutputsSchema` is the same wire shape as function inputs). e.g. `output: { schema: { priority: input.enum(["low","high"]), summary: input.text() } }`. When you pass the agent *handle* to `s.ai.agent.run({ agent })`, `.result` is typed straight from this schema — no `resultShape` witness needed (the shape is declared once). `resultShape` remains only to override that, or to type an agent referenced by bare name.
   - **Run + read recipe (`s.ai.agent.run`):** bind the run to a var (`s.ai.agent.run({ agent, args, as: "run" })`) — it produces a rich envelope, and the completion is at **`.result`**. Read one structured field with a dotted ref (`response: ref("run.result.priority")`) or the whole completion (`ref("run.result")`, typed from `output.schema`); persist it in a later step the same way (`s.set_var({ name, value: ref("run.result.summary") })`). `args` is a plain object of run inputs (`{ topic: inp("topic") }` — raw literals are fine, e.g. `{ max_steps: 3 }`) surfaced to the agent as `{{ $args.topic }}`. Tool-call / per-step data (when tools ran) rides `.toolCalls` / `.steps` on the same envelope — both optional, absent or empty when no tools executed.
+  - **Marketplace:** for chat history, use `@xanots/chatbot`; for vector RAG, use `@xanots/vector` (`tools: [vector.searchTool]`). Find add-ons with `xanots marketplace search <q>`.
 
 # Realtime def shapes
 

package/llms.txt

@@ -1,4 +1,4 @@
-# xanots v0.0.2
+# xanots v0.0.3
 
 > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
 

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "xanots",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.",
   "coverage": {
     "objectKinds": {
@@ -8562,6 +8562,34 @@
           "flag": "--framework <id>",
           "description": "Frontend framework to scaffold: react (default), svelte"
         },
+        {
+          "flag": "--theme <id>",
+          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
+        },
+        {
+          "flag": "--radius <len>",
+          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
+        },
+        {
+          "flag": "--dark <mode>",
+          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
+        },
+        {
+          "flag": "--font <id>",
+          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
+        },
+        {
+          "flag": "--font-mono <id>",
+          "description": "Code typeface (default: the system mono stack)"
+        },
+        {
+          "flag": "--font-heading <id>",
+          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
+        },
+        {
+          "flag": "--icons <id>",
+          "description": "Icon set: lucide (default), tabler, phosphor"
+        },
         {
           "flag": "--ai <preset>",
           "description": "AI instruction files to scaffold: claude, codex, cursor, none"
@@ -8700,6 +8728,34 @@
           "flag": "--framework <id>",
           "description": "Frontend framework to scaffold: react (default), svelte"
         },
+        {
+          "flag": "--theme <id>",
+          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
+        },
+        {
+          "flag": "--radius <len>",
+          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
+        },
+        {
+          "flag": "--dark <mode>",
+          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
+        },
+        {
+          "flag": "--font <id>",
+          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
+        },
+        {
+          "flag": "--font-mono <id>",
+          "description": "Code typeface (default: the system mono stack)"
+        },
+        {
+          "flag": "--font-heading <id>",
+          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
+        },
+        {
+          "flag": "--icons <id>",
+          "description": "Icon set: lucide (default), tabler, phosphor"
+        },
         {
           "flag": "--ai <preset>",
           "description": "AI instruction files to scaffold: claude, codex, cursor, none"
@@ -8901,6 +8957,34 @@
           "flag": "--framework <id>",
           "description": "Frontend framework to scaffold: react (default), svelte"
         },
+        {
+          "flag": "--theme <id>",
+          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
+        },
+        {
+          "flag": "--radius <len>",
+          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
+        },
+        {
+          "flag": "--dark <mode>",
+          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
+        },
+        {
+          "flag": "--font <id>",
+          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
+        },
+        {
+          "flag": "--font-mono <id>",
+          "description": "Code typeface (default: the system mono stack)"
+        },
+        {
+          "flag": "--font-heading <id>",
+          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
+        },
+        {
+          "flag": "--icons <id>",
+          "description": "Icon set: lucide (default), tabler, phosphor"
+        },
         {
           "flag": "--ai <preset>",
           "description": "AI instruction files to scaffold: claude, codex, cursor, none"
@@ -8912,6 +8996,10 @@
         {
           "flag": "--no-install",
           "description": "Skip the post-scaffold npm install"
+        },
+        {
+          "flag": "--marketplace <pkgs>",
+          "description": "Add-on packages to install and register, comma-separated"
         }
       ],
       "description": "Scaffold a new XanoTS project"
@@ -9201,6 +9289,34 @@
           "flag": "--framework <id>",
           "description": "Frontend framework to scaffold: react (default), svelte"
         },
+        {
+          "flag": "--theme <id>",
+          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
+        },
+        {
+          "flag": "--radius <len>",
+          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
+        },
+        {
+          "flag": "--dark <mode>",
+          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
+        },
+        {
+          "flag": "--font <id>",
+          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
+        },
+        {
+          "flag": "--font-mono <id>",
+          "description": "Code typeface (default: the system mono stack)"
+        },
+        {
+          "flag": "--font-heading <id>",
+          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
+        },
+        {
+          "flag": "--icons <id>",
+          "description": "Icon set: lucide (default), tabler, phosphor"
+        },
         {
           "flag": "--ai <preset>",
           "description": "AI instruction files to scaffold: claude, codex, cursor, none"
@@ -9468,6 +9584,34 @@
           "flag": "--framework <id>",
           "description": "Frontend framework to scaffold: react (default), svelte"
         },
+        {
+          "flag": "--theme <id>",
+          "description": "shadcn/ui theme — <base> or <base>-<accent> (e.g. zinc-blue), a registry theme URL, or a registry item JSON path; an unknown id lists every base and accent"
+        },
+        {
+          "flag": "--radius <len>",
+          "description": "Corner radius for the scaffold's theme — a number of rem (0, 0.5, 1) or a CSS length"
+        },
+        {
+          "flag": "--dark <mode>",
+          "description": "What switches the app into its dark palette: system (default, follows the OS), toggle (adds a control), off"
+        },
+        {
+          "flag": "--font <id>",
+          "description": "Body typeface, self-hosted from its @fontsource package (default: the system stack)"
+        },
+        {
+          "flag": "--font-mono <id>",
+          "description": "Code typeface (default: the system mono stack)"
+        },
+        {
+          "flag": "--font-heading <id>",
+          "description": "Heading typeface, bound to h1–h6 (default: inherits the body face)"
+        },
+        {
+          "flag": "--icons <id>",
+          "description": "Icon set: lucide (default), tabler, phosphor"
+        },
         {
           "flag": "--ai <preset>",
           "description": "AI instruction files to scaffold: claude, codex, cursor, none"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xanots/sdk",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "XanoTS — your Xano backend as TypeScript. `xanots deploy` ships your typed workspace (and an optional static frontend) to a live, auto-expiring ephemeral environment and prints its URL. init → deploy → URL.",
   "keywords": [
     "xanots",
@@ -40,6 +40,10 @@
       "types": "./dist/node.d.ts",
       "import": "./dist/node.js"
     },
+    "./scaffold": {
+      "types": "./dist/scaffold.d.ts",
+      "import": "./dist/scaffold.js"
+    },
     "./codegen": {
       "types": "./dist/codegen.d.ts",
       "import": "./dist/codegen.js"
@@ -67,6 +71,8 @@
     "codegen:sweep": "tsx scripts/codegen-sweep.ts",
     "codegen:replay": "tsx scripts/codegen-replay.ts",
     "codegen:imports": "tsx scripts/codegen-imports.ts",
+    "codegen:themes": "tsx scripts/gen-shadcn-themes.ts",
+    "codegen:fonts": "tsx scripts/gen-shadcn-fonts.ts",
     "audit:spec-drift": "tsx scripts/spec-drift.ts",
     "audit:special-required": "tsx scripts/special-required.ts",
     "audit:output-flag": "tsx scripts/audit-output-flag.ts",

package/dist/chunk-47WDWMBJ.js

@@ -1,14 +0,0 @@
-// src/emit/npm.ts
-import { spawnSync } from "child_process";
-function npmBinary() {
-  return process.platform === "win32" ? "npm.cmd" : "npm";
-}
-function runNpm(args, cwd) {
-  const res = spawnSync(npmBinary(), [...args], { cwd, stdio: "inherit" });
-  return res.status ?? 1;
-}
-
-export {
-  runNpm
-};
-//# sourceMappingURL=chunk-47WDWMBJ.js.map