@enfyra/mcp-server 0.0.115 → 0.0.117

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@enfyra/mcp-server",
3
- "version": "0.0.115",
3
+ "version": "0.0.117",
4
4
  "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -1531,7 +1531,7 @@ ensure_page_extension({
1531
1531
  name: "ReportsPage",
1532
1532
  description: "Reports dashboard",
1533
1533
  menuId: "<created-menu-id>",
1534
- code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"surface-card p-4\\"><div class=\\"flex items-start justify-between gap-3\\"><div><p class=\\"text-sm font-medium text-[var(--text-tertiary)]\\">Total</p><p class=\\"mt-2 text-2xl font-semibold text-[var(--text-primary)]\\">0</p></div><span class=\\"eapp-identity-soft rounded-[var(--radius-control)] p-2\\"><span class=\\"eapp-identity-text\\">◆</span></span></div><div class=\\"mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]\\"><div class=\\"eapp-identity-solid h-full w-1/2\\"></div></div></article><article class=\\"eapp-identity-surface rounded-[var(--radius-panel)] border p-4\\"><p class=\\"text-sm font-semibold text-[var(--text-primary)]\\">Selected report</p><p class=\\"mt-1 text-sm text-[var(--text-tertiary)]\\">Only selected/current identity blocks use identity surface.</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'neutral', variant: 'outline', onClick: () => {}, order: 80 }])</script>",
1534
+ code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"eapp-surface-card p-4\\"><div class=\\"flex items-start justify-between gap-3\\"><div><p class=\\"text-sm font-medium eapp-text-tertiary\\">Total</p><p class=\\"mt-2 text-2xl font-semibold eapp-text-primary\\">0</p></div><span class=\\"eapp-primary-soft eapp-radius-control p-2\\"><span class=\\"eapp-primary-text\\">◆</span></span></div><div class=\\"mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted\\"><div class=\\"eapp-primary-solid h-full w-1/2\\"></div></div></article><article class=\\"eapp-primary-surface eapp-radius-panel border p-4\\"><p class=\\"text-sm font-semibold eapp-text-primary\\">Selected report</p><p class=\\"mt-1 text-sm eapp-text-tertiary\\">Only selected/current identity blocks use identity surface.</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'neutral', variant: 'outline', onClick: () => {}, order: 80 }])</script>",
1535
1535
  isEnabled: true
