zframes 0.7.0 → 0.8.0

package/dist/index.js

@@ -55,9 +55,35 @@ var GridPositionSchema = z2.object({
   w: z2.number().int().min(1).describe("Width in grid columns"),
   h: z2.number().int().min(1).describe("Height in grid rows")
 });
+var FrameStyleSchema = z2.object({
+  accentHue: z2.number().int().min(0).max(360).optional().describe(
+    "Override this card's accent hue (0\u2013360) \u2014 its rim, title dot, and highlights. Inherits theme.accentHue if unset."
+  ),
+  accentSat: z2.number().min(0).max(100).optional().describe("Override this card's accent saturation (0\u2013100)."),
+  baseHue: z2.number().int().min(0).max(360).optional().describe(
+    "Override this card's dark surface tint hue (0\u2013360) \u2014 warm or cool just this one card. Inherits theme.baseHue if unset."
+  ),
+  baseSat: z2.number().min(0).max(100).optional().describe("Override this card's surface tint saturation (0\u2013100)."),
+  surfaceOpacity: z2.number().min(0.3).max(1).optional().describe(
+    "Override this card's surface opacity (0.3\u20131) \u2014 drop it toward 0.5 for a single frosted/glassy card over the background."
+  ),
+  radius: z2.number().min(0).optional().describe("Override this card's corner radius in px (0 = square)."),
+  borderStrength: z2.number().min(0).max(1).optional().describe(
+    "Override this card's rim opacity (0\u20131); 0 = borderless flat card."
+  ),
+  density: z2.number().min(0.6).max(1.4).optional().describe("Override this card's padding scale (0.6\u20131.4)."),
+  elevation: z2.number().min(0).max(2).optional().describe(
+    "Override this card's shadow depth (0\u20132); raise it to float a hero card, 0 to flatten one."
+  )
+}).describe(
+  "Per-frame cosmetic overrides \u2014 accent, surface tint, glass, corners, border, padding, shadow \u2014 for THIS card only. Every field optional; omit to inherit the dashboard `theme`/`appearance`."
+);
 var FrameInstanceSchema = z2.object({
   id: z2.string().describe("Unique instance id within the dashboard"),
   frame: z2.string().describe("Name of a registered frame"),
+  style: FrameStyleSchema.optional().describe(
+    "Optional per-frame cosmetic overrides (accent, glass, corners, \u2026) for this card only. Omit to inherit the dashboard theme/appearance."
+  ),
   title: z2.string().optional().describe(
     'Optional custom card title. Omit it to use the frame\'s own polished default label (its catalogue `label`, e.g. "OI by Strike") \u2014 that is the norm. Only set this for a genuinely instance-specific label the default can\'t know, e.g. the ticker on a price-chart ("TSLA") or which outlet a news-feed shows. Never abbreviate. Ignored by chrome-less frames like heading.'
   ),
@@ -70,8 +96,8 @@ var FrameInstanceSchema = z2.object({
   )
 });
 var BackgroundSchema = z2.object({
-  type: z2.enum(["none", "color", "gradient", "unicorn"]).default("none").describe(
-    "Background style: 'none' (the signature dark indigo glow \u2014 the default), 'color' (a solid colour), 'gradient' (a custom two-colour linear gradient), or 'unicorn' (an animated Unicorn Studio scene)."
+  type: z2.enum(["none", "color", "gradient", "unicorn", "image"]).default("none").describe(
+    "Background style: 'none' (the signature dark indigo glow \u2014 the default), 'color' (a solid colour), 'gradient' (a custom two-colour linear gradient), 'unicorn' (an animated Unicorn Studio scene), or 'image' (a full-bleed photo/illustration behind the dashboard, with a legibility scrim)."
   ),
   color: z2.string().default("#0a0a12").describe(
     "Solid background colour (any CSS colour). Used when type is 'color'."
@@ -88,6 +114,18 @@ var BackgroundSchema = z2.object({
   dpi: z2.number().min(0.5).max(3).default(1.5).describe("Unicorn scene device-pixel-ratio cap (perf vs sharpness)."),
   opacity: z2.number().min(0).max(1).default(0.16).describe(
     "Opacity of the unicorn scene (0\u20131). Keep moderate (~0.15) so the animation reads as a living backdrop in the gutters without competing with the (opaque) dashboard cards."
+  ),
+  imageUrl: z2.string().optional().describe(
+    "Background image URL \u2014 required when type is 'image'. An https URL, or a local path served next to the dashboard (e.g. '/hero.png'). Rendered full-bleed behind everything."
+  ),
+  imageFit: z2.enum(["cover", "contain"]).default("cover").describe(
+    "How the background image fills the viewport when type is 'image': 'cover' crops to fill (default), 'contain' letterboxes to show the whole image."
+  ),
+  imageBlur: z2.number().min(0).max(40).default(0).describe(
+    "Gaussian blur applied to the background image in px (0\u201340). Blur a busy photo so the dashboard cards stay readable over it. Used when type is 'image'."
+  ),
+  overlayOpacity: z2.number().min(0).max(1).default(0.55).describe(
+    "Opacity of the dark scrim laid over the background image (0\u20131). Raise it to darken a bright image so card text stays legible; lower it to let the image show through. Used when type is 'image'."
   )
 }).describe("Visual background rendered behind the whole dashboard.");
 var ThemeSchema = z2.object({
@@ -108,9 +146,12 @@ var ThemeSchema = z2.object({
   ),
   downColor: z2.string().regex(/^#[0-9a-fA-F]{6}$/, "must be a 6-digit hex colour like #ff6b81").default("#ff6b81").describe(
     "Semantic colour for losses / negative change / bearish (down). 6-digit hex; default #ff6b81 (red). The counterpart to upColor \u2014 tints every loss delta, mover row, down-candle, and 'short'/'put' marker."
+  ),
+  surface: z2.enum(["dark", "light"]).default("dark").describe(
+    "Overall surface mode. 'dark' (default) is the signature dark dashboard \u2014 light text on dark cards. 'light' flips to a daylight scheme \u2014 dark text on near-white cards \u2014 for a printed/paper or bright-office look. The accent (baseHue tints the surface either way), the semantic up/down colours, and typography are unchanged; only the ink + card lightness invert."
   )
 }).describe(
-  "Dashboard-wide colour identity \u2014 accent (rims/highlights), the dark card-surface tint (base), and the semantic up/down (gain/loss) colours."
+  "Dashboard-wide colour identity \u2014 accent (rims/highlights), the card-surface tint (base), the light/dark surface mode, and the semantic up/down (gain/loss) colours."
 );
 var TypographySchema = z2.object({
   fontFamily: z2.enum(["sans", "mono", "serif"]).default("sans").describe(
@@ -212,7 +253,10 @@ var DashboardSpecSchema = z2.preprocess(
       gradientAngle: 160,
       scale: 1,
       dpi: 1.5,
-      opacity: 0.16
+      opacity: 0.16,
+      imageFit: "cover",
+      imageBlur: 0,
+      overlayOpacity: 0.55
     }),
     theme: ThemeSchema.default({
       accentHue: 242,
@@ -220,7 +264,8 @@ var DashboardSpecSchema = z2.preprocess(
       baseHue: 233,
       baseSat: 20,
       upColor: "#3fd08f",
-      downColor: "#ff6b81"
+      downColor: "#ff6b81",
+      surface: "dark"
     }),
     typography: TypographySchema.default({
       fontFamily: "sans",
@@ -403,6 +448,41 @@ function defineFrameMeta(meta) {
 
 // ../frames/src/schemas.ts
 import { z as z3 } from "zod";
+
+// ../frames/src/custom-data-shared.ts
+function isBlockedHost(hostname) {
+  const host = hostname.toLowerCase().replace(/^\[|\]$/g, "");
+  if (host === "localhost" || host === "0.0.0.0" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal") || host === "::1" || host === "::")
+    return true;
+  const v4 = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+  if (v4) {
+    const [a, b] = [Number(v4[1]), Number(v4[2])];
+    if (a === 127 || a === 10 || a === 0) return true;
+    if (a === 192 && b === 168) return true;
+    if (a === 172 && b >= 16 && b <= 31) return true;
+    if (a === 169 && b === 254) return true;
+    if (a === 100 && b >= 64 && b <= 127) return true;
+  }
+  if (/^f[cd][0-9a-f]{2}:/i.test(host) || /^fe[89ab][0-9a-f]:/i.test(host))
+    return true;
+  return false;
+}
+function validateCustomUrl(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return "not a valid URL";
+  }
+  if (parsed.protocol !== "https:") return "only https:// URLs are allowed";
+  if (parsed.username || parsed.password)
+    return "URLs with embedded credentials are not allowed";
+  if (isBlockedHost(parsed.hostname))
+    return "private/localhost hosts are not allowed";
+  return null;
+}
+
+// ../frames/src/schemas.ts
 var widgetIcon = (name) => `/widget-icons/${name}.png`;
 var SOURCES = {
   hyperliquid: { name: "Hyperliquid", url: "https://hyperliquid.xyz" },
@@ -520,10 +600,13 @@ var noteMeta = defineFrameMeta({
   category: "layout",
   iconUrl: widgetIcon("note"),
   layout: { w: 4, h: 3, minW: 2, minH: 2 },
-  description: "Free-form text note pinned to the dashboard \u2014 trading plans, reminders, watch levels. Needs no data provider.",
+  description: "Free-form text note pinned to the dashboard \u2014 trading plans, reminders, watch levels. Renders a safe Markdown subset: **bold**, *italic*, `inline code`, [links](https://\u2026), #/##/### headings, and - / 1. lists. Plain text still renders as written. Needs no data provider.",
   capabilities: [],
+  chrome: "plain",
   schema: z3.object({
-    text: z3.string().min(1).describe("The note's text content. Plain text; newlines are preserved."),
+    text: z3.string().min(1).describe(
+      "The note's text content. Renders a safe Markdown subset \u2014 **bold**, *italic*, `code`, [text](https://url), #/##/### headings, and unordered (-) / ordered (1.) lists (raw HTML is never executed). Blank lines start new paragraphs; single newlines become line breaks. Plain text works too."
+    ),
     align: z3.enum(["left", "center"]).default("left").describe("Text alignment inside the card.")
   })
 });
@@ -847,6 +930,7 @@ var imageMeta = defineFrameMeta({
   layout: { w: 3, h: 3, minW: 1, minH: 1 },
   description: "Displays an image from a URL \u2014 logos, memes, chart screenshots, banners. Needs no data provider.",
   capabilities: [],
+  chrome: "plain",
   schema: z3.object({
     url: z3.string().min(1).describe("Image URL (https)."),
     alt: z3.string().default("").describe("Alt text for accessibility."),
@@ -855,6 +939,57 @@ var imageMeta = defineFrameMeta({
     )
   })
 });
+var heroNumberMeta = defineFrameMeta({
+  name: "hero-number",
+  label: "Hero Number",
+  category: "layout",
+  iconUrl: widgetIcon("hero-number"),
+  layout: { w: 3, h: 2, minW: 2, minH: 1 },
+  description: "A big manual KPI card you fill in yourself \u2014 one headline number, a caption, and an optional signed change. Static text, not a live feed: use it to pin a figure that has no provider (a target, a personal goal, a fact from elsewhere), e.g. '$39.6T' national debt or '127 EH/s' hashrate. Needs no data provider.",
+  capabilities: [],
+  chrome: "plain",
+  schema: z3.object({
+    value: z3.string().min(1).describe(
+      'The headline figure, shown large. Free text so you can include units/symbols, e.g. "$39.6T", "127 EH/s", "4.25%".'
+    ),
+    label: z3.string().default("").describe(
+      'Caption naming what the number is, e.g. "US National Debt". Empty hides it.'
+    ),
+    delta: z3.string().default("").describe(
+      'Optional change chip shown under the number, e.g. "+1.5%" or "-3 blocks". Empty hides it.'
+    ),
+    deltaDir: z3.enum(["up", "down", "neutral"]).default("neutral").describe(
+      "Tint for the delta chip: up = gain color, down = loss color, neutral = muted. Purely cosmetic \u2014 it does not parse the delta text."
+    ),
+    sublabel: z3.string().default("").describe(
+      'Optional small line under the delta for context, e.g. "as of Jul 2026". Empty hides it.'
+    )
+  })
+});
+var imageGalleryMeta = defineFrameMeta({
+  name: "image-gallery",
+  label: "Image Gallery",
+  category: "layout",
+  iconUrl: widgetIcon("image-gallery"),
+  layout: { w: 4, h: 3, minW: 2, minH: 2 },
+  description: "A rotating gallery that cross-fades through a list of images on a timer \u2014 chart screenshots, memes, banners, a mood board. Needs no data provider.",
+  capabilities: [],
+  chrome: "plain",
+  schema: z3.object({
+    images: z3.array(
+      z3.object({
+        url: z3.string().min(1).describe("Image URL (https)."),
+        alt: z3.string().default("").describe("Alt text for accessibility.")
+      })
+    ).min(1).describe("The images to rotate through, in order. At least one."),
+    intervalSec: z3.number().int().min(0).default(6).describe(
+      "Seconds between cross-fades when there is more than one image. 0 shows the first image, fixed."
+    ),
+    fit: z3.enum(["cover", "contain"]).default("cover").describe(
+      "How each image fills the frame: cover crops to fill, contain letterboxes."
+    )
+  })
+});
 var headingMeta = defineFrameMeta({
   name: "heading",
   label: "Heading",
@@ -866,7 +1001,13 @@ var headingMeta = defineFrameMeta({
   chrome: "bare",
   schema: z3.object({
     title: z3.string().min(1).describe("The heading text."),
-    subtitle: z3.string().optional().describe("Smaller supporting line under the title.")
+    subtitle: z3.string().optional().describe("Smaller supporting line under the title."),
+    accent: z3.number().min(0).max(360).optional().describe(
+      "Optional hue (0\u2013360) that tints the marker dot, the rule, and the title. Omit to use the dashboard's own accent (the default look)."
+    ),
+    align: z3.enum(["left", "center"]).default("left").describe(
+      "Left aligns the label with a trailing rule (default); center places the label between rules on both sides."
+    )
   })
 });
 var dailyAnalysisMeta = defineFrameMeta({
@@ -1154,6 +1295,7 @@ var videoMeta = defineFrameMeta({
   layout: { w: 4, h: 3, minW: 2, minH: 2 },
   description: "Embeds a video from a YouTube or Vimeo link (or any direct embed URL) as an iframe \u2014 a livestream, a market-news clip, a focus playlist. Needs no data provider.",
   capabilities: [],
+  chrome: "plain",
   schema: z3.object({
     url: z3.string().min(1).describe(
       "Video URL \u2014 a YouTube watch/share link, a Vimeo link, or a direct embeddable URL (https)."
@@ -1197,6 +1339,7 @@ var linkGridMeta = defineFrameMeta({
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
   description: "A grid of quick-launch tiles linking to your favourite sites \u2014 TradingView, exchanges, news, docs, your own dashboards. Each tile opens in a new tab and shows the destination site's favicon by default (fetched keyless from a public favicon service), with an optional per-link icon override and a first-letter fallback. Needs no data provider.",
   capabilities: [],
+  chrome: "plain",
   schema: z3.object({
     links: z3.array(
       z3.object({
@@ -1247,6 +1390,7 @@ var quoteMeta = defineFrameMeta({
   layout: { w: 4, h: 2, minW: 2, minH: 1 },
   description: 'Displays a market or trading quote, centered \u2014 set one or rotate through several. A calm bit of wall-art for the dashboard: trading maxims, reminders of your own rules, mantras. Write any attribution into the text itself (e.g. "\u2026 \u2014 Buffett"). Needs no data provider.',
   capabilities: [],
+  chrome: "plain",
   schema: z3.object({
     quotes: z3.array(z3.string().min(1)).min(1).default([
       "Be fearful when others are greedy, and greedy when others are fearful. \u2014 Warren Buffett",
@@ -1276,7 +1420,11 @@ var dividerMeta = defineFrameMeta({
     orientation: z3.enum(["horizontal", "vertical"]).default("horizontal").describe(
       "Horizontal rule (spans the width) or vertical rule (spans the height)."
     ),
-    style: z3.enum(["solid", "dashed", "dotted"]).default("solid").describe("Line style.")
+    style: z3.enum(["solid", "dashed", "dotted"]).default("solid").describe("Line style."),
+    accent: z3.number().min(0).max(360).optional().describe(
+      "Optional hue (0\u2013360) that tints the rule and its label. Omit for the default subtle hairline."
+    ),
+    thickness: z3.number().int().min(1).max(8).default(1).describe("Rule thickness in pixels. 1 is the default hairline.")
   })
 });
 var diceMeta = defineFrameMeta({
@@ -2117,210 +2265,1603 @@ var dexPoolTreemapMeta = defineFrameMeta({
     count: z3.number().int().min(5).max(15).default(12).describe("How many trending pools to include (up to 15).")
   })
 });
-var frameMetas = [
-  newsFeedMeta,
-  portfolioValueMeta,
-  portfolioAllocationMeta,
-  portfolioHoldingsMeta,
-  bitcoinDominanceMeta,
-  clockMeta,
-  dailyAnalysisMeta,
-  dinoGameMeta,
-  fearGreedMeta,
-  filingsFeedMeta,
-  fundamentalsMeta,
-  financialStressMeta,
-  laborMarketMeta,
-  nationalDebtMeta,
-  treasuryAuctionsMeta,
-  fundingHeatmapMeta,
-  fundingRateChartMeta,
-  headingMeta,
-  imageMeta,
-  inflationPulseMeta,
-  marketHoursMeta,
-  noteMeta,
-  priceChartMeta,
-  priceCompareMeta,
-  priceLivelineMeta,
-  priceTickerMeta,
-  ratesBoardMeta,
-  fxBoardMeta,
-  shortVolumeMeta,
-  topMoversMeta,
-  tvlTreemapMeta,
-  yieldCurveMeta,
-  dexVolumeTreemapMeta,
-  dexVolumeChartMeta,
-  protocolTvlTreemapMeta,
-  protocolTvlChartMeta,
-  protocolFeesTreemapMeta,
-  marketCapTreemapMeta,
-  openInterestMeta,
-  snakeMeta,
-  flappyBirdMeta,
-  videoMeta,
-  drawdyMeta,
-  countdownMeta,
-  linkGridMeta,
-  calculatorMeta,
-  quoteMeta,
-  dividerMeta,
-  btcFeesMeta,
-  btcMempoolMeta,
-  btcBlocksMeta,
-  btcHashrateMeta,
-  btcDifficultyMeta,
-  miningPoolsMeta,
-  lightningStatsMeta,
-  optionsPutCallMeta,
-  optionsIvMeta,
-  optionsOiStrikeMeta,
-  coinMoversMeta,
-  mvrvMeta,
-  nuplMeta,
-  soprMeta,
-  puellMultipleMeta,
-  mayerMultipleMeta,
-  piCycleMeta,
-  maMultiplierMeta,
-  rsiMomentumMeta,
-  volumeProfileMeta,
-  dxyMeta,
-  cycleSignalsMeta,
-  stablecoinSupplyMeta,
-  yieldScannerMeta,
-  defiRevenueMeta,
-  fundingComparisonMeta,
-  ethSupplyMeta,
-  ethStakingMeta,
-  predictionMarketsMeta,
-  etfFlowsMeta,
-  trendingCoinsMeta,
-  sectorPerformanceMeta,
-  macroCalendarMeta,
-  stablecoinChainsMeta,
-  sectorTreemapMeta,
-  etfFlowsChartMeta,
-  realizedPriceMeta,
-  reserveRiskMeta,
-  nftCollectionsMeta,
-  dexHotPoolsMeta,
-  chainActivityMeta,
-  nftTreemapMeta,
-  dexPoolTreemapMeta
-];
-var allFrameMetas = [
-  ...frameMetas,
-  breakevenMeta,
-  breathingMeta,
-  checklistMeta,
-  dayMeterMeta,
-  diceMeta,
-  holidayCalendarMeta,
-  journalLogMeta,
-  journalOpenMeta,
-  journalResultsMeta,
-  journalScoreMeta,
-  marqueeMeta,
-  pomodoroMeta,
-  returnsProjectorMeta,
-  riskRewardMeta,
-  rulesCardMeta,
-  sessionProgressMeta,
-  spotifyEmbedMeta,
-  stopwatchMeta
-];
-
-// src/dashboards.ts
-import { existsSync } from "fs";
-function list() {
-  const entries = listDashboards();
-  if (entries.length === 0) {
-    console.log(`no dashboards in your store yet (${dashboardsDir()})`);
-    console.log("  create one: npx --yes zframes@latest init <name>");
-    return 0;
-  }
-  console.log(`dashboards in ${dashboardsDir()}:`);
-  for (const e of entries) {
-    const mark = e.isDefault ? "*" : " ";
-    const title = e.title ? `  \u2014 ${e.title}` : "";
-    console.log(`  ${mark} ${e.name}${title}`);
-  }
-  if (entries.some((e) => e.isDefault)) {
-    console.log(
-      "\n  * = default (served when you run `zframes serve` with no name)"
-    );
-  } else {
-    console.log("\n  no default set \u2014 `zframes use <name>` to pick one.");
-  }
-  return 0;
-}
-function use(args) {
-  const name = args.find((a) => !a.startsWith("-"));
-  if (!name) {
-    console.error("usage: zframes use <name>");
-    return 1;
-  }
-  if (!isValidName(name)) {
-    console.error(
-      `\u2717 "${name}" is not a valid dashboard name (lowercase letters, digits, "-", "_")`
-    );
-    return 1;
-  }
-  if (!existsSync(dashboardPath(name))) {
-    console.error(
-      `\u2717 no dashboard named "${name}" in your store (${dashboardsDir()})`
-    );
-    console.error(
-      `  create it with \`zframes init ${name}\`, or run \`zframes list\` to see what's there.`
-    );
-    return 1;
-  }
-  setDefault(name);
-  console.log(`\u2713 default dashboard is now "${name}"`);
-  return 0;
-}
-
-// src/init.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname, resolve as resolve2 } from "path";
-
-// ../spec/src/presets.ts
-var SCENE_DEFAULT_PROJECT_ID = "YrTzGatwjK7EoFpCSfgZ";
-
-// src/init.ts
-function parseArgs(args) {
-  let target = "dashboard.json";
-  let title = "my dashboard";
-  let author = "";
-  let force = false;
-  let makeDefault = false;
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === "--title" || a === "-t") {
-      title = args[++i] ?? "";
-    } else if (a.startsWith("--title=")) {
-      title = a.slice("--title=".length);
-    } else if (a === "--author" || a === "-a") {
-      author = args[++i] ?? "";
-    } else if (a.startsWith("--author=")) {
-      author = a.slice("--author=".length);
-    } else if (a === "--force" || a === "-f") {
-      force = true;
-    } else if (a === "--default") {
-      makeDefault = true;
-    } else if (!a.startsWith("-")) {
-      target = a;
-    } else {
-      return { error: `unknown option "${a}"` };
-    }
-  }
-  if (!title.trim()) return { error: "--title cannot be empty" };
-  return { target, title, author, force, makeDefault };
-}
-function resolveDest(target) {
-  const c = classifyTarget(target, process.cwd());
+var sectorBarsMeta = defineFrameMeta({
+  name: "sector-bars",
+  label: "Sector Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("sector-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Crypto sector rotation as a diverging bar chart \u2014 market categories (L1s, DeFi, AI, memes, RWA, \u2026) ranked by 24h market-cap change, gains right in green, losses left in red. The chart-first sibling of the Sector Performance list. Keyless (CoinGecko categories).",
+  capabilities: ["sector-performance"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(4).max(20).default(10).describe("How many sectors (by absolute 24h change) to chart.")
+  })
+});
+var fundingBarsMeta = defineFrameMeta({
+  name: "funding-bars",
+  label: "Funding by Venue",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-bars"),
+  layout: { w: 4, h: 3, minW: 3, minH: 2 },
+  description: "One coin's predicted perpetual funding rate compared across venues (Hyperliquid vs Binance vs Bybit) as a diverging bar chart of annualized rates \u2014 positive funding (longs pay) in green, negative in red. Makes a funding-arb spread visible at a glance. Keyless (Hyperliquid predicted fundings).",
+  capabilities: ["funding-comparison"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    coin: z3.string().min(1).default("BTC").describe('Coin to compare across venues, e.g. "BTC", "ETH", "SOL".')
+  })
+});
+var etfFlowBarsMeta = defineFrameMeta({
+  name: "etf-flow-bars",
+  label: "ETF Flow Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("etf-flow-bars"),
+  layout: { w: 6, h: 3, minW: 3, minH: 3 },
+  description: "Spot BTC or ETH ETF daily net flows as diverging bars \u2014 one bar per day, inflows up in green, outflows down in red. The classic ETF-flow chart; complements the cumulative line and per-issuer snapshot. Keyless (SoSoValue); best-effort, may be empty if the source is unavailable.",
+  capabilities: ["etf-flows"],
+  source: SOURCES.sosovalue,
+  schema: z3.object({
+    asset: z3.enum(["btc", "eth"]).default("btc").describe("Which spot-ETF complex to chart."),
+    lookback: z3.enum(["1M", "3M", "6M"]).default("1M").describe("History window for the daily-flow bars.")
+  })
+});
+var chainActivityBarsMeta = defineFrameMeta({
+  name: "chain-activity-bars",
+  label: "Chain Activity Bars",
+  category: "onchain",
+  iconUrl: widgetIcon("chain-activity-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "24h confirmed transactions per major L1 (Bitcoin, Ethereum, Litecoin, Dogecoin, \u2026) as a horizontal bar chart, ranked busiest-first \u2014 cross-chain usage compared at a glance. The chart-first sibling of the Chain Activity table. Keyless (Blockchair).",
+  capabilities: ["chain-activity"],
+  source: SOURCES.blockchair,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(12).default(8).describe("How many chains (by 24h transactions) to chart.")
+  })
+});
+var marketScatterMeta = defineFrameMeta({
+  name: "market-scatter",
+  label: "Market Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("market-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Top coins as a bubble scatter \u2014 24h price change on the x-axis, market cap on a log y-axis, bubble size by market cap. Shows in one view whether large caps or small caps are moving, and who's the outlier. Keyless (CoinGecko top-50 by market cap).",
+  capabilities: ["coin-markets"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(50).default(30).describe("How many top coins (by market cap) to plot.")
+  })
+});
+var marketBubblesMeta = defineFrameMeta({
+  name: "market-bubbles",
+  label: "Market Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("market-bubbles"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "Top coins as a floating bubble cloud \u2014 one logo bubble per coin, area by market cap, ring tinted green/red by 24h change. A playful at-a-glance map of where the market's weight sits; bubbles are draggable. Keyless (CoinGecko top-50 by market cap).",
+  capabilities: ["coin-markets"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(50).default(25).describe("How many top coins (by market cap) to show."),
+    sizeBy: z3.enum(["market-cap", "change"]).default("market-cap").describe(
+      "Bubble sizing \u2014 'market-cap' weights by market cap, 'change' weights by absolute 24h % move (today's action, not size)."
+    )
+  })
+});
+var bubbleTopN = (max, def, what) => z3.number().int().min(3).max(max).default(def).describe(`How many of the largest ${what} to show.`);
+var tvlBubblesMeta = defineFrameMeta({
+  name: "tvl-bubbles",
+  label: "TVL Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("tvl-bubbles"),
+  layout: { w: 6, h: 4, minW: 3, minH: 3 },
+  description: "Blockchain ecosystems as a floating bubble cloud, area by total value locked (TVL) \u2014 the bubble-chart sibling of the TVL treemap. Data from DeFiLlama. Draggable, playful answer to 'where does on-chain capital live'.",
+  capabilities: ["tvl"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    topN: bubbleTopN(30, 14, "chains")
+  })
+});
+var protocolTvlBubblesMeta = defineFrameMeta({
+  name: "protocol-tvl-bubbles",
+  label: "Protocol TVL Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("protocol-tvl-bubbles"),
+  layout: { w: 6, h: 4, minW: 3, minH: 3 },
+  description: "DeFi protocols as a bubble cloud \u2014 area by total value locked (TVL), ring tinted green/red by 1-day change. Data from DeFiLlama. Unlike tvl-bubbles (chains), this ranks individual protocols (Lido, Aave, EigenLayer\u2026).",
+  capabilities: ["protocol-tvl"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    topN: bubbleTopN(30, 14, "protocols by TVL")
+  })
+});
+var dexVolumeBubblesMeta = defineFrameMeta({
+  name: "dex-volume-bubbles",
+  label: "DEX Volume Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("dex-volume-bubbles"),
+  layout: { w: 6, h: 4, minW: 3, minH: 3 },
+  description: "Decentralized exchanges as a bubble cloud \u2014 area by trailing-24h trading volume, ring tinted green/red by 1-day change. Data from DeFiLlama. Where on-chain trading flow is concentrated right now.",
+  capabilities: ["dex-volume"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    topN: bubbleTopN(30, 14, "DEX protocols by 24h volume")
+  })
+});
+var protocolFeesBubblesMeta = defineFrameMeta({
+  name: "protocol-fees-bubbles",
+  label: "Protocol Fees Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("protocol-fees-bubbles"),
+  layout: { w: 6, h: 4, minW: 3, minH: 3 },
+  description: "Protocols as a bubble cloud \u2014 area by fees generated in the last 24h, ring tinted green/red by 1-day change. Data from DeFiLlama. Where users are actually paying for blockspace and services.",
+  capabilities: ["protocol-fees"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    topN: bubbleTopN(30, 14, "fee-earning protocols")
+  })
+});
+var sectorBubblesMeta = defineFrameMeta({
+  name: "sector-bubbles",
+  label: "Sector Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("sector-bubbles"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Crypto sector rotation as a bubble cloud \u2014 each category's area by market cap, ring tinted green/red by 24h change. The bubble-chart sibling of the sector treemap. Keyless (CoinGecko categories).",
+  capabilities: ["sector-performance"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(6).max(30).default(16).describe("How many sectors to show.")
+  })
+});
+var nftBubblesMeta = defineFrameMeta({
+  name: "nft-bubbles",
+  label: "NFT Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("nft-bubbles"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Blue-chip NFT collections as a bubble cloud \u2014 area by market capitalisation, ring tinted green/red by 24h floor-price change. Keyless (CoinGecko free tier).",
+  capabilities: ["nft-market"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    topN: z3.number().int().min(4).max(10).default(8).describe("How many collections to show (up to 10 curated majors).")
+  })
+});
+var dexPoolBubblesMeta = defineFrameMeta({
+  name: "dex-pool-bubbles",
+  label: "DEX Pool Bubbles",
+  category: "onchain",
+  iconUrl: widgetIcon("dex-pool-bubbles"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Trending DEX pools on a chain as a bubble cloud \u2014 area by 24h trading volume, ring tinted green/red by 24h price change. Which pairs are pulling the most on-chain volume. Keyless (GeckoTerminal free tier).",
+  capabilities: ["dex-pools"],
+  source: SOURCES.geckoterminal,
+  schema: z3.object({
+    network: z3.enum(["eth", "solana", "base", "arbitrum", "bsc", "polygon_pos"]).default("eth").describe("Which chain's trending pools to show."),
+    count: z3.number().int().min(5).max(15).default(12).describe("How many trending pools to include (up to 15).")
+  })
+});
+var moversBubblesMeta = defineFrameMeta({
+  name: "movers-bubbles",
+  label: "Movers Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("movers-bubbles"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "The broad market's biggest movers as a bubble cloud \u2014 logo bubbles sized by the magnitude of the move over a chosen window, green for gainers, red for losers. Today's action at a glance, regardless of coin size. Keyless (CoinPaprika, ~2000 coins).",
+  capabilities: ["coin-movers"],
+  source: SOURCES.coinpaprika,
+  schema: z3.object({
+    window: z3.enum(["1h", "24h", "7d", "30d"]).default("24h").describe("Price-change window the movers are ranked by."),
+    limit: z3.number().int().min(6).max(30).default(18).describe("Total bubbles \u2014 split evenly into top gainers and losers.")
+  })
+});
+var sentimentGaugeMeta = defineFrameMeta({
+  name: "sentiment-gauge",
+  label: "Sentiment Gauge",
+  category: "crypto",
+  iconUrl: widgetIcon("sentiment-gauge"),
+  layout: { w: 3, h: 3, minW: 2, minH: 2 },
+  description: "Crypto fear & greed index as a radial gauge \u2014 the arc fills from extreme fear (0) to extreme greed (100) in the mood color, with the reading and classification in the center. A dial-style alternative to the Fear & Greed sparkline card. Keyless (alternative.me).",
+  capabilities: ["sentiment"],
+  source: SOURCES.alternativeMe,
+  schema: z3.object({})
+});
+var moversBarsMeta = defineFrameMeta({
+  name: "movers-bars",
+  label: "Movers Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("movers-bars"),
+  layout: { w: 4, h: 5, minW: 3, minH: 4 },
+  description: "Top gainers and losers across the broad crypto market as a diverging bar chart \u2014 the biggest movers over a chosen window, gains right in green, losses left in red, ranked by size. The chart-first sibling of the Coin Movers list. Keyless (CoinPaprika, ~2000 coins).",
+  capabilities: ["coin-movers"],
+  source: SOURCES.coinpaprika,
+  schema: z3.object({
+    window: z3.enum(["1h", "24h", "7d", "30d"]).default("24h").describe("Price-change window the movers are ranked by."),
+    limit: z3.number().int().min(6).max(20).default(12).describe("Total bars \u2014 split evenly into top gainers and top losers.")
+  })
+});
+var tvlBarsMeta = defineFrameMeta({
+  name: "tvl-bars",
+  label: "TVL by Chain Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("tvl-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Total value locked (TVL) per blockchain as a horizontal bar chart, ranked largest-first \u2014 DeFi capital compared across chains at a glance. The chart-first sibling of the TVL treemap. Keyless (DeFiLlama).",
+  capabilities: ["tvl"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(4).max(20).default(10).describe("How many chains (by TVL) to chart.")
+  })
+});
+var yieldScatterMeta = defineFrameMeta({
+  name: "yield-scatter",
+  label: "Yield Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("yield-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "DeFi yield pools as a risk/reward bubble scatter \u2014 total APY on the x-axis, pool TVL on a log y-axis, bubble size by TVL. Surfaces the deep, high-yield pools (top-right) versus thin outliers in one view. The chart-first sibling of the Yield Scanner list. Keyless (DeFiLlama).",
+  capabilities: ["yields"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(60).default(40).describe("How many pools (by TVL) to plot."),
+    maxApy: z3.number().min(10).max(1e3).default(100).describe(
+      "Hide pools whose APY exceeds this, so extreme incentive outliers don't crush the x-axis."
+    ),
+    stablecoinOnly: z3.boolean().default(false).describe("Restrict to stablecoin pools only.")
+  })
+});
+var nftScatterMeta = defineFrameMeta({
+  name: "nft-scatter",
+  label: "NFT Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("nft-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Blue-chip NFT collections as a bubble scatter \u2014 24h floor change on the x-axis, 24h trading volume on a log y-axis, bubble size by market cap. Shows which collections are moving on real volume versus thin floors. The chart-first sibling of the NFT Collections list. Keyless (CoinGecko, curated slugs).",
+  capabilities: ["nft-market"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(15).default(12).describe("How many collections (by market cap) to plot.")
+  })
+});
+var dominanceGaugeMeta = defineFrameMeta({
+  name: "dominance-gauge",
+  label: "Dominance Gauge",
+  category: "crypto",
+  iconUrl: widgetIcon("dominance-gauge"),
+  layout: { w: 3, h: 3, minW: 2, minH: 2 },
+  description: "One asset's share of total crypto market cap as a radial gauge \u2014 the arc fills from 0% to 100% dominance with the reading in the center. A dial-style alternative to the segmented Bitcoin Dominance bar. Keyless (CoinGecko global).",
+  capabilities: ["global-market"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    coin: z3.enum(["btc", "eth"]).default("btc").describe("Which asset's market-cap dominance to gauge.")
+  })
+});
+var putCallGaugeMeta = defineFrameMeta({
+  name: "put-call-gauge",
+  label: "Put/Call Gauge",
+  category: "derivatives",
+  iconUrl: widgetIcon("put-call-gauge"),
+  layout: { w: 3, h: 3, minW: 2, minH: 2 },
+  description: "Options put/call ratio as a radial gauge \u2014 the arc reads from 0 (all calls, bullish) through 1 (balanced) toward 2 (put-heavy, defensive), colored green below 1 and red above. A dial-style alternative to the Put/Call Ratio card. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Options underlying to read the ratio for."),
+    basis: z3.enum(["oi", "volume"]).default("oi").describe("Ratio basis \u2014 open interest or 24h contract volume.")
+  })
+});
+var customDataMeta = defineFrameMeta({
+  name: "custom-data",
+  label: "Custom Data",
+  category: "tools",
+  iconUrl: widgetIcon("custom-data"),
+  layout: { w: 4, h: 3, minW: 2, minH: 2 },
+  description: "The escape hatch: renders ANY keyless HTTPS JSON API as a stat, line chart, bars, or label\u2192value table \u2014 for data no built-in frame covers (weather, sports, public stats, niche feeds). Fetches browser-direct, so the API must be CORS-open, need no key, and be public https (localhost/private hosts are refused). Point `values` at the JSON with a dot/bracket path \u2014 e.g. 'hourly.temperature_2m', 'data[0].price', 'items[*].name'. A path resolving to an array charts as a series; a scalar shows as a stat. Verify the URL and path against a real response before emitting them.",
+  capabilities: [],
+  schema: z3.object({
+    url: z3.string().min(1).refine((u) => validateCustomUrl(u) === null, {
+      message: "must be a public https:// URL (no credentials, no localhost/private hosts)"
+    }).default(
+      "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd"
+    ).describe(
+      "The JSON endpoint, public https only. Must be CORS-open and keyless \u2014 never embed an API key or token; the spec is shareable. Include query params in the URL."
+    ),
+    values: z3.string().min(1).max(200).default("bitcoin.usd").describe(
+      "Dot/bracket path to the value(s) inside the response, e.g. 'hourly.temperature_2m' (array \u2192 series), 'data[0].price' (scalar \u2192 stat), 'items[*].volume' ([*] maps over an array). No expressions \u2014 keys, [indices], and [*] only."
+    ),
+    labels: z3.string().max(200).default("").describe(
+      "Optional path to a parallel array of labels \u2014 x-axis ticks for bars, row names for the table, e.g. 'hourly.time' or 'items[*].name'. Empty = positional indices."
+    ),
+    display: z3.enum(["stat", "line", "bars", "table"]).default("stat").describe(
+      "How to render: stat = big headline number (last value) with sparkline history; line = the series as a line chart; bars = labelled bar chart; table = label \u2192 value rows."
+    ),
+    label: z3.string().max(80).default("").describe(
+      'Caption naming the metric, e.g. "Bangkok Temp (\xB0C)". Empty shows only the API hostname.'
+    ),
+    unit: z3.string().max(12).default("").describe(
+      'Unit suffix appended to numeric values, e.g. "\xB0C", "%", "km".'
+    ),
+    refreshMinutes: z3.number().int().min(1).max(1440).default(15).describe(
+      "Re-fetch interval in minutes. Be polite to free APIs \u2014 15+ unless the data genuinely moves faster."
+    )
+  })
+});
+var oiTreemapMeta = defineFrameMeta({
+  name: "oi-treemap",
+  label: "OI Treemap",
+  category: "derivatives",
+  iconUrl: widgetIcon("oi-treemap"),
+  layout: { w: 6, h: 4, minW: 3, minH: 3 },
+  description: "Treemap of live Hyperliquid open interest, sized by USD notional \u2014 largest markets first, the long tail rolled into a single 'Other' tile. A single-glance map of where perp capital concentrates right now. Keyless (Hyperliquid).",
+  capabilities: ["open-interest"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(30).default(12).describe(
+      "How many of the largest open-interest markets to show as individual tiles before rolling the rest into a single 'Other' tile."
+    )
+  })
+});
+var ohlcvVolumeBarsMeta = defineFrameMeta({
+  name: "ohlcv-volume-bars",
+  label: "OHLCV Volume Bars",
+  category: "derivatives",
+  iconUrl: widgetIcon("ohlcv-volume-bars"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Per-candle trading volume for one Hyperliquid symbol as vertical bars over time, each bar tinted green when that candle closed up and red when it closed down. Works for any HIP-3 perp (stocks, indices, commodities) and crypto. Keyless (Hyperliquid).",
+  capabilities: ["ohlcv"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    symbol: z3.string().min(1).describe(
+      'Hyperliquid symbol to chart volume for. HIP-3 cross-asset: stocks "xyz:TSLA"/"xyz:NVDA", indices "xyz:SP500", commodities "xyz:GOLD". Crypto: "BTC", "ETH".'
+    ),
+    interval: z3.enum(["1m", "5m", "15m", "1h", "4h", "1d"]).default("1h").describe("Candle interval each volume bar represents.")
+  })
+});
+var fundingSpreadBarsMeta = defineFrameMeta({
+  name: "funding-spread-bars",
+  label: "Funding Spread Bars",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-spread-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Cross-venue predicted funding-rate spread per coin (max \u2212 min annualized rate across Hyperliquid/Binance/Bybit) as a ranked horizontal bar chart \u2014 the widest spreads are the clearest funding-arbitrage or crowded-positioning candidates. The bars-first sibling of Cross-Venue Funding. Keyless (Hyperliquid predicted fundings).",
+  capabilities: ["funding-comparison"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(20).default(10).describe("How many coins (by cross-venue funding spread) to chart.")
+  })
+});
+var fundingVenueHeatmapMeta = defineFrameMeta({
+  name: "funding-venue-heatmap",
+  label: "Funding Venue Heatmap",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-venue-heatmap"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "Heatmap of predicted annualized funding rates \u2014 coins as rows, venues (Hyperliquid/Binance/Bybit) as columns, green positive / red negative. Spots which venue is paying up (or charging) for a given coin at a glance. Keyless (Hyperliquid predicted fundings).",
+  capabilities: ["funding-comparison"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(8).describe(
+      "How many coins (by cross-venue funding spread) to include as heatmap rows."
+    )
+  })
+});
+var fundingCarryAreaMeta = defineFrameMeta({
+  name: "funding-carry-area",
+  label: "Funding Carry",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-carry-area"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Stacked area of each symbol's running cumulative funding cost or benefit over a configurable lookback \u2014 the running total a position would have paid or earned in funding, symbol by symbol. Shows whether carry has been a persistent drag or tailwind. Keyless (Hyperliquid).",
+  capabilities: ["funding-history"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    symbols: z3.array(z3.string()).min(1).max(6).describe(
+      'Hyperliquid symbols to compare cumulative funding carry for, e.g. ["BTC", "ETH"]. Up to 6.'
+    ),
+    lookback: z3.enum(["24h", "7D", "1M"]).default("7D").describe("History window for the cumulative funding-carry chart.")
+  })
+});
+var volumeShareDonutMeta = defineFrameMeta({
+  name: "volume-share-donut",
+  label: "Volume Share Donut",
+  category: "derivatives",
+  iconUrl: widgetIcon("volume-share-donut"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Donut of 24h Hyperliquid trading volume share across the busiest symbols, top symbols as slices with the long tail rolled into 'Other'. Shows where perp trading activity concentrates right now. Keyless (Hyperliquid).",
+  capabilities: ["day-stats"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(7).describe(
+      "How many top symbols (by 24h notional volume) to show as individual slices before rolling the rest into a single 'Other' slice."
+    )
+  })
+});
+var volumeMoversScatterMeta = defineFrameMeta({
+  name: "volume-movers-scatter",
+  label: "Volume Movers Scatter",
+  category: "derivatives",
+  iconUrl: widgetIcon("volume-movers-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Hyperliquid perps as a bubble scatter \u2014 24h price change on the x-axis, 24h notional volume on a log y-axis, bubble size by volume. Shows whether the busiest markets are also the biggest movers, or diverging. Keyless (Hyperliquid).",
+  capabilities: ["day-stats"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(60).default(40).describe(
+      "How many of the busiest symbols (by 24h notional volume) to plot."
+    )
+  })
+});
+var fundingLeaderboardBarsMeta = defineFrameMeta({
+  name: "funding-leaderboard-bars",
+  label: "Funding Leaderboard",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-leaderboard-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Predicted hourly funding rate ranked across the whole Hyperliquid universe \u2014 crypto and HIP-3 equities together \u2014 as a diverging bar chart, largest absolute rates first. Surfaces the most expensive (or most rewarded) side to hold right now. Keyless (Hyperliquid).",
+  capabilities: ["day-stats"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(20).default(10).describe("How many symbols (by absolute funding rate) to chart.")
+  })
+});
+var fundingCrowdingScatterMeta = defineFrameMeta({
+  name: "funding-crowding-scatter",
+  label: "Funding Crowding Scatter",
+  category: "derivatives",
+  iconUrl: widgetIcon("funding-crowding-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "24h price change (x) vs predicted funding rate (y) across Hyperliquid perps, bubble size by open interest \u2014 the combination of a stretched funding rate and heavy open interest flags a crowded, squeeze-prone position. Keyless (Hyperliquid).",
+  capabilities: ["day-stats", "open-interest"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(60).default(40).describe("How many symbols (by open interest) to plot.")
+  })
+});
+var liquidityBasisBarsMeta = defineFrameMeta({
+  name: "liquidity-basis-bars",
+  label: "Liquidity & Basis Bars",
+  category: "derivatives",
+  iconUrl: widgetIcon("liquidity-basis-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Ranked horizontal bars of a chosen liquidity/pricing metric across Hyperliquid perps \u2014 either the bid/ask impact-price spread (% of mark price) or the mark-vs-oracle basis (bps). Surfaces the least liquid or most stretched markets at a glance. Keyless (Hyperliquid).",
+  capabilities: ["day-stats"],
+  source: SOURCES.hyperliquid,
+  schema: z3.object({
+    metric: z3.enum(["spread", "basis"]).default("spread").describe(
+      'Which liquidity metric to rank by: "spread" (bid/ask impact-price spread as a % of mark price) or "basis" (mark-vs-oracle premium in basis points).'
+    ),
+    limit: z3.number().int().min(3).max(20).default(10).describe(
+      "How many symbols (by the chosen metric's magnitude) to chart."
+    )
+  })
+});
+var coinMomentumHeatmapMeta = defineFrameMeta({
+  name: "coin-momentum-heatmap",
+  label: "Coin Momentum Heatmap",
+  category: "crypto",
+  iconUrl: widgetIcon("coin-momentum-heatmap"),
+  layout: { w: 5, h: 5, minW: 4, minH: 3 },
+  description: "Top coins by market-cap rank as a momentum heatmap \u2014 rows are coins, columns are 1h/24h/7d/30d change windows, colored diverging green/red by magnitude. Spot which coins are heating up (or cooling off) across every timeframe at a glance. Keyless (CoinPaprika, ~2000 coins).",
+  capabilities: ["coin-movers"],
+  source: SOURCES.coinpaprika,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(30).default(15).describe("How many top coins (by market-cap rank) to include as rows.")
+  })
+});
+var coinMomentumScatterMeta = defineFrameMeta({
+  name: "coin-momentum-scatter",
+  label: "Coin Momentum Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("coin-momentum-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Broad-market coins as a momentum scatter \u2014 24h change on the x-axis, 7d change on the y-axis, bubble size by market cap, colored by 24h direction. Reveals whether today's move is a continuation or a reversal of the week's trend. Keyless (CoinPaprika, ~2000 coins).",
+  capabilities: ["coin-movers"],
+  source: SOURCES.coinpaprika,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(100).default(50).describe("How many top coins (by market-cap rank) to plot.")
+  })
+});
+var trendingBarsMeta = defineFrameMeta({
+  name: "trending-bars",
+  label: "Trending Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("trending-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "The coins with the most search interest right now on CoinGecko as a diverging bar chart \u2014 24h change per trending coin, gains right in green, losses left in red. The chart-first sibling of the Trending Coins list. Keyless (CoinGecko).",
+  capabilities: ["trending-coins"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(7).describe("How many trending coins to chart.")
+  })
+});
+var nftActivityBarsMeta = defineFrameMeta({
+  name: "nft-activity-bars",
+  label: "NFT Activity Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("nft-activity-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Blue-chip NFT collections ranked by 24h sales count as a horizontal bar chart \u2014 which collections are actually trading, not just holding a floor price. The chart-first sibling of the NFT Collections list. Keyless (CoinGecko, curated slugs).",
+  capabilities: ["nft-market"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(15).default(10).describe("How many collections (by 24h sales) to chart.")
+  })
+});
+var dominanceBarsMeta = defineFrameMeta({
+  name: "dominance-bars",
+  label: "Dominance Bars",
+  category: "markets",
+  iconUrl: widgetIcon("dominance-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Market-cap dominance for every asset in CoinGecko's global snapshot \u2014 not just BTC and ETH \u2014 as a horizontal bar chart, ranked largest-first. Surfaces the next tier (USDT, BNB, SOL, \u2026) the segmented Bitcoin Dominance bar collapses into 'Others'. Keyless (CoinGecko).",
+  capabilities: ["global-market"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(8).describe("How many assets (by market-cap dominance) to chart.")
+  })
+});
+var trendingBubblesMeta = defineFrameMeta({
+  name: "trending-bubbles",
+  label: "Trending Bubbles",
+  category: "crypto",
+  iconUrl: widgetIcon("trending-bubbles"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "The coins with the most search interest right now on CoinGecko as a floating bubble cloud \u2014 bubble area by |24h change|, ring tinted green/red by direction. A movement-first alternative to the Trending Coins list. Keyless (CoinGecko).",
+  capabilities: ["trending-coins"],
+  source: SOURCES.coingecko,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(10).describe("How many trending coins to show.")
+  })
+});
+var yieldRiskPieMeta = defineFrameMeta({
+  name: "yield-risk-pie",
+  label: "Yield Risk Pie",
+  category: "crypto",
+  iconUrl: widgetIcon("yield-risk-pie"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "DeFi yield pools grouped by impermanent-loss risk as a donut, sliced by total value locked (TVL) \u2014 no-IL-risk, IL-risk, and unknown, summed across every pool. A quick read on how much yield-seeking capital carries IL exposure. Keyless (DeFiLlama).",
+  capabilities: ["yields"],
+  source: SOURCES.defillama,
+  schema: z3.object({})
+});
+var dexPoolLiquidityScatterMeta = defineFrameMeta({
+  name: "dex-pool-liquidity-scatter",
+  label: "DEX Pool Liquidity Scatter",
+  category: "onchain",
+  iconUrl: widgetIcon("dex-pool-liquidity-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Trending DEX pools on a chain as a liquidity-vs-volume bubble scatter \u2014 pool reserves on a log x-axis, 24h trading volume on a log y-axis, bubble size by 24h trade count, tinted green/red by 24h price change. Surfaces deep, active pools versus thin or quiet ones. Keyless (GeckoTerminal free tier).",
+  capabilities: ["dex-pools"],
+  source: SOURCES.geckoterminal,
+  schema: z3.object({
+    network: z3.enum(["eth", "solana", "base", "arbitrum", "bsc", "polygon_pos"]).default("eth").describe("Which chain's trending pools to show."),
+    count: z3.number().int().min(5).max(15).default(12).describe("How many trending pools to plot (up to 15).")
+  })
+});
+var protocolFeesVsTvlScatterMeta = defineFrameMeta({
+  name: "protocol-fees-vs-tvl-scatter",
+  label: "Protocol Fees vs TVL Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("protocol-fees-vs-tvl-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "DeFi protocols as a fees-vs-TVL bubble scatter \u2014 total value locked on a log x-axis, trailing-24h fees on a log y-axis, bubble size by fees. Surfaces capital-efficient protocols earning outsized fees on their TVL versus large-but-quiet ones. Only protocols DeFiLlama reports both a TVL and a fees figure for are plotted. Keyless (DeFiLlama).",
+  capabilities: ["protocol-tvl", "protocol-fees"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(40).default(20).describe("How many protocols (by 24h fees) to plot.")
+  })
+});
+var yieldCompositionScatterMeta = defineFrameMeta({
+  name: "yield-composition-scatter",
+  label: "Yield Composition Scatter",
+  category: "crypto",
+  iconUrl: widgetIcon("yield-composition-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "DeFi yield pools as a base-vs-reward APY scatter \u2014 organic (base) APY on the x-axis, incentive (reward) APY on the y-axis, bubble size by TVL. Separates pools earning real organic yield from ones propped up by token incentives. Keyless (DeFiLlama).",
+  capabilities: ["yields"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(10).max(60).default(40).describe("How many pools (by TVL) to plot."),
+    stablecoinOnly: z3.boolean().default(false).describe("Restrict to stablecoin pools only.")
+  })
+});
+var protocolTvlByCategoryMeta = defineFrameMeta({
+  name: "protocol-tvl-by-category",
+  label: "Protocol TVL by Category",
+  category: "crypto",
+  iconUrl: widgetIcon("protocol-tvl-by-category"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Total value locked (TVL) summed by DeFiLlama category \u2014 Dexes, Lending, Liquid Staking, and more \u2014 as a horizontal bar chart ranked largest-first. Shows which slice of DeFi actually holds the capital. Keyless (DeFiLlama).",
+  capabilities: ["protocol-tvl"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(4).max(20).default(10).describe("How many DeFi categories (by summed TVL) to chart.")
+  })
+});
+var protocolTvlShareAreaMeta = defineFrameMeta({
+  name: "protocol-tvl-share-area",
+  label: "Protocol TVL Share Area",
+  category: "crypto",
+  iconUrl: widgetIcon("protocol-tvl-share-area"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Stacked area chart of total value locked (TVL) for several DeFi protocols over a lookback window, each protocol's slice stacked to show the combined total and how the mix shifts over time. The composition-focused sibling of the Protocol TVL Chart's overlaid lines. Data from DeFiLlama (daily granularity).",
+  capabilities: ["protocol-tvl"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    protocols: z3.array(z3.string()).min(1).max(6).describe(
+      'DeFiLlama protocol slugs (lowercase, hyphenated), e.g. ["lido", "aave", "eigenlayer"]. 1 to 6.'
+    ),
+    lookback: z3.enum(["7D", "1M", "3M"]).default("1M").describe("History window for the chart.")
+  })
+});
+var dexVolumeShareAreaMeta = defineFrameMeta({
+  name: "dex-volume-share-area",
+  label: "DEX Volume Share Area",
+  category: "crypto",
+  iconUrl: widgetIcon("dex-volume-share-area"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Stacked area chart of daily DEX trading volume for several protocols over a lookback window, stacked to show combined volume and how each DEX's share shifts over time. The composition-focused sibling of the DEX Volume Chart's overlaid lines. Data from DeFiLlama (daily granularity).",
+  capabilities: ["dex-volume"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    protocols: z3.array(z3.string()).min(1).max(6).describe(
+      'DeFiLlama DEX protocol slugs (lowercase, hyphenated), e.g. ["uniswap", "pancakeswap", "aerodrome-slipstream"]. 1 to 6.'
+    ),
+    lookback: z3.enum(["7D", "1M", "3M"]).default("1M").describe("History window for the chart.")
+  })
+});
+var yieldMomentumBarsMeta = defineFrameMeta({
+  name: "yield-momentum-bars",
+  label: "Yield Momentum Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("yield-momentum-bars"),
+  layout: { w: 4, h: 5, minW: 3, minH: 4 },
+  description: "DeFi yield pools ranked by 7-day APY change as a diverging bar chart \u2014 the biggest APY gains and drops over the past week, filtered above a TVL floor to skip dust pools. Surfaces where yields are heating up or cooling off. Keyless (DeFiLlama).",
+  capabilities: ["yields"],
+  source: SOURCES.defillama,
+  schema: z3.object({
+    limit: z3.number().int().min(6).max(20).default(12).describe(
+      "How many pools to chart, split into the largest 7-day APY gains and drops."
+    ),
+    minTvlUsd: z3.number().min(0).default(1e6).describe("Minimum pool TVL in USD \u2014 a liquidity floor to hide dust.")
+  })
+});
+var btcDifficultyChartMeta = defineFrameMeta({
+  name: "btc-difficulty-chart",
+  label: "BTC Difficulty Chart",
+  category: "bitcoin",
+  iconUrl: widgetIcon("btc-difficulty-chart"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Bitcoin network difficulty over time as a line chart, with the current difficulty and hashrate as headline figures \u2014 the long-run mining-cost trend, charted rather than a single retarget countdown. Keyless (mempool.space).",
+  capabilities: ["btc-hashrate"],
+  source: SOURCES.mempool,
+  schema: z3.object({
+    window: z3.enum(["1y", "2y", "3y"]).default("1y").describe("History window for the difficulty line.")
+  })
+});
+var btcBlockSizeBarsMeta = defineFrameMeta({
+  name: "btc-block-size-bars",
+  label: "BTC Block Size Bars",
+  category: "bitcoin",
+  iconUrl: widgetIcon("btc-block-size-bars"),
+  layout: { w: 5, h: 4, minW: 3, minH: 3 },
+  description: "Recent Bitcoin block sizes as a vertical bar chart, oldest to newest \u2014 spot when blocks are running full (near the ~4MB weight limit) versus half-empty. The chart-first sibling of the BTC Blocks feed. Keyless (mempool.space).",
+  capabilities: ["btc-blocks"],
+  source: SOURCES.mempool,
+  schema: z3.object({
+    count: z3.number().int().min(3).max(15).default(8).describe("How many recent blocks to chart (oldest \u2192 newest).")
+  })
+});
+var chainPriceMoversMeta = defineFrameMeta({
+  name: "chain-price-movers",
+  label: "Chain Price Movers",
+  category: "onchain",
+  iconUrl: widgetIcon("chain-price-movers"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "24h native-asset price change per major L1 (Bitcoin, Ethereum, Litecoin, Dogecoin, \u2026) as a diverging bar chart, gains right in green, losses left in red. The price-led sibling of the Chain Activity Bars transaction chart. Keyless (Blockchair).",
+  capabilities: ["chain-activity"],
+  source: SOURCES.blockchair,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(12).default(8).describe("How many chains (by absolute 24h price change) to chart.")
+  })
+});
+var chainActivityScatterMeta = defineFrameMeta({
+  name: "chain-activity-scatter",
+  label: "Chain Activity Scatter",
+  category: "onchain",
+  iconUrl: widgetIcon("chain-activity-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Major L1s as a bubble scatter \u2014 24h native-asset price change on the x-axis, 24h confirmed transactions on a log y-axis, bubble size by current mempool backlog. Shows which chains are both moving in price and busy on-chain. Keyless (Blockchair).",
+  capabilities: ["chain-activity"],
+  source: SOURCES.blockchair,
+  schema: z3.object({})
+});
+var mempoolFeeCurveMeta = defineFrameMeta({
+  name: "mempool-fee-curve",
+  label: "Mempool Fee Curve",
+  category: "bitcoin",
+  iconUrl: widgetIcon("mempool-fee-curve"),
+  layout: { w: 5, h: 3, minW: 3, minH: 2 },
+  description: "Bitcoin mempool's projected next-to-mine blocks as a fee-decay bar chart \u2014 median sat/vB per block, tinted by urgency, showing how fast fees drop as you're willing to wait a block or two longer. The chart-first sibling of the BTC Mempool card. Keyless (mempool.space).",
+  capabilities: ["btc-mempool"],
+  source: SOURCES.mempool,
+  schema: z3.object({
+    projectedBlocks: z3.number().int().min(1).max(8).default(5).describe(
+      "How many projected (yet-to-be-mined) blocks to chart, next-to-mine first."
+    )
+  })
+});
+var miningPoolsShareMeta = defineFrameMeta({
+  name: "mining-pools-share",
+  label: "Mining Pools Share",
+  category: "bitcoin",
+  iconUrl: widgetIcon("mining-pools-share"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Bitcoin mining-pool dominance as a donut \u2014 top pools by block share over a window plus an 'Other' slice, with the top-3 combined share in the center as a quick hashpower-concentration read. The chart-first sibling of the Mining Pools treemap. Keyless (mempool.space).",
+  capabilities: ["mining-pools"],
+  source: SOURCES.mempool,
+  schema: z3.object({
+    window: z3.enum(["24h", "3d", "1w", "1m"]).default("1w").describe("Window over which to measure each pool's block share."),
+    topN: z3.number().int().min(3).max(8).default(5).describe(
+      "How many of the largest pools to show as slices; the rest fold into 'Other'."
+    )
+  })
+});
+var optionsMaxPainMeta = defineFrameMeta({
+  name: "options-max-pain",
+  label: "Max Pain by Strike",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-max-pain"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Max pain for the nearest Deribit options expiry (BTC or ETH) \u2014 the aggregate payout option writers would owe at each candidate settlement strike, as a bar chart, with the strike that minimizes it (where the most contracts expire worthless) highlighted against the current spot. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH.")
+  })
+});
+var optionsOiSkewMeta = defineFrameMeta({
+  name: "options-oi-skew",
+  label: "OI Skew by Strike",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-oi-skew"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Net call-minus-put open interest by strike for the nearest Deribit options expiry (BTC or ETH) \u2014 a single diverging bar per strike showing where positioning skews call-heavy (green, above zero) versus put-heavy (red, below zero) near spot. The netted sibling of OI by Strike. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH."),
+    strikes: z3.number().int().min(6).max(30).default(14).describe(
+      "How many strikes nearest the current spot to show (centered on the underlying price)."
+    )
+  })
+});
+var optionsVolSpreadMeta = defineFrameMeta({
+  name: "options-vol-spread",
+  label: "BTC/ETH Vol Spread",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-vol-spread"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "BTC DVOL and ETH DVOL implied-volatility indices plotted together over time \u2014 the spread between crypto's two most liquid vol benchmarks, and which one is pricing bigger expected swings. Keyless (Deribit).",
+  capabilities: ["volatility-index"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    lookback: z3.enum(["7D", "1M", "3M"]).default("1M").describe("History window for both volatility-index lines.")
+  })
+});
+var optionsFlowSkewMeta = defineFrameMeta({
+  name: "options-flow-skew",
+  label: "Positioning vs Flow Skew",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-flow-skew"),
+  layout: { w: 4, h: 3, minW: 3, minH: 2 },
+  description: "Call/put skew for BTC or ETH options across two bases at once \u2014 open interest (standing positioning) and 24h volume (today's flow) \u2014 as two diverging bars. Green = call-heavy, red = put-heavy; the two diverging signals fresh flow fighting stale positioning. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH.")
+  })
+});
+var optionsVolSmileMeta = defineFrameMeta({
+  name: "options-vol-smile",
+  label: "Vol Smile",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-vol-smile"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Implied volatility by strike for the nearest Deribit options expiry (BTC or ETH) \u2014 a call-IV line and a put-IV line across the strike range, the classic 'vol smile' shape that shows where the market prices tail risk richest. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH.")
+  })
+});
+var optionsOiLadderHeatmapMeta = defineFrameMeta({
+  name: "options-oi-ladder-heatmap",
+  label: "OI Ladder Heatmap",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-oi-ladder-heatmap"),
+  layout: { w: 8, h: 5, minW: 5, minH: 4 },
+  description: "Open interest across strike and expiry for BTC or ETH options, as a heatmap \u2014 expiries as rows (nearest first), strike bands as columns, cell shade by total call+put OI. Surfaces where positioning concentrates across the whole term structure, not just the nearest expiry. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH."),
+    expiries: z3.number().int().min(3).max(16).default(8).describe(
+      "How many upcoming expiries (nearest-first) to show as rows."
+    ),
+    buckets: z3.number().int().min(6).max(20).default(10).describe(
+      "How many strike bands (columns) to bin open interest into, spanning the shown expiries' strike range."
+    )
+  })
+});
+var optionsMaxPainMultiMeta = defineFrameMeta({
+  name: "options-max-pain-multi",
+  label: "Max Pain by Expiry",
+  category: "derivatives",
+  iconUrl: widgetIcon("options-max-pain-multi"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Max pain strike for each upcoming Deribit options expiry (BTC or ETH), plotted as % deviation from spot \u2014 one bar per expiry, showing which dated books are pinned above versus below the current price. The term-structure sibling of Max Pain by Strike. Keyless (Deribit).",
+  capabilities: ["options-summary"],
+  source: SOURCES.deribit,
+  schema: z3.object({
+    currency: z3.enum(["BTC", "ETH"]).default("BTC").describe("Which Deribit options book \u2014 BTC or ETH."),
+    expiries: z3.number().int().min(3).max(16).default(8).describe("How many upcoming expiries (nearest-first) to chart.")
+  })
+});
+var mvrvZscoreChartMeta = defineFrameMeta({
+  name: "mvrv-zscore-chart",
+  label: "MVRV Z-Score Chart",
+  category: "onchain",
+  iconUrl: widgetIcon("mvrv-zscore-chart"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "Bitcoin MVRV Z-Score plotted as a full daily time-series line, not just a sparkline \u2014 how many standard deviations market cap sits above realized cap across the whole available history. Historically, spikes above ~7 have marked cycle tops and dips below 0 mark deep-value bottoms. The chart-first sibling of the MVRV gauge. Keyless (Coin Metrics).",
+  capabilities: ["onchain-valuation"],
+  source: SOURCES.coinMetrics,
+  schema: z3.object({
+    window: z3.enum(["1Y", "2Y", "4Y", "all"]).default("all").describe("How much history the chart shows.")
+  })
+});
+var nuplCycleChartMeta = defineFrameMeta({
+  name: "nupl-cycle-chart",
+  label: "NUPL Cycle Chart",
+  category: "onchain",
+  iconUrl: widgetIcon("nupl-cycle-chart"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "Net Unrealized Profit/Loss plotted as a full daily time-series line across Bitcoin's cycle sentiment bands \u2014 Capitulation, Hope/Fear, Optimism, Belief, Euphoria/Greed. The chart-first sibling of the NUPL gauge. Keyless (Coin Metrics).",
+  capabilities: ["onchain-valuation"],
+  source: SOURCES.coinMetrics,
+  schema: z3.object({
+    window: z3.enum(["1Y", "2Y", "4Y", "all"]).default("all").describe("How much history the chart shows.")
+  })
+});
+var cycleValuationCompositeMeta = defineFrameMeta({
+  name: "cycle-valuation-composite",
+  label: "Cycle Valuation Composite",
+  category: "onchain",
+  iconUrl: widgetIcon("cycle-valuation-composite"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Three cycle-valuation signals \u2014 MVRV Z-Score, NUPL, and BTC's 14-day RSI \u2014 overlaid on one chart, each independently min-max normalized to 0\u2013100% over the selected window so their unrelated native scales become directly comparable. All three near the top together reads late-cycle euphoria; all three near the bottom reads capitulation. Keyless (Coin Metrics).",
+  capabilities: ["onchain-valuation", "price-history-daily"],
+  source: SOURCES.coinMetrics,
+  schema: z3.object({
+    window: z3.enum(["1Y", "2Y", "4Y", "all"]).default("2Y").describe("How much history each signal is normalized and charted over.")
+  })
+});
+var onchainOscillatorOverlayMeta = defineFrameMeta({
+  name: "onchain-oscillator-overlay",
+  label: "On-Chain Oscillator Overlay",
+  category: "onchain",
+  iconUrl: widgetIcon("onchain-oscillator-overlay"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "SOPR, Puell Multiple, and Reserve Risk overlaid on one chart, each independently min-max normalized to 0\u2013100% over the selected window \u2014 three on-chain cycle oscillators with unrelated native scales made directly comparable. Keyless (bitcoin-data.com; polled once daily, best-effort per metric).",
+  capabilities: ["onchain-cycle-extras"],
+  source: SOURCES.bitcoinData,
+  schema: z3.object({
+    window: z3.enum(["90D", "180D", "1Y"]).default("1Y").describe("How much history each signal is normalized and charted over.")
+  })
+});
+var ethIssuanceImpactMeta = defineFrameMeta({
+  name: "eth-issuance-impact",
+  label: "ETH Issuance Impact",
+  category: "onchain",
+  iconUrl: widgetIcon("eth-issuance-impact"),
+  layout: { w: 4, h: 3, minW: 2, minH: 2 },
+  description: "Ethereum's actual net annual supply growth (post-Merge PoS issuance minus EIP-1559 burn) vs the counterfactual pre-Merge PoW issuance rate, as diverging bars \u2014 how much leaner ETH's inflation is under proof-of-stake. Negative (deflationary) growth in green, positive (inflationary) in red. Keyless (ultrasound.money).",
+  capabilities: ["eth-supply"],
+  source: SOURCES.ultrasound,
+  schema: z3.object({})
+});
+var treasuryAvgRateBarsMeta = defineFrameMeta({
+  name: "treasury-avg-rate-bars",
+  label: "Treasury Avg Rate Bars",
+  category: "macro",
+  iconUrl: widgetIcon("treasury-avg-rate-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "U.S. Treasury average interest rates across the full set of security classes as a horizontal bar chart, ranked highest-first. The chart-first sibling of the Rates Board's Treasury-rates section. Keyless (U.S. Treasury).",
+  capabilities: ["treasury-rates"],
+  source: SOURCES.treasury,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(25).default(20).describe(
+      "How many security classes (by average rate, highest first) to chart."
+    )
+  })
+});
+var treasuryAuctionDemandScatterMeta = defineFrameMeta({
+  name: "treasury-auction-demand-scatter",
+  label: "Treasury Auction Demand",
+  category: "macro",
+  iconUrl: widgetIcon("treasury-auction-demand-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Recent completed U.S. Treasury auctions as a bubble scatter \u2014 awarded rate on the x-axis, bid-to-cover ratio (demand) on the y-axis, one dot per auction labelled by term. Reveals whether richer (lower-yield) auctions also draw stronger demand. Keyless (U.S. Treasury).",
+  capabilities: ["treasury-auctions"],
+  source: SOURCES.treasury,
+  schema: z3.object({
+    count: z3.number().int().min(5).max(30).default(20).describe(
+      "How many recent completed auctions (with a reported rate and bid-to-cover) to plot."
+    )
+  })
+});
+var treasuryAuctionSizeBarsMeta = defineFrameMeta({
+  name: "treasury-auction-size-bars",
+  label: "Treasury Auction Size",
+  category: "macro",
+  iconUrl: widgetIcon("treasury-auction-size-bars"),
+  layout: { w: 6, h: 3, minW: 3, minH: 3 },
+  description: "Recent completed U.S. Treasury auctions as paired bars \u2014 the offering amount beside the amount actually accepted, per auction, oldest to newest. Shows at a glance how close each auction came to being fully subscribed. Keyless (U.S. Treasury).",
+  capabilities: ["treasury-auctions"],
+  source: SOURCES.treasury,
+  schema: z3.object({
+    count: z3.number().int().min(3).max(20).default(8).describe(
+      "How many recent completed auctions to chart (oldest to newest)."
+    )
+  })
+});
+var nyfedReferenceRateBarsMeta = defineFrameMeta({
+  name: "nyfed-reference-rate-bars",
+  label: "NY Fed Rate Bars",
+  category: "macro",
+  iconUrl: widgetIcon("nyfed-reference-rate-bars"),
+  layout: { w: 4, h: 3, minW: 3, minH: 2 },
+  description: "The six official New York Fed reference rates (effective fed funds, SOFR, tri-party and broad general collateral repo, overnight bank funding, and SOFR averages) as a horizontal bar chart \u2014 level or reported volume. The chart-first sibling of the Rates Board's NY Fed section. Keyless (NY Fed).",
+  capabilities: ["reference-rates"],
+  source: SOURCES.nyFed,
+  schema: z3.object({
+    metric: z3.enum(["rate", "volume"]).default("rate").describe(
+      `"rate" charts each reference rate's level (%); "volume" charts its reported trading volume in USD (SOFR averages report no volume and are skipped in this mode).`
+    ),
+    limit: z3.number().int().min(2).max(6).default(6).describe("How many of the six official reference rates to chart.")
+  })
+});
+var nyfedSofrTermAveragesBarsMeta = defineFrameMeta({
+  name: "nyfed-sofr-term-averages-bars",
+  label: "SOFR Term Averages",
+  category: "macro",
+  iconUrl: widgetIcon("nyfed-sofr-term-averages-bars"),
+  layout: { w: 3, h: 3, minW: 2, minH: 2 },
+  description: "SOFR compounded average rates over the trailing 30, 90, and 180 days as a simple bar comparison \u2014 a quick read on where short-term secured funding costs have been trending. Keyless (NY Fed).",
+  capabilities: ["reference-rates"],
+  source: SOURCES.nyFed,
+  schema: z3.object({})
+});
+var nyfedFedFundsBandGaugeMeta = defineFrameMeta({
+  name: "nyfed-fed-funds-band-gauge",
+  label: "Fed Funds Band Gauge",
+  category: "macro",
+  iconUrl: widgetIcon("nyfed-fed-funds-band-gauge"),
+  layout: { w: 3, h: 3, minW: 2, minH: 2 },
+  description: "The effective fed funds rate as a radial gauge inside the FOMC's current target band \u2014 the arc fills from the band's lower bound to its upper bound, with the live EFFR reading in the center. Makes it visible at a glance whether the effective rate is trading near the top, bottom, or middle of the target range. Keyless (NY Fed).",
+  capabilities: ["reference-rates"],
+  source: SOURCES.nyFed,
+  schema: z3.object({})
+});
+var treasuryDebtCompositionAreaMeta = defineFrameMeta({
+  name: "treasury-debt-composition-area",
+  label: "Debt Composition",
+  category: "macro",
+  iconUrl: widgetIcon("treasury-debt-composition-area"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "U.S. total public debt outstanding split into debt held by the public vs. intragovernmental holdings, as a stacked area chart over time \u2014 the two components that sum to the National Debt card's headline total. Keyless (U.S. Treasury).",
+  capabilities: ["national-debt"],
+  source: SOURCES.treasury,
+  schema: z3.object({
+    trendDays: z3.number().int().min(30).max(365).default(180).describe(
+      "How many business days of history to load for the stacked area."
+    )
+  })
+});
+var ofrStressCategoryAreaMeta = defineFrameMeta({
+  name: "ofr-stress-category-area",
+  label: "FSI by Category",
+  category: "macro",
+  iconUrl: widgetIcon("ofr-stress-category-area"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "The OFR Financial Stress Index decomposed into its five contributing categories (credit, equity valuation, safe assets, funding, volatility) as a stacked area chart over time \u2014 each category can be positive or negative and they sum to the overall index shown on the Financial Stress card. Keyless (OFR).",
+  capabilities: ["financial-stress"],
+  source: SOURCES.ofr,
+  schema: z3.object({
+    trendDays: z3.number().int().min(20).max(90).default(60).describe("How many recent daily readings to plot in the stacked area.")
+  })
+});
+var miseryIndexMeta = defineFrameMeta({
+  name: "misery-index",
+  label: "Misery Index",
+  category: "macro",
+  iconUrl: widgetIcon("misery-index"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "The classic 'Misery Index' \u2014 CPI year-over-year inflation stacked with the unemployment rate \u2014 as a two-series stacked area chart, month-aligned, plus the combined headline score. Monthly macro context for stock dashboards, not a live feed. Keyless (BLS).",
+  capabilities: ["macro-series"],
+  source: SOURCES.bls,
+  schema: z3.object({
+    months: z3.number().int().min(13).max(36).default(18).describe("How many recent monthly observations to chart.")
+  })
+});
+var realWagesMeta = defineFrameMeta({
+  name: "real-wages",
+  label: "Real Wages",
+  category: "macro",
+  iconUrl: widgetIcon("real-wages"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "Are paychecks outrunning inflation? A two-line chart comparing year-over-year average hourly earnings growth against year-over-year CPI inflation \u2014 when earnings run above CPI, real (inflation-adjusted) pay is rising. Monthly macro context, not a live feed. Keyless (BLS).",
+  capabilities: ["macro-series"],
+  source: SOURCES.bls,
+  schema: z3.object({
+    months: z3.number().int().min(13).max(36).default(18).describe(
+      "How many recent monthly year-over-year observations to chart."
+    )
+  })
+});
+var laborForceFlowMeta = defineFrameMeta({
+  name: "labor-force-flow",
+  label: "Labor Force Flow",
+  category: "macro",
+  iconUrl: widgetIcon("labor-force-flow"),
+  layout: { w: 6, h: 3, minW: 3, minH: 2 },
+  description: "The unemployment rate and the labor-force participation rate plotted together over time \u2014 a rising unemployment rate alongside a falling participation rate points to people leaving the workforce rather than finding jobs. Monthly macro context, not a live feed. Keyless (BLS).",
+  capabilities: ["macro-series"],
+  source: SOURCES.bls,
+  schema: z3.object({
+    months: z3.number().int().min(13).max(36).default(18).describe("How many recent monthly observations to chart.")
+  })
+});
+var payrollsBarsMeta = defineFrameMeta({
+  name: "payrolls-bars",
+  label: "Payrolls Bars",
+  category: "macro",
+  iconUrl: widgetIcon("payrolls-bars"),
+  layout: { w: 6, h: 3, minW: 3, minH: 3 },
+  description: "Monthly nonfarm payrolls net change as a diverging bar chart \u2014 jobs added up in green, jobs cut down in red. The chart-first sibling of the Labor Market frame's headline figure. Monthly macro data, not a live feed. Keyless (BLS).",
+  capabilities: ["macro-series"],
+  source: SOURCES.bls,
+  schema: z3.object({
+    months: z3.number().int().min(6).max(36).default(18).describe("How many recent months of net payroll change to chart.")
+  })
+});
+var shortVolumeBarsMeta = defineFrameMeta({
+  name: "short-volume-bars",
+  label: "Short Volume Bars",
+  category: "equities",
+  iconUrl: widgetIcon("short-volume-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Daily reported short-sale volume for a watchlist of US-listed stocks, ranked highest-first as a horizontal bar chart \u2014 the chart-first sibling of the Short Volume list. IMPORTANT: this is reported short volume (sell-side short flow, including market-maker hedging), NOT short interest, and is not a directional signal on its own. Daily data published the next business day; not a live feed. US equities only. (FINRA).",
+  capabilities: ["short-volume"],
+  source: SOURCES.finra,
+  schema: z3.object({
+    symbols: z3.array(z3.string()).min(1).max(12).describe(
+      'US-listed stock tickers to rank, e.g. ["TSLA","NVDA","AAPL"]. HIP-3 symbols ("xyz:TSLA") work too \u2014 the dex prefix is stripped. Crypto has no SEC/FINRA short-volume and is ignored.'
+    )
+  })
+});
+var capitalStructureBarsMeta = defineFrameMeta({
+  name: "capital-structure-bars",
+  label: "Capital Structure Bars",
+  category: "equities",
+  iconUrl: widgetIcon("capital-structure-bars"),
+  layout: { w: 4, h: 3, minW: 3, minH: 2 },
+  description: "One company's balance-sheet shape as a horizontal bar chart \u2014 total assets, shareholders' equity, and liabilities (derived as assets minus equity) \u2014 from SEC EDGAR XBRL company facts. Updates only when the company files (annual/quarterly), not a live feed. Requires the zframes runtime's data proxy (ships with `zframes serve` / `vite dev`); resolve by ticker (bundled top-500 map) or raw SEC CIK. (SEC EDGAR).",
+  capabilities: ["fundamentals"],
+  source: SOURCES.secEdgar,
+  schema: z3.object({
+    symbol: z3.string().min(1).describe(
+      'Company to chart \u2014 a ticker ("AAPL", "NVDA"), a HIP-3 symbol ("xyz:NVDA"), or a raw SEC CIK ("320193"). Tickers outside the bundled top-500 map need a CIK.'
+    )
+  })
+});
+var filingsMixMeta = defineFrameMeta({
+  name: "filings-mix",
+  label: "Filings Mix",
+  category: "equities",
+  iconUrl: widgetIcon("filings-mix"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "What kind of paper is one company actually filing? A donut of recent SEC EDGAR filings bucketed into periodic & material reports (10-K, 10-Q, 8-K, registrations, proxies, activist stakes\u2026), insider ownership forms (3/4/5/144), and everything else \u2014 the chart-first sibling of the Filings Feed. Official data from SEC's free, CORS-safe submissions endpoint; event-driven, not a price feed. Resolve by ticker (bundled top-500 map) or raw SEC CIK. (SEC EDGAR).",
+  capabilities: ["filings"],
+  source: SOURCES.secEdgar,
+  schema: z3.object({
+    symbol: z3.string().min(1).describe(
+      'Company to show filing mix for \u2014 a ticker ("AAPL", "NVDA"), a HIP-3 symbol ("xyz:TSLA"), or a raw SEC CIK ("320193"). Tickers outside the bundled top-500 map need a CIK.'
+    )
+  })
+});
+var fxCrossHeatmapMeta = defineFrameMeta({
+  name: "fx-cross-heatmap",
+  label: "FX Cross Heatmap",
+  category: "macro",
+  iconUrl: widgetIcon("fx-cross-heatmap"),
+  layout: { w: 6, h: 4, minW: 4, minH: 4 },
+  description: "A full currency \xD7 currency cross-rate matrix as a heatmap \u2014 each cell is the day-over-day % change of that specific cross, derived from every listed currency's rate vs a common pivot, green up / red down. Spots which cross is moving hardest across an entire currency set, not just one pair at a time. Keyless (Frankfurter/ECB).",
+  capabilities: ["fx-rates"],
+  source: SOURCES.frankfurter,
+  schema: z3.object({
+    symbols: z3.array(z3.string().length(3)).min(3).max(8).default(["USD", "EUR", "GBP", "JPY", "CHF", "CAD"]).describe(
+      'Currencies (ISO 4217 codes) forming both axes of the matrix, e.g. ["USD","EUR","GBP","JPY"]. At least 3, so the grid shows more than one cross.'
+    )
+  })
+});
+var etfIssuerTreemapMeta = defineFrameMeta({
+  name: "etf-issuer-treemap",
+  label: "ETF Issuer Treemap",
+  category: "crypto",
+  iconUrl: widgetIcon("etf-issuer-treemap"),
+  layout: { w: 5, h: 4, minW: 4, minH: 3 },
+  description: "Spot BTC or ETH ETF issuers as a treemap \u2014 tile size by assets under management, tint green/red by that issuer's net flow today. Shows who holds the most AND who's gathering or losing assets right now, in one view. Best-effort; may be empty if the source is unavailable. Keyless (SoSoValue).",
+  capabilities: ["etf-flows"],
+  source: SOURCES.sosovalue,
+  schema: z3.object({
+    asset: z3.enum(["btc", "eth"]).default("btc").describe("Which spot-ETF complex to show."),
+    limit: z3.number().int().min(3).max(15).default(10).describe("How many issuers (by AUM) to show in the treemap.")
+  })
+});
+var fxTrendChartMeta = defineFrameMeta({
+  name: "fx-trend-chart",
+  label: "FX Trend Chart",
+  category: "macro",
+  iconUrl: widgetIcon("fx-trend-chart"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "Several currencies' recent trend vs a base, each indexed to 0% at the start of the window so wildly different-magnitude pairs (JPY vs CHF) compare cleanly on one chart. The multi-line sibling of the FX Board. Keyless (Frankfurter/ECB).",
+  capabilities: ["fx-rates"],
+  source: SOURCES.frankfurter,
+  schema: z3.object({
+    base: z3.string().length(3).default("USD").describe(
+      'Base currency (ISO 4217 code) each line is quoted against, e.g. "USD".'
+    ),
+    symbols: z3.array(z3.string().length(3)).min(1).max(8).default(["EUR", "GBP", "JPY", "CHF"]).describe(
+      'Currencies to chart (ISO 4217 codes), e.g. ["EUR","GBP","JPY"]. A code equal to the base is skipped.'
+    )
+  })
+});
+var fearGreedChartMeta = defineFrameMeta({
+  name: "fear-greed-chart",
+  label: "Fear & Greed Chart",
+  category: "sentiment",
+  iconUrl: widgetIcon("fear-greed-chart"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "Crypto Fear & Greed index over time as a line chart \u2014 the mood swing from extreme fear to extreme greed across a wide window, the line tinted by the latest reading. The chart-first sibling of the Fear & Greed card. Keyless (alternative.me).",
+  capabilities: ["sentiment"],
+  source: SOURCES.alternativeMe,
+  schema: z3.object({
+    days: z3.number().int().min(30).max(365).default(180).describe("How many days of index history to chart.")
+  })
+});
+var predictionMarketBarsMeta = defineFrameMeta({
+  name: "prediction-market-bars",
+  label: "Prediction Market Bars",
+  category: "sentiment",
+  iconUrl: widgetIcon("prediction-market-bars"),
+  layout: { w: 5, h: 5, minW: 4, minH: 4 },
+  description: "Live Polymarket odds as a horizontal bar chart \u2014 the highest-volume open prediction markets ranked by trailing-24h volume. The chart-first sibling of the Prediction Markets list. Keyless (Polymarket).",
+  capabilities: ["prediction-markets"],
+  source: SOURCES.polymarket,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(15).default(8).describe("How many markets (by volume) to chart.")
+  })
+});
+var dxyChartMeta = defineFrameMeta({
+  name: "dxy-chart",
+  label: "Dollar Index Chart",
+  category: "macro",
+  iconUrl: widgetIcon("dxy-chart"),
+  layout: { w: 6, h: 3, minW: 4, minH: 3 },
+  description: "US Dollar Index (DXY) as a line chart over time \u2014 the dollar's trend vs a basket of six major currencies, tinted green/red by its own direction. The chart-first sibling of the Dollar Index card. Keyless (Frankfurter/ECB).",
+  capabilities: ["dollar-index"],
+  source: SOURCES.frankfurter,
+  schema: z3.object({})
+});
+var fxMoversBarsMeta = defineFrameMeta({
+  name: "fx-movers-bars",
+  label: "FX Movers Bars",
+  category: "macro",
+  iconUrl: widgetIcon("fx-movers-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "A currency set's day-over-day % change vs a base as a diverging bar chart \u2014 strengthening currencies right in green, weakening left in red, ranked by move. The chart-first sibling of the FX Board. Keyless (Frankfurter/ECB).",
+  capabilities: ["fx-rates"],
+  source: SOURCES.frankfurter,
+  schema: z3.object({
+    base: z3.string().length(3).default("USD").describe(
+      'Base currency (ISO 4217 code) each bar is quoted against, e.g. "USD".'
+    ),
+    symbols: z3.array(z3.string().length(3)).min(1).max(12).default(["EUR", "GBP", "JPY", "CHF", "CAD", "AUD"]).describe(
+      'Currencies to chart (ISO 4217 codes), e.g. ["EUR","GBP","JPY"]. A code equal to the base is skipped.'
+    )
+  })
+});
+var predictionMarketScatterMeta = defineFrameMeta({
+  name: "prediction-market-scatter",
+  label: "Prediction Market Scatter",
+  category: "sentiment",
+  iconUrl: widgetIcon("prediction-market-scatter"),
+  layout: { w: 6, h: 4, minW: 4, minH: 3 },
+  description: "Live Polymarket odds as a bubble scatter \u2014 each market's top-outcome probability on the x-axis, trailing-24h volume on a log y-axis, bubble size by volume. Surfaces high-conviction, high-volume markets versus thin long shots. The chart-first sibling of the Prediction Markets list. Keyless (Polymarket).",
+  capabilities: ["prediction-markets"],
+  source: SOURCES.polymarket,
+  schema: z3.object({
+    limit: z3.number().int().min(5).max(30).default(15).describe("How many markets (by volume) to plot.")
+  })
+});
+var etfIssuerBarsMeta = defineFrameMeta({
+  name: "etf-issuer-bars",
+  label: "ETF Issuer Bars",
+  category: "crypto",
+  iconUrl: widgetIcon("etf-issuer-bars"),
+  layout: { w: 4, h: 4, minW: 3, minH: 3 },
+  description: "Spot BTC or ETH ETF issuers' daily net flow as a diverging bar chart \u2014 inflows right in green, outflows left in red, ranked by size. The chart-first sibling of the Spot ETF Flows list. Best-effort; may be empty if the source is unavailable. Keyless (SoSoValue).",
+  capabilities: ["etf-flows"],
+  source: SOURCES.sosovalue,
+  schema: z3.object({
+    asset: z3.enum(["btc", "eth"]).default("btc").describe("Which spot-ETF complex to chart."),
+    limit: z3.number().int().min(3).max(15).default(10).describe("How many issuers (by |net flow|) to chart.")
+  })
+});
+var portfolioMoversMeta = defineFrameMeta({
+  name: "portfolio-movers",
+  label: "Portfolio Movers",
+  category: "portfolio",
+  iconUrl: widgetIcon("portfolio-movers"),
+  layout: { w: 4, h: 5, minW: 3, minH: 4 },
+  description: "Your connected portfolio's holdings as a diverging bar chart of 24h price change \u2014 gainers right in green, losers left in red. Source is a connected Binance account (read-only key, in-app) or a public on-chain wallet address. Only holdings the source reports a 24h change for are shown \u2014 currently that's on-chain wallet holdings (priced via CoinGecko); a Binance-only portfolio will show its empty state until the account layer adds a price-change feed. Renders a connect prompt until a source is set.",
+  capabilities: ["portfolio"],
+  account: true,
+  schema: z3.object({
+    ...portfolioConfigShape,
+    limit: z3.number().int().min(4).max(30).default(15).describe("How many holdings (by absolute 24h change) to chart.")
+  })
+});
+var portfolioValueBarsMeta = defineFrameMeta({
+  name: "portfolio-value-bars",
+  label: "Portfolio Value Bars",
+  category: "portfolio",
+  iconUrl: widgetIcon("portfolio-value-bars"),
+  layout: { w: 4, h: 5, minW: 3, minH: 4 },
+  description: "Your connected portfolio's positions as a horizontal bar chart ranked by live USD value, largest first. The chart-first sibling of the Portfolio Holdings table. Source is a connected Binance account (read-only key, in-app) or a public on-chain wallet address. Renders a connect prompt until a source is set.",
+  capabilities: ["portfolio", "quote-stream"],
+  account: true,
+  schema: z3.object({
+    ...portfolioConfigShape,
+    limit: z3.number().int().min(3).max(25).default(12).describe("How many holdings (by USD value, descending) to chart.")
+  })
+});
+var etfFlowCalendarMeta = defineFrameMeta({
+  name: "etf-flow-calendar",
+  label: "ETF Flow Calendar",
+  category: "crypto",
+  iconUrl: widgetIcon("etf-flow-calendar"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "Spot BTC or ETH ETF daily net flows as a GitHub-style calendar heatmap \u2014 one column per weekday, one row per week, green shades for inflow days and red for outflow days (intensity relative to the window). Surfaces weekly inflow/outflow rhythm the daily bar chart doesn't show at a glance. Keyless (SoSoValue); best-effort, may be empty if the source is unavailable.",
+  capabilities: ["etf-flows"],
+  source: SOURCES.sosovalue,
+  schema: z3.object({
+    asset: z3.enum(["btc", "eth"]).default("btc").describe("Which spot-ETF complex to chart."),
+    lookback: z3.enum(["1M", "3M", "6M"]).default("3M").describe("History window for the calendar grid.")
+  })
+});
+var predictionMarketsBubbleMeta = defineFrameMeta({
+  name: "prediction-markets-bubble",
+  label: "Prediction Markets Bubbles",
+  category: "sentiment",
+  iconUrl: widgetIcon("prediction-markets-bubble"),
+  layout: { w: 6, h: 5, minW: 4, minH: 3 },
+  description: "Live Polymarket odds as a floating bubble cloud \u2014 one bubble per open market, sized by 24h volume, tinted by how confident the leading outcome is (muted near a toss-up, vivid green near certain). The chart-first sibling of the Prediction Markets list. Keyless (Polymarket Gamma API).",
+  capabilities: ["prediction-markets"],
+  source: SOURCES.polymarket,
+  schema: z3.object({
+    limit: z3.number().int().min(3).max(20).default(10).describe("How many markets (by volume) to show.")
+  })
+});
+var frameMetas = [
+  customDataMeta,
+  newsFeedMeta,
+  portfolioValueMeta,
+  portfolioAllocationMeta,
+  portfolioHoldingsMeta,
+  bitcoinDominanceMeta,
+  clockMeta,
+  dailyAnalysisMeta,
+  dinoGameMeta,
+  fearGreedMeta,
+  filingsFeedMeta,
+  fundamentalsMeta,
+  financialStressMeta,
+  laborMarketMeta,
+  nationalDebtMeta,
+  treasuryAuctionsMeta,
+  fundingHeatmapMeta,
+  fundingRateChartMeta,
+  headingMeta,
+  heroNumberMeta,
+  imageMeta,
+  imageGalleryMeta,
+  inflationPulseMeta,
+  marketHoursMeta,
+  noteMeta,
+  priceChartMeta,
+  priceCompareMeta,
+  priceLivelineMeta,
+  priceTickerMeta,
+  ratesBoardMeta,
+  fxBoardMeta,
+  shortVolumeMeta,
+  topMoversMeta,
+  tvlTreemapMeta,
+  yieldCurveMeta,
+  dexVolumeTreemapMeta,
+  dexVolumeChartMeta,
+  protocolTvlTreemapMeta,
+  protocolTvlChartMeta,
+  protocolFeesTreemapMeta,
+  marketCapTreemapMeta,
+  openInterestMeta,
+  snakeMeta,
+  flappyBirdMeta,
+  videoMeta,
+  drawdyMeta,
+  countdownMeta,
+  linkGridMeta,
+  calculatorMeta,
+  quoteMeta,
+  dividerMeta,
+  btcFeesMeta,
+  btcMempoolMeta,
+  btcBlocksMeta,
+  btcHashrateMeta,
+  btcDifficultyMeta,
+  miningPoolsMeta,
+  lightningStatsMeta,
+  optionsPutCallMeta,
+  optionsIvMeta,
+  optionsOiStrikeMeta,
+  coinMoversMeta,
+  mvrvMeta,
+  nuplMeta,
+  soprMeta,
+  puellMultipleMeta,
+  mayerMultipleMeta,
+  piCycleMeta,
+  maMultiplierMeta,
+  rsiMomentumMeta,
+  volumeProfileMeta,
+  dxyMeta,
+  cycleSignalsMeta,
+  stablecoinSupplyMeta,
+  yieldScannerMeta,
+  defiRevenueMeta,
+  fundingComparisonMeta,
+  ethSupplyMeta,
+  ethStakingMeta,
+  predictionMarketsMeta,
+  etfFlowsMeta,
+  trendingCoinsMeta,
+  sectorPerformanceMeta,
+  macroCalendarMeta,
+  stablecoinChainsMeta,
+  sectorTreemapMeta,
+  etfFlowsChartMeta,
+  realizedPriceMeta,
+  reserveRiskMeta,
+  nftCollectionsMeta,
+  dexHotPoolsMeta,
+  chainActivityMeta,
+  nftTreemapMeta,
+  dexPoolTreemapMeta,
+  sectorBarsMeta,
+  fundingBarsMeta,
+  etfFlowBarsMeta,
+  chainActivityBarsMeta,
+  marketScatterMeta,
+  marketBubblesMeta,
+  tvlBubblesMeta,
+  protocolTvlBubblesMeta,
+  dexVolumeBubblesMeta,
+  protocolFeesBubblesMeta,
+  sectorBubblesMeta,
+  nftBubblesMeta,
+  dexPoolBubblesMeta,
+  moversBubblesMeta,
+  sentimentGaugeMeta,
+  moversBarsMeta,
+  tvlBarsMeta,
+  yieldScatterMeta,
+  nftScatterMeta,
+  dominanceGaugeMeta,
+  putCallGaugeMeta,
+  oiTreemapMeta,
+  ohlcvVolumeBarsMeta,
+  fundingSpreadBarsMeta,
+  fundingVenueHeatmapMeta,
+  fundingCarryAreaMeta,
+  volumeShareDonutMeta,
+  volumeMoversScatterMeta,
+  fundingLeaderboardBarsMeta,
+  fundingCrowdingScatterMeta,
+  liquidityBasisBarsMeta,
+  coinMomentumHeatmapMeta,
+  coinMomentumScatterMeta,
+  trendingBarsMeta,
+  nftActivityBarsMeta,
+  dominanceBarsMeta,
+  trendingBubblesMeta,
+  yieldRiskPieMeta,
+  dexPoolLiquidityScatterMeta,
+  protocolFeesVsTvlScatterMeta,
+  yieldCompositionScatterMeta,
+  protocolTvlByCategoryMeta,
+  protocolTvlShareAreaMeta,
+  dexVolumeShareAreaMeta,
+  yieldMomentumBarsMeta,
+  btcDifficultyChartMeta,
+  btcBlockSizeBarsMeta,
+  chainPriceMoversMeta,
+  chainActivityScatterMeta,
+  mempoolFeeCurveMeta,
+  miningPoolsShareMeta,
+  optionsMaxPainMeta,
+  optionsOiSkewMeta,
+  optionsVolSpreadMeta,
+  optionsFlowSkewMeta,
+  optionsVolSmileMeta,
+  optionsOiLadderHeatmapMeta,
+  optionsMaxPainMultiMeta,
+  mvrvZscoreChartMeta,
+  nuplCycleChartMeta,
+  cycleValuationCompositeMeta,
+  onchainOscillatorOverlayMeta,
+  ethIssuanceImpactMeta,
+  treasuryAvgRateBarsMeta,
+  treasuryAuctionDemandScatterMeta,
+  treasuryAuctionSizeBarsMeta,
+  nyfedReferenceRateBarsMeta,
+  nyfedSofrTermAveragesBarsMeta,
+  nyfedFedFundsBandGaugeMeta,
+  treasuryDebtCompositionAreaMeta,
+  ofrStressCategoryAreaMeta,
+  miseryIndexMeta,
+  realWagesMeta,
+  laborForceFlowMeta,
+  payrollsBarsMeta,
+  shortVolumeBarsMeta,
+  capitalStructureBarsMeta,
+  filingsMixMeta,
+  fxCrossHeatmapMeta,
+  etfIssuerTreemapMeta,
+  fxTrendChartMeta,
+  fearGreedChartMeta,
+  predictionMarketBarsMeta,
+  dxyChartMeta,
+  fxMoversBarsMeta,
+  predictionMarketScatterMeta,
+  etfIssuerBarsMeta,
+  portfolioMoversMeta,
+  portfolioValueBarsMeta,
+  etfFlowCalendarMeta,
+  predictionMarketsBubbleMeta
+];
+var allFrameMetas = [
+  ...frameMetas,
+  breakevenMeta,
+  breathingMeta,
+  checklistMeta,
+  dayMeterMeta,
+  diceMeta,
+  holidayCalendarMeta,
+  journalLogMeta,
+  journalOpenMeta,
+  journalResultsMeta,
+  journalScoreMeta,
+  marqueeMeta,
+  pomodoroMeta,
+  returnsProjectorMeta,
+  riskRewardMeta,
+  rulesCardMeta,
+  sessionProgressMeta,
+  spotifyEmbedMeta,
+  stopwatchMeta
+];
+
+// src/dashboards.ts
+import { existsSync } from "fs";
+function list() {
+  const entries = listDashboards();
+  if (entries.length === 0) {
+    console.log(`no dashboards in your store yet (${dashboardsDir()})`);
+    console.log("  create one: npx --yes zframes@latest init <name>");
+    return 0;
+  }
+  console.log(`dashboards in ${dashboardsDir()}:`);
+  for (const e of entries) {
+    const mark = e.isDefault ? "*" : " ";
+    const title = e.title ? `  \u2014 ${e.title}` : "";
+    console.log(`  ${mark} ${e.name}${title}`);
+  }
+  if (entries.some((e) => e.isDefault)) {
+    console.log(
+      "\n  * = default (served when you run `zframes serve` with no name)"
+    );
+  } else {
+    console.log("\n  no default set \u2014 `zframes use <name>` to pick one.");
+  }
+  return 0;
+}
+function use(args) {
+  const name = args.find((a) => !a.startsWith("-"));
+  if (!name) {
+    console.error("usage: zframes use <name>");
+    return 1;
+  }
+  if (!isValidName(name)) {
+    console.error(
+      `\u2717 "${name}" is not a valid dashboard name (lowercase letters, digits, "-", "_")`
+    );
+    return 1;
+  }
+  if (!existsSync(dashboardPath(name))) {
+    console.error(
+      `\u2717 no dashboard named "${name}" in your store (${dashboardsDir()})`
+    );
+    console.error(
+      `  create it with \`zframes init ${name}\`, or run \`zframes list\` to see what's there.`
+    );
+    return 1;
+  }
+  setDefault(name);
+  console.log(`\u2713 default dashboard is now "${name}"`);
+  return 0;
+}
+
+// src/init.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname, resolve as resolve2 } from "path";
+
+// ../spec/src/presets.ts
+var SCENE_DEFAULT_PROJECT_ID = "YrTzGatwjK7EoFpCSfgZ";
+
+// src/init.ts
+function parseArgs(args) {
+  let target = "dashboard.json";
+  let title = "my dashboard";
+  let author = "";
+  let force = false;
+  let makeDefault = false;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--title" || a === "-t") {
+      title = args[++i] ?? "";
+    } else if (a.startsWith("--title=")) {
+      title = a.slice("--title=".length);
+    } else if (a === "--author" || a === "-a") {
+      author = args[++i] ?? "";
+    } else if (a.startsWith("--author=")) {
+      author = a.slice("--author=".length);
+    } else if (a === "--force" || a === "-f") {
+      force = true;
+    } else if (a === "--default") {
+      makeDefault = true;
+    } else if (!a.startsWith("-")) {
+      target = a;
+    } else {
+      return { error: `unknown option "${a}"` };
+    }
+  }
+  if (!title.trim()) return { error: "--title cannot be empty" };
+  return { target, title, author, force, makeDefault };
+}
+function resolveDest(target) {
+  const c = classifyTarget(target, process.cwd());
   if ("error" in c) return c;
   if (c.kind === "store") return { dest: c.file, name: c.name };
   if (c.file.toLowerCase().endsWith(".json")) return { dest: c.file };
@@ -3980,6 +5521,11 @@ var VENUE_LABELS = {
   BybitPerp: "Bybit"
 };
 var dexOf = (symbol) => symbol.includes(":") ? symbol.split(":")[0] : "";
+function optNum(value) {
+  if (value === void 0) return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
 async function info(body) {
   return fetchJson(INFO_URL, void 0, {
     init: {
@@ -4114,11 +5660,24 @@ var HyperliquidProvider = class {
           const markPx = Number(ctx.markPx);
           const prevDayPx = Number(ctx.prevDayPx);
           if (!Number.isFinite(markPx) || !Number.isFinite(prevDayPx)) return;
-          out[asset.name] = {
+          const stat = {
             markPx,
             prevDayPx,
             changePct: prevDayPx ? (markPx - prevDayPx) / prevDayPx * 100 : 0
           };
+          const funding = optNum(ctx.funding);
+          const dayNtlVlm = optNum(ctx.dayNtlVlm);
+          const premium = optNum(ctx.premium);
+          const oraclePx = optNum(ctx.oraclePx);
+          const impactBid = ctx.impactPxs ? optNum(ctx.impactPxs[0]) : void 0;
+          const impactAsk = ctx.impactPxs ? optNum(ctx.impactPxs[1]) : void 0;
+          if (funding !== void 0) stat.funding = funding;
+          if (dayNtlVlm !== void 0) stat.dayNtlVlm = dayNtlVlm;
+          if (premium !== void 0) stat.premium = premium;
+          if (oraclePx !== void 0) stat.oraclePx = oraclePx;
+          if (impactBid !== void 0 && impactAsk !== void 0)
+            stat.impactPxs = [impactBid, impactAsk];
+          out[asset.name] = stat;
         });
       })
     );