react-semaphor 0.1.568 → 0.1.570

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.
Files changed (191) hide show
  1. package/README.md +0 -7
  2. package/dist/analytics-protocol/index.js +434 -454
  3. package/dist/appearance/index.js +6 -3
  4. package/dist/appearance-runtime/index.js +1 -1
  5. package/dist/assistant-context/index.js +1 -1
  6. package/dist/brand-studio/index.js +572 -436
  7. package/dist/briefings/index.js +4 -4
  8. package/dist/chunks/appearance-context-BwBp25ZG.js +162 -0
  9. package/dist/chunks/appearance-runtime-provider-BRHYELkC.js +80 -0
  10. package/dist/chunks/assistant-chat-B-Ddyy8b.js +5940 -0
  11. package/dist/chunks/{bookmark-impact-CJ-65omV.js → bookmark-impact-DCYD-6Fr.js} +2 -2
  12. package/dist/chunks/{bookmark-state-Du3s13_V.js → bookmark-state-CflS88gq.js} +251 -250
  13. package/dist/chunks/brand-B4BdpAB_.js +54 -0
  14. package/dist/chunks/{card-filter-builder-BBuB99GZ.js → card-filter-builder-0VvKmRst.js} +992 -991
  15. package/dist/chunks/{comparison-window-caption-CMLb3mut.js → comparison-window-caption-PtcDWvkN.js} +252 -253
  16. package/dist/chunks/{dashboard-YnWZC4dK.js → dashboard-DxGIr1vZ.js} +1 -1
  17. package/dist/chunks/{dashboard-briefing-launcher-BF89TU2h.js → dashboard-briefing-launcher-B-quOOOQ.js} +253 -253
  18. package/dist/chunks/{dashboard-controls-atHc1EjP.js → dashboard-controls-Caodx80b.js} +288 -285
  19. package/dist/chunks/dashboard-json-Ct-AGDHF.js +66 -0
  20. package/dist/chunks/{dates-CKO05ino.js → dates-B9mL8BHE.js} +16 -15
  21. package/dist/chunks/edit-Bpdh_P_a.js +226 -0
  22. package/dist/chunks/{edit-dashboard-visual-DdmTfn-J.js → edit-dashboard-visual-DeDTuYB5.js} +2257 -2270
  23. package/dist/chunks/{filter-reach-copy-jZGzK_IH.js → filter-reach-copy-BSY33ro5.js} +1440 -1301
  24. package/dist/chunks/filter-value-text-DvvSNlho.js +146 -0
  25. package/dist/chunks/index-BVKzKl5d.js +90 -0
  26. package/dist/chunks/{index-RNaTnE3m.js → index-CV_Kzou0.js} +233 -223
  27. package/dist/chunks/{index-CPNZW0mu.js → index-y3HUzRNk.js} +76 -77
  28. package/dist/chunks/{layout-grid-0hIlqEtk.js → layout-grid-8rR-LPTk.js} +1 -1
  29. package/dist/chunks/{list-filter-DkgoCeBm.js → list-filter-C1-uTgjR.js} +1 -1
  30. package/dist/chunks/matrix-analytical-definition-dkS8szLM.js +1253 -0
  31. package/dist/chunks/matrix-member-presentation-DRa-9e6Q.js +169 -0
  32. package/dist/chunks/{matrix-operation-contract-Eb6elidS.js → matrix-operation-contract-DCVinw1o.js} +122 -122
  33. package/dist/chunks/{metric-comparison-ChXUFaZu.js → metric-comparison-n9NsIa-2.js} +175 -128
  34. package/dist/chunks/paintbrush-aR17Z3C9.js +27 -0
  35. package/dist/chunks/{palette-4vf2BEEg.js → palette-a5FCZKFI.js} +1 -1
  36. package/dist/chunks/{_commonjsHelpers-DimLPMtv.js → pickers-DkqmtnTL.js} +352 -290
  37. package/dist/chunks/pivot-result-contract-expectations-C-HnUKYe.js +55 -0
  38. package/dist/chunks/{pivot-result-identity-BlbLrqaC.js → pivot-result-identity-B89X5xjb.js} +1 -1
  39. package/dist/chunks/raw-temporal-value-DdT0s47W.js +159 -0
  40. package/dist/chunks/{report-preferences-dialog-Mbd-I0wV.js → report-preferences-dialog-Yvhv3WX2.js} +95 -97
  41. package/dist/chunks/{report-runtime-context-DnA_PiKo.js → report-runtime-context-BhPzLTbS.js} +1 -1
  42. package/dist/chunks/{resolve-dashboard-input-context-Du0fjN3h.js → resolve-dashboard-input-context-Lkbwycwe.js} +5491 -5683
  43. package/dist/chunks/resolver-DG_tfEpt.js +156 -0
  44. package/dist/chunks/{save-D6pHmSSP.js → save-D985VvYp.js} +1 -1
  45. package/dist/chunks/{saved-dashboard-context-y8N6RvjS.js → saved-dashboard-context-DC_TEd6y.js} +6 -6
  46. package/dist/chunks/schema-C9NPiIru.js +2568 -0
  47. package/dist/chunks/{semaphor-ready-indicator-BSEdUq40.js → semaphor-ready-indicator-ByFvqHEO.js} +35916 -36001
  48. package/dist/chunks/{shelf-drop-preview-context-D7QqPl36.js → shelf-drop-preview-context-CjoVaK6J.js} +64 -66
  49. package/dist/chunks/{stored-dashboard-d3xQYxBD.js → stored-dashboard-C0hekXiI.js} +332 -333
  50. package/dist/chunks/{code-editor-DJNOsgJH.js → style-sheet-parts-C7qGZuH1.js} +2402 -2040
  51. package/dist/chunks/{table-export-sheet--DUKWk6o.js → table-export-sheet-CP8zSOhj.js} +1 -1
  52. package/dist/chunks/{temporal-input-presentation--2r9BLr0.js → temporal-input-presentation-CqbJjIuu.js} +18 -18
  53. package/dist/chunks/{token-types-C8JymO8s.js → token-types-iKMplaBL.js} +1 -1
  54. package/dist/chunks/{upload-Cf3wXZT8.js → upload-CiGNKJ_0.js} +1 -1
  55. package/dist/chunks/validators-B8fpdinG.js +3651 -0
  56. package/dist/chunks/{variable-draft-DOX03R4A.js → variable-draft-9-huI1h4.js} +4 -4
  57. package/dist/dashboard/index.js +2 -2
  58. package/dist/dashboard-authoring/index.js +1888 -1826
  59. package/dist/format-utils/index.js +230 -231
  60. package/dist/index.js +349 -353
  61. package/dist/layouts/index.js +1 -1
  62. package/dist/report-runtime-context/index.js +1 -1
  63. package/dist/style.css +1 -1
  64. package/dist/surfboard/index.js +2 -2
  65. package/dist/types/appearance/index.d.ts +1 -0
  66. package/dist/types/brand-studio/brand-studio-draft.d.ts +7 -0
  67. package/dist/types/brand-studio/index.d.ts +1 -1
  68. package/dist/types/components/briefings/briefing-author/run-model.d.ts +1 -2
  69. package/dist/types/components/providers/appearance-runtime-provider.d.ts +4 -1
  70. package/dist/types/components/sharing-and-management/hooks/use-resource-management.d.ts +0 -2
  71. package/dist/types/components/sharing-and-management/utils/types.d.ts +0 -72
  72. package/dist/types/components/surfboard/filter/types.d.ts +5 -4
  73. package/dist/types/components/ui-custom/date-range-presets.d.ts +1 -17
  74. package/dist/types/components/visual/data-table/hooks/use-data-table-logic.d.ts +0 -1
  75. package/dist/types/components/visual/data-table/types/data-table.d.ts +0 -9
  76. package/dist/types/components/visual/data-table/utils/pagination-utils.d.ts +0 -19
  77. package/dist/types/components/visual/shared/utils/table-column-order.d.ts +0 -1
  78. package/dist/types/index.js +9 -9
  79. package/dist/types/lib/appearance/aliases.d.ts +42 -0
  80. package/dist/types/lib/appearance/compiler.d.ts +6 -0
  81. package/dist/types/lib/appearance/defaults.d.ts +6 -0
  82. package/dist/types/lib/appearance/index.d.ts +2 -0
  83. package/dist/types/lib/appearance/normalize-organization.d.ts +17 -0
  84. package/dist/types/lib/appearance/resolver.d.ts +2 -2
  85. package/dist/types/lib/appearance/types.d.ts +38 -1
  86. package/dist/types/lib/charts/types.d.ts +6 -2
  87. package/dist/types/lib/dashboard/semantic-dataset-references.d.ts +0 -1
  88. package/dist/types/lib/dashboard-inputs/dashboard-input-values.d.ts +0 -2
  89. package/dist/types/lib/dashboard-variables/types.d.ts +1 -6
  90. package/dist/types/lib/download-pdf.d.ts +0 -1
  91. package/dist/types/lib/hooks/use-dashboard.d.ts +3 -4
  92. package/dist/types/lib/hooks/use-date-filter.d.ts +3 -3
  93. package/dist/types/lib/matrix-table/matrix-card-adapter.d.ts +1 -1
  94. package/dist/types/lib/stores/dashboard-store.d.ts +15 -6
  95. package/dist/types/lib/stores/editor-store.d.ts +0 -1
  96. package/dist/types/lib/stores/table-actions.d.ts +0 -1
  97. package/dist/types/lib/table-formatting/table-formatting-css.d.ts +0 -5
  98. package/dist/types/lib/types/common-types.d.ts +3 -2
  99. package/dist/types/lib/types/explorer-types.d.ts +2 -2
  100. package/dist/types/lib/types/index.d.ts +1 -1
  101. package/dist/types/lib/types/summary-types.d.ts +0 -5
  102. package/dist/types/lib/utils/card-definition.d.ts +7 -7
  103. package/dist/types/shared/analytics-protocol/agent-time-window.d.ts +84 -0
  104. package/dist/types/shared/analytics-protocol/analytics-base-schemas.d.ts +4 -4
  105. package/dist/types/shared/analytics-protocol/applied-constraints.d.ts +2 -2
  106. package/dist/types/shared/analytics-protocol/contracts.d.ts +8 -17
  107. package/dist/types/shared/analytics-protocol/execution-input-schemas.d.ts +10 -10
  108. package/dist/types/shared/analytics-protocol/fixtures.d.ts +3 -2
  109. package/dist/types/shared/analytics-protocol/index.d.ts +2 -4
  110. package/dist/types/shared/analytics-protocol/matrix-definition-contract.d.ts +72 -72
  111. package/dist/types/shared/analytics-protocol/relative-date/describe.d.ts +18 -0
  112. package/dist/types/shared/analytics-protocol/relative-date/index.d.ts +7 -0
  113. package/dist/types/shared/analytics-protocol/relative-date/limits.d.ts +3 -0
  114. package/dist/types/shared/analytics-protocol/relative-date/presets.d.ts +11 -0
  115. package/dist/types/shared/analytics-protocol/relative-date/resolve.d.ts +49 -0
  116. package/dist/types/shared/analytics-protocol/relative-date/schemas.d.ts +76 -0
  117. package/dist/types/shared/analytics-protocol/relative-date/traits.d.ts +51 -0
  118. package/dist/types/shared/analytics-protocol/relative-date/window.d.ts +111 -0
  119. package/dist/types/shared/analytics-protocol/selection-contract.d.ts +1 -1
  120. package/dist/types/shared/assistant-protocol/context.d.ts +30 -30
  121. package/dist/types/shared/dashboard-authoring/changes/card-query-part.d.ts +0 -2
  122. package/dist/types/shared/dashboard-authoring/changes/dashboard-change.d.ts +344 -1772
  123. package/dist/types/shared/dashboard-authoring/changes/diagnostics.d.ts +4 -1
  124. package/dist/types/shared/dashboard-authoring/changes/read-card-query.d.ts +8 -4
  125. package/dist/types/shared/dashboard-authoring/changes/resolve-dashboard-changes.d.ts +9 -0
  126. package/dist/types/shared/dashboard-authoring/conditional-formatting/schema.d.ts +104 -104
  127. package/dist/types/shared/dashboard-authoring/control-execution-contract.d.ts +20 -20
  128. package/dist/types/shared/dashboard-authoring/dashboard-style/bounds.d.ts +17 -0
  129. package/dist/types/shared/dashboard-authoring/dashboard-style/brand.d.ts +20 -0
  130. package/dist/types/shared/dashboard-authoring/dashboard-style/edit-words.d.ts +7 -0
  131. package/dist/types/shared/dashboard-authoring/dashboard-style/edit.d.ts +19 -0
  132. package/dist/types/shared/dashboard-authoring/dashboard-style/index.d.ts +15 -0
  133. package/dist/types/shared/dashboard-authoring/dashboard-style/layers.d.ts +19 -0
  134. package/dist/types/shared/dashboard-authoring/dashboard-style/legacy.d.ts +21 -0
  135. package/dist/types/shared/dashboard-authoring/dashboard-style/parse.d.ts +18 -0
  136. package/dist/types/shared/dashboard-authoring/dashboard-style/pickers.d.ts +12 -0
  137. package/dist/types/shared/dashboard-authoring/dashboard-style/types.d.ts +122 -0
  138. package/dist/types/shared/dashboard-authoring/dashboard-style/view.d.ts +10 -0
  139. package/dist/types/shared/dashboard-authoring/index.d.ts +1 -0
  140. package/dist/types/shared/dashboard-authoring/operations/operation-types.d.ts +11 -0
  141. package/dist/types/shared/dashboard-authoring/outline/outline-dashboard.d.ts +23 -0
  142. package/dist/types/shared/dashboard-authoring/outline/outline-filters.d.ts +10 -2
  143. package/dist/types/shared/format-utils/filter-detail.d.ts +2 -8
  144. package/dist/types/shared/format-utils/filter-line.d.ts +2 -2
  145. package/dist/types/shared/format-utils/matrix-continuation.d.ts +10 -10
  146. package/dist/types/shared/temporal/index.d.ts +0 -2
  147. package/dist/types/shared/temporal/temporal-parity-fixtures.d.ts +2 -2
  148. package/package.json +7 -26
  149. package/DATA_APP_SDK.md +0 -339
  150. package/dist/chunks/appearance-context-DEYtWinQ.js +0 -126
  151. package/dist/chunks/appearance-runtime-provider-B-M8gwlZ.js +0 -81
  152. package/dist/chunks/assistant-chat-BN5I8KuN.js +0 -8849
  153. package/dist/chunks/color-CJvdlFM_.js +0 -2162
  154. package/dist/chunks/dashboard-json-Cxp3inxd.js +0 -68
  155. package/dist/chunks/filter-value-text-7zhmth1S.js +0 -163
  156. package/dist/chunks/index-CLIro-EG.js +0 -425
  157. package/dist/chunks/index-CuHybtft.js +0 -51
  158. package/dist/chunks/matrix-analytical-definition-C9xB_T84.js +0 -717
  159. package/dist/chunks/matrix-card-BSUeSXpD.js +0 -42
  160. package/dist/chunks/matrix-member-presentation-DZNgQpUq.js +0 -105
  161. package/dist/chunks/operators-B3zZoskU.js +0 -66
  162. package/dist/chunks/pivot-result-contract-expectations-Ddh1rNz5.js +0 -56
  163. package/dist/chunks/raw-temporal-value-Bqz8wc7L.js +0 -242
  164. package/dist/chunks/selection-reducer-OaJ-N5uN.js +0 -46
  165. package/dist/chunks/source-entity-resolution-DF6GulDn.js +0 -607
  166. package/dist/chunks/validators-wtjw0aw6.js +0 -3332
  167. package/dist/data-app-sdk/index.js +0 -1412
  168. package/dist/data-app-sdk-adapters/index.js +0 -361
  169. package/dist/data-app-sdk-validation/index.js +0 -1031
  170. package/dist/types/components/sharing-and-management/utils/group-types.d.ts +0 -105
  171. package/dist/types/data-app-sdk/adapters.d.ts +0 -35
  172. package/dist/types/data-app-sdk/builders.d.ts +0 -62
  173. package/dist/types/data-app-sdk/contracts.d.ts +0 -419
  174. package/dist/types/data-app-sdk/executor.d.ts +0 -5
  175. package/dist/types/data-app-sdk/field-catalog-validation.d.ts +0 -29
  176. package/dist/types/data-app-sdk/hooks.d.ts +0 -11
  177. package/dist/types/data-app-sdk/index.d.ts +0 -9
  178. package/dist/types/data-app-sdk/provider.d.ts +0 -8
  179. package/dist/types/data-app-sdk/relationship-aware-field-policy.d.ts +0 -21
  180. package/dist/types/data-app-sdk/selection.d.ts +0 -2
  181. package/dist/types/data-app-sdk/validation.d.ts +0 -58
  182. package/dist/types/data-app-sdk-adapters.d.ts +0 -2
  183. package/dist/types/data-app-sdk-validation.d.ts +0 -2
  184. package/dist/types/data-app-sdk.d.ts +0 -2
  185. package/dist/types/shared/analytics-protocol/relative-date-filter.d.ts +0 -68
  186. package/dist/types/shared/analytics-protocol/relative-date-label.d.ts +0 -20
  187. package/dist/types/shared/analytics-protocol/time-window-schema.d.ts +0 -314
  188. package/dist/types/shared/analytics-protocol/time-window.d.ts +0 -52
  189. package/dist/types/shared/temporal/relative-date.d.ts +0 -21
  190. package/dist/types/shared/temporal/time-window-periods.d.ts +0 -21
  191. package/src/data-app-sdk/README.md +0 -402