1536
1536
  })`,
1537
1537
  notes: [
@@ -1546,14 +1546,15 @@ ensure_page_extension({
1546
1546
  'Put page-level actions in useHeaderActionRegistry or useSubHeaderActionRegistry, destructure register first, then call it with one action or an array.',
1547
1547
  'Page extensions should be full-bleed by default and responsive from the first version.',
1548
1548
  'The extension root is already inside Enfyra admin page main; do not add root-level page padding.',
1549
- 'Use existing eApp theme variables for panels, rows, badges, borders, controls, radius, and text. Pair border/divide utilities with border-[var(--border-default)] or divide-[var(--border-default)] so light and dark themes stay consistent.',
1550
- 'Treat primary color as runtime-configurable by the app color picker. For Nuxt UI components, choose color="primary" by semantic intent. For custom extension UI, decide whether each element is neutral surface, runtime-primary identity, or status: regular panels/KPI cards/list rows use surface-card/surface-muted or --card-* tokens, while selected/current identity blocks, primary tiles, progress fills, primary icons, and primary CTA fills use eapp-identity-surface, eapp-identity-soft, eapp-identity-solid, or eapp-identity-text so the color picker controls them.',
1551
- 'Pattern examples: KPI/metric cards should be surface-card with a small eapp-identity-soft icon tile; selected/current entity cards may use eapp-identity-surface; progress bars use bg-[var(--surface-muted)] tracks plus eapp-identity-solid fills; list rows use neutral surfaces/dividers and only small chips inside; primary scope actions use UButton color="primary" variant="solid"; secondary actions use neutral variants.',
1549
+ 'Use eApp theme class tokens for panels, rows, badges, borders, controls, radius, and text. Generated extension templates should prefer eapp-surface-*, eapp-text-*, eapp-radius-*, eapp-divide-y, and eapp-primary-* over raw CSS variable utilities.',
1550
+ 'Treat primary color as runtime-configurable by the app color picker. For Nuxt UI components, choose color="primary" by semantic intent. For custom extension UI, decide whether each element is neutral surface, runtime-primary identity, or status: regular panels/KPI cards/list rows use eapp-surface-card/eapp-surface-muted/eapp-surface-hover/eapp-divide-y and eapp-text-* classes, while selected/current identity blocks, primary tiles, progress fills, primary icons, and primary CTA fills use eapp-primary-surface, eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, or eapp-primary-text so the color picker controls them.',
1551
+ 'Decision cases: normal decorative accents, feature icons, non-state tiles, active tabs, progress fills, selected segments, and primary actions use runtime primary/identity classes; true semantic states use their matching status colors such as error, warning, success, or info; large ordinary surfaces stay neutral and carry only small badges/icons for status; selected/current entity blocks may use eapp-primary-surface.',
1552
+ 'Pattern examples: KPI/metric cards should be eapp-surface-card with a small eapp-primary-soft icon tile; selected/current entity cards may use eapp-primary-surface; progress bars use eapp-surface-muted tracks plus eapp-primary-solid fills; list rows use eapp-surface-card/eapp-divide-y/eapp-surface-hover and only small chips inside; primary scope actions use UButton color="primary" variant="solid"; secondary actions use neutral variants.',
1552
1553
  'Status colors belong only in UBadge/token-backed badges, small icons, or short status text. Do not color large panels, alert-like success blocks, KPI cards, list containers, or attention/reconciliation blocks green/yellow/red because of state; keep the block neutral and place the status badge/icon inside.',
1553
1554
  'Use PageHeader gradient: "none" for generated operational pages unless the user explicitly asks for a decorative page accent; do not hardcode cyan/violet/purple/blue/green gradients.',
1554
1555
  'For general card grids inside the shell, use md:grid-cols-2 xl:grid-cols-3 instead of lg:grid-cols-3 because the desktop sidebar leaves tablet-width content at 1024px.',
1555
- 'Do not use Nuxt UI neutral semantic classes such as bg-default, text-muted, text-dimmed, border-default, or divide-default inside extension code; use eApp tokens/classes.',
1556
- 'Do not pass ui.content: "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller content classes should only append z-index or width.',
1556
+ 'Do not use Nuxt UI neutral semantic classes such as bg-default, text-muted, text-dimmed, border-default, or divide-default inside extension code; use eApp class tokens instead. Do not write text-[var(...)], bg-[var(...)], or border-[var(...)] in generated extension templates unless no class token exists for that exact primitive.',
1557
+ 'Do not pass ui.content: "eapp-surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller content classes should only append z-index or width.',
1557
1558
  'Do not inject global CSS, create theme guards, redefine the app palette, or solve one extension by overriding the whole app shell.',
1558
1559
  'Keep list selection local and fetch detail rows only; do not refetch the whole list after a row click unless the list data changed.',
1559
1560
  'Page extension paths are admin app UI routes. Do not verify them with test_rest_endpoint against ENFYRA_API_URL unless inspect_route shows an API route with the same path.',
@@ -1565,17 +1566,17 @@ ensure_page_extension({
1565
1566
  code: `// Create reusable/bulky sections as widget extension records first.
