@classic-homes/theme-mcp 0.5.6 → 0.5.8

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.
@@ -6,8 +6,54 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
6
6
 
7
7
  // src/data/component-catalog.json
8
8
  var component_catalog_default = {
9
- version: "0.5.6",
9
+ version: "0.5.8",
10
10
  components: [
11
+ {
12
+ name: "AccessInspector",
13
+ description: "Admin-only overlay that shows which role or permission gates UI and data, lists denials including API 403s, and previews the page as another role",
14
+ category: "core",
15
+ importPath: "@classic-homes/access-inspector-svelte",
16
+ props: [
17
+ {
18
+ name: "config",
19
+ type: "AccessInspectorConfig",
20
+ default: "{}",
21
+ required: false,
22
+ description: "Who may use it and how it opens (see below)"
23
+ }
24
+ ],
25
+ variants: [],
26
+ slots: [
27
+ {
28
+ name: "children",
29
+ description: "Main content",
30
+ required: false
31
+ }
32
+ ],
33
+ events: [],
34
+ examples: [
35
+ {
36
+ title: "RequireAccess (gate and mark)",
37
+ code: `<script>
38
+ import { RequireAccess } from '@classic-homes/access-inspector-svelte';
39
+ </script>
40
+
41
+ <RequireAccess permissions={['reports:read']} label="Reports">
42
+ <ReportsCard />
43
+ {#snippet fallback()}
44
+ <p>Ask your manager for report access.</p>
45
+ {/snippet}
46
+ </RequireAccess>`
47
+ },
48
+ {
49
+ title: "use:requires (mark only)",
50
+ code: "<button use:requires={{ permissions: ['homes:update'], label: 'Edit' }}>Edit</button>"
51
+ }
52
+ ],
53
+ relatedComponents: [
54
+ "FeedbackWidget"
55
+ ]
56
+ },
11
57
  {
12
58
  name: "ActionHeader",
13
59
  description: "Responsive app page header with back link, badges and actions that fold into an overflow menu instead of wrapping",
@@ -885,6 +931,19 @@ var component_catalog_default = {
885
931
  required: false,
886
932
  description: "Custom HTML legend (e.g. `ChartLegend`) instead of the built-in one; React takes a function returning a node"
887
933
  },
934
+ {
935
+ name: "showDataPoints",
936
+ type: "boolean",
937
+ default: "false",
938
+ required: false,
939
+ description: "Show data point markers on the line (needed for clicks on a point)"
940
+ },
941
+ {
942
+ name: "selected",
943
+ type: "string | string[] | null",
944
+ required: false,
945
+ description: "Controlled selection: points at the named categories show enlarged and ringed. Set it from `onClick` to cross-filter"
946
+ },
888
947
  {
889
948
  name: "onClick",
890
949
  type: "(params: DataPointEventParams) => void",
@@ -1984,6 +2043,12 @@ var component_catalog_default = {
1984
2043
  required: false,
1985
2044
  description: "Custom HTML legend (e.g. `ChartLegend`) instead of the built-in one; React takes a function returning a node"
1986
2045
  },
2046
+ {
2047
+ name: "selected",
2048
+ type: "string | string[] | null",
2049
+ required: false,
2050
+ description: "Controlled selection: bars outside the named categories fade. Set it from `onClick` to cross-filter"
2051
+ },
1987
2052
  {
1988
2053
  name: "onClick",
1989
2054
  type: "(params: DataPointEventParams) => void",
@@ -7602,6 +7667,120 @@ var component_catalog_default = {
7602
7667
  "FormField"
7603
7668
  ]
7604
7669
  },
7670
+ {
7671
+ name: "DeltaText",
7672
+ description: "An inline change against a previous value, coloured by whether the direction is good",
7673
+ category: "chart",
7674
+ importPath: "@classic-homes/charts-svelte",
7675
+ props: [
7676
+ {
7677
+ name: "current",
7678
+ type: "number | null | undefined",
7679
+ required: true,
7680
+ description: "The current value"
7681
+ },
7682
+ {
7683
+ name: "previous",
7684
+ type: "number | null | undefined",
7685
+ required: true,
7686
+ description: "The value compared against"
7687
+ },
7688
+ {
7689
+ name: "display",
7690
+ type: "'percent' | 'absolute' | 'both'",
7691
+ default: "'percent'",
7692
+ required: false,
7693
+ description: "How the change is shown; a change from zero falls back to absolute"
7694
+ },
7695
+ {
7696
+ name: "goodWhen",
7697
+ type: "'up' | 'down' | 'none'",
7698
+ default: "'up'",
7699
+ required: false,
7700
+ description: "Which direction is coloured as good; `'none'` stays neutral"
7701
+ },
7702
+ {
7703
+ name: "valueFormat",
7704
+ type: "ValueFormat",
7705
+ required: false,
7706
+ description: "How the absolute change and the previous value are written"
7707
+ },
7708
+ {
7709
+ name: "locale",
7710
+ type: "string",
7711
+ default: "'en-US'",
7712
+ required: false,
7713
+ description: "Locale for `valueFormat` and the percentage"
7714
+ },
7715
+ {
7716
+ name: "label",
7717
+ type: "string",
7718
+ default: "'vs <previous>'",
7719
+ required: false,
7720
+ description: "Text after the change; `''` hides it"
7721
+ },
7722
+ {
7723
+ name: "class",
7724
+ type: "string",
7725
+ required: false,
7726
+ description: "Custom CSS class"
7727
+ }
7728
+ ],
7729
+ variants: [
7730
+ {
7731
+ name: "display",
7732
+ values: [
7733
+ "percent",
7734
+ "absolute",
7735
+ "both"
7736
+ ],
7737
+ default: "percent"
7738
+ },
7739
+ {
7740
+ name: "goodWhen",
7741
+ values: [
7742
+ "up",
7743
+ "down",
7744
+ "none"
7745
+ ],
7746
+ default: "up"
7747
+ }
7748
+ ],
7749
+ slots: [],
7750
+ events: [],
7751
+ examples: [
7752
+ {
7753
+ title: "Basic Usage",
7754
+ code: `<script>
7755
+ import { DeltaText } from '@classic-homes/charts-svelte';
7756
+ </script>
7757
+
7758
+ <DeltaText current={142} previous={130} label="vs last year" />`
7759
+ },
7760
+ {
7761
+ title: "Lower Is Better",
7762
+ code: '<DeltaText current={112} previous={121} valueFormat="days" goodWhen="down" display="both" />'
7763
+ },
7764
+ {
7765
+ title: "In a Table Cell",
7766
+ code: `{#snippet closingsCell(value, row)}
7767
+ <div class="flex flex-col items-end">
7768
+ <span class="tabular-nums">{value}</span>
7769
+ <DeltaText current={row.closings} previous={row.priorClosings} label="" />
7770
+ </div>
7771
+ {/snippet}
7772
+
7773
+ <DataTable
7774
+ {data}
7775
+ columns={[{ id: 'closings', header: 'Closings', accessor: 'closings', cell: closingsCell }]}
7776
+ />`
7777
+ }
7778
+ ],
7779
+ relatedComponents: [
7780
+ "StatCard",
7781
+ "StatGroup"
7782
+ ]
7783
+ },
7605
7784
  {
7606
7785
  name: "Dialog",
7607
7786
  description: "Modal window for focused interactions and confirmations",
@@ -7996,6 +8175,12 @@ var component_catalog_default = {
7996
8175
  required: false,
7997
8176
  description: "Custom HTML legend (e.g. `ChartLegend`) instead of the built-in one; React takes a function returning a node"
7998
8177
  },
8178
+ {
8179
+ name: "selected",
8180
+ type: "string | string[] | null",
8181
+ required: false,
8182
+ description: "Controlled selection: slices outside the named ones fade. Set it from `onClick` to cross-filter"
8183
+ },
7999
8184
  {
8000
8185
  name: "onClick",
8001
8186
  type: "(params: SliceEventParams) => void",
@@ -12906,6 +13091,12 @@ var component_catalog_default = {
12906
13091
  required: false,
12907
13092
  description: "Custom HTML legend (e.g. `ChartLegend`) instead of the built-in one; React takes a function returning a node"
12908
13093
  },
13094
+ {
13095
+ name: "selected",
13096
+ type: "string | string[] | null",
13097
+ required: false,
13098
+ description: "Controlled selection: points at the named categories show enlarged and ringed. Set it from `onClick` to cross-filter"
13099
+ },
12909
13100
  {
12910
13101
  name: "onClick",
12911
13102
  type: "(params: DataPointEventParams) => void",
@@ -14439,6 +14630,13 @@ var component_catalog_default = {
14439
14630
  required: false,
14440
14631
  description: "Debounce time for search"
14441
14632
  },
14633
+ {
14634
+ name: "maxVisibleTags",
14635
+ type: "number",
14636
+ default: "6",
14637
+ required: false,
14638
+ description: 'Selected tags shown before the rest fold into a "+N more" toggle (`Infinity` shows all)'
14639
+ },
14442
14640
  {
14443
14641
  name: "onValueChange",
14444
14642
  type: "(value: string[]) => void",
@@ -14801,7 +14999,7 @@ var component_catalog_default = {
14801
14999
  examples: [
14802
15000
  {
14803
15001
  title: "Basic Usage",
14804
- code: "<script>\n let selectedIds = $state(new Set<string>());\n const notifications = [...];\n</script>\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={notifications.length}\n allSelected={selectedIds.size === notifications.length}\n onSelectAll={(selected) => {\n /* ... */\n }}\n onMarkRead={() => {\n /* ... */\n }}\n onMarkUnread={() => {\n /* ... */\n }}\n onDelete={() => {\n /* ... */\n }}\n/>"
15002
+ code: "<script>\n let selectedIds = $state(new Set<string>());\n const notifications = [\n /* your notifications */\n ];\n</script>\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={notifications.length}\n allSelected={selectedIds.size === notifications.length}\n onSelectAll={(selected) => {\n /* ... */\n }}\n onMarkRead={() => {\n /* ... */\n }}\n onMarkUnread={() => {\n /* ... */\n }}\n onDelete={() => {\n /* ... */\n }}\n/>"
14805
15003
  },
14806
15004
  {
14807
15005
  title: "No Selection",
@@ -14821,7 +15019,7 @@ var component_catalog_default = {
14821
15019
  {
14822
15020
  title: "Select All",
14823
15021
  description: "Toggle selection of all visible notifications:",
14824
- code: "<script>\n function handleSelectAll(selected: boolean) {\n if (selected) {\n selectedIds = new Set(filteredNotifications().map(n => n.id));\n } else {\n selectedIds = new Set();\n }\n }\n</script>\n\n<NotificationBulkActions\n onSelectAll={handleSelectAll}\n {...}\n/>"
15022
+ code: "<script>\n function handleSelectAll(selected: boolean) {\n if (selected) {\n selectedIds = new Set(filteredNotifications.map(n => n.id));\n } else {\n selectedIds = new Set();\n }\n }\n</script>\n\n<NotificationBulkActions\n onSelectAll={handleSelectAll}\n {...}\n/>"
14825
15023
  },
14826
15024
  {
14827
15025
  title: "Mark as Read",
@@ -14840,7 +15038,7 @@ var component_catalog_default = {
14840
15038
  },
14841
15039
  {
14842
15040
  title: "Complete Implementation",
14843
- code: "<script>\n import { toastStore } from '@classic-homes/theme-svelte';\n import {\n NotificationList,\n NotificationFilters,\n NotificationBulkActions,\n } from '@classic-homes/theme-svelte/notifications';\n import type { Notification, NotificationFilter, NotificationCounts } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([...]);\n let filter = $state<NotificationFilter>('all');\n let selectedIds = $state(new Set<string>());\n\n const filteredNotifications = $derived(() => {\n switch (filter) {\n case 'unread': return notifications.filter(n => !n.read);\n case 'read': return notifications.filter(n => n.read);\n default: return notifications;\n }\n });\n\n const counts = $derived<NotificationCounts>({\n all: notifications.length,\n unread: notifications.filter(n => !n.read).length,\n read: notifications.filter(n => n.read).length,\n });\n\n const allSelected = $derived(\n filteredNotifications().length > 0 &&\n filteredNotifications().every(n => selectedIds.has(n.id))\n );\n\n function handleToggleSelect(id: string, selected: boolean) {\n const newSet = new Set(selectedIds);\n if (selected) newSet.add(id);\n else newSet.delete(id);\n selectedIds = newSet;\n }\n\n function handleSelectAll(selected: boolean) {\n if (selected) {\n selectedIds = new Set(filteredNotifications().map(n => n.id));\n } else {\n selectedIds = new Set();\n }\n }\n\n function handleClearSelection() {\n selectedIds = new Set();\n }\n\n function handleBulkMarkRead() {\n notifications = notifications.map(n =>\n selectedIds.has(n.id)\n ? { ...n, read: true, readAt: new Date().toISOString() }\n : n\n );\n selectedIds = new Set();\n toastStore.success('Marked as read');\n }\n\n function handleBulkMarkUnread() {\n notifications = notifications.map(n =>\n selectedIds.has(n.id)\n ? { ...n, read: false, readAt: undefined }\n : n\n );\n selectedIds = new Set();\n toastStore.info('Marked as unread');\n }\n\n function handleBulkDelete() {\n notifications = notifications.filter(n => !selectedIds.has(n.id));\n selectedIds = new Set();\n toastStore.info('Deleted');\n }\n</script>\n\n<NotificationFilters bind:filter {counts} onFilterChange={() => (selectedIds = new Set())} />\n\n{#if filteredNotifications().length > 0}\n <NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications().length}\n {allSelected}\n onSelectAll={handleSelectAll}\n onMarkRead={handleBulkMarkRead}\n onMarkUnread={handleBulkMarkUnread}\n onDelete={handleBulkDelete}\n onClearSelection={handleClearSelection}\n />\n{/if}\n\n<NotificationList\n notifications={filteredNotifications()}\n {selectedIds}\n selectable={true}\n onToggleSelect={handleToggleSelect}\n/>"
15041
+ code: "<script>\n import { toastStore } from '@classic-homes/theme-svelte';\n import {\n NotificationList,\n NotificationFilters,\n NotificationBulkActions,\n } from '@classic-homes/theme-svelte/notifications';\n import type {\n Notification,\n NotificationFilter,\n NotificationCounts,\n } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([\n /* your notifications */\n ]);\n let filter = $state<NotificationFilter>('all');\n let selectedIds = $state(new Set<string>());\n\n const filteredNotifications = $derived.by(() => {\n switch (filter) {\n case 'unread':\n return notifications.filter((n) => !n.read);\n case 'read':\n return notifications.filter((n) => n.read);\n default:\n return notifications;\n }\n });\n\n const counts = $derived<NotificationCounts>({\n all: notifications.length,\n unread: notifications.filter((n) => !n.read).length,\n read: notifications.filter((n) => n.read).length,\n });\n\n const allSelected = $derived(\n filteredNotifications.length > 0 && filteredNotifications.every((n) => selectedIds.has(n.id))\n );\n\n function handleToggleSelect(id: string, selected: boolean) {\n const newSet = new Set(selectedIds);\n if (selected) newSet.add(id);\n else newSet.delete(id);\n selectedIds = newSet;\n }\n\n function handleSelectAll(selected: boolean) {\n if (selected) {\n selectedIds = new Set(filteredNotifications.map((n) => n.id));\n } else {\n selectedIds = new Set();\n }\n }\n\n function handleClearSelection() {\n selectedIds = new Set();\n }\n\n function handleBulkMarkRead() {\n notifications = notifications.map((n) =>\n selectedIds.has(n.id) ? { ...n, read: true, readAt: new Date().toISOString() } : n\n );\n selectedIds = new Set();\n toastStore.success('Marked as read');\n }\n\n function handleBulkMarkUnread() {\n notifications = notifications.map((n) =>\n selectedIds.has(n.id) ? { ...n, read: false, readAt: undefined } : n\n );\n selectedIds = new Set();\n toastStore.info('Marked as unread');\n }\n\n function handleBulkDelete() {\n notifications = notifications.filter((n) => !selectedIds.has(n.id));\n selectedIds = new Set();\n toastStore.info('Deleted');\n }\n</script>\n\n<NotificationFilters bind:filter {counts} onFilterChange={() => (selectedIds = new Set())} />\n\n{#if filteredNotifications.length > 0}\n <NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications.length}\n {allSelected}\n onSelectAll={handleSelectAll}\n onMarkRead={handleBulkMarkRead}\n onMarkUnread={handleBulkMarkUnread}\n onDelete={handleBulkDelete}\n onClearSelection={handleClearSelection}\n />\n{/if}\n\n<NotificationList\n notifications={filteredNotifications}\n {selectedIds}\n selectable={true}\n onToggleSelect={handleToggleSelect}\n/>"
14844
15042
  }
14845
15043
  ],
14846
15044
  relatedComponents: [
@@ -14918,7 +15116,7 @@ var component_catalog_default = {
14918
15116
  },
14919
15117
  {
14920
15118
  title: "Complete Implementation",
14921
- code: "<script>\n import { toastStore } from '@classic-homes/theme-svelte';\n import { NotificationList, NotificationDialog } from '@classic-homes/theme-svelte/notifications';\n import type { Notification } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([...]);\n let selectedNotification = $state<Notification | null>(null);\n let dialogOpen = $state(false);\n\n function handleNotificationClick(notification: Notification) {\n selectedNotification = notification;\n dialogOpen = true;\n }\n\n function handleDialogClose() {\n dialogOpen = false;\n selectedNotification = null;\n }\n\n function markAsRead(id: string) {\n notifications = notifications.map(n =>\n n.id === id ? { ...n, read: true, readAt: new Date().toISOString() } : n\n );\n toastStore.success('Notification marked as read');\n }\n\n function markAsUnread(id: string) {\n notifications = notifications.map(n =>\n n.id === id ? { ...n, read: false, readAt: undefined } : n\n );\n toastStore.info('Notification marked as unread');\n }\n\n function deleteNotification(id: string) {\n notifications = notifications.filter(n => n.id !== id);\n handleDialogClose();\n toastStore.info('Notification deleted');\n }\n</script>\n\n<NotificationList {notifications} onNotificationClick={handleNotificationClick} />\n\n<NotificationDialog\n notification={selectedNotification}\n bind:open={dialogOpen}\n onClose={handleDialogClose}\n onMarkRead={markAsRead}\n onMarkUnread={markAsUnread}\n onDelete={deleteNotification}\n/>"
15119
+ code: "<script>\n import { toastStore } from '@classic-homes/theme-svelte';\n import { NotificationList, NotificationDialog } from '@classic-homes/theme-svelte/notifications';\n import type { Notification } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([\n /* your notifications */\n ]);\n let selectedNotification = $state<Notification | null>(null);\n let dialogOpen = $state(false);\n\n function handleNotificationClick(notification: Notification) {\n selectedNotification = notification;\n dialogOpen = true;\n }\n\n function handleDialogClose() {\n dialogOpen = false;\n selectedNotification = null;\n }\n\n function markAsRead(id: string) {\n notifications = notifications.map((n) =>\n n.id === id ? { ...n, read: true, readAt: new Date().toISOString() } : n\n );\n toastStore.success('Notification marked as read');\n }\n\n function markAsUnread(id: string) {\n notifications = notifications.map((n) =>\n n.id === id ? { ...n, read: false, readAt: undefined } : n\n );\n toastStore.info('Notification marked as unread');\n }\n\n function deleteNotification(id: string) {\n notifications = notifications.filter((n) => n.id !== id);\n handleDialogClose();\n toastStore.info('Notification deleted');\n }\n</script>\n\n<NotificationList {notifications} onNotificationClick={handleNotificationClick} />\n\n<NotificationDialog\n notification={selectedNotification}\n bind:open={dialogOpen}\n onClose={handleDialogClose}\n onMarkRead={markAsRead}\n onMarkUnread={markAsUnread}\n onDelete={deleteNotification}\n/>"
14922
15120
  },
14923
15121
  {
14924
15122
  title: "With Action Links",
@@ -14980,11 +15178,11 @@ var component_catalog_default = {
14980
15178
  },
14981
15179
  {
14982
15180
  title: "With Notification List",
14983
- code: "<script>\n import {\n NotificationFilters,\n NotificationList,\n } from '@classic-homes/theme-svelte/notifications';\n import type { Notification, NotificationFilter, NotificationCounts } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([...]);\n let filter = $state<NotificationFilter>('all');\n\n const counts = $derived<NotificationCounts>({\n all: notifications.length,\n unread: notifications.filter(n => !n.read).length,\n read: notifications.filter(n => n.read).length,\n });\n\n const filteredNotifications = $derived(() => {\n switch (filter) {\n case 'unread': return notifications.filter(n => !n.read);\n case 'read': return notifications.filter(n => n.read);\n default: return notifications;\n }\n });\n</script>\n\n<NotificationFilters bind:filter {counts} />\n\n<NotificationList\n notifications={filteredNotifications()}\n emptyTitle={filter === 'unread'\n ? 'No unread notifications'\n : filter === 'read'\n ? 'No read notifications'\n : 'No notifications'}\n/>"
15181
+ code: "<script>\n import { NotificationFilters, NotificationList } from '@classic-homes/theme-svelte/notifications';\n import type {\n Notification,\n NotificationFilter,\n NotificationCounts,\n } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([\n /* your notifications */\n ]);\n let filter = $state<NotificationFilter>('all');\n\n const counts = $derived<NotificationCounts>({\n all: notifications.length,\n unread: notifications.filter((n) => !n.read).length,\n read: notifications.filter((n) => n.read).length,\n });\n\n const filteredNotifications = $derived.by(() => {\n switch (filter) {\n case 'unread':\n return notifications.filter((n) => !n.read);\n case 'read':\n return notifications.filter((n) => n.read);\n default:\n return notifications;\n }\n });\n</script>\n\n<NotificationFilters bind:filter {counts} />\n\n<NotificationList\n notifications={filteredNotifications}\n emptyTitle={filter === 'unread'\n ? 'No unread notifications'\n : filter === 'read'\n ? 'No read notifications'\n : 'No notifications'}\n/>"
14984
15182
  },
14985
15183
  {
14986
15184
  title: "Reset Selection on Filter Change",
14987
- code: "<script>\n let selectedIds = $state(new Set<string>());\n\n function handleFilterChange(newFilter: NotificationFilter) {\n filter = newFilter;\n selectedIds = new Set(); // Clear selection\n }\n</script>\n\n<NotificationFilters\n bind:filter\n {counts}\n onFilterChange={handleFilterChange}\n/>\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications().length}\n {...}\n/>"
15185
+ code: "<script>\n let selectedIds = $state(new Set<string>());\n\n function handleFilterChange(newFilter: NotificationFilter) {\n filter = newFilter;\n selectedIds = new Set(); // Clear selection\n }\n</script>\n\n<NotificationFilters\n bind:filter\n {counts}\n onFilterChange={handleFilterChange}\n/>\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications.length}\n {...}\n/>"
14988
15186
  }
14989
15187
  ],
14990
15188
  relatedComponents: [
@@ -15175,12 +15373,12 @@ var component_catalog_default = {
15175
15373
  },
15176
15374
  {
15177
15375
  title: "Complete Notification Center",
15178
- code: "<script>\n import {\n NotificationList,\n NotificationFilters,\n NotificationBulkActions,\n NotificationDialog,\n } from '@classic-homes/theme-svelte/notifications';\n import type { Notification, NotificationFilter, NotificationCounts } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([...]);\n let filter = $state<NotificationFilter>('all');\n let selectedIds = $state(new Set<string>());\n let dialogOpen = $state(false);\n let selectedNotification = $state<Notification | null>(null);\n\n const filteredNotifications = $derived(() => {\n switch (filter) {\n case 'unread': return notifications.filter(n => !n.read);\n case 'read': return notifications.filter(n => n.read);\n default: return notifications;\n }\n });\n\n const counts: NotificationCounts = $derived({\n all: notifications.length,\n unread: notifications.filter(n => !n.read).length,\n read: notifications.filter(n => n.read).length,\n });\n</script>\n\n<NotificationFilters bind:filter {counts} />\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications().length}\n onSelectAll={(selected) => {\n /* ... */\n }}\n onMarkRead={() => {\n /* ... */\n }}\n onDelete={() => {\n /* ... */\n }}\n/>\n\n<NotificationList\n notifications={filteredNotifications()}\n {selectedIds}\n selectable={true}\n onToggleSelect={handleToggleSelect}\n onNotificationClick={handleNotificationClick}\n/>\n\n<NotificationDialog notification={selectedNotification} bind:open={dialogOpen} />"
15376
+ code: "<script>\n import {\n NotificationList,\n NotificationFilters,\n NotificationBulkActions,\n NotificationDialog,\n } from '@classic-homes/theme-svelte/notifications';\n import type {\n Notification,\n NotificationFilter,\n NotificationCounts,\n } from '@classic-homes/notifications/core';\n\n let notifications = $state<Notification[]>([\n /* your notifications */\n ]);\n let filter = $state<NotificationFilter>('all');\n let selectedIds = $state(new Set<string>());\n let dialogOpen = $state(false);\n let selectedNotification = $state<Notification | null>(null);\n\n const filteredNotifications = $derived.by(() => {\n switch (filter) {\n case 'unread':\n return notifications.filter((n) => !n.read);\n case 'read':\n return notifications.filter((n) => n.read);\n default:\n return notifications;\n }\n });\n\n const counts: NotificationCounts = $derived({\n all: notifications.length,\n unread: notifications.filter((n) => !n.read).length,\n read: notifications.filter((n) => n.read).length,\n });\n</script>\n\n<NotificationFilters bind:filter {counts} />\n\n<NotificationBulkActions\n selectedCount={selectedIds.size}\n totalCount={filteredNotifications.length}\n onSelectAll={(selected) => {\n /* ... */\n }}\n onMarkRead={() => {\n /* ... */\n }}\n onDelete={() => {\n /* ... */\n }}\n/>\n\n<NotificationList\n notifications={filteredNotifications}\n {selectedIds}\n selectable={true}\n onToggleSelect={handleToggleSelect}\n onNotificationClick={handleNotificationClick}\n/>\n\n<NotificationDialog notification={selectedNotification} bind:open={dialogOpen} />"
15179
15377
  },
15180
15378
  {
15181
15379
  title: "With Filter-Specific Empty States",
15182
15380
  code: `<NotificationList
15183
- notifications={filteredNotifications()}
15381
+ notifications={filteredNotifications}
15184
15382
  emptyTitle={filter === 'unread'
15185
15383
  ? 'No unread notifications'
15186
15384
  : filter === 'read'
@@ -15788,6 +15986,12 @@ var component_catalog_default = {
15788
15986
  required: false,
15789
15987
  description: "Custom HTML legend (e.g. `ChartLegend`) instead of the built-in one; React takes a function returning a node"
15790
15988
  },
15989
+ {
15990
+ name: "selected",
15991
+ type: "string | string[] | null",
15992
+ required: false,
15993
+ description: "Controlled selection: slices outside the named ones fade. Set it from `onClick` to cross-filter"
15994
+ },
15791
15995
  {
15792
15996
  name: "onClick",
15793
15997
  type: "(params: SliceEventParams) => void",
@@ -20297,6 +20501,7 @@ var component_catalog_default = {
20297
20501
  relatedComponents: [
20298
20502
  "StatGroup",
20299
20503
  "Sparkline",
20504
+ "DeltaText",
20300
20505
  "BulletChart"
20301
20506
  ]
20302
20507
  },
@@ -22523,7 +22728,7 @@ function registerComponentResources(server) {
22523
22728
 
22524
22729
  // src/data/token-definitions.json
22525
22730
  var token_definitions_default = {
22526
- version: "0.5.6",
22731
+ version: "0.5.8",
22527
22732
  colors: {
22528
22733
  brand: [
22529
22734
  {
@@ -23506,7 +23711,7 @@ function registerTokenResources(server) {
23506
23711
 
23507
23712
  // src/data/styles-catalog.json
23508
23713
  var styles_catalog_default = {
23509
- version: "0.5.6",
23714
+ version: "0.5.8",
23510
23715
  package: "@classic-homes/theme-styles",
23511
23716
  description: "Base CSS styles, accessibility features, and utility classes for the Classic Theme design system",
23512
23717
  integration: {
@@ -23889,7 +24094,7 @@ import { ResourceTemplate as ResourceTemplate2 } from "@modelcontextprotocol/sdk
23889
24094
 
23890
24095
  // src/data/pattern-library.json
23891
24096
  var pattern_library_default = {
23892
- version: "0.5.6",
24097
+ version: "0.5.8",
23893
24098
  layouts: [
23894
24099
  {
23895
24100
  id: "dashboard-page",
@@ -24983,7 +25188,7 @@ function registerLayoutResources(server) {
24983
25188
 
24984
25189
  // src/data/schema-catalog.json
24985
25190
  var schema_catalog_default = {
24986
- version: "0.5.6",
25191
+ version: "0.5.8",
24987
25192
  packageName: "@classic-homes/theme-svelte",
24988
25193
  importPath: "@classic-homes/theme-svelte",
24989
25194
  generatedFrom: "packages/svelte/src/lib/schemas/index.ts",
@@ -25791,7 +25996,7 @@ import { ResourceTemplate as ResourceTemplate3 } from "@modelcontextprotocol/sdk
25791
25996
 
25792
25997
  // src/data/auth-catalog.json
25793
25998
  var auth_catalog_default = {
25794
- version: "0.5.6",
25999
+ version: "0.5.8",
25795
26000
  packageName: "@classic-homes/auth",
25796
26001
  description: "Authentication services and Svelte bindings for Classic Theme apps",
25797
26002
  subpackages: {
@@ -26398,6 +26603,17 @@ var auth_catalog_default = {
26398
26603
  name: "isRoleDeniedError",
26399
26604
  signature: "(error: unknown) => error is RoleDeniedError",
26400
26605
  description: "Type guard to check if an error is a RoleDeniedError"
26606
+ },
26607
+ {
26608
+ name: "ApiError",
26609
+ signature: "class extends Error { status: number; code?: string; details?: Record<string, unknown>; method: string; endpoint: string }",
26610
+ description: "Thrown by apiRequest/api.* on any non-2xx response. message is the server's message (unchanged from the old plain Error); a CHAPI 403 carries details.required (and details.mode).",
26611
+ example: "import { api, isApiError } from '@classic-homes/auth/core';\n\ntry {\n await api.put('/homes/42', body, true);\n} catch (e) {\n if (isApiError(e) && e.status === 403) {\n console.log(e.details?.required); // ['homes:update']\n }\n}"
26612
+ },
26613
+ {
26614
+ name: "isApiError",
26615
+ signature: "(error: unknown) => error is ApiError",
26616
+ description: "Type guard for ApiError"
26401
26617
  }
26402
26618
  ],
26403
26619
  types: [
@@ -26527,6 +26743,122 @@ formatUserRoles(user, { lowercase: true }); // "admin, manager"`
26527
26743
  ]
26528
26744
  }
26529
26745
  ]
26746
+ },
26747
+ "access-probe": {
26748
+ description: "Inert hooks for permission troubleshooting tools (the Access Inspector). setAccessProbe receives every role/permission decision; setAccessSubject previews the UI as another role set for the signed-in user only. Browser-only; UI decisions only (the API still authorizes with the real token).",
26749
+ functions: [
26750
+ {
26751
+ name: "setAccessProbe",
26752
+ signature: "(probe: ((event: AccessCheckEvent) => void) | null) => AccessProbe | null",
26753
+ description: "Install the function that receives every decision: core hasRole*, store has*, checkAuth ('route'), filterByAccess/canAccess ('nav'), API 403s ('http', path only). One probe at a time; no-op on the server."
26754
+ },
26755
+ {
26756
+ name: "setAccessSubject",
26757
+ signature: "(userId: string, subject: { roles: string[]; permissions: string[] }) => void",
26758
+ description: "'View as': access checks for this user id use the given roles/permissions. Checks for other users, authStore.user and sign-in allowedRoles gating are unaffected. Cleared on any login/logout/expiry."
26759
+ },
26760
+ {
26761
+ name: "clearAccessSubject",
26762
+ signature: "() => void",
26763
+ description: "End the 'view as' preview"
26764
+ },
26765
+ {
26766
+ name: "effectiveSubject",
26767
+ signature: "(user) => { roles; permissions; simulated }",
26768
+ description: "Roles/permissions to decide access with: the override when it targets this user, else the user's own"
26769
+ },
26770
+ {
26771
+ name: "evaluateAccess",
26772
+ signature: "(subject: AccessSubject, requirement: AccessRequirement) => { allowed: boolean; missing: { roles: string[]; permissions: string[] } }",
26773
+ description: "Shared any/all decision used by checkAuth and the inspector. Roles and permissions must both pass; empty lists are no restriction; exact membership.",
26774
+ example: "import { evaluateAccess, effectiveSubject } from '@classic-homes/auth/core';\n\nevaluateAccess(effectiveSubject(user), { permissions: ['homes:update'] });"
26775
+ },
26776
+ {
26777
+ name: "requirementFromDenial",
26778
+ signature: "(code: string | undefined, details: unknown) => AccessRequirement | null",
26779
+ description: "Read what a CHAPI 403 required (requirePermissions: string[] + INSUFFICIENT_PERMISSIONS; requireRole: string + FORBIDDEN)"
26780
+ }
26781
+ ],
26782
+ types: [
26783
+ {
26784
+ name: "AccessRequirement",
26785
+ description: "What UI or a request requires",
26786
+ properties: [
26787
+ {
26788
+ name: "roles",
26789
+ type: "string[]",
26790
+ required: false,
26791
+ description: "Any one of these roles (all with requireAllRoles)"
26792
+ },
26793
+ {
26794
+ name: "permissions",
26795
+ type: "string[]",
26796
+ required: false,
26797
+ description: "Any one of these permissions (all with requireAllPermissions)"
26798
+ },
26799
+ {
26800
+ name: "requireAllRoles",
26801
+ type: "boolean",
26802
+ required: false,
26803
+ description: "Require every listed role"
26804
+ },
26805
+ {
26806
+ name: "requireAllPermissions",
26807
+ type: "boolean",
26808
+ required: false,
26809
+ description: "Require every listed permission"
26810
+ }
26811
+ ]
26812
+ },
26813
+ {
26814
+ name: "AccessCheckEvent",
26815
+ description: "One reported decision",
26816
+ properties: [
26817
+ {
26818
+ name: "source",
26819
+ type: "'check' | 'route' | 'nav' | 'http' | 'element'",
26820
+ required: true,
26821
+ description: "Where the decision came from"
26822
+ },
26823
+ {
26824
+ name: "requirement",
26825
+ type: "AccessRequirement",
26826
+ required: true,
26827
+ description: "What was required"
26828
+ },
26829
+ {
26830
+ name: "allowed",
26831
+ type: "boolean",
26832
+ required: true,
26833
+ description: "Outcome"
26834
+ },
26835
+ {
26836
+ name: "missing",
26837
+ type: "{ roles: string[]; permissions: string[] }",
26838
+ required: true,
26839
+ description: "What the subject lacked"
26840
+ },
26841
+ {
26842
+ name: "subjectId",
26843
+ type: "string | null",
26844
+ required: true,
26845
+ description: "User checked (checks also run for other users)"
26846
+ },
26847
+ {
26848
+ name: "simulated",
26849
+ type: "boolean",
26850
+ required: true,
26851
+ description: "Decided against the 'view as' subject"
26852
+ },
26853
+ {
26854
+ name: "label",
26855
+ type: "string",
26856
+ required: false,
26857
+ description: "Nav item id/href, route path or 'METHOD /path'"
26858
+ }
26859
+ ]
26860
+ }
26861
+ ]
26530
26862
  }
26531
26863
  },
26532
26864
  types: [
@@ -28815,6 +29147,22 @@ function registerAuthResources(server) {
28815
29147
  code: "import { authService, RoleDeniedError } from '@classic-homes/auth/core';\n\ntry {\n await authService.login(credentials, { allowedRoles: ['admin', 'agent'] });\n} catch (e) {\n if (e instanceof RoleDeniedError) {\n // User authenticated but lacks role\n }\n}",
28816
29148
  description: "Validate roles during login and handle access denial"
28817
29149
  },
29150
+ accessInspector: {
29151
+ code: `<!-- +layout.svelte (once). Admins: Ctrl+Shift+A or ?access-inspector=1 -->
29152
+ <script>
29153
+ import { AccessInspector, RequireAccess, requires } from '@classic-homes/access-inspector-svelte';
29154
+ </script>
29155
+
29156
+ <AccessInspector />
29157
+
29158
+ <RequireAccess permissions={['reports:read']} label="Reports">
29159
+ <ReportsCard />
29160
+ {#snippet fallback()}<p>No access</p>{/snippet}
29161
+ </RequireAccess>
29162
+
29163
+ <button use:requires={{ permissions: ['homes:update'] }}>Edit</button>`,
29164
+ description: "Admin permission troubleshooting: outlines gated UI, lists denials incl. API 403s with the roles that grant each permission (CHAPI /auth/access-catalog), and previews as another role. Import @classic-homes/access-inspector-core/styles.css once."
29165
+ },
28818
29166
  testing: {
28819
29167
  code: "import { setupTestAuth, mockUser, assertAuthenticated } from '@classic-homes/auth/testing';\n\nconst ctx = setupTestAuth();\n// Run tests\nctx.cleanup();",
28820
29168
  description: "Set up mocks for testing auth flows"
@@ -28833,7 +29181,7 @@ import { ResourceTemplate as ResourceTemplate4 } from "@modelcontextprotocol/sdk
28833
29181
 
28834
29182
  // src/data/notifications-catalog.json
28835
29183
  var notifications_catalog_default = {
28836
- version: "0.5.6",
29184
+ version: "0.5.8",
28837
29185
  packageName: "@classic-homes/notifications",
28838
29186
  description: "Notification services and Svelte bindings for Classic Theme apps",
28839
29187
  subpackages: {
@@ -29745,7 +30093,7 @@ function registerNotificationsResources(server) {
29745
30093
 
29746
30094
  // src/data/docs-catalog.json
29747
30095
  var docs_catalog_default = {
29748
- version: "0.5.6",
30096
+ version: "0.5.8",
29749
30097
  packageName: "@classic-homes/theme-docs",
29750
30098
  description: "Markdown documentation components for the Classic theme system",
29751
30099
  exports: {
@@ -31423,7 +31771,7 @@ function registerDocsResources(server) {
31423
31771
 
31424
31772
  // src/data/charts-catalog.json
31425
31773
  var charts_catalog_default = {
31426
- version: "0.5.6",
31774
+ version: "0.5.8",
31427
31775
  packageName: "@classic-homes/charts-core",
31428
31776
  description: "Core utilities, types, and themes for Classic Theme chart components",
31429
31777
  subpackages: {
@@ -31511,7 +31859,7 @@ var charts_catalog_default = {
31511
31859
  {
31512
31860
  name: "getReplaceMerge",
31513
31861
  signature: "(prev: object | null | undefined, next: object, isComponentType: (mainType: string) => boolean) => string[]",
31514
- description: "replaceMerge list for setOption when a complete option supersedes the previous one: always series and graphic, plus component types that were removed or shrank. Pass echarts.ComponentModel.hasClass as isComponentType. Keeps legend selection and dataZoom state, unlike notMerge"
31862
+ description: "replaceMerge list for setOption when a complete option supersedes the previous one: graphic, series unless every series keeps its keys and type (so a data refresh merges and does not replay the entry animation), plus component types that were removed or shrank. Pass echarts.ComponentModel.hasClass as isComponentType. Keeps legend selection and dataZoom state, unlike notMerge"
31515
31863
  },
31516
31864
  {
31517
31865
  name: "resolveValueFormatter",
@@ -32013,7 +32361,7 @@ var charts_catalog_default = {
32013
32361
  name: "data",
32014
32362
  type: "LineChartData",
32015
32363
  required: true,
32016
- description: "Chart data with categories and series"
32364
+ description: "Chart data with categories and series. A series' forecastFrom (index) draws that point onward as a forecast: dashed line with hollow points, or faded dashed-outline bars, tagged with forecastLabel (default 'Forecast') in the tooltip. A series' variant: 'ghost' draws it as a faded reference (e.g. the prior period): dashed, faded line with no points, fill or labels"
32017
32365
  },
32018
32366
  {
32019
32367
  name: "smooth",
@@ -32081,6 +32429,12 @@ var charts_catalog_default = {
32081
32429
  required: false,
32082
32430
  description: "Show data labels (default false)"
32083
32431
  },
32432
+ {
32433
+ name: "selected",
32434
+ type: "string | string[] | null",
32435
+ required: false,
32436
+ description: "Controlled selection: the named categories stand out (other bars fade; line/area points there are enlarged and ringed) and the accessible description names them. The chart never changes it itself \u2014 set it from onClick to cross-filter"
32437
+ },
32084
32438
  {
32085
32439
  name: "onClick",
32086
32440
  type: "(params: DataPointEventParams) => void",
@@ -32127,7 +32481,7 @@ var charts_catalog_default = {
32127
32481
  name: "data",
32128
32482
  type: "BarChartData",
32129
32483
  required: true,
32130
- description: "Chart data with categories and series"
32484
+ description: "Chart data with categories and series. A series' forecastFrom (index) draws that point onward as a forecast: dashed line with hollow points, or faded dashed-outline bars, tagged with forecastLabel (default 'Forecast') in the tooltip. A series' variant: 'ghost' draws it as a faded reference (e.g. the prior period): faded bars beside the solid ones (own parallel stack), no value labels, left out of showTotal totals"
32131
32485
  },
32132
32486
  {
32133
32487
  name: "orientation",
@@ -32189,6 +32543,12 @@ var charts_catalog_default = {
32189
32543
  required: false,
32190
32544
  description: "Vertical axis customisation (name, formatter, rotate, min, max, interval, show)"
32191
32545
  },
32546
+ {
32547
+ name: "selected",
32548
+ type: "string | string[] | null",
32549
+ required: false,
32550
+ description: "Controlled selection: the named categories stand out (other bars fade; line/area points there are enlarged and ringed) and the accessible description names them. The chart never changes it itself \u2014 set it from onClick to cross-filter"
32551
+ },
32192
32552
  {
32193
32553
  name: "onClick",
32194
32554
  type: "(params: DataPointEventParams) => void",
@@ -32279,6 +32639,12 @@ var charts_catalog_default = {
32279
32639
  required: false,
32280
32640
  description: "Data label text: an ECharts template or a function (params include per-point `label`)"
32281
32641
  },
32642
+ {
32643
+ name: "selected",
32644
+ type: "string | string[] | null",
32645
+ required: false,
32646
+ description: "Controlled selection: the named slices stand out (others fade) and the accessible description names them. The chart never changes it itself \u2014 set it from onClick to cross-filter"
32647
+ },
32282
32648
  {
32283
32649
  name: "onClick",
32284
32650
  type: "(params: SliceEventParams) => void",
@@ -32308,6 +32674,12 @@ var charts_catalog_default = {
32308
32674
  type: "string | number",
32309
32675
  required: false,
32310
32676
  description: "Center value text"
32677
+ },
32678
+ {
32679
+ name: "selected",
32680
+ type: "string | string[] | null",
32681
+ required: false,
32682
+ description: "Controlled selection: the named slices stand out (others fade) and the accessible description names them. The chart never changes it itself \u2014 set it from onClick to cross-filter"
32311
32683
  }
32312
32684
  ]
32313
32685
  },
@@ -32319,7 +32691,7 @@ var charts_catalog_default = {
32319
32691
  name: "data",
32320
32692
  type: "AreaChartData",
32321
32693
  required: true,
32322
- description: "Chart data with categories and series"
32694
+ description: "Chart data with categories and series. A series' forecastFrom (index) draws that point onward as a forecast (dashed line, faded area, hollow points), tagged with forecastLabel (default 'Forecast') in the tooltip. A series' variant: 'ghost' draws it as a faded reference (e.g. the prior period): dashed, faded line with no fill, points or labels"
32323
32695
  },
32324
32696
  {
32325
32697
  name: "smooth",
@@ -32381,6 +32753,18 @@ var charts_catalog_default = {
32381
32753
  required: false,
32382
32754
  description: "Show data labels (default false)"
32383
32755
  },
32756
+ {
32757
+ name: "selected",
32758
+ type: "string | string[] | null",
32759
+ required: false,
32760
+ description: "Controlled selection: the named categories stand out (other bars fade; line/area points there are enlarged and ringed) and the accessible description names them. The chart never changes it itself \u2014 set it from onClick to cross-filter"
32761
+ },
32762
+ {
32763
+ name: "showDataPoints",
32764
+ type: "boolean",
32765
+ required: false,
32766
+ description: "Show data points on the area's line (needed for clicks on a point)"
32767
+ },
32384
32768
  {
32385
32769
  name: "onClick",
32386
32770
  type: "(params: DataPointEventParams) => void",
@@ -33604,6 +33988,60 @@ var charts_catalog_default = {
33604
33988
  }
33605
33989
  ]
33606
33990
  },
33991
+ {
33992
+ name: "DeltaTextProps",
33993
+ description: "Inline change between two values: coloured \u25B2/\u25BC, the change and a 'vs previous' label (Svelte only; React pending)",
33994
+ properties: [
33995
+ {
33996
+ name: "current",
33997
+ type: "number | null | undefined",
33998
+ required: true,
33999
+ description: "The current value"
34000
+ },
34001
+ {
34002
+ name: "previous",
34003
+ type: "number | null | undefined",
34004
+ required: true,
34005
+ description: "The value compared against"
34006
+ },
34007
+ {
34008
+ name: "display",
34009
+ type: "'percent' | 'absolute' | 'both'",
34010
+ required: false,
34011
+ description: "How the change is shown (default 'percent'; a change from zero falls back to absolute)"
34012
+ },
34013
+ {
34014
+ name: "goodWhen",
34015
+ type: "'up' | 'down' | 'none'",
34016
+ required: false,
34017
+ description: "Which direction is good, for colouring (default 'up'); 'none' stays neutral"
34018
+ },
34019
+ {
34020
+ name: "valueFormat",
34021
+ type: "ValueFormat",
34022
+ required: false,
34023
+ description: "How the absolute change and previous value are written"
34024
+ },
34025
+ {
34026
+ name: "locale",
34027
+ type: "string",
34028
+ required: false,
34029
+ description: "Locale for valueFormat and the percentage (default 'en-US')"
34030
+ },
34031
+ {
34032
+ name: "label",
34033
+ type: "string",
34034
+ required: false,
34035
+ description: "Text after the change (default 'vs <previous>'; '' hides it)"
34036
+ },
34037
+ {
34038
+ name: "class",
34039
+ type: "string",
34040
+ required: false,
34041
+ description: "Custom CSS class"
34042
+ }
34043
+ ]
34044
+ },
33607
34045
  {
33608
34046
  name: "StatCardProps",
33609
34047
  description: "Stat card: a headline metric with its change and trend (Svelte only; React pending)",
@@ -35169,6 +35607,12 @@ var charts_catalog_default = {
35169
35607
  data: "value + StatDelta",
35170
35608
  summary: "KPI value with delta, trend sparkline, definition and tone"
35171
35609
  },
35610
+ {
35611
+ name: "DeltaText",
35612
+ props: "DeltaTextProps",
35613
+ data: "current + previous",
35614
+ summary: "Inline coloured \u25B2/\u25BC change vs a previous value (StatCard's change line, for KPI rows and table cells)"
35615
+ },
35172
35616
  {
35173
35617
  name: "StatGroup",
35174
35618
  props: "StatGroupProps",
@@ -35373,7 +35817,7 @@ ${catalog4.quickReference.typesSubpath}
35373
35817
 
35374
35818
  **Svelte and React (13):** AreaChart, BarChart, LineChart, PieChart, DonutChart, CandlestickChart, FunnelChart, GaugeChart, HeatmapChart, RadarChart, SankeyChart, ScatterChart, TreemapChart
35375
35819
 
35376
- **Report charts and stats (Svelte only, React pending):** ComboChart, DotPlotChart, BulletChart, HistogramChart, BoxPlotChart, WaterfallChart, Sparkline, StatCard, StatGroup (plus the ChartDataTable base component). See \`charts://reporting\`.
35820
+ **Report charts and stats (Svelte only, React pending):** ComboChart, DotPlotChart, BulletChart, HistogramChart, BoxPlotChart, WaterfallChart, Sparkline, StatCard, DeltaText, StatGroup (plus the ChartDataTable base component). See \`charts://reporting\`.
35377
35821
 
35378
35822
  \`\`\`typescript
35379
35823
  ${catalog4.quickReference.reportingUsage ?? ""}
@@ -35410,7 +35854,7 @@ ${catalog4.quickReference.reportingUsage ?? ""}
35410
35854
  - \`abbreviateNumber(value, decimals?)\` - Abbreviate to K/M/B/T
35411
35855
  - \`createTooltipFormatter(options?)\` - Create ECharts tooltip formatter
35412
35856
  - \`escapeHtml(value)\` - Escape user data in custom tooltip formatters
35413
- - \`getReplaceMerge(prev, next, isComponentType)\` - setOption replaceMerge list that drops removed series/components but keeps legend and dataZoom state
35857
+ - \`getReplaceMerge(prev, next, isComponentType)\` - setOption replaceMerge list that drops removed series/components but keeps legend and dataZoom state; same-shape series merge so data refreshes do not replay the entry animation
35414
35858
  - \`resolveValueFormatter(valueFormat, locale?)\` - Turn a valueFormat prop into a \`(value) => string\` function
35415
35859
  - \`formatValue(value, formatter?, empty?)\` - Format a possibly-missing value
35416
35860
 
@@ -35457,6 +35901,9 @@ interface LineChartData {
35457
35901
  color?: string;
35458
35902
  labels?: (string | null)[];
35459
35903
  stack?: string; // stack group id
35904
+ forecastFrom?: number; // index of first forecast point: dashed line / faded bars, tagged in tooltip (Line, Area, Bar)
35905
+ forecastLabel?: string; // tooltip tag, default 'Forecast' (e.g. 'Partial month')
35906
+ variant?: 'ghost'; // faded reference (e.g. prior period): dashed faded line / faded bars beside the solid ones; no labels, not in totals (Line, Area, Bar, Combo)
35460
35907
  }[];
35461
35908
  }
35462
35909
  // ComboChart series add type?: 'bar' | 'line' | 'area' and axis?: 'primary' | 'secondary'
@@ -35470,6 +35917,7 @@ interface HistogramBin { start?: number; end?: number; label?: string } // Histo
35470
35917
  interface BoxPlotGroup { name: string; values: number[] }
35471
35918
  interface WaterfallStep { name: string; value: number; isTotal?: boolean | 'value'; color?: string; label?: string }
35472
35919
  interface StatDelta { previous: number | null | undefined; current?: number | null; display?: 'percent' | 'absolute' | 'both'; goodWhen?: 'up' | 'down' | 'none'; label?: string }
35920
+ interface DeltaTextProps { current: number | null | undefined; previous: number | null | undefined; display?; goodWhen?; valueFormat?: ValueFormat; locale?: string; label?: string; class?: string } // <DeltaText>: StatCard's change line, inline
35473
35921
  \`\`\`
35474
35922
 
35475
35923
  **Slices (Pie, Donut, Funnel):**
@@ -35561,7 +36009,7 @@ interface SankeyData {
35561
36009
 
35562
36010
  // src/data/gantt-catalog.json
35563
36011
  var gantt_catalog_default = {
35564
- version: "0.5.6",
36012
+ version: "0.5.8",
35565
36013
  packageName: "@classic-homes/gantt-core",
35566
36014
  description: "Framework-agnostic Gantt engine: working calendars, a critical-path scheduler, an editable project model with undo/redo, timeline geometry, drag math, accessible descriptions and import/export. No DOM, no framework, no runtime dependencies. @classic-homes/gantt-svelte renders it; a React package (@classic-homes/gantt-react) is planned.",
35567
36015
  packages: {
@@ -36544,7 +36992,7 @@ function registerGanttResources(server) {
36544
36992
 
36545
36993
  // src/data/maps-catalog.json
36546
36994
  var maps_catalog_default = {
36547
- version: "0.5.6",
36995
+ version: "0.5.8",
36548
36996
  packageName: "@classic-homes/maps-core",
36549
36997
  description: "Core utilities, types, and themes for Classic Theme MapLibre GL components",
36550
36998
  subpackages: {
@@ -37187,12 +37635,12 @@ var maps_catalog_default = {
37187
37635
  ]
37188
37636
  },
37189
37637
  fingerprint: {
37190
- description: "Fast O(1) GeoJSON equality checking via fingerprinting",
37638
+ description: "GeoJSON change detection: count, first/last id and a content hash of every feature",
37191
37639
  functions: [
37192
37640
  {
37193
37641
  name: "createGeoJSONFingerprint",
37194
37642
  signature: "(data: GeoJSONFeatureCollection | GeoJSON.GeoJSON | string | null | undefined) => GeoJSONFingerprint",
37195
- description: "Create a lightweight fingerprint for fast equality comparison without deep comparison"
37643
+ description: "Fingerprint a FeatureCollection (count, first/last id, hash of every id, geometry and properties) in one pass"
37196
37644
  },
37197
37645
  {
37198
37646
  name: "fingerprintEqual",
@@ -39468,7 +39916,7 @@ var maps_catalog_default = {
39468
39916
  },
39469
39917
  {
39470
39918
  name: "GeoJSONFingerprint",
39471
- description: "Lightweight fingerprint for fast GeoJSON equality checking",
39919
+ description: "Fingerprint for GeoJSON change detection: count, first/last id and a content hash",
39472
39920
  properties: [
39473
39921
  {
39474
39922
  name: "count",
@@ -39487,6 +39935,12 @@ var maps_catalog_default = {
39487
39935
  type: "string | number | undefined",
39488
39936
  required: true,
39489
39937
  description: "ID of the last feature (undefined if no features or no ID)"
39938
+ },
39939
+ {
39940
+ name: "hash",
39941
+ type: "number",
39942
+ required: true,
39943
+ description: "Hash of every feature's id, geometry and properties (0 for no features)"
39490
39944
  }
39491
39945
  ]
39492
39946
  },
@@ -42170,7 +42624,7 @@ ${catalog6.quickReference.tailwindConfig}
42170
42624
 
42171
42625
  // src/data/native-catalog.json
42172
42626
  var native_catalog_default = {
42173
- version: "0.5.6",
42627
+ version: "0.5.8",
42174
42628
  packageName: "@classic-homes/native",
42175
42629
  description: "Native device APIs for iOS and Android mobile apps. Uses Capacitor for native functionality with web fallbacks.",
42176
42630
  subpackages: {
@@ -43880,7 +44334,7 @@ import { NativeGuard, usePlatformCheck } from '@classic-homes/native/react';
43880
44334
 
43881
44335
  // src/data/viewer-catalog.json
43882
44336
  var viewer_catalog_default = {
43883
- version: "0.5.6",
44337
+ version: "0.5.8",
43884
44338
  packageName: "@classic-homes/viewer-svelte",
43885
44339
  description: "Client-side, view-only document viewers: PDF, Word (.docx), Excel (.xlsx), CSV/TSV and CAD (DXF; DWG through the separate GPL package). Files are parsed and rendered in the browser; nothing is uploaded or converted on a server. Each format is a lazy-loaded subpath with an optional peer dependency, so apps only bundle what they register. Svelte 5 only; a React package (viewer-react) is planned.",
43886
44340
  packages: {
@@ -44939,7 +45393,7 @@ function registerPrompts(server) {
44939
45393
  // package.json
44940
45394
  var package_default = {
44941
45395
  name: "@classic-homes/theme-mcp",
44942
- version: "0.5.6",
45396
+ version: "0.5.8",
44943
45397
  description: "MCP server for Classic Theme design system - enables AI assistants to understand and correctly use components, tokens, and patterns",
44944
45398
  type: "module",
44945
45399
  main: "dist/index.js",
@@ -45038,4 +45492,4 @@ function createServer() {
45038
45492
  export {
45039
45493
  createServer
45040
45494
  };
45041
- //# sourceMappingURL=chunk-2X53FIOJ.js.map
45495
+ //# sourceMappingURL=chunk-T45XY5RI.js.map