@@ -1,5 +1,5 @@
1
- import { a, R as s, D as o } from "../chunks/report-preferences-dialog-Mbd-I0wV.js";
2
- import { C as f, E as D } from "../chunks/bookmark-state-Du3s13_V.js";
1
+ import { a, R as s, D as o } from "../chunks/report-preferences-dialog-Yvhv3WX2.js";
2
+ import { C as f, E as D } from "../chunks/bookmark-state-CflS88gq.js";
3
3
  export {
4
4
  f as CONTROL_CARD_DEFAULT_VALUE,
5
5
  a as DisplayFormatPreferencesFields,
@@ -1,4 +1,5 @@
1
1
  export { assertValidAppearanceSpec, validateAppearanceSpec, } from '../lib/appearance/schema.js';
2
2
  export { mergeAppearanceSpecs, normalizeAppearanceSpec, } from '../lib/appearance/merge.js';
3
3
  export { resolveAppearance } from '../lib/appearance/resolver.js';
4
+ export { normalizeOrganizationAppearance } from '../lib/appearance/normalize-organization.js';
4
5
  export { APPEARANCE_SPEC_VERSION, type AppearanceMode, type AppearanceSpec, type AppearanceValidationIssue, type AppearanceValidationIssueCode, type AppearanceValidationResult, type NormalizedAppearanceSpec, } from '../lib/appearance/types.js';
@@ -74,6 +74,13 @@ type PresetScheme = {
74
74
  export declare const BRAND_STUDIO_PRESETS: BrandStudioPreset[];
75
75
  export declare function createBrandStudioDraft(appearance?: AppearanceSpec | null): BrandStudioDraft;
76
76
  export declare function buildAppearanceSpecFromDraft(draft: BrandStudioDraft): AppearanceSpec;
77
+ /**
78
+ * The brand as it is saved: what differs from the defaults, on one path each
79
+ * (dashboard style API-3). A component colour the draft only copied from its token
80
+ * on the dashboard canvas or the card frame (the editor's shape fills them) is left
81
+ * to the token, so a later token change still reaches that surface.
82
+ */
83
+ export declare function brandStudioSaveSpec(draft: BrandStudioDraft): AppearanceSpec;
77
84
  export declare function applyBrandStudioPreset(draft: BrandStudioDraft, presetId: string): BrandStudioDraft;
78
85
  export declare function applyBrandStudioColorToken(scheme: RequiredBrandStudioScheme, token: BrandStudioColorToken, value: string): void;
79
86
  export declare function applyBrandStudioRadiusToken(scheme: RequiredBrandStudioScheme, token: BrandStudioRadiusToken, value: number): void;
@@ -1,2 +1,2 @@
1
1
  export { BrandStudioEditor, type BrandStudioEditorProps, } from './brand-studio-editor.js';
2
- export { applyBrandStudioPreset, BRAND_STUDIO_PRESETS, buildAppearanceSpecFromDraft, createBrandStudioDraft, type BrandStudioDraft, type RequiredBrandStudioScheme, } from './brand-studio-draft.js';
2
+ export { applyBrandStudioPreset, BRAND_STUDIO_PRESETS, buildAppearanceSpecFromDraft, brandStudioSaveSpec, createBrandStudioDraft, type BrandStudioDraft, type RequiredBrandStudioScheme, } from './brand-studio-draft.js';
@@ -1,8 +1,7 @@
1
- import { BriefingDeliveryChannel, BriefingRecipient, BriefingRun } from '../../../lib/types/briefing-types.js';
1
+ import { BriefingRecipient, BriefingRun } from '../../../lib/types/briefing-types.js';
2
2
  import { isActiveBriefingRunStatus, isTerminalBriefingRunStatus } from '../use-briefing-run-detail.js';
3
3
  export declare const isTerminalRunStatus: typeof isTerminalBriefingRunStatus;
4
4
  export declare const isActiveRunStatus: typeof isActiveBriefingRunStatus;
5
- export declare function deliveryChannels(current: BriefingDeliveryChannel[], channel: BriefingDeliveryChannel, checked: boolean): BriefingDeliveryChannel[];
6
5
  export declare function creatorEmailRecipient(currentUser: {
7
6
  email?: string | null;
8
7
  name?: string | null;
@@ -1,8 +1,11 @@
1
1
  import { ReactNode } from 'react';
2
2
  import { AppearanceSpec, NormalizedAppearanceSpec } from '../../lib/appearance/types.js';
3
+ import { DashboardStyle } from '../../shared/dashboard-authoring/dashboard-style/types.js';
3
4
  export type AppearanceRuntimeProviderProps = {
4
5
  appearance?: AppearanceSpec | null;
5
6
  organizationAppearance?: AppearanceSpec | null;
7
+ /** The dashboard's own style, between the organization and the token. */
8
+ dashboardStyle?: DashboardStyle;
6
9
  tokenAppearance?: AppearanceSpec | null;
7
10
  reactAppearance?: AppearanceSpec | null;
8
11
  systemMode?: 'light' | 'dark';
@@ -16,4 +19,4 @@ export type InternalAppearanceRuntimeProviderProps = AppearanceRuntimeProviderPr
16
19
  * Portaled Semaphor content receives the matching scope through PortalScope.
17
20
  */
18
21
  export declare function AppearanceRuntimeProvider(props: AppearanceRuntimeProviderProps): import("react").JSX.Element;
19
- export declare function InternalAppearanceRuntimeProvider({ appearance, organizationAppearance, tokenAppearance, reactAppearance, resolvedAppearance, systemMode, children, }: InternalAppearanceRuntimeProviderProps): import("react").JSX.Element;
22
+ export declare function InternalAppearanceRuntimeProvider({ appearance, organizationAppearance, dashboardStyle, tokenAppearance, reactAppearance, resolvedAppearance, systemMode, children, }: InternalAppearanceRuntimeProviderProps): import("react").JSX.Element;
@@ -239,8 +239,6 @@ export declare function useVisualManagement(onDeleteSuccess?: () => void, onCrea
239
239
  isUpdatingShares: boolean;
240
240
  refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<any, Error>>;
241
241
  };
242
- export declare function useDashboardShares(dashboardId: string): import('@tanstack/react-query').UseQueryResult<any, Error>;
243
- export declare function useVisualShares(visualId: string): import('@tanstack/react-query').UseQueryResult<any, Error>;
244
242
  export declare function useCreateVisualWithFrame(onSuccessCallback?: (data?: any) => void): import('@tanstack/react-query').UseMutationResult<any, Error, CreateVisualRequest, unknown>;
245
243
  export declare function useUpdateVisualMutation(): import('@tanstack/react-query').UseMutationResult<any, Error, {
246
244
  visualId: string;
@@ -1,4 +1,3 @@
1
- import { GroupShareData } from './group-types.js';
2
1
  export interface MinimalResourceForSharing {
3
2
  id: string;
4
3
  title: string;
@@ -7,82 +6,11 @@ export declare enum ResourceType {
7
6
  DASHBOARD = "dashboard",
8
7
  VISUAL = "visual"
9
8
  }
10
- export type UserType = 'tenant' | 'organization';
11
- export interface User {
12
- id: string;
13
- name: string;
14
- email: string;
15
- type: string;
16
- }
17
9
  export interface Tenant {
18
10
  id: string;
19
11
  name: string;
20
12
  /** Every user in the tenant, counted on the server (tenants API). */
21
13
  userCount?: number;
22
14
  }
23
- export interface SelectedUser {
24
- id: string;
25
- role: ShareRole;
26
- }
27
- export interface UsersToUpdate {
28
- id: string;
29
- currentRole: ShareRole;
30
- newRole: ShareRole;
31
- }
32
15
  export type ShareScope = 'specific_tenant_user' | 'all_tenant_users' | 'specific_org_user' | 'all_org_users' | 'org_users_only' | 'all_tenants_only';
33
16
  export type ShareRole = 'VIEWER' | 'EDITOR' | 'CONTRIBUTOR';
34
- export interface RoleOption {
35
- value: ShareRole;
36
- label: string;
37
- description: string;
38
- }
39
- export type ShareMode = 'allOrgUsers' | 'specificOrgUsers' | 'allTenants' | 'allTenantUsers' | 'specificTenantUsers' | 'specificGroups' | 'allOrgGroups' | 'allTenantGroups';
40
- export type OrgTabShareData = {
41
- context: 'org-tab';
42
- mode: 'allOrgUsers';
43
- orgWideRole: ShareRole;
44
- removeAccess?: boolean;
45
- updateAccess?: boolean;
46
- } | {
47
- context: 'org-tab';
48
- mode: 'specificOrgUsers';
49
- selectedUsers: SelectedUser[];
50
- usersToRemove: string[];
51
- usersToUpdate: UsersToUpdate[];
52
- };
53
- export type TenantTabShareData = {
54
- context: 'tenant-tab';
55
- mode: 'allTenants';
56
- allTenantsRole: ShareRole;
57
- removeAccess?: boolean;
58
- updateAccess?: boolean;
59
- } | {
60
- context: 'tenant-tab';
61
- mode: 'allTenantUsers';
62
- tenantId: string;
63
- tenantWideRole: ShareRole;
64
- removeAccess?: boolean;
65
- updateAccess?: boolean;
66
- } | {
67
- context: 'tenant-tab';
68
- mode: 'specificTenantUsers';
69
- tenantId: string;
70
- selectedUsers: SelectedUser[];
71
- usersToRemove: string[];
72
- usersToUpdate: UsersToUpdate[];
73
- };
74
- export type OrgUserShareData = OrgTabShareData | TenantTabShareData;
75
- export type TenantUserShareData = {
76
- context: 'tenant-dialog';
77
- mode: 'allTenantUsers';
78
- tenantWideRole: ShareRole;
79
- removeAccess?: boolean;
80
- updateAccess?: boolean;
81
- } | {
82
- context: 'tenant-dialog';
83
- mode: 'specificTenantUsers';
84
- selectedUsers: SelectedUser[];
85
- usersToRemove: string[];
86
- usersToUpdate: UsersToUpdate[];
87
- };
88
- export type ShareData = OrgUserShareData | TenantUserShareData | GroupShareData;
@@ -2,7 +2,7 @@ import { DashboardInputTargetContext } from '../../../lib/dashboard-inputs/dashb
2
2
  import { NormalizedDashboardInput } from '../../../lib/types/common-types.js';
3
3
  import { CalculatedFieldFormula, Field } from '../../../lib/types/explorer-types.js';
4
4
  import { RawTemporalSelection, TemporalBucketMetadata } from '../../../shared/analytics-protocol/contracts.js';
5
- import { DateUnit, RelativeDateFilter, RelativeDateUnit, SubDayDateUnit } from '../../../shared/analytics-protocol/relative-date-filter.js';
5
+ import { DateUnit, RelativeDateUnit, RelativeDateWindow, StoredRelativeDate, SubDayDateUnit } from '../../../shared/analytics-protocol/relative-date/index.js';
6
6
  export type DateSelectionMode = 'range' | 'months' | 'day';
7
7
  export type DateComparisonOperation = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'between' | 'not between' | 'is null' | 'is not null';
8
8
  export type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
@@ -13,7 +13,7 @@ export type ComboBoxOption = {
13
13
  [key: string]: FilterOptionValue;
14
14
  };
15
15
  export type TSelectedRecord = ComboBoxOption;
16
- export type { DateUnit, RelativeDateFilter, RelativeDateUnit, SubDayDateUnit, };
16
+ export type { DateUnit, RelativeDateUnit, RelativeDateWindow, StoredRelativeDate, SubDayDateUnit, };
17
17
  export type TemporalPrecision = 'minute';
18
18
  /**
19
19
  * Options for a relative date pick ("Today", "Last 7 days"). The pick is a
@@ -44,7 +44,7 @@ export type FixedDayDefaultDateFilter = {
44
44
  unit: 'day';
45
45
  date: string;
46
46
  };
47
- export type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
47
+ export type DefaultDateFilter = StoredRelativeDate | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
48
48
  export type FilterKind = 'field' | 'global-date';
49
49
  /**
50
50
  * Target column configuration for multi-field filters.
@@ -176,7 +176,8 @@ type FilterForBetween = BaseFilter & {
176
176
  type FilterForDate = BaseFilter & {
177
177
  operation: 'between' | 'not between' | '=' | '!=' | '>' | '<' | '>=' | '<=';
178
178
  values: [Date | string, Date | string] | [Date | string];
179
- relativeMeta?: RelativeDateFilter;
179
+ /** The relative window the dates come from, as stored; read it with `readRelativeDate` (relative-date-as-of SPEC 2.2). */
180
+ relativeMeta?: StoredRelativeDate;
180
181
  temporalPrecision?: TemporalPrecision;
181
182
  };
182
183
  type FilterForNull = BaseFilter & {
@@ -1,10 +1,8 @@
1
- import { DefaultDateFilter, FixedDayDefaultDateFilter, FixedMonthDefaultDateFilter, RelativeDateFilter } from '../surfboard/filter/types.js';
1
+ import { DefaultDateFilter, FixedDayDefaultDateFilter, FixedMonthDefaultDateFilter } from '../surfboard/filter/types.js';
2
2
  import { WeekStart } from '../../lib/types/token-types.js';
3
3
  import { CalendarContext } from '../../shared/report-runtime-context/index.js';
4
4
  /** Calendar inputs for defaults, including reproducible and fiscal reports. */
5
5
  export type DefaultDateCalendar = Pick<CalendarContext, 'tz' | 'weekStart'> & Partial<Pick<CalendarContext, 'anchor' | 'fiscalCalendar'>>;
6
- /** A valid relative date, read by the shared protocol reader. */
7
- export declare const isRelativeDateFilter: (value: unknown) => value is RelativeDateFilter;
8
6
  export declare const isFixedMonthDefaultDateFilter: (value: unknown) => value is FixedMonthDefaultDateFilter;
9
7
  export declare const isFixedDayDefaultDateFilter: (value: unknown) => value is FixedDayDefaultDateFilter;
10
8
  /**
@@ -22,17 +20,3 @@ export declare function resolveCalendarDayRange(date: string, timezone: string):
22
20
  */
23
21
  export declare const isSingleDayDefaultDateFilter: (value: DefaultDateFilter | undefined) => boolean;
24
22
  export declare function resolveDefaultDateFilterForDefaults(meta: DefaultDateFilter, calendar: string | DefaultDateCalendar, weekStart?: WeekStart): [Date, Date] | undefined;
25
- /**
26
- * The window a relative date names at `now` in the timezone, from the shared
27
- * date module (analytics kernel Phase 3), so a preview matches what the server
28
- * runs. Callers here have no fiscal calendar, so quarters and years are
29
- * calendar periods; previews show those as labels only (K8).
30
- *
31
- * @param meta - The relative date filter metadata
32
- * @param timezone - IANA timezone string (e.g., "America/New_York", "UTC")
33
- * @param weekStart - Day the week starts on (0=Sunday, 1=Monday). Defaults to 1 (Monday/ISO).
34
- * @param now - The anchor instant; a pinned calendar anchor passes its own.
35
- * @returns `[start, inclusive end]`
36
- */
37
- export declare function resolveRelativeDateForDefaults(meta: RelativeDateFilter, timezone: string, weekStart?: WeekStart, now?: Date): [Date, Date];
38
- export { findPresetLabel, getRelativeDateLabel, getRelativeOffsetLabel, presetMetadata, relativeMetaEquals, } from '../../shared/analytics-protocol/relative-date-label.js';
@@ -80,7 +80,6 @@ export declare function useDataTableLogic(props: DataTableLogicProps): {
80
80
  handleColumnSettingsChange: (next: ColumnSettings) => void;
81
81
  handleColumnBaseStyleChange: (next: TableBaseStyle) => void;
82
82
  isHandlingVisibilityChange: React.RefObject<boolean>;
83
- themeStyle: import('../../../index.js').StyleProps | undefined;
84
83
  tableRef: React.RefObject<any>;
85
84
  internalColumnSettings: ColumnSettingsMap;
86
85
  internalSelectColumnVisible: boolean;
@@ -258,11 +258,6 @@ export interface DataTablePaginationProps {
258
258
  exportData?: any[];
259
259
  appearance?: DataTablePaginationAppearance;
260
260
  }
261
- export interface ColorPickerProps {
262
- color: string;
263
- onChange: (color: string) => void;
264
- className?: string;
265
- }
266
261
  export declare const DATE_FORMAT_GROUPS: {
267
262
  label: string;
268
263
  formats: {
@@ -274,10 +269,6 @@ export declare const DATE_FORMATS: {
274
269
  label: string;
275
270
  value: string;
276
271
  }[];
277
- export declare const DATE_FORMAT_TYPES: {
278
- label: string;
279
- value: string;
280
- }[];
281
272
  export declare const COMMON_TIMEZONES: {
282
273
  label: string;
283
274
  value: string;
@@ -1,5 +1,4 @@
1
1
  import { TCard, VisualDisplayMode } from '../../../../lib/types/common-types.js';
2
- import { PaginationMetadata } from '../../../../lib/types/explorer-types.js';
3
2
  export type PaginationMode = 'client' | 'server' | 'disabled';
4
3
  export declare const TABLE_PAGE_SIZE_OPTIONS: readonly [10, 20, 50, 100, 500, 1000];
5
4
  export declare const DEFAULT_TABLE_PAGE_SIZE = 50;
@@ -19,21 +18,3 @@ export declare function isDevPaginationSwitchableCard(card: TCard): boolean;
19
18
  * - Client pagination: When card has raw SQL OR is not a table
20
19
  */
21
20
  export declare function getPaginationMode(card: TCard, displayMode?: VisualDisplayMode): PaginationMode;
22
- /**
23
- * Converts frontend pagination state (0-based) to backend format (1-based)
24
- */
25
- export declare function toBackendPagination(pageIndex: number, pageSize: number): {
26
- page: number;
27
- pageSize: number;
28
- };
29
- /**
30
- * Converts backend pagination metadata (1-based) to frontend format (0-based)
31
- */
32
- export declare function fromBackendPagination(metadata: PaginationMetadata): {
33
- pageIndex: number;
34
- pageSize: number;
35
- pageCount: number;
36
- totalCount: number;
37
- hasNextPage: boolean;
38
- hasPrevPage: boolean;
39
- };
@@ -14,7 +14,6 @@ type ConfigField = DetailField | GroupByField | MetricField;
14
14
  export declare function reorderTableCardConfig(card: TCard, request: ColumnReorderRequest, columnKeyMap?: QueryColumnKeyMap): CardConfig | null;
15
15
  export declare function hasConfigOwnedTableFields(card: TCard | undefined): boolean;
16
16
  export declare function hasConfigBackedTableColumnOrder(card: TCard | undefined, columnKeyMap: QueryColumnKeyMap | undefined): boolean;
17
- export declare function getConfigBackedTableOutputColumnIds(card: TCard | undefined, columnKeyMap: QueryColumnKeyMap | undefined): string[];
18
17
  export declare function resolveDataTableFieldOutputKey(field: ConfigField, role: QueryColumnKeyRole, availableKeys: string[], columnKeyMap?: QueryColumnKeyMap): string | undefined;
19
18
  export declare function resolveDataTableColumnDisplayLabel(columnId: string, card: TCard | undefined, columnKeyMap?: QueryColumnKeyMap): string | undefined;
20
19
  export declare function buildDataTableColumnDisplayLabels(columnIds: readonly string[], card: TCard | undefined, columnKeyMap?: QueryColumnKeyMap, resultColumns?: readonly SemaphorResultColumn[], temporalPresentation?: GroupedTemporalPresentation): {
@@ -1,8 +1,8 @@
1
- import { B as s, y as r, C as l, E as o, V as i, j as n, c as d, g as m, f as u, b as c, e as E, d as C, a as T, x as p, w as D, l as A, h as I, o as _, v as F, u as S, m as b, n as L, p as f, k as N, q as y, s as R, i as h, r as g, t as x } from "../chunks/bookmark-state-Du3s13_V.js";
2
- import { C as O, D as V, L as w, e as k, g as U, j as z, h as B, k as K, d as v, b as Y, i as q, c as G, n as P, f as Q } from "../chunks/validators-wtjw0aw6.js";
3
- import { D as W } from "../chunks/token-types-C8JymO8s.js";
4
- import { r as X, a as H } from "../chunks/pivot-result-identity-BlbLrqaC.js";
5
- import { D as $ } from "../chunks/report-runtime-context-DnA_PiKo.js";
1
+ import { B as t, y as r, C as l, E as o, V as i, j as n, c as d, g as m, f as u, b as c, e as E, d as C, a as T, x as p, w as D, l as A, h as I, o as _, v as F, u as S, m as b, n as L, p as f, k as N, q as y, s as R, i as h, r as g, t as x } from "../chunks/bookmark-state-CflS88gq.js";
2
+ import { C as O, D as V, L as w, d as U, g as k, e as z, h as B, f as K, c as v, a as Y, i as q, b as G, n as P, s as Q } from "../chunks/validators-B8fpdinG.js";
3
+ import { D as j } from "../chunks/token-types-iKMplaBL.js";
4
+ import { r as X, a as H } from "../chunks/pivot-result-identity-B89X5xjb.js";
5
+ import { D as $ } from "../chunks/report-runtime-context-BhPzLTbS.js";
6
6
  const e = [
7
7
  "concatenate",
8
8
  "conditional-category",
@@ -36,14 +36,14 @@ const e = [
36
36
  "is-blank"
37
37
  ];
38
38
  export {
39
- s as BOOKMARK_STATE_VERSION,
39
+ t as BOOKMARK_STATE_VERSION,
40
40
  r as BOOKMARK_VISIBILITIES,
41
41
  O as CALCULATED_FIELD_ENTITY_MARKER,
42
42
  e as CALCULATED_FIELD_TEMPLATE_IDS,
43
43
  l as CONTROL_CARD_DEFAULT_VALUE,
44
44
  V as DATE_FORMAT_VALUES,
45
45
  $ as DEFAULT_CALENDAR_CONTEXT,
46
- W as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
46
+ j as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
47
47
  o as EMPTY_SELECTION,
48
48
  w as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
49
49
  i as VIEWER_LIMITS,
@@ -55,9 +55,9 @@ export {
55
55
  E as collectQualifiedDatasetNamesFromExplorerField,
56
56
  C as datasetRefFromSource,
57
57
  T as dependencyDisplayIdentity,
58
- k as getCalculatedFieldComputeStage,
58
+ U as getCalculatedFieldComputeStage,
59
59
  p as getCustomizableTableCardIds,
60
- U as getFieldRuntimeColumnName,
60
+ k as getFieldRuntimeColumnName,
61
61
  D as getSortableTableCardIds,
62
62
  z as hasCalculatedFieldMarker,
63
63
  B as hasCalculatedFormulaInputs,
@@ -0,0 +1,42 @@
1
+ import { AppearanceSpec } from './types.js';
2
+ /**
3
+ * One canonical path per property (dashboard style DS-D26, SPEC §3.3). Some
4
+ * properties also have a component-level path; inside one layer the component
5
+ * value wins, as it always has, and is moved onto the canonical token path, so
6
+ * that layers merge by property: a later layer's token beats an earlier layer's
7
+ * component value, and the reverse.
8
+ */
9
+ export declare const APPEARANCE_ALIASES: readonly [{
10
+ readonly alias: readonly ["components", "dashboard", "padding"];
11
+ readonly canonical: readonly ["tokens", "spacing", "dashboardPadding"];
12
+ }, {
13
+ readonly alias: readonly ["components", "card", "borderRadius"];
14
+ readonly canonical: readonly ["tokens", "radius", "card"];
15
+ }, {
16
+ readonly alias: readonly ["components", "card", "shadow"];
17
+ readonly canonical: readonly ["tokens", "shadow", "card"];
18
+ }, {
19
+ readonly alias: readonly ["components", "card", "padding"];
20
+ readonly canonical: readonly ["tokens", "spacing", "cardPadding"];
21
+ }, {
22
+ readonly alias: readonly ["components", "pagination", "borderRadius"];
23
+ readonly canonical: readonly ["tokens", "radius", "control"];
24
+ }, {
25
+ readonly alias: readonly ["components", "interactive", "borderRadius"];
26
+ readonly canonical: readonly ["tokens", "radius", "control"];
27
+ }];
28
+ /**
29
+ * A layer that recolours the page without naming a canvas paints the canvas with the
30
+ * page colour, as the dashboard surface always did (dashboard style P2-09). A colour
31
+ * equal to the default page colour never did, so it doesn't.
32
+ */
33
+ export declare const CANVAS_FROM_PAGE_COLOR: {
34
+ readonly page: readonly ["tokens", "color", "background"];
35
+ readonly canvas: readonly ["components", "dashboard", "background"];
36
+ };
37
+ export declare function normalizeAppearanceAliases<T extends AppearanceSpec | null | undefined>(spec: T): T;
38
+ export declare function readPath(value: unknown, path: readonly string[]): unknown;
39
+ /** A copy with `path` set; parents are copied, never mutated. */
40
+ export declare function writePath(value: Record<string, unknown>, path: readonly string[], leaf: unknown): Record<string, unknown>;
41
+ /** A copy without `path`; a parent left empty is removed. */
42
+ export declare function deletePath(value: Record<string, unknown>, path: readonly string[]): Record<string, unknown>;
@@ -6,4 +6,10 @@ export declare function compileAppearance(params: {
6
6
  systemMode?: ResolvedAppearanceMode;
7
7
  defaults?: NormalizedAppearanceSpec;
8
8
  }): CompiledAppearance;
9
+ /** The named card shadows (dashboard style SPEC §3.3); `subtle` is the card's long-standing `shadow-sm`. */
10
+ export declare const APPEARANCE_SHADOWS: {
11
+ readonly none: "none";
12
+ readonly subtle: "0 1px 2px 0 rgb(0 0 0 / 0.05)";
13
+ readonly raised: "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)";
14
+ };
9
15
  export declare function resolveAppearanceMode(mode: AppearanceMode, systemMode?: ResolvedAppearanceMode): ResolvedAppearanceMode;
@@ -1,3 +1,9 @@
1
1
  import { NormalizedAppearanceSpec } from './types.js';
2
+ /**
3
+ * The default chart palette (dashboard style SPEC §3.7, DS-D25): brand blue first,
4
+ * validated for colour-blind separation on white and on zinc-900. Series take slots
5
+ * in order.
6
+ */
2
7
  export declare const SEMAPHOR_DEFAULT_CHART_PALETTE: string[];
8
+ export declare const SEMAPHOR_DEFAULT_DARK_CHART_PALETTE: string[];
3
9
  export declare const SEMAPHOR_DEFAULT_APPEARANCE_SPEC: NormalizedAppearanceSpec;
@@ -1,7 +1,9 @@
1
+ export { APPEARANCE_ALIASES, CANVAS_FROM_PAGE_COLOR, normalizeAppearanceAliases } from './aliases.js';
1
2
  export * from './color.js';
2
3
  export * from './compiler.js';
3
4
  export * from './defaults.js';
4
5
  export * from './merge.js';
6
+ export * from './normalize-organization.js';
5
7
  export * from './resolver.js';
6
8
  export * from './schema.js';
7
9
  export * from './types.js';
@@ -0,0 +1,17 @@
1
+ import { AppearanceSpec } from './types.js';
2
+ /**
3
+ * A stored organization appearance, rewritten to state what renders today and
4
+ * nothing more (SPEC §4.6): hidden legacy defaults removed, aliases folded onto
5
+ * their canonical paths (the component value winning), values equal to the
6
+ * defaults removed, retired table components removed. `null` when nothing is left.
7
+ */
8
+ export declare function normalizeOrganizationAppearance(spec: AppearanceSpec): {
9
+ spec: AppearanceSpec | null;
10
+ changes: string[];
11
+ };
12
+ /**
13
+ * What a stored brand drew under the old renderers, on canonical paths, values equal
14
+ * to the defaults kept: the brand's side of "the brand wins today" when a dashboard's
15
+ * legacy style is converted (SPEC §4.5). Read the brand as stored, before it is normalized.
16
+ */
17
+ export declare function renderedOrganizationScheme(spec: AppearanceSpec | null | undefined, mode: 'light' | 'dark'): Record<string, unknown> | undefined;
@@ -1,2 +1,2 @@
1
- import { AppearanceResolutionLayers, NormalizedAppearanceSpec } from './types.js';
2
- export declare function resolveAppearance(layers?: AppearanceResolutionLayers): NormalizedAppearanceSpec;
1
+ import { AppearanceLayers, NormalizedAppearanceSpec } from './types.js';
2
+ export declare function resolveAppearance(layers?: AppearanceLayers): NormalizedAppearanceSpec;
@@ -1,3 +1,4 @@
1
+ import { DashboardStyle } from '../../shared/dashboard-authoring/dashboard-style/types.js';
1
2
  export declare const APPEARANCE_SPEC_VERSION: 1;
2
3
  export type AppearanceMode = 'light' | 'dark' | 'system';
3
4
  export type ResolvedAppearanceMode = 'light' | 'dark';
@@ -36,18 +37,24 @@ export type AppearanceTokens = {
36
37
  };
37
38
  };
38
39
  export type BaseSurfaceAppearance = {
40
+ /** On `components.dashboard` (the canvas) also the keywords `muted` and `background`, naming those color tokens. */
39
41
  background?: string;
40
42
  foreground?: string;
41
43
  borderColor?: string;
42
44
  borderRadius?: number;
45
+ /** CSS shadow, or `none`, `subtle` or `raised` (compiled to CSS). */
43
46
  shadow?: string;
44
47
  padding?: number;
48
+ /** `components.card` only: 1 draws the card border, 0 hides it. */
49
+ borderWidth?: 0 | 1;
45
50
  };
46
51
  export type InteractiveSurfaceAppearance = BaseSurfaceAppearance & {
47
52
  toolbarBackground?: string;
48
53
  };
49
54
  export type ChartAppearance = {
50
55
  palette?: string[];
56
+ /** Corner radius of bars, px. */
57
+ barRadius?: number;
51
58
  background?: string;
52
59
  foreground?: string;
53
60
  gridColor?: string;
@@ -149,17 +156,47 @@ export type RgbColor = {
149
156
  g: number;
150
157
  b: number;
151
158
  };
159
+ /**
160
+ * Everything a chart builder takes from the appearance (dashboard style SPEC §3.5,
161
+ * CT-1): chart code gets style and mode only from a `ChartTheme` it is given.
162
+ * `gridColor`, `axisColor` and `legendColor` are unset when Chart.js's own colours draw.
163
+ */
164
+ export type ChartTheme = {
165
+ mode: ResolvedAppearanceMode;
166
+ palette: string[];
167
+ font: {
168
+ family: string;
169
+ size: number;
170
+ };
171
+ gridColor?: string;
172
+ axisColor?: string;
173
+ legendColor?: string;
174
+ tooltip: {
175
+ background: string;
176
+ title: string;
177
+ body: string;
178
+ footer: string;
179
+ border: string;
180
+ cornerRadius: number;
181
+ };
182
+ barRadius: number;
183
+ };
152
184
  export type CompiledAppearance = {
153
185
  mode: ResolvedAppearanceMode;
154
186
  scheme: AppearanceScheme;
155
187
  cssVariables: Record<string, string>;
156
188
  colorValues: AppearanceColorTokens;
157
189
  chartPalette: string[];
190
+ chartTheme: ChartTheme;
158
191
  table?: TableAppearance;
159
192
  };
160
- export type AppearanceResolutionLayers = {
193
+ /** The resolver's inputs, first to last (dashboard style DS-D4, SPEC §3.3). */
194
+ export type AppearanceLayers = {
161
195
  defaults?: NormalizedAppearanceSpec;
196
+ /** Brand Studio's saved brand, or its preview while it is open. */
162
197
  organizationAppearance?: AppearanceSpec | null | undefined;
198
+ /** The dashboard's own style: the editing draft's. */
199
+ dashboardStyle?: DashboardStyle | undefined;
163
200
  tokenAppearance?: AppearanceSpec | null | undefined;
164
201
  reactAppearance?: AppearanceSpec | null | undefined;
165
202
  };
@@ -1,4 +1,5 @@
1
- import { StyleProps, TDataColumn, TCardPreferences, TCard } from '../types/common-types.js';
1
+ import { TDataColumn, TCardPreferences, TCard } from '../types/common-types.js';
2
+ import { ChartTheme } from '../appearance/types.js';
2
3
  import { Chart, ChartConfiguration } from 'chart.js';
3
4
  import { ComparisonMetadataMap, QueryConfig } from '../types/query-types.js';
4
5
  import { ChartNumericPresentationContext } from '../formatters/chart-numeric-presentation.js';
@@ -25,7 +26,8 @@ export type ChartConfigParams = {
25
26
  provider?: TChartProvider;
26
27
  userSettings?: object;
27
28
  preferences?: TCardPreferences;
28
- themeStyle?: StyleProps;
29
+ /** The appearance's chart style and mode (dashboard style SPEC §3.5): the only style a builder reads. */
30
+ chartTheme: ChartTheme;
29
31
  /**
30
32
  * Indicates SQL/dev mode where grouping is derived directly from raw data
31
33
  */
@@ -47,6 +49,8 @@ export type BlurEffectProps = {
47
49
  cfg: TChartConfiguration | undefined;
48
50
  apply: boolean;
49
51
  blurColor?: string;
52
+ /** The chart's mode, from its `ChartTheme` (CT-1). */
53
+ mode?: 'light' | 'dark';
50
54
  };
51
55
  export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'matrixTable' | 'detailTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
52
56
  export { TABLE_CHART_TYPES, isTableChartType };
@@ -17,7 +17,6 @@ export declare function findBySemanticDatasetReferenceCandidate<TDataset extends
17
17
  export declare function getSemanticDatasetPayloadLookupNames<TDataset extends SemanticDatasetIdentityLike>(datasets: TDataset[] | undefined, dataset: TDataset): string[];
18
18
  export declare function collectCardSemanticDatasetReferences(card: TCard | undefined): SemanticDatasetReference[];
19
19
  export declare function collectFrameSemanticDatasetReferences(frame: TFrame | undefined): SemanticDatasetReference[];
20
- export declare function collectDashboardSemanticDatasetReferences(dashboard: TDashboard): SemanticDatasetReference[];
21
20
  export declare function resolveEffectiveCardSemanticDatasetReference(card: TCard | undefined, cardConfig?: CardConfig): SemanticDatasetReference | null;
22
21
  export declare function findDashboardFrameById(dashboard: TDashboard | undefined, frameId: string | undefined): TFrame | null;
23
22
  export declare function haveMatchingSemanticDatasetReferences(left: SemanticDatasetReference[], right: SemanticDatasetReference[]): boolean;
@@ -72,8 +72,6 @@ export declare function compactDashboardInputValues(values: DashboardInputValues
72
72
  * when `over` is empty.
73
73
  */
74
74
  export declare function overlayDashboardInputValues(base: DashboardInputValues, over: DashboardInputValues): DashboardInputValues;
75
- /** The values without any slot of these inputs, on every target. `values` itself when none is held. */
76
- export declare function removeDashboardInputSlotsById(values: DashboardInputValues, inputIds: ReadonlySet<string>): DashboardInputValues;
77
75
  /**
78
76
  * The saved defaults the runtime reads (SPEC 5.2): the filter model's, which
79
77
  * hold owned `defaultFilterValues` entries as slots. With no such entry they
@@ -1,4 +1,4 @@
1
- import { ControlDefinition, ControlOption, DashboardInputExportKey, DataVariable, DocumentInputDefinition, ReportValueKey, ResolvedDashboardInput, TextVariablePresentation, VariableRef } from '../types/common-types.js';
1
+ import { ControlDefinition, ControlOption, DashboardInputExportKey, DataVariable, DocumentInputDefinition, ReportValueKey, ResolvedDashboardInput, VariableRef } from '../types/common-types.js';
2
2
  import { TFilterValue } from '../../components/surfboard/filter/types.js';
3
3
  import { TemporalTextPresentationContext } from '../text-variables/temporal-input-text.js';
4
4
  import { TextVariableChipFace } from '../text-variables/text-variable-types.js';
@@ -200,8 +200,3 @@ export type RenderedText = {
200
200
  /** A data variable in this text is still loading (print readiness, DV-D32). */
201
201
  pending: boolean;
202
202
  };
203
- /** A stored variable inline, as both text shapes hold it. */
204
- export type StoredVariableInline = {
205
- ref: VariableRef;
206
- presentation?: TextVariablePresentation;
207
- };
@@ -164,7 +164,6 @@ export declare function downloadDocumentPdf(apiServiceUrl: string, authToken: Au
164
164
  password?: string;
165
165
  }): Promise<void>;
166
166
  export declare function getVisualParamsForPrint(authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, overrides?: VisualPrintRuntimeOverrides): VisualPdfParams;
167
- export declare function downloadVisualPdf(apiServiceUrl: string, authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, cardChartType?: TChartType, password?: string, pageSize?: string, orientation?: string, filterLine?: string, filterValues?: TFilterValue[], expandedState?: Record<string, boolean>, matrix?: MatrixPdfCapture): Promise<void>;
168
167
  /** `captured`: the print parameters taken at the click (`getVisualParamsForPrint`), for a fallback after an await. */
169
168
  export declare function downloadVisualPdfWithResponse(apiServiceUrl: string, authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, cardChartType?: TChartType, password?: string, pageSize?: string, orientation?: string, filterLine?: string, filterValues?: TFilterValue[], expandedState?: Record<string, boolean>, matrix?: MatrixPdfCapture, captured?: VisualPdfParams): Promise<PdfDownloadResponse | undefined>;
170
169
  type FastPathOptions = {
@@ -1,4 +1,4 @@
1
- import { AuthToken, CustomCard, DashboardLifecycleEvent, DashboardInputExecutionSnapshot, TDashboard, TEvent, TStyle } from '../types/common-types.js';
1
+ import { AuthToken, CustomCard, DashboardLifecycleEvent, DashboardInputExecutionSnapshot, TDashboard, TEvent } from '../types/common-types.js';
2
2
  import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
3
3
  import { TFilterValue } from '../../components/surfboard/filter/types.js';
4
4
  import { ControlContractOverrides } from '../dashboard-inputs/control-contract-overrides.js';
@@ -19,7 +19,6 @@ type UseDashboardProps = {
19
19
  presentationExecutionSnapshot?: PresentationExecutionSnapshot;
20
20
  /** PDF render: the viewer's table settings captured at export time. Nothing is read or written. */
21
21
  viewerTableSettings?: Readonly<Record<string, ViewerTableSettings>>;
22
- customStyle?: TStyle;
23
22
  currentTheme?: 'light' | 'dark' | 'system';
24
23
  onSave?: (dashboard: TDashboard) => void;
25
24
  onEvent?: (event: TEvent) => void;
@@ -30,7 +29,7 @@ type UseDashboardProps = {
30
29
  type?: 'dashboard' | 'visual';
31
30
  cardId?: string;
32
31
  };
33
- export declare function useDashboard({ customStyle, currentTheme, onSave, onEvent, onDashboardLifecycleEvent, defaultFilterValues, defaultControlValues, controlContractOverrides, dashboardInputExecutionSnapshot, printInputCapture, presentationExecutionSnapshot, viewerTableSettings, type, cardId, selectedSheetId, onFilterValuesChange, }: UseDashboardProps): {
32
+ export declare function useDashboard({ currentTheme, onSave, onEvent, onDashboardLifecycleEvent, defaultFilterValues, defaultControlValues, controlContractOverrides, dashboardInputExecutionSnapshot, printInputCapture, presentationExecutionSnapshot, viewerTableSettings, type, cardId, selectedSheetId, onFilterValuesChange, }: UseDashboardProps): {
34
33
  isFetching: boolean;
35
34
  isLoading: boolean;
36
35
  isError: boolean;
@@ -38,7 +37,7 @@ export declare function useDashboard({ customStyle, currentTheme, onSave, onEven
38
37
  initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
39
38
  dashboard: TDashboard;
40
39
  semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
41
- organizationAppearance?: import('../appearance/types.js').AppearanceSpec | null;
40
+ organizationAppearance?: import('../types/index.js').AppearanceSpec | null;
42
41
  viewer?: import('../../shared/dashboard-viewer/index.js').DashboardViewerPayload;
43
42
  } | null, Error>>;
44
43
  };