1566
1567
  const reportStatusWidgetCode = \`
1567
1568
  <template>
1568
- <section class="surface-card p-4">
1569
+ <section class="eapp-surface-card p-4">
1569
1570
  <div class="flex items-start justify-between gap-3">
1570
1571
  <div>
1571
- <p class="text-sm font-medium text-[var(--text-tertiary)]">Total reports</p>
1572
- <p class="mt-2 text-2xl font-semibold text-[var(--text-primary)]">{{ total }}</p>
1573
- <p class="mt-1 text-xs text-[var(--text-tertiary)]">{{ latestLabel }}</p>
1572
+ <p class="text-sm font-medium eapp-text-tertiary">Total reports</p>
1573
+ <p class="mt-2 text-2xl font-semibold eapp-text-primary">{{ total }}</p>
1574
+ <p class="mt-1 text-xs eapp-text-tertiary">{{ latestLabel }}</p>
1574
1575
  </div>
1575
1576
  <UButton type="button" color="neutral" variant="outline" @click.stop.prevent="emit('refresh')">Refresh</UButton>
1576
1577
  </div>
1577
- <div class="mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]">
1578
- <div class="eapp-identity-solid h-full" :style="{ width: progressWidth }"></div>
1578
+ <div class="mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted">
1579
+ <div class="eapp-primary-solid h-full" :style="{ width: progressWidth }"></div>
1579
1580
  </div>
1580
1581
  <UButton v-if="hasLatest" type="button" class="mt-3" color="primary" variant="solid" @click.stop.prevent="openLatest">Open latest</UButton>
1581
1582
  </section>
@@ -1644,7 +1645,7 @@ const NotificationList = defineComponent({
1644
1645
  return () => h('div', { class: 'p-2 text-sm' }, [
1645
1646
  h('button', {
1646
1647
  type: 'button',
1647
- class: 'flex w-full items-center justify-between rounded px-2 py-2 text-left hover:bg-[var(--surface-muted)]',
1648
+ class: 'flex w-full items-center justify-between rounded px-2 py-2 text-left eapp-surface-hover',
1648
1649
  onClick: () => navigateTo('/notifications'),
1649
1650
  }, [
1650
1651
  h('span', 'Open notification center'),
@@ -1711,7 +1712,7 @@ const description = computed(() => unread.value > 0 ? 'Needs review' : 'All caug
1711
1712
  const NotificationPanelContent = defineComponent({
1712
1713
  name: 'NotificationPanelContent',
1713
1714
  setup() {
1714
- return () => h('div', { class: 'px-2 py-1 text-xs text-[var(--text-tertiary)]' }, 'Recent unread notifications can render here.')
1715
+ return () => h('div', { class: 'px-2 py-1 text-xs eapp-text-tertiary' }, 'Recent unread notifications can render here.')
1715
1716
  },
1716
1717
  })
1717
1718
 
@@ -301,26 +301,52 @@ function getExtensionThemeContract() {
301
301
  'Card/list grids inside the default shell must account for the 280px desktop sidebar. Do not switch general card grids to three columns at lg; use md:grid-cols-2 xl:grid-cols-3 unless a local container proves three columns have enough width.',
302
302
  ],
303
303
  theme: [
304
- 'Use existing eApp theme variables/classes, not hardcoded light or dark colors. The app theme source of truth is CSS variables, including --brand-*, --surface-*, --card-*, --control-*, --action-*, --badge-*, --radius-*, --border-*, and --text-*.',
305
- 'Primary color is runtime-configurable through the app color picker and must affect extension identity UI. For Nuxt UI components, choose color="primary" by semantic intent and let the app map it through the primary contract; do not choose a concrete palette. For custom extension UI, first choose whether the element is neutral surface, runtime-primary identity, or status. Regular panels, KPI cards, list rows, and large content blocks should use surface-card/surface-muted or --card-* tokens. Entity identity, selected/current state, active progress, primary tiles, primary icons, and primary CTA fills should use eapp-identity-surface, eapp-identity-soft, eapp-identity-solid, eapp-identity-text, or UButton/UBadge color="primary" so the color picker controls them.',
306
- 'Use eapp-identity-surface only for larger entity/feature blocks, selected/current cards, tiles, or cards that should read like normal app cards with a very subtle active-primary tint; it is not a saturated selected-state fill and must not be applied broadly to every KPI/list wrapper. Add eapp-identity-surface-hover when that block is clickable. Use eapp-identity-soft for compact selected entity chips, pills, small icon tiles, and identity callouts; add eapp-identity-soft-hover when compact surfaces are clickable; use eapp-identity-solid only for primary identity fills; use eapp-identity-text for identity icons or inline text. The eapp-accent-* aliases are still available for the same runtime-primary intent, but eapp-identity-* is preferred when the UI element represents an entity or feature identity.',
307
- 'Nuxt UI secondary is still a valid semantic color when the product intentionally wants a secondary action or state. Do not use color="secondary", from-secondary-*, bg-secondary-*, text-secondary-*, or cyan/purple/green palette utilities merely to approximate an entity accent; use eapp-identity-* and let the app decide the color.',
308
- 'Do not make custom extension blocks with Tailwind palette utilities or raw primary utilities such as text-primary, bg-primary/10, border-primary, ring-primary/20, from-cyan-*, text-violet-*, bg-green-*, bg-emerald-*, text-green-*, border-green-*, or dark:bg-zinc-950. The app owns how eapp-identity-* and eapp-accent-* map to the active color picker value.',
304
+ 'Use eApp theme class tokens, not hardcoded light/dark colors and not raw CSS variables inside extension templates. The app owns the CSS variable implementation; generated extensions should choose class tokens by intent.',
305
+ 'Primary color is runtime-configurable through the app color picker and must affect extension identity UI. For Nuxt UI components, choose color="primary" by semantic intent and let the app map it through the primary contract; do not choose a concrete palette. For custom extension UI, first choose whether the element is neutral surface, runtime-primary identity, or status. Regular panels, KPI cards, list rows, and large content blocks should use eapp-surface-card, eapp-surface-muted, eapp-surface-flat, eapp-surface-hover, eapp-divide-y, and eapp-text-* classes. Entity identity, selected/current state, active progress, primary tiles, primary icons, and primary CTA fills should use eapp-primary-surface, eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, eapp-primary-text, eapp-primary-border, or eapp-primary-ring so the color picker controls them.',
306
+ 'Use eapp-primary-surface only for larger entity/feature blocks, selected/current cards, tiles, or cards that should read like normal app cards with a very subtle active-primary tint; it is not a saturated selected-state fill and must not be applied broadly to every KPI/list wrapper. Add eapp-primary-surface-hover when that block is clickable. Use eapp-primary-soft for compact selected entity chips, pills, small icon tiles, and identity callouts; add eapp-primary-soft-hover when compact surfaces are clickable; use eapp-primary-subtle for a slightly stronger selected fill; use eapp-primary-solid only for primary identity fills; use eapp-primary-text for identity icons or inline text. eapp-identity-* remains an alias for the same runtime-primary intent, but eapp-primary-* is preferred in new extension code.',
307
+ 'Nuxt UI secondary is still a valid semantic color when the product intentionally wants a secondary action or state. Do not use color="secondary", from-secondary-*, bg-secondary-*, text-secondary-*, or cyan/purple/green palette utilities merely to approximate an entity accent; use eapp-primary-* and let the app decide the color.',
308
+ 'Do not make custom extension blocks with Tailwind palette utilities, raw CSS variable utilities, or raw primary utilities such as text-[var(--*)], bg-[var(--*)], border-[var(--*)], text-primary, bg-primary/10, border-primary, ring-primary/20, from-cyan-*, text-violet-*, bg-green-*, bg-emerald-*, text-green-*, border-green-*, or dark:bg-zinc-950. The app owns how eapp-primary-* maps to the active color picker value.',
309
309
  'Use UButton color="primary" only for the single main action for the current scope. Refresh, back, navigation, filters, and secondary actions should be neutral variants unless they are the main mutation.',
310
310
  'PageHeader gradient must be "none" for generated operational extensions unless the user explicitly asks for a decorative page accent. Do not hardcode cyan, violet, purple, blue, or green PageHeader gradients to force color variety.',
311
311
  'Do not inject global CSS, create theme guards, redefine the app palette, or solve one extension by overriding the whole app shell.',
312
- 'For panels/cards, prefer surface-card, surface-card-hover, surface-muted, or explicit token classes such as bg-[var(--card-bg)] border-[var(--card-border)] shadow-[var(--card-shadow)]. Use text-[var(--text-primary|secondary|tertiary)] for copy.',
312
+ 'For panels/cards, prefer eapp-surface-card, eapp-surface-hover, eapp-surface-muted, eapp-surface-flat, and eapp-divide-y. Use eapp-text-primary, eapp-text-secondary, eapp-text-tertiary, or eapp-text-quaternary for copy.',
313
313
  'Never use Nuxt UI neutral semantic classes such as bg-default, bg-muted, border-default, divide-default, text-muted, text-dimmed, or hardcoded dark palettes such as dark:bg-zinc-950, bg-slate-*, text-gray-*, border-black, or black.',
314
- 'Never use bare border/divide-y for panels or rows: pair them with border-[var(--border-default)] or divide-[var(--border-default)].',
314
+ 'Never use bare border/divide-y for panels or rows: pair borders with eapp-divider or use eapp-divide-y for row separators.',
315
315
  'Use radius tokens or mapped rounded utilities consistently: --radius-card for cards, --radius-panel for nested panels, --radius-control for buttons/inputs, --radius-subcontrol for compact inner controls, and --radius-pill for pills.',
316
316
  'Status colors must remain readable in both themes and must stay scoped to badges, small icons, or short status text. Use UBadge or badge tokens for non-primary statuses such as --badge-success-soft-*, --badge-warning-soft-*, --badge-danger-soft-*, --badge-info-soft-*, and --badge-neutral-soft-* instead of neon translucent colors. Do not color large panels, alert-like success blocks, KPI cards, list containers, or reconciliation/attention blocks green/yellow/red because the status is good/warning/error; use neutral app surfaces for the block and place a small status badge/icon inside.',
317
317
  'Keep dark and light contrast comparable. Do not make dark mode more neon or lower-contrast than light mode; prefer muted soft backgrounds with clear text and visible borders.',
318
318
  ],
319
+ decisionCases: [
320
+ {
321
+ intent: 'Normal accent, decorative icon, feature icon, non-state tile, active tab fill, progress fill, selected segment, primary metric accent, or primary action.',
322
+ colorContract: 'Use runtime primary so the app color picker controls the color.',
323
+ use: 'UButton/UBadge color="primary", eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, eapp-primary-text, or eapp-primary-surface when the whole block is selected/current identity.',
324
+ avoid: 'Do not pick cyan, purple, green, amber, secondary, or concrete Tailwind palettes just because they look good.',
325
+ },
326
+ {
327
+ intent: 'True semantic state: error, danger, destructive, warning, pending attention, success, healthy, running, failed, info, or notice.',
328
+ colorContract: 'Use the matching state/status color because the color communicates meaning, not brand identity.',
329
+ use: 'UAlert/UBadge color="error|warning|success|info|neutral", state/badge tokens such as --badge-success-soft-*, or error/warning/info/success utilities that are already backed by app tokens.',
330
+ avoid: 'Do not force semantic state UI to primary; an error must stay error, a warning must stay warning, success can stay success when it is a badge/icon/short status.',
331
+ },
332
+ {
333
+ intent: 'Large ordinary surface: KPI card, list container, table panel, detail panel, summary block, empty state panel, reconciliation block, or attention block.',
334
+ colorContract: 'Use neutral app surfaces first; large surfaces should not become state-colored or arbitrary accent-colored.',
335
+ use: 'eapp-surface-card, eapp-surface-hover, eapp-surface-muted, eapp-surface-flat, eapp-divide-y, and eapp-text-* classes.',
336
+ avoid: 'Do not color large blocks green/yellow/red because their content says healthy/warning/error; place a status badge/icon inside the neutral block instead.',
337
+ },
338
+ {
339
+ intent: 'Selected/current entity or user-selected option where the whole block is the active identity.',
340
+ colorContract: 'Use runtime primary identity surface, but subtly.',
341
+ use: 'eapp-primary-surface plus optional eapp-primary-surface-hover; eapp-primary-soft/text for the icon or chip inside.',
342
+ avoid: 'Do not use eapp-primary-surface for every card in a grid/list or as a broad page background.',
343
+ },
344
+ ],
319
345
  components: [
320
346
  'Use Nuxt UI/eApp components for normal controls: UButton, UInput, UTextarea, USelectMenu/USelect, USwitch, UCheckbox, UTabs, UBadge, UModal, and CommonDrawer when available.',
321
347
  'Buttons should have stable geometry: hover may change color, border, or shadow but must not move the button or resize its content. Disabled buttons keep disabled cursor/visual state.',
322
348
  'Inputs and textareas should not add hover movement or decorative hover states; focus, invalid, disabled, and loading states must be explicit.',
323
- 'Dynamic extensions resolve UModal to the app CommonModal. Do not pass ui.content: "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller ui.content should only append z-index, width, or max-width classes.',
349
+ 'Dynamic extensions resolve UModal to the app CommonModal. Do not pass ui.content: "eapp-surface-card" or "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller ui.content should only append z-index, width, or max-width classes.',
324
350
  'Use CommonDrawer for side-panel editing. Open drawers immediately on user action and render loading/error/content inside the drawer instead of waiting for fetch before opening.',
325
351
  'Use UBadge or token-backed badge spans for status. Keep badges legible in both themes with tokenized background, text, and border.',
326
352
  ],
@@ -344,27 +370,27 @@ function getExtensionThemeContract() {
344
370
  {
345
371
  useWhen: 'Ordinary KPI, metric, or summary card where the whole card is not selected/current identity.',
346
372
  use: 'Neutral card surface; put runtime-primary only on a small identity icon tile, progress fill, or main CTA inside the card.',
347
- snippet: '<article class="surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm text-[var(--text-tertiary)]">Metric</p><p class="mt-2 text-2xl font-semibold text-[var(--text-primary)]">{{ value }}</p></div><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-identity-text" /></span></div></article>',
373
+ snippet: '<article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Metric</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">{{ value }}</p></div><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div></article>',
348
374
  },
349
375
  {
350
376
  useWhen: 'Selected/current entity, active plan, chosen package, or the single block that represents the active identity.',
351
- use: 'eapp-identity-surface for the selected/current block, with eapp-identity-soft/text for compact icon parts.',
352
- snippet: '<article class="eapp-identity-surface eapp-identity-surface-hover rounded-[var(--radius-panel)] border p-4"><div class="flex items-center gap-3"><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:box" class="size-5 eapp-identity-text" /></span><div><p class="font-semibold text-[var(--text-primary)]">{{ name }}</p><p class="text-sm text-[var(--text-tertiary)]">Currently selected</p></div></div></article>',
377
+ use: 'eapp-primary-surface for the selected/current block, with eapp-primary-soft/text for compact icon parts.',
378
+ snippet: '<article class="eapp-primary-surface eapp-primary-surface-hover eapp-radius-panel border p-4"><div class="flex items-center gap-3"><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:box" class="size-5 eapp-primary-text" /></span><div><p class="font-semibold eapp-text-primary">{{ name }}</p><p class="text-sm eapp-text-tertiary">Currently selected</p></div></div></article>',
353
379
  },
354
380
  {
355
381
  useWhen: 'Progress, active tab indicator, selected segment fill, or primary visual meter.',
356
- use: 'Neutral track plus eapp-identity-solid fill so the app color picker controls the fill.',
357
- snippet: '<div class="h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]"><div class="eapp-identity-solid h-full" :style="{ width: progressWidth }"></div></div>',
382
+ use: 'Neutral track plus eapp-primary-solid fill so the app color picker controls the fill.',
383
+ snippet: '<div class="h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted"><div class="eapp-primary-solid h-full" :style="{ width: progressWidth }"></div></div>',
358
384
  },
359
385
  {
360
386
  useWhen: 'Success, warning, error, info, healthy, running, failed, pending, or attention status.',
361
387
  use: 'UBadge/status badge tokens and optionally a small icon only. Keep large alert/panel/card backgrounds neutral unless the whole block is an identity block.',
362
- snippet: '<section class="surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold text-[var(--text-primary)]">Reconciliation</p><UBadge color="success" variant="soft">Healthy</UBadge></div><p class="mt-1 text-sm text-[var(--text-tertiary)]">Latest report found no mismatches.</p></section>',
388
+ snippet: '<section class="eapp-surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold eapp-text-primary">Reconciliation</p><UBadge color="success" variant="soft">Healthy</UBadge></div><p class="mt-1 text-sm eapp-text-tertiary">Latest report found no mismatches.</p></section>',
363
389
  },
364
390
  {
365
391
  useWhen: 'List rows, table-like records, history rows, and secondary navigation rows.',
366
392
  use: 'Neutral row surface, tokenized dividers, hover surface-muted, with small status/identity chips inside.',
367
- snippet: '<div class="surface-card divide-y divide-[var(--border-default)]"><button class="flex w-full items-center justify-between px-4 py-3 text-left hover:bg-[var(--surface-muted)]"><span class="text-sm font-medium text-[var(--text-primary)]">{{ row.name }}</span><UBadge color="neutral" variant="soft">{{ row.state }}</UBadge></button></div>',
393
+ snippet: '<div class="eapp-surface-card eapp-divide-y"><button class="flex w-full items-center justify-between px-4 py-3 text-left eapp-surface-hover"><span class="text-sm font-medium eapp-text-primary">{{ row.name }}</span><UBadge color="neutral" variant="soft">{{ row.state }}</UBadge></button></div>',
368
394
  },
369
395
  {
370
396
  useWhen: 'Primary action for the current scope, such as create/save/apply/open-current.',
@@ -372,7 +398,7 @@ function getExtensionThemeContract() {
372
398
  snippet: '<div class="flex justify-end gap-2"><UButton color="neutral" variant="outline">Cancel</UButton><UButton color="primary" variant="solid" icon="lucide:save">Save</UButton></div>',
373
399
  },
374
400
  ],
375
- compactExample: '<template><section class="min-h-full w-full space-y-4"><article class="surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm text-[var(--text-tertiary)]">Neutral KPI</p><p class="mt-2 text-2xl font-semibold text-[var(--text-primary)]">24</p></div><span class="eapp-identity-soft rounded-[var(--radius-control)] p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-identity-text" /></span></div><div class="mt-3 h-1.5 overflow-hidden rounded-[var(--radius-pill)] bg-[var(--surface-muted)]"><div class="eapp-identity-solid h-full w-1/2"></div></div></article><section class="surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold text-[var(--text-primary)]">Status block stays neutral</p><UBadge color="success" variant="soft">Healthy</UBadge></div></section></section></template>',
401
+ compactExample: '<template><section class="min-h-full w-full space-y-4"><article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Neutral KPI</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">24</p></div><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div><div class="mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted"><div class="eapp-primary-solid h-full w-1/2"></div></div></article><section class="eapp-surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold eapp-text-primary">Status block stays neutral</p><UBadge color="success" variant="soft">Healthy</UBadge></div></section></section></template>',
376
402
  };
377
403
  }
378
404