react-semaphor 0.1.564 → 0.1.565

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 (132) hide show
  1. package/DATA_APP_SDK.md +3 -3
  2. package/README.md +2 -2
  3. package/dist/analytics-protocol/index.js +8 -8
  4. package/dist/assistant-context/index.js +3 -2
  5. package/dist/brand-studio/index.js +28 -29
  6. package/dist/briefings/index.js +4 -4
  7. package/dist/chunks/{assistant-chat-D1BEEHUF.js → assistant-chat-DNfb5fbF.js} +204 -204
  8. package/dist/chunks/{bookmark-impact-XOsVUAqW.js → bookmark-impact-CHr7b1J2.js} +2 -2
  9. package/dist/chunks/bookmark-state-ByODVqee.js +1613 -0
  10. package/dist/chunks/card-filter-builder-CcEcfaYz.js +4100 -0
  11. package/dist/chunks/{switch-BW4yXSYs.js → code-editor-DJNOsgJH.js} +463 -442
  12. package/dist/chunks/{comparison-window-caption-D1EUXzaR.js → comparison-window-caption-CMLb3mut.js} +451 -419
  13. package/dist/chunks/{dashboard-DfYsASNd.js → dashboard-CtIfxycc.js} +1 -1
  14. package/dist/chunks/dashboard-briefing-launcher-D3mc6peE.js +4910 -0
  15. package/dist/chunks/{dashboard-controls-CJ8Dz50D.js → dashboard-controls-BFv0zdws.js} +692 -682
  16. package/dist/chunks/{dashboard-json-D3uZxGO-.js → dashboard-json-CXn_3OYb.js} +4 -4
  17. package/dist/chunks/{dates-EvDtT25n.js → dates-DcRxw17S.js} +12 -12
  18. package/dist/chunks/{edit-dashboard-visual-CgHJXBQv.js → edit-dashboard-visual-Y6HatqBd.js} +7704 -10337
  19. package/dist/chunks/filter-reach-copy-DbggA5B7.js +4673 -0
  20. package/dist/chunks/{filter-value-text-CPwFkrMz.js → filter-value-text-7zhmth1S.js} +2 -2
  21. package/dist/chunks/{index-CAgf2x4E.js → index-DDa_rklN.js} +68 -63
  22. package/dist/chunks/{layout-grid-BM65viQh.js → layout-grid-0hIlqEtk.js} +1 -1
  23. package/dist/chunks/{list-filter-BoeLBfL3.js → list-filter-DkgoCeBm.js} +1 -1
  24. package/dist/chunks/{matrix-analytical-definition-hEucouWM.js → matrix-analytical-definition-C9xB_T84.js} +18 -18
  25. package/dist/chunks/{matrix-card-CCh9JjP1.js → matrix-card-BSUeSXpD.js} +2 -2
  26. package/dist/chunks/{matrix-member-presentation-DsAUbuoL.js → matrix-member-presentation-DZNgQpUq.js} +1 -1
  27. package/dist/chunks/{matrix-operation-contract-DsLdFdSa.js → matrix-operation-contract-Eb6elidS.js} +1 -1
  28. package/dist/chunks/{metric-comparison-Bnso1cm1.js → metric-comparison-ChXUFaZu.js} +1 -1
  29. package/dist/chunks/{palette-p1XSJFgB.js → palette-4vf2BEEg.js} +1 -1
  30. package/dist/chunks/{pivot-result-contract-expectations-B53jqszr.js → pivot-result-contract-expectations-Ddh1rNz5.js} +4 -4
  31. package/dist/chunks/{pivot-result-identity-Dq5jm-EC.js → pivot-result-identity-BlbLrqaC.js} +1 -1
  32. package/dist/chunks/{report-preferences-dialog-DMqxSU4X.js → report-preferences-dialog-Db-b04B4.js} +122 -131
  33. package/dist/chunks/{report-runtime-context-BITkNSDa.js → report-runtime-context-DnA_PiKo.js} +1 -1
  34. package/dist/chunks/resolve-dashboard-input-context-C18J-YZC.js +21394 -0
  35. package/dist/chunks/{save-CHV1B1fL.js → save-D6pHmSSP.js} +1 -1
  36. package/dist/chunks/saved-dashboard-context-DhC_EVus.js +629 -0
  37. package/dist/chunks/{selection-reducer-Bz5aywT4.js → selection-reducer-OaJ-N5uN.js} +1 -1
  38. package/dist/chunks/{semaphor-ready-indicator-CFeCIuaw.js → semaphor-ready-indicator-T6TsiBMT.js} +80634 -80503
  39. package/dist/chunks/{shelf-drop-preview-context-cEyVkKTF.js → shelf-drop-preview-context-CNWL_b0S.js} +407 -407
  40. package/dist/chunks/{source-entity-resolution-DdDVXFB8.js → source-entity-resolution-DF6GulDn.js} +1 -1
  41. package/dist/chunks/stored-dashboard-IdmtrNkA.js +5026 -0
  42. package/dist/chunks/{table-export-sheet-bSXxGn-v.js → table-export-sheet--DUKWk6o.js} +1 -1
  43. package/dist/chunks/{temporal-input-presentation-sk9gqLi6.js → temporal-input-presentation--2r9BLr0.js} +392 -377
  44. package/dist/chunks/{token-types-BUK06hU2.js → token-types-C8JymO8s.js} +1 -1
  45. package/dist/chunks/{upload-BnmuyPqW.js → upload-Cf3wXZT8.js} +1 -1
  46. package/dist/chunks/{validators-BIM0FE31.js → validators-wtjw0aw6.js} +7 -7
  47. package/dist/chunks/variable-draft-3xseULxR.js +241 -0
  48. package/dist/dashboard/index.js +2 -2
  49. package/dist/dashboard-authoring/index.js +2206 -1705
  50. package/dist/data-app-sdk/index.js +4 -4
  51. package/dist/data-app-sdk-adapters/index.js +2 -2
  52. package/dist/data-app-sdk-validation/index.js +5 -5
  53. package/dist/format-utils/index.js +174 -167
  54. package/dist/index.js +189 -187
  55. package/dist/pdf-export-policy/index.js +80 -28
  56. package/dist/pdf-table-layout/index.js +65 -65
  57. package/dist/report-runtime-context/index.js +1 -1
  58. package/dist/style.css +1 -1
  59. package/dist/surfboard/index.js +2 -2
  60. package/dist/types/briefings/attachment-outcomes.d.ts +1 -1
  61. package/dist/types/components/dashboard-variables/data-variables-menu.d.ts +8 -0
  62. package/dist/types/components/dashboard-variables/variable-editor-host.d.ts +1 -0
  63. package/dist/types/components/index.d.ts +2 -0
  64. package/dist/types/index.js +5 -5
  65. package/dist/types/lib/dashboard-inputs/build-normalized-dashboard-inputs.d.ts +62 -0
  66. package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-authoring.d.ts +33 -2
  67. package/dist/types/lib/dashboard-inputs/filter-settings.d.ts +7 -2
  68. package/dist/types/lib/dashboard-inputs/prepare-loaded-dashboard.d.ts +4 -2
  69. package/dist/types/lib/dashboard-variables/data-text.d.ts +33 -0
  70. package/dist/types/lib/dashboard-variables/types.d.ts +207 -0
  71. package/dist/types/lib/document/document-edits.d.ts +16 -1
  72. package/dist/types/lib/document/document-panel-target.d.ts +1 -1
  73. package/dist/types/lib/document/document-section-query-options.d.ts +29 -0
  74. package/dist/types/lib/document/document-table-data-policy.d.ts +0 -1
  75. package/dist/types/lib/hooks/use-dashboard-frame-query.d.ts +92 -0
  76. package/dist/types/lib/query-context/build-card-query-context.d.ts +6 -0
  77. package/dist/types/lib/query-context/describe-card-execution-snapshot.d.ts +1 -0
  78. package/dist/types/lib/query-context/use-semantic-execution-payload-for-cards.d.ts +24 -0
  79. package/dist/types/lib/stores/dashboard-store.d.ts +36 -0
  80. package/dist/types/lib/text-variables/temporal-input-text.d.ts +28 -0
  81. package/dist/types/lib/text-variables/text-variable-types.d.ts +72 -0
  82. package/dist/types/lib/types/common-types.d.ts +155 -51
  83. package/dist/types/lib/utils/card-definition.d.ts +2 -2
  84. package/dist/types/shared/assistant-context/index.d.ts +1 -1
  85. package/dist/types/shared/assistant-context/saved-dashboard-context.d.ts +51 -1
  86. package/dist/types/shared/dashboard-authoring/card-query-request.d.ts +7 -1
  87. package/dist/types/shared/dashboard-authoring/card-settings/resolve-card-highlights.d.ts +10 -0
  88. package/dist/types/shared/dashboard-authoring/changes/card-query-part.d.ts +1 -0
  89. package/dist/types/shared/dashboard-authoring/changes/dashboard-change.d.ts +1087 -430
  90. package/dist/types/shared/dashboard-authoring/changes/diagnostics.d.ts +18 -1
  91. package/dist/types/shared/dashboard-authoring/changes/resolve-dashboard-changes.d.ts +1 -1
  92. package/dist/types/shared/dashboard-authoring/conditional-formatting/kpi.d.ts +10 -0
  93. package/dist/types/shared/dashboard-authoring/conditional-formatting/schema.d.ts +40 -40
  94. package/dist/types/shared/dashboard-authoring/control-execution-contract.d.ts +16 -16
  95. package/dist/types/shared/dashboard-authoring/dashboard-card-source-index.d.ts +1 -0
  96. package/dist/types/shared/dashboard-authoring/dashboard-filter-targets.d.ts +29 -0
  97. package/dist/types/shared/dashboard-authoring/dashboard-input-scope.d.ts +7 -4
  98. package/dist/types/shared/dashboard-authoring/dashboard-variable-card.d.ts +159 -0
  99. package/dist/types/shared/dashboard-authoring/dashboard-variable-changes.d.ts +61 -0
  100. package/dist/types/shared/dashboard-authoring/document-section-cards.d.ts +7 -0
  101. package/dist/types/shared/dashboard-authoring/filter-model/index.d.ts +2 -0
  102. package/dist/types/shared/dashboard-authoring/filter-model/read-dashboard-filter-model.d.ts +10 -0
  103. package/dist/types/shared/dashboard-authoring/index.d.ts +6 -0
  104. package/dist/types/shared/dashboard-authoring/measure-calculations/comparison.d.ts +2 -0
  105. package/dist/types/shared/dashboard-authoring/operations/operation-sentences.d.ts +1 -1
  106. package/dist/types/shared/dashboard-authoring/operations/operation-types.d.ts +50 -3
  107. package/dist/types/shared/dashboard-authoring/outline/outline-dashboard.d.ts +48 -1
  108. package/dist/types/shared/dashboard-authoring/outline/outline-filters.d.ts +2 -2
  109. package/dist/types/shared/dashboard-authoring/text-card-words/blocks.d.ts +87 -13
  110. package/dist/types/shared/dashboard-authoring/text-card-words/chip-colors.d.ts +23 -0
  111. package/dist/types/shared/dashboard-authoring/text-card-words/index.d.ts +90 -8
  112. package/dist/types/shared/dashboard-authoring/text-card-words/rich-content.d.ts +31 -3
  113. package/dist/types/shared/dashboard-authoring/text-card-words/variable-words.d.ts +8 -0
  114. package/dist/types/shared/dashboard-authoring/variable-draft.d.ts +125 -0
  115. package/dist/types/shared/dashboard-authoring/variable-editability.d.ts +24 -0
  116. package/dist/types/shared/dashboard-authoring/variable-references.d.ts +39 -0
  117. package/dist/types/shared/format-utils/document-print.d.ts +4 -2
  118. package/dist/types/shared/format-utils/index.d.ts +1 -0
  119. package/dist/types/shared/format-utils/pdf-capacity-lines.d.ts +17 -0
  120. package/dist/types/shared/format-utils/pdf-delivery.d.ts +8 -1
  121. package/dist/types/shared/format-utils/pdf-export-policy.d.ts +74 -6
  122. package/dist/types/shared/format-utils/presentation-execution.d.ts +9 -0
  123. package/package.json +2 -2
  124. package/src/data-app-sdk/README.md +3 -3
  125. package/dist/chunks/bookmark-state-CWeoGbrx.js +0 -743
  126. package/dist/chunks/braces-DzgoQC64.js +0 -23
  127. package/dist/chunks/dashboard-briefing-launcher-lvYfJoUQ.js +0 -3878
  128. package/dist/chunks/filter-reach-copy-Cmb05jlE.js +0 -3965
  129. package/dist/chunks/global-date-filter-utils-ruJYwjgZ.js +0 -16733
  130. package/dist/chunks/resolve-dashboard-input-context-i_jCSYae.js +0 -8214
  131. package/dist/chunks/saved-dashboard-context-Dg3oDmH_.js +0 -564
  132. package/dist/chunks/use-create-flow-overlay-state-Dl6DCxh8.js +0 -1436
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { fieldRefSchema } from './field-ref.js';
3
+ import { TextRun } from '../text-card-words/blocks.js';
3
4
  export { fieldRefSchema };
4
5
  export declare const AGGREGATES: readonly ["SUM", "COUNT", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"];
5
6
  /** A measure, optionally with an aggregate; `__count` counts rows. */
@@ -4221,6 +4222,211 @@ export declare const matrixColumnsSchema: z.ZodObject<{
4221
4222
  })[];
4222
4223
  }>;
4223
4224
  export declare const handleSchema: z.ZodString;
4225
+ declare const variablePresentationSchema: z.ZodObject<{
4226
+ decimals: z.ZodOptional<z.ZodNumber>;
4227
+ temporal: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
4228
+ mode: z.ZodLiteral<"style">;
4229
+ dateStyle: z.ZodEnum<["short", "medium", "long"]>;
4230
+ }, "strict", z.ZodTypeAny, {
4231
+ mode: "style";
4232
+ dateStyle: "short" | "long" | "medium";
4233
+ }, {
4234
+ mode: "style";
4235
+ dateStyle: "short" | "long" | "medium";
4236
+ }>, z.ZodObject<{
4237
+ mode: z.ZodLiteral<"pattern">;
4238
+ dialect: z.ZodLiteral<"semaphor_tokens">;
4239
+ pattern: z.ZodString;
4240
+ }, "strict", z.ZodTypeAny, {
4241
+ pattern: string;
4242
+ dialect: "semaphor_tokens";
4243
+ mode: "pattern";
4244
+ }, {
4245
+ pattern: string;
4246
+ dialect: "semaphor_tokens";
4247
+ mode: "pattern";
4248
+ }>, z.ZodObject<{
4249
+ mode: z.ZodLiteral<"period_label">;
4250
+ }, "strict", z.ZodTypeAny, {
4251
+ mode: "period_label";
4252
+ }, {
4253
+ mode: "period_label";
4254
+ }>]>>;
4255
+ units: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
4256
+ signWords: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
4257
+ absolute: z.ZodOptional<z.ZodBoolean>;
4258
+ percent: z.ZodOptional<z.ZodBoolean>;
4259
+ }, "strict", z.ZodTypeAny, {
4260
+ percent?: boolean | undefined;
4261
+ decimals?: number | undefined;
4262
+ absolute?: boolean | undefined;
4263
+ signWords?: [string, string, string] | undefined;
4264
+ temporal?: {
4265
+ mode: "style";
4266
+ dateStyle: "short" | "long" | "medium";
4267
+ } | {
4268
+ pattern: string;
4269
+ dialect: "semaphor_tokens";
4270
+ mode: "pattern";
4271
+ } | {
4272
+ mode: "period_label";
4273
+ } | undefined;
4274
+ units?: [string, string] | undefined;
4275
+ }, {
4276
+ percent?: boolean | undefined;
4277
+ decimals?: number | undefined;
4278
+ absolute?: boolean | undefined;
4279
+ signWords?: [string, string, string] | undefined;
4280
+ temporal?: {
4281
+ mode: "style";
4282
+ dateStyle: "short" | "long" | "medium";
4283
+ } | {
4284
+ pattern: string;
4285
+ dialect: "semaphor_tokens";
4286
+ mode: "pattern";
4287
+ } | {
4288
+ mode: "period_label";
4289
+ } | undefined;
4290
+ units?: [string, string] | undefined;
4291
+ }>;
4292
+ /**
4293
+ * A chip's colours (data variables DV-D23, P3b-08): the highlight words card
4294
+ * highlights use, comparison operators only, each a text and background
4295
+ * colour when its condition holds on the chip's value.
4296
+ */
4297
+ declare const chipColorSchema: z.ZodObject<{
4298
+ when: z.ZodObject<{
4299
+ operator: z.ZodEnum<["=", "!=", ">", ">=", "<", "<="]>;
4300
+ value: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
4301
+ }, "strict", z.ZodTypeAny, {
4302
+ value: string | number;
4303
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4304
+ }, {
4305
+ value: string | number;
4306
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4307
+ }>;
4308
+ color: z.ZodString;
4309
+ }, "strict", z.ZodTypeAny, {
4310
+ when: {
4311
+ value: string | number;
4312
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4313
+ };
4314
+ color: string;
4315
+ }, {
4316
+ when: {
4317
+ value: string | number;
4318
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4319
+ };
4320
+ color: string;
4321
+ }>;
4322
+ /** A variable run's presentation: the chip's, its colour rules in highlight words. */
4323
+ declare const runPresentationSchema: z.ZodObject<{
4324
+ decimals: z.ZodOptional<z.ZodNumber>;
4325
+ temporal: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
4326
+ mode: z.ZodLiteral<"style">;
4327
+ dateStyle: z.ZodEnum<["short", "medium", "long"]>;
4328
+ }, "strict", z.ZodTypeAny, {
4329
+ mode: "style";
4330
+ dateStyle: "short" | "long" | "medium";
4331
+ }, {
4332
+ mode: "style";
4333
+ dateStyle: "short" | "long" | "medium";
4334
+ }>, z.ZodObject<{
4335
+ mode: z.ZodLiteral<"pattern">;
4336
+ dialect: z.ZodLiteral<"semaphor_tokens">;
4337
+ pattern: z.ZodString;
4338
+ }, "strict", z.ZodTypeAny, {
4339
+ pattern: string;
4340
+ dialect: "semaphor_tokens";
4341
+ mode: "pattern";
4342
+ }, {
4343
+ pattern: string;
4344
+ dialect: "semaphor_tokens";
4345
+ mode: "pattern";
4346
+ }>, z.ZodObject<{
4347
+ mode: z.ZodLiteral<"period_label">;
4348
+ }, "strict", z.ZodTypeAny, {
4349
+ mode: "period_label";
4350
+ }, {
4351
+ mode: "period_label";
4352
+ }>]>>;
4353
+ units: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
4354
+ signWords: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
4355
+ absolute: z.ZodOptional<z.ZodBoolean>;
4356
+ percent: z.ZodOptional<z.ZodBoolean>;
4357
+ } & {
4358
+ colors: z.ZodOptional<z.ZodArray<z.ZodObject<{
4359
+ when: z.ZodObject<{
4360
+ operator: z.ZodEnum<["=", "!=", ">", ">=", "<", "<="]>;
4361
+ value: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
4362
+ }, "strict", z.ZodTypeAny, {
4363
+ value: string | number;
4364
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4365
+ }, {
4366
+ value: string | number;
4367
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4368
+ }>;
4369
+ color: z.ZodString;
4370
+ }, "strict", z.ZodTypeAny, {
4371
+ when: {
4372
+ value: string | number;
4373
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4374
+ };
4375
+ color: string;
4376
+ }, {
4377
+ when: {
4378
+ value: string | number;
4379
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4380
+ };
4381
+ color: string;
4382
+ }>, "many">>;
4383
+ }, "strict", z.ZodTypeAny, {
4384
+ percent?: boolean | undefined;
4385
+ decimals?: number | undefined;
4386
+ absolute?: boolean | undefined;
4387
+ colors?: {
4388
+ when: {
4389
+ value: string | number;
4390
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4391
+ };
4392
+ color: string;
4393
+ }[] | undefined;
4394
+ signWords?: [string, string, string] | undefined;
4395
+ temporal?: {
4396
+ mode: "style";
4397
+ dateStyle: "short" | "long" | "medium";
4398
+ } | {
4399
+ pattern: string;
4400
+ dialect: "semaphor_tokens";
4401
+ mode: "pattern";
4402
+ } | {
4403
+ mode: "period_label";
4404
+ } | undefined;
4405
+ units?: [string, string] | undefined;
4406
+ }, {
4407
+ percent?: boolean | undefined;
4408
+ decimals?: number | undefined;
4409
+ absolute?: boolean | undefined;
4410
+ colors?: {
4411
+ when: {
4412
+ value: string | number;
4413
+ operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
4414
+ };
4415
+ color: string;
4416
+ }[] | undefined;
4417
+ signWords?: [string, string, string] | undefined;
4418
+ temporal?: {
4419
+ mode: "style";
4420
+ dateStyle: "short" | "long" | "medium";
4421
+ } | {
4422
+ pattern: string;
4423
+ dialect: "semaphor_tokens";
4424
+ mode: "pattern";
4425
+ } | {
4426
+ mode: "period_label";
4427
+ } | undefined;
4428
+ units?: [string, string] | undefined;
4429
+ }>;
4224
4430
  declare const filterValueSchema: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>;
4225
4431
  /**
4226
4432
  * How a column reads and shows (card appearance SPEC 3.1), keyed by the
@@ -4239,35 +4445,604 @@ export declare const columnSettingsInputSchema: z.ZodObject<{
4239
4445
  role: z.ZodOptional<z.ZodString>;
4240
4446
  inherits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4241
4447
  }, "strict", z.ZodTypeAny, {
4242
- label?: string | null | undefined;
4243
- role?: string | undefined;
4244
- field?: string | undefined;
4245
- format?: Record<string, unknown> | null | undefined;
4246
- polarity?: "higher_is_better" | "lower_is_better" | "neutral" | null | undefined;
4247
- width?: number | null | undefined;
4248
- hidden?: boolean | undefined;
4249
- inherits?: string[] | undefined;
4448
+ label?: string | null | undefined;
4449
+ role?: string | undefined;
4450
+ field?: string | undefined;
4451
+ format?: Record<string, unknown> | null | undefined;
4452
+ polarity?: "higher_is_better" | "lower_is_better" | "neutral" | null | undefined;
4453
+ hidden?: boolean | undefined;
4454
+ width?: number | null | undefined;
4455
+ inherits?: string[] | undefined;
4456
+ }, {
4457
+ label?: string | null | undefined;
4458
+ role?: string | undefined;
4459
+ field?: string | undefined;
4460
+ format?: Record<string, unknown> | null | undefined;
4461
+ polarity?: "higher_is_better" | "lower_is_better" | "neutral" | null | undefined;
4462
+ hidden?: boolean | undefined;
4463
+ width?: number | null | undefined;
4464
+ inherits?: string[] | undefined;
4465
+ }>;
4466
+ /**
4467
+ * The stored format's fields in words, by kind of format. The definition's `columns` summary and a
4468
+ * refused format's fix say the same: on a dashboard whose columns inherit their formats the outline
4469
+ * shows none to copy, and agents without these words guessed `decimals` and `style` (card
4470
+ * appearance ledger P0-02, P5-03, P5-05).
4471
+ */
4472
+ export declare const FORMAT_WORDS: {
4473
+ readonly number: "{ type: 'number' | 'currency' | 'percent', currency?: 'USD' (on a currency), minimumFractionDigits?, maximumFractionDigits?, compact?: true (1.2K), percentValueMode: 'fraction' (0.1 is 10%) | 'whole' (on a percent) }";
4474
+ readonly temporal_bucket: "{ type: 'temporal_bucket', presentation: { mode: 'preset', preset: 'short' | 'long' | 'numeric' | 'iso' } or { mode: 'pattern', pattern: 'MMM YYYY' } }";
4475
+ readonly date: "{ type: 'date', preset?: 'short' | 'long' | 'numeric' | 'iso', pattern? }";
4476
+ };
4477
+ declare const variableMetricQuerySchema: z.ZodObject<{
4478
+ domainId: z.ZodString;
4479
+ datasetName: z.ZodString;
4480
+ measures: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4481
+ aggregate: z.ZodOptional<z.ZodEnum<["SUM", "COUNT", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
4482
+ comparison: z.ZodOptional<z.ZodType<{
4483
+ kind: "previous_period";
4484
+ toDate?: boolean | undefined;
4485
+ alignment?: "calendar" | "weekday" | undefined;
4486
+ offsetPeriods?: number | undefined;
4487
+ } | {
4488
+ kind: "previous_year";
4489
+ toDate?: boolean | undefined;
4490
+ alignment?: "calendar" | "weekday" | undefined;
4491
+ offsetYears?: number | undefined;
4492
+ } | {
4493
+ kind: "target";
4494
+ targetValue: number;
4495
+ } | {
4496
+ kind: "inherit";
4497
+ } | {
4498
+ kind: "off";
4499
+ }, z.ZodTypeDef, {
4500
+ kind: "previous_period";
4501
+ toDate?: boolean | undefined;
4502
+ alignment?: "calendar" | "weekday" | undefined;
4503
+ offsetPeriods?: number | undefined;
4504
+ } | {
4505
+ kind: "previous_year";
4506
+ toDate?: boolean | undefined;
4507
+ alignment?: "calendar" | "weekday" | undefined;
4508
+ offsetYears?: number | undefined;
4509
+ } | {
4510
+ kind: "target";
4511
+ targetValue: number;
4512
+ } | {
4513
+ kind: "inherit";
4514
+ } | {
4515
+ kind: "off";
4516
+ }>>;
4517
+ name: z.ZodString;
4518
+ label: z.ZodOptional<z.ZodString>;
4519
+ datasetName: z.ZodOptional<z.ZodString>;
4520
+ datasetId: z.ZodOptional<z.ZodString>;
4521
+ connectionId: z.ZodOptional<z.ZodString>;
4522
+ source: z.ZodOptional<z.ZodObject<{
4523
+ kind: z.ZodLiteral<"semantic">;
4524
+ domainId: z.ZodString;
4525
+ datasetName: z.ZodString;
4526
+ datasetId: z.ZodOptional<z.ZodString>;
4527
+ connectionId: z.ZodOptional<z.ZodString>;
4528
+ }, "strict", z.ZodTypeAny, {
4529
+ kind: "semantic";
4530
+ domainId: string;
4531
+ datasetName: string;
4532
+ datasetId?: string | undefined;
4533
+ connectionId?: string | undefined;
4534
+ }, {
4535
+ kind: "semantic";
4536
+ domainId: string;
4537
+ datasetName: string;
4538
+ datasetId?: string | undefined;
4539
+ connectionId?: string | undefined;
4540
+ }>>;
4541
+ }, "strict", z.ZodTypeAny, {
4542
+ name: string;
4543
+ datasetName?: string | undefined;
4544
+ datasetId?: string | undefined;
4545
+ label?: string | undefined;
4546
+ connectionId?: string | undefined;
4547
+ source?: {
4548
+ kind: "semantic";
4549
+ domainId: string;
4550
+ datasetName: string;
4551
+ datasetId?: string | undefined;
4552
+ connectionId?: string | undefined;
4553
+ } | undefined;
4554
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4555
+ comparison?: {
4556
+ kind: "previous_period";
4557
+ toDate?: boolean | undefined;
4558
+ alignment?: "calendar" | "weekday" | undefined;
4559
+ offsetPeriods?: number | undefined;
4560
+ } | {
4561
+ kind: "previous_year";
4562
+ toDate?: boolean | undefined;
4563
+ alignment?: "calendar" | "weekday" | undefined;
4564
+ offsetYears?: number | undefined;
4565
+ } | {
4566
+ kind: "target";
4567
+ targetValue: number;
4568
+ } | {
4569
+ kind: "inherit";
4570
+ } | {
4571
+ kind: "off";
4572
+ } | undefined;
4573
+ }, {
4574
+ name: string;
4575
+ datasetName?: string | undefined;
4576
+ datasetId?: string | undefined;
4577
+ label?: string | undefined;
4578
+ connectionId?: string | undefined;
4579
+ source?: {
4580
+ kind: "semantic";
4581
+ domainId: string;
4582
+ datasetName: string;
4583
+ datasetId?: string | undefined;
4584
+ connectionId?: string | undefined;
4585
+ } | undefined;
4586
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4587
+ comparison?: {
4588
+ kind: "previous_period";
4589
+ toDate?: boolean | undefined;
4590
+ alignment?: "calendar" | "weekday" | undefined;
4591
+ offsetPeriods?: number | undefined;
4592
+ } | {
4593
+ kind: "previous_year";
4594
+ toDate?: boolean | undefined;
4595
+ alignment?: "calendar" | "weekday" | undefined;
4596
+ offsetYears?: number | undefined;
4597
+ } | {
4598
+ kind: "target";
4599
+ targetValue: number;
4600
+ } | {
4601
+ kind: "inherit";
4602
+ } | {
4603
+ kind: "off";
4604
+ } | undefined;
4605
+ }>]>, "many">>;
4606
+ dimensions: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4607
+ name: z.ZodString;
4608
+ label: z.ZodOptional<z.ZodString>;
4609
+ datasetName: z.ZodOptional<z.ZodString>;
4610
+ datasetId: z.ZodOptional<z.ZodString>;
4611
+ connectionId: z.ZodOptional<z.ZodString>;
4612
+ source: z.ZodOptional<z.ZodObject<{
4613
+ kind: z.ZodLiteral<"semantic">;
4614
+ domainId: z.ZodString;
4615
+ datasetName: z.ZodString;
4616
+ datasetId: z.ZodOptional<z.ZodString>;
4617
+ connectionId: z.ZodOptional<z.ZodString>;
4618
+ }, "strict", z.ZodTypeAny, {
4619
+ kind: "semantic";
4620
+ domainId: string;
4621
+ datasetName: string;
4622
+ datasetId?: string | undefined;
4623
+ connectionId?: string | undefined;
4624
+ }, {
4625
+ kind: "semantic";
4626
+ domainId: string;
4627
+ datasetName: string;
4628
+ datasetId?: string | undefined;
4629
+ connectionId?: string | undefined;
4630
+ }>>;
4631
+ }, "strict", z.ZodTypeAny, {
4632
+ name: string;
4633
+ datasetName?: string | undefined;
4634
+ datasetId?: string | undefined;
4635
+ label?: string | undefined;
4636
+ connectionId?: string | undefined;
4637
+ source?: {
4638
+ kind: "semantic";
4639
+ domainId: string;
4640
+ datasetName: string;
4641
+ datasetId?: string | undefined;
4642
+ connectionId?: string | undefined;
4643
+ } | undefined;
4644
+ }, {
4645
+ name: string;
4646
+ datasetName?: string | undefined;
4647
+ datasetId?: string | undefined;
4648
+ label?: string | undefined;
4649
+ connectionId?: string | undefined;
4650
+ source?: {
4651
+ kind: "semantic";
4652
+ domainId: string;
4653
+ datasetName: string;
4654
+ datasetId?: string | undefined;
4655
+ connectionId?: string | undefined;
4656
+ } | undefined;
4657
+ }>]>, "many">>;
4658
+ filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
4659
+ id: z.ZodOptional<z.ZodString>;
4660
+ field: z.ZodUnion<[z.ZodString, z.ZodObject<{
4661
+ aggregate: z.ZodOptional<z.ZodEnum<["SUM", "COUNT", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
4662
+ name: z.ZodString;
4663
+ label: z.ZodOptional<z.ZodString>;
4664
+ datasetName: z.ZodOptional<z.ZodString>;
4665
+ datasetId: z.ZodOptional<z.ZodString>;
4666
+ connectionId: z.ZodOptional<z.ZodString>;
4667
+ source: z.ZodOptional<z.ZodObject<{
4668
+ kind: z.ZodLiteral<"semantic">;
4669
+ domainId: z.ZodString;
4670
+ datasetName: z.ZodString;
4671
+ datasetId: z.ZodOptional<z.ZodString>;
4672
+ connectionId: z.ZodOptional<z.ZodString>;
4673
+ }, "strict", z.ZodTypeAny, {
4674
+ kind: "semantic";
4675
+ domainId: string;
4676
+ datasetName: string;
4677
+ datasetId?: string | undefined;
4678
+ connectionId?: string | undefined;
4679
+ }, {
4680
+ kind: "semantic";
4681
+ domainId: string;
4682
+ datasetName: string;
4683
+ datasetId?: string | undefined;
4684
+ connectionId?: string | undefined;
4685
+ }>>;
4686
+ }, "strict", z.ZodTypeAny, {
4687
+ name: string;
4688
+ datasetName?: string | undefined;
4689
+ datasetId?: string | undefined;
4690
+ label?: string | undefined;
4691
+ connectionId?: string | undefined;
4692
+ source?: {
4693
+ kind: "semantic";
4694
+ domainId: string;
4695
+ datasetName: string;
4696
+ datasetId?: string | undefined;
4697
+ connectionId?: string | undefined;
4698
+ } | undefined;
4699
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4700
+ }, {
4701
+ name: string;
4702
+ datasetName?: string | undefined;
4703
+ datasetId?: string | undefined;
4704
+ label?: string | undefined;
4705
+ connectionId?: string | undefined;
4706
+ source?: {
4707
+ kind: "semantic";
4708
+ domainId: string;
4709
+ datasetName: string;
4710
+ datasetId?: string | undefined;
4711
+ connectionId?: string | undefined;
4712
+ } | undefined;
4713
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4714
+ }>]>;
4715
+ operator: z.ZodEnum<["=", "!=", "in", "not_in", "contains", "not_contains", "between", "not_between", ">", ">=", "<", "<=", "is_null", "is_not_null"]>;
4716
+ values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">>;
4717
+ /** "aggregate" filters a measure after aggregation (HAVING). */
4718
+ scope: z.ZodOptional<z.ZodEnum<["row", "aggregate"]>>;
4719
+ }, "strict", z.ZodTypeAny, {
4720
+ field: string | {
4721
+ name: string;
4722
+ datasetName?: string | undefined;
4723
+ datasetId?: string | undefined;
4724
+ label?: string | undefined;
4725
+ connectionId?: string | undefined;
4726
+ source?: {
4727
+ kind: "semantic";
4728
+ domainId: string;
4729
+ datasetName: string;
4730
+ datasetId?: string | undefined;
4731
+ connectionId?: string | undefined;
4732
+ } | undefined;
4733
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4734
+ };
4735
+ operator: "between" | "=" | "!=" | ">" | ">=" | "<" | "<=" | "contains" | "in" | "not_in" | "not_contains" | "not_between" | "is_null" | "is_not_null";
4736
+ values?: (string | number | boolean)[] | undefined;
4737
+ id?: string | undefined;
4738
+ scope?: "aggregate" | "row" | undefined;
4739
+ }, {
4740
+ field: string | {
4741
+ name: string;
4742
+ datasetName?: string | undefined;
4743
+ datasetId?: string | undefined;
4744
+ label?: string | undefined;
4745
+ connectionId?: string | undefined;
4746
+ source?: {
4747
+ kind: "semantic";
4748
+ domainId: string;
4749
+ datasetName: string;
4750
+ datasetId?: string | undefined;
4751
+ connectionId?: string | undefined;
4752
+ } | undefined;
4753
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4754
+ };
4755
+ operator: "between" | "=" | "!=" | ">" | ">=" | "<" | "<=" | "contains" | "in" | "not_in" | "not_contains" | "not_between" | "is_null" | "is_not_null";
4756
+ values?: (string | number | boolean)[] | undefined;
4757
+ id?: string | undefined;
4758
+ scope?: "aggregate" | "row" | undefined;
4759
+ }>, "many">>;
4760
+ orderBy: z.ZodOptional<z.ZodObject<{
4761
+ field: z.ZodUnion<[z.ZodString, z.ZodObject<{
4762
+ aggregate: z.ZodOptional<z.ZodEnum<["SUM", "COUNT", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
4763
+ name: z.ZodString;
4764
+ label: z.ZodOptional<z.ZodString>;
4765
+ datasetName: z.ZodOptional<z.ZodString>;
4766
+ datasetId: z.ZodOptional<z.ZodString>;
4767
+ connectionId: z.ZodOptional<z.ZodString>;
4768
+ source: z.ZodOptional<z.ZodObject<{
4769
+ kind: z.ZodLiteral<"semantic">;
4770
+ domainId: z.ZodString;
4771
+ datasetName: z.ZodString;
4772
+ datasetId: z.ZodOptional<z.ZodString>;
4773
+ connectionId: z.ZodOptional<z.ZodString>;
4774
+ }, "strict", z.ZodTypeAny, {
4775
+ kind: "semantic";
4776
+ domainId: string;
4777
+ datasetName: string;
4778
+ datasetId?: string | undefined;
4779
+ connectionId?: string | undefined;
4780
+ }, {
4781
+ kind: "semantic";
4782
+ domainId: string;
4783
+ datasetName: string;
4784
+ datasetId?: string | undefined;
4785
+ connectionId?: string | undefined;
4786
+ }>>;
4787
+ }, "strict", z.ZodTypeAny, {
4788
+ name: string;
4789
+ datasetName?: string | undefined;
4790
+ datasetId?: string | undefined;
4791
+ label?: string | undefined;
4792
+ connectionId?: string | undefined;
4793
+ source?: {
4794
+ kind: "semantic";
4795
+ domainId: string;
4796
+ datasetName: string;
4797
+ datasetId?: string | undefined;
4798
+ connectionId?: string | undefined;
4799
+ } | undefined;
4800
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4801
+ }, {
4802
+ name: string;
4803
+ datasetName?: string | undefined;
4804
+ datasetId?: string | undefined;
4805
+ label?: string | undefined;
4806
+ connectionId?: string | undefined;
4807
+ source?: {
4808
+ kind: "semantic";
4809
+ domainId: string;
4810
+ datasetName: string;
4811
+ datasetId?: string | undefined;
4812
+ connectionId?: string | undefined;
4813
+ } | undefined;
4814
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4815
+ }>]>;
4816
+ direction: z.ZodEnum<["asc", "desc"]>;
4817
+ }, "strict", z.ZodTypeAny, {
4818
+ field: string | {
4819
+ name: string;
4820
+ datasetName?: string | undefined;
4821
+ datasetId?: string | undefined;
4822
+ label?: string | undefined;
4823
+ connectionId?: string | undefined;
4824
+ source?: {
4825
+ kind: "semantic";
4826
+ domainId: string;
4827
+ datasetName: string;
4828
+ datasetId?: string | undefined;
4829
+ connectionId?: string | undefined;
4830
+ } | undefined;
4831
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4832
+ };
4833
+ direction: "asc" | "desc";
4834
+ }, {
4835
+ field: string | {
4836
+ name: string;
4837
+ datasetName?: string | undefined;
4838
+ datasetId?: string | undefined;
4839
+ label?: string | undefined;
4840
+ connectionId?: string | undefined;
4841
+ source?: {
4842
+ kind: "semantic";
4843
+ domainId: string;
4844
+ datasetName: string;
4845
+ datasetId?: string | undefined;
4846
+ connectionId?: string | undefined;
4847
+ } | undefined;
4848
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4849
+ };
4850
+ direction: "asc" | "desc";
4851
+ }>>;
4852
+ }, "strict", z.ZodTypeAny, {
4853
+ domainId: string;
4854
+ datasetName: string;
4855
+ measures?: (string | {
4856
+ name: string;
4857
+ datasetName?: string | undefined;
4858
+ datasetId?: string | undefined;
4859
+ label?: string | undefined;
4860
+ connectionId?: string | undefined;
4861
+ source?: {
4862
+ kind: "semantic";
4863
+ domainId: string;
4864
+ datasetName: string;
4865
+ datasetId?: string | undefined;
4866
+ connectionId?: string | undefined;
4867
+ } | undefined;
4868
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4869
+ comparison?: {
4870
+ kind: "previous_period";
4871
+ toDate?: boolean | undefined;
4872
+ alignment?: "calendar" | "weekday" | undefined;
4873
+ offsetPeriods?: number | undefined;
4874
+ } | {
4875
+ kind: "previous_year";
4876
+ toDate?: boolean | undefined;
4877
+ alignment?: "calendar" | "weekday" | undefined;
4878
+ offsetYears?: number | undefined;
4879
+ } | {
4880
+ kind: "target";
4881
+ targetValue: number;
4882
+ } | {
4883
+ kind: "inherit";
4884
+ } | {
4885
+ kind: "off";
4886
+ } | undefined;
4887
+ })[] | undefined;
4888
+ filters?: {
4889
+ field: string | {
4890
+ name: string;
4891
+ datasetName?: string | undefined;
4892
+ datasetId?: string | undefined;
4893
+ label?: string | undefined;
4894
+ connectionId?: string | undefined;
4895
+ source?: {
4896
+ kind: "semantic";
4897
+ domainId: string;
4898
+ datasetName: string;
4899
+ datasetId?: string | undefined;
4900
+ connectionId?: string | undefined;
4901
+ } | undefined;
4902
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4903
+ };
4904
+ operator: "between" | "=" | "!=" | ">" | ">=" | "<" | "<=" | "contains" | "in" | "not_in" | "not_contains" | "not_between" | "is_null" | "is_not_null";
4905
+ values?: (string | number | boolean)[] | undefined;
4906
+ id?: string | undefined;
4907
+ scope?: "aggregate" | "row" | undefined;
4908
+ }[] | undefined;
4909
+ orderBy?: {
4910
+ field: string | {
4911
+ name: string;
4912
+ datasetName?: string | undefined;
4913
+ datasetId?: string | undefined;
4914
+ label?: string | undefined;
4915
+ connectionId?: string | undefined;
4916
+ source?: {
4917
+ kind: "semantic";
4918
+ domainId: string;
4919
+ datasetName: string;
4920
+ datasetId?: string | undefined;
4921
+ connectionId?: string | undefined;
4922
+ } | undefined;
4923
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4924
+ };
4925
+ direction: "asc" | "desc";
4926
+ } | undefined;
4927
+ dimensions?: (string | {
4928
+ name: string;
4929
+ datasetName?: string | undefined;
4930
+ datasetId?: string | undefined;
4931
+ label?: string | undefined;
4932
+ connectionId?: string | undefined;
4933
+ source?: {
4934
+ kind: "semantic";
4935
+ domainId: string;
4936
+ datasetName: string;
4937
+ datasetId?: string | undefined;
4938
+ connectionId?: string | undefined;
4939
+ } | undefined;
4940
+ })[] | undefined;
4941
+ }, {
4942
+ domainId: string;
4943
+ datasetName: string;
4944
+ measures?: (string | {
4945
+ name: string;
4946
+ datasetName?: string | undefined;
4947
+ datasetId?: string | undefined;
4948
+ label?: string | undefined;
4949
+ connectionId?: string | undefined;
4950
+ source?: {
4951
+ kind: "semantic";
4952
+ domainId: string;
4953
+ datasetName: string;
4954
+ datasetId?: string | undefined;
4955
+ connectionId?: string | undefined;
4956
+ } | undefined;
4957
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4958
+ comparison?: {
4959
+ kind: "previous_period";
4960
+ toDate?: boolean | undefined;
4961
+ alignment?: "calendar" | "weekday" | undefined;
4962
+ offsetPeriods?: number | undefined;
4963
+ } | {
4964
+ kind: "previous_year";
4965
+ toDate?: boolean | undefined;
4966
+ alignment?: "calendar" | "weekday" | undefined;
4967
+ offsetYears?: number | undefined;
4968
+ } | {
4969
+ kind: "target";
4970
+ targetValue: number;
4971
+ } | {
4972
+ kind: "inherit";
4973
+ } | {
4974
+ kind: "off";
4975
+ } | undefined;
4976
+ })[] | undefined;
4977
+ filters?: {
4978
+ field: string | {
4979
+ name: string;
4980
+ datasetName?: string | undefined;
4981
+ datasetId?: string | undefined;
4982
+ label?: string | undefined;
4983
+ connectionId?: string | undefined;
4984
+ source?: {
4985
+ kind: "semantic";
4986
+ domainId: string;
4987
+ datasetName: string;
4988
+ datasetId?: string | undefined;
4989
+ connectionId?: string | undefined;
4990
+ } | undefined;
4991
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
4992
+ };
4993
+ operator: "between" | "=" | "!=" | ">" | ">=" | "<" | "<=" | "contains" | "in" | "not_in" | "not_contains" | "not_between" | "is_null" | "is_not_null";
4994
+ values?: (string | number | boolean)[] | undefined;
4995
+ id?: string | undefined;
4996
+ scope?: "aggregate" | "row" | undefined;
4997
+ }[] | undefined;
4998
+ orderBy?: {
4999
+ field: string | {
5000
+ name: string;
5001
+ datasetName?: string | undefined;
5002
+ datasetId?: string | undefined;
5003
+ label?: string | undefined;
5004
+ connectionId?: string | undefined;
5005
+ source?: {
5006
+ kind: "semantic";
5007
+ domainId: string;
5008
+ datasetName: string;
5009
+ datasetId?: string | undefined;
5010
+ connectionId?: string | undefined;
5011
+ } | undefined;
5012
+ aggregate?: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT" | undefined;
5013
+ };
5014
+ direction: "asc" | "desc";
5015
+ } | undefined;
5016
+ dimensions?: (string | {
5017
+ name: string;
5018
+ datasetName?: string | undefined;
5019
+ datasetId?: string | undefined;
5020
+ label?: string | undefined;
5021
+ connectionId?: string | undefined;
5022
+ source?: {
5023
+ kind: "semantic";
5024
+ domainId: string;
5025
+ datasetName: string;
5026
+ datasetId?: string | undefined;
5027
+ connectionId?: string | undefined;
5028
+ } | undefined;
5029
+ })[] | undefined;
5030
+ }>;
5031
+ export declare const VARIABLE_GETS: readonly ["only", "first", "list", "aggregate"];
5032
+ /** How the answer is taken from the rows (DV-D5): a word, or the object with a list's limit and separator. */
5033
+ declare const variableGetSchema: z.ZodUnion<[z.ZodEnum<["only", "first", "list", "aggregate"]>, z.ZodObject<{
5034
+ kind: z.ZodEnum<["only", "first", "list", "aggregate"]>;
5035
+ limit: z.ZodOptional<z.ZodNumber>;
5036
+ separator: z.ZodOptional<z.ZodString>;
5037
+ }, "strict", z.ZodTypeAny, {
5038
+ kind: "aggregate" | "first" | "only" | "list";
5039
+ limit?: number | undefined;
5040
+ separator?: string | undefined;
4250
5041
  }, {
4251
- label?: string | null | undefined;
4252
- role?: string | undefined;
4253
- field?: string | undefined;
4254
- format?: Record<string, unknown> | null | undefined;
4255
- polarity?: "higher_is_better" | "lower_is_better" | "neutral" | null | undefined;
4256
- width?: number | null | undefined;
4257
- hidden?: boolean | undefined;
4258
- inherits?: string[] | undefined;
4259
- }>;
4260
- /**
4261
- * The stored format's fields in words, by kind of format. The definition's `columns` summary and a
4262
- * refused format's fix say the same: on a dashboard whose columns inherit their formats the outline
4263
- * shows none to copy, and agents without these words guessed `decimals` and `style` (card
4264
- * appearance ledger P0-02, P5-03, P5-05).
4265
- */
4266
- export declare const FORMAT_WORDS: {
4267
- readonly number: "{ type: 'number' | 'currency' | 'percent', currency?: 'USD' (on a currency), minimumFractionDigits?, maximumFractionDigits?, compact?: true (1.2K), percentValueMode: 'fraction' (0.1 is 10%) | 'whole' (on a percent) }";
4268
- readonly temporal_bucket: "{ type: 'temporal_bucket', presentation: { mode: 'preset', preset: 'short' | 'long' | 'numeric' | 'iso' } or { mode: 'pattern', pattern: 'MMM YYYY' } }";
4269
- readonly date: "{ type: 'date', preset?: 'short' | 'long' | 'numeric' | 'iso', pattern? }";
4270
- };
5042
+ kind: "aggregate" | "first" | "only" | "list";
5043
+ limit?: number | undefined;
5044
+ separator?: string | undefined;
5045
+ }>]>;
4271
5046
  export declare const relationshipAddSchema: z.ZodObject<{
4272
5047
  op: z.ZodLiteral<"relationship.add">;
4273
5048
  from: z.ZodObject<{
@@ -4382,11 +5157,11 @@ export declare const tabChangeSchemas: readonly [z.ZodObject<{
4382
5157
  op: z.ZodLiteral<"layout.untab">;
4383
5158
  cardId: z.ZodUnion<[z.ZodString, z.ZodString]>;
4384
5159
  }, "strict", z.ZodTypeAny, {
4385
- cardId: string;
4386
5160
  op: "layout.untab";
4387
- }, {
4388
5161
  cardId: string;
5162
+ }, {
4389
5163
  op: "layout.untab";
5164
+ cardId: string;
4390
5165
  }>];
4391
5166
  export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
4392
5167
  op: z.ZodLiteral<"card.add">;
@@ -4396,130 +5171,7 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
4396
5171
  title: z.ZodString;
4397
5172
  description: z.ZodOptional<z.ZodString>;
4398
5173
  query: z.ZodOptional<z.ZodTypeAny>;
4399
- text: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
4400
- type: z.ZodLiteral<"heading">;
4401
- level: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>;
4402
- content: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4403
- text: z.ZodOptional<z.ZodString>;
4404
- variable: z.ZodOptional<z.ZodString>;
4405
- bold: z.ZodOptional<z.ZodBoolean>;
4406
- italic: z.ZodOptional<z.ZodBoolean>;
4407
- link: z.ZodOptional<z.ZodString>;
4408
- }, "strict", z.ZodTypeAny, {
4409
- bold?: boolean | undefined;
4410
- link?: string | undefined;
4411
- text?: string | undefined;
4412
- italic?: boolean | undefined;
4413
- variable?: string | undefined;
4414
- }, {
4415
- bold?: boolean | undefined;
4416
- link?: string | undefined;
4417
- text?: string | undefined;
4418
- italic?: boolean | undefined;
4419
- variable?: string | undefined;
4420
- }>]>, "many">;
4421
- }, "strict", z.ZodTypeAny, {
4422
- type: "heading";
4423
- level: 1 | 2;
4424
- content: (string | {
4425
- bold?: boolean | undefined;
4426
- link?: string | undefined;
4427
- text?: string | undefined;
4428
- italic?: boolean | undefined;
4429
- variable?: string | undefined;
4430
- })[];
4431
- }, {
4432
- type: "heading";
4433
- level: 1 | 2;
4434
- content: (string | {
4435
- bold?: boolean | undefined;
4436
- link?: string | undefined;
4437
- text?: string | undefined;
4438
- italic?: boolean | undefined;
4439
- variable?: string | undefined;
4440
- })[];
4441
- }>, z.ZodObject<{
4442
- type: z.ZodLiteral<"paragraph">;
4443
- content: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4444
- text: z.ZodOptional<z.ZodString>;
4445
- variable: z.ZodOptional<z.ZodString>;
4446
- bold: z.ZodOptional<z.ZodBoolean>;
4447
- italic: z.ZodOptional<z.ZodBoolean>;
4448
- link: z.ZodOptional<z.ZodString>;
4449
- }, "strict", z.ZodTypeAny, {
4450
- bold?: boolean | undefined;
4451
- link?: string | undefined;
4452
- text?: string | undefined;
4453
- italic?: boolean | undefined;
4454
- variable?: string | undefined;
4455
- }, {
4456
- bold?: boolean | undefined;
4457
- link?: string | undefined;
4458
- text?: string | undefined;
4459
- italic?: boolean | undefined;
4460
- variable?: string | undefined;
4461
- }>]>, "many">;
4462
- }, "strict", z.ZodTypeAny, {
4463
- type: "paragraph";
4464
- content: (string | {
4465
- bold?: boolean | undefined;
4466
- link?: string | undefined;
4467
- text?: string | undefined;
4468
- italic?: boolean | undefined;
4469
- variable?: string | undefined;
4470
- })[];
4471
- }, {
4472
- type: "paragraph";
4473
- content: (string | {
4474
- bold?: boolean | undefined;
4475
- link?: string | undefined;
4476
- text?: string | undefined;
4477
- italic?: boolean | undefined;
4478
- variable?: string | undefined;
4479
- })[];
4480
- }>, z.ZodObject<{
4481
- type: z.ZodLiteral<"list">;
4482
- style: z.ZodEnum<["bulleted", "numbered"]>;
4483
- items: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4484
- text: z.ZodOptional<z.ZodString>;
4485
- variable: z.ZodOptional<z.ZodString>;
4486
- bold: z.ZodOptional<z.ZodBoolean>;
4487
- italic: z.ZodOptional<z.ZodBoolean>;
4488
- link: z.ZodOptional<z.ZodString>;
4489
- }, "strict", z.ZodTypeAny, {
4490
- bold?: boolean | undefined;
4491
- link?: string | undefined;
4492
- text?: string | undefined;
4493
- italic?: boolean | undefined;
4494
- variable?: string | undefined;
4495
- }, {
4496
- bold?: boolean | undefined;
4497
- link?: string | undefined;
4498
- text?: string | undefined;
4499
- italic?: boolean | undefined;
4500
- variable?: string | undefined;
4501
- }>]>, "many">, "many">;
4502
- }, "strict", z.ZodTypeAny, {
4503
- type: "list";
4504
- style: "bulleted" | "numbered";
4505
- items: (string | {
4506
- bold?: boolean | undefined;
4507
- link?: string | undefined;
4508
- text?: string | undefined;
4509
- italic?: boolean | undefined;
4510
- variable?: string | undefined;
4511
- })[][];
4512
- }, {
4513
- type: "list";
4514
- style: "bulleted" | "numbered";
4515
- items: (string | {
4516
- bold?: boolean | undefined;
4517
- link?: string | undefined;
4518
- text?: string | undefined;
4519
- italic?: boolean | undefined;
4520
- variable?: string | undefined;
4521
- })[][];
4522
- }>]>, "many">>;
5174
+ text: z.ZodOptional<z.ZodTypeAny>;
4523
5175
  matrix: z.ZodOptional<z.ZodObject<{
4524
5176
  columns: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
4525
5177
  name: z.ZodString;
@@ -4617,7 +5269,7 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
4617
5269
  /** Card appearance: a card is born finished, with the settings `card.update` takes. */
4618
5270
  columns: z.ZodOptional<z.ZodTypeAny>;
4619
5271
  }, "strict", z.ZodTypeAny, {
4620
- type: "table" | "matrix" | "kpi" | "text" | "line" | "bar" | "area" | "pie" | "detail_table";
5272
+ type: "table" | "matrix" | "kpi" | "text" | "bar" | "line" | "area" | "pie" | "detail_table";
4621
5273
  title: string;
4622
5274
  op: "card.add";
4623
5275
  description?: string | undefined;
@@ -4641,42 +5293,13 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
4641
5293
  position?: "top" | "end" | {
4642
5294
  after: string;
4643
5295
  } | undefined;
4644
- text?: ({
4645
- type: "heading";
4646
- level: 1 | 2;
4647
- content: (string | {
4648
- bold?: boolean | undefined;
4649
- link?: string | undefined;
4650
- text?: string | undefined;
4651
- italic?: boolean | undefined;
4652
- variable?: string | undefined;
4653
- })[];
4654
- } | {
4655
- type: "paragraph";
4656
- content: (string | {
4657
- bold?: boolean | undefined;
4658
- link?: string | undefined;
4659
- text?: string | undefined;
4660
- italic?: boolean | undefined;
4661
- variable?: string | undefined;
4662
- })[];
4663
- } | {
4664
- type: "list";
4665
- style: "bulleted" | "numbered";
4666
- items: (string | {
4667
- bold?: boolean | undefined;
4668
- link?: string | undefined;
4669
- text?: string | undefined;
4670
- italic?: boolean | undefined;
4671
- variable?: string | undefined;
4672
- })[][];
4673
- })[] | undefined;
5296
+ text?: any;
5297
+ query?: any;
4674
5298
  width?: "quarter" | "full" | "half" | "third" | undefined;
4675
5299
  handle?: string | undefined;
4676
5300
  sheetId?: string | undefined;
4677
- query?: any;
4678
5301
  }, {
4679
- type: "table" | "matrix" | "kpi" | "text" | "line" | "bar" | "area" | "pie" | "detail_table";
5302
+ type: "table" | "matrix" | "kpi" | "text" | "bar" | "line" | "area" | "pie" | "detail_table";
4680
5303
  title: string;
4681
5304
  op: "card.add";
4682
5305
  description?: string | undefined;
@@ -4700,40 +5323,11 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
4700
5323
  position?: "top" | "end" | {
4701
5324
  after: string;
4702
5325
  } | undefined;
4703
- text?: ({
4704
- type: "heading";
4705
- level: 1 | 2;
4706
- content: (string | {
4707
- bold?: boolean | undefined;
4708
- link?: string | undefined;
4709
- text?: string | undefined;
4710
- italic?: boolean | undefined;
4711
- variable?: string | undefined;
4712
- })[];
4713
- } | {
4714
- type: "paragraph";
4715
- content: (string | {
4716
- bold?: boolean | undefined;
4717
- link?: string | undefined;
4718
- text?: string | undefined;
4719
- italic?: boolean | undefined;
4720
- variable?: string | undefined;
4721
- })[];
4722
- } | {
4723
- type: "list";
4724
- style: "bulleted" | "numbered";
4725
- items: (string | {
4726
- bold?: boolean | undefined;
4727
- link?: string | undefined;
4728
- text?: string | undefined;
4729
- italic?: boolean | undefined;
4730
- variable?: string | undefined;
4731
- })[][];
4732
- })[] | undefined;
5326
+ text?: any;
5327
+ query?: any;
4733
5328
  width?: "quarter" | "full" | "half" | "third" | undefined;
4734
5329
  handle?: string | undefined;
4735
5330
  sheetId?: string | undefined;
4736
- query?: any;
4737
5331
  }>, z.ZodObject<{
4738
5332
  op: z.ZodLiteral<"card.update">;
4739
5333
  cardId: z.ZodUnion<[z.ZodString, z.ZodString]>;
@@ -5257,130 +5851,7 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
5257
5851
  } | undefined;
5258
5852
  })[] | null | undefined;
5259
5853
  }>>;
5260
- text: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
5261
- type: z.ZodLiteral<"heading">;
5262
- level: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>;
5263
- content: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
5264
- text: z.ZodOptional<z.ZodString>;
5265
- variable: z.ZodOptional<z.ZodString>;
5266
- bold: z.ZodOptional<z.ZodBoolean>;
5267
- italic: z.ZodOptional<z.ZodBoolean>;
5268
- link: z.ZodOptional<z.ZodString>;
5269
- }, "strict", z.ZodTypeAny, {
5270
- bold?: boolean | undefined;
5271
- link?: string | undefined;
5272
- text?: string | undefined;
5273
- italic?: boolean | undefined;
5274
- variable?: string | undefined;
5275
- }, {
5276
- bold?: boolean | undefined;
5277
- link?: string | undefined;
5278
- text?: string | undefined;
5279
- italic?: boolean | undefined;
5280
- variable?: string | undefined;
5281
- }>]>, "many">;
5282
- }, "strict", z.ZodTypeAny, {
5283
- type: "heading";
5284
- level: 1 | 2;
5285
- content: (string | {
5286
- bold?: boolean | undefined;
5287
- link?: string | undefined;
5288
- text?: string | undefined;
5289
- italic?: boolean | undefined;
5290
- variable?: string | undefined;
5291
- })[];
5292
- }, {
5293
- type: "heading";
5294
- level: 1 | 2;
5295
- content: (string | {
5296
- bold?: boolean | undefined;
5297
- link?: string | undefined;
5298
- text?: string | undefined;
5299
- italic?: boolean | undefined;
5300
- variable?: string | undefined;
5301
- })[];
5302
- }>, z.ZodObject<{
5303
- type: z.ZodLiteral<"paragraph">;
5304
- content: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
5305
- text: z.ZodOptional<z.ZodString>;
5306
- variable: z.ZodOptional<z.ZodString>;
5307
- bold: z.ZodOptional<z.ZodBoolean>;
5308
- italic: z.ZodOptional<z.ZodBoolean>;
5309
- link: z.ZodOptional<z.ZodString>;
5310
- }, "strict", z.ZodTypeAny, {
5311
- bold?: boolean | undefined;
5312
- link?: string | undefined;
5313
- text?: string | undefined;
5314
- italic?: boolean | undefined;
5315
- variable?: string | undefined;
5316
- }, {
5317
- bold?: boolean | undefined;
5318
- link?: string | undefined;
5319
- text?: string | undefined;
5320
- italic?: boolean | undefined;
5321
- variable?: string | undefined;
5322
- }>]>, "many">;
5323
- }, "strict", z.ZodTypeAny, {
5324
- type: "paragraph";
5325
- content: (string | {
5326
- bold?: boolean | undefined;
5327
- link?: string | undefined;
5328
- text?: string | undefined;
5329
- italic?: boolean | undefined;
5330
- variable?: string | undefined;
5331
- })[];
5332
- }, {
5333
- type: "paragraph";
5334
- content: (string | {
5335
- bold?: boolean | undefined;
5336
- link?: string | undefined;
5337
- text?: string | undefined;
5338
- italic?: boolean | undefined;
5339
- variable?: string | undefined;
5340
- })[];
5341
- }>, z.ZodObject<{
5342
- type: z.ZodLiteral<"list">;
5343
- style: z.ZodEnum<["bulleted", "numbered"]>;
5344
- items: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
5345
- text: z.ZodOptional<z.ZodString>;
5346
- variable: z.ZodOptional<z.ZodString>;
5347
- bold: z.ZodOptional<z.ZodBoolean>;
5348
- italic: z.ZodOptional<z.ZodBoolean>;
5349
- link: z.ZodOptional<z.ZodString>;
5350
- }, "strict", z.ZodTypeAny, {
5351
- bold?: boolean | undefined;
5352
- link?: string | undefined;
5353
- text?: string | undefined;
5354
- italic?: boolean | undefined;
5355
- variable?: string | undefined;
5356
- }, {
5357
- bold?: boolean | undefined;
5358
- link?: string | undefined;
5359
- text?: string | undefined;
5360
- italic?: boolean | undefined;
5361
- variable?: string | undefined;
5362
- }>]>, "many">, "many">;
5363
- }, "strict", z.ZodTypeAny, {
5364
- type: "list";
5365
- style: "bulleted" | "numbered";
5366
- items: (string | {
5367
- bold?: boolean | undefined;
5368
- link?: string | undefined;
5369
- text?: string | undefined;
5370
- italic?: boolean | undefined;
5371
- variable?: string | undefined;
5372
- })[][];
5373
- }, {
5374
- type: "list";
5375
- style: "bulleted" | "numbered";
5376
- items: (string | {
5377
- bold?: boolean | undefined;
5378
- link?: string | undefined;
5379
- text?: string | undefined;
5380
- italic?: boolean | undefined;
5381
- variable?: string | undefined;
5382
- })[][];
5383
- }>]>, "many">>;
5854
+ text: z.ZodOptional<z.ZodTypeAny>;
5384
5855
  matrix: z.ZodOptional<z.ZodObject<{
5385
5856
  columns: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
5386
5857
  name: z.ZodString;
@@ -5467,9 +5938,9 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
5467
5938
  }>>;
5468
5939
  columns: z.ZodOptional<z.ZodTypeAny>;
5469
5940
  }, "strict", z.ZodTypeAny, {
5470
- cardId: string;
5471
5941
  op: "card.update";
5472
- type?: "table" | "matrix" | "kpi" | "line" | "bar" | "area" | "pie" | "detail_table" | undefined;
5942
+ cardId: string;
5943
+ type?: "table" | "matrix" | "kpi" | "bar" | "line" | "area" | "pie" | "detail_table" | undefined;
5473
5944
  description?: string | null | undefined;
5474
5945
  columns?: any;
5475
5946
  matrix?: {
@@ -5488,36 +5959,7 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
5488
5959
  } | undefined;
5489
5960
  })[];
5490
5961
  } | undefined;
5491
- text?: ({
5492
- type: "heading";
5493
- level: 1 | 2;
5494
- content: (string | {
5495
- bold?: boolean | undefined;
5496
- link?: string | undefined;
5497
- text?: string | undefined;
5498
- italic?: boolean | undefined;
5499
- variable?: string | undefined;
5500
- })[];
5501
- } | {
5502
- type: "paragraph";
5503
- content: (string | {
5504
- bold?: boolean | undefined;
5505
- link?: string | undefined;
5506
- text?: string | undefined;
5507
- italic?: boolean | undefined;
5508
- variable?: string | undefined;
5509
- })[];
5510
- } | {
5511
- type: "list";
5512
- style: "bulleted" | "numbered";
5513
- items: (string | {
5514
- bold?: boolean | undefined;
5515
- link?: string | undefined;
5516
- text?: string | undefined;
5517
- italic?: boolean | undefined;
5518
- variable?: string | undefined;
5519
- })[][];
5520
- })[] | undefined;
5962
+ text?: any;
5521
5963
  title?: string | undefined;
5522
5964
  query?: {
5523
5965
  domainId?: string | undefined;
@@ -5779,9 +6221,9 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
5779
6221
  })[] | null | undefined;
5780
6222
  } | undefined;
5781
6223
  }, {
5782
- cardId: string;
5783
6224
  op: "card.update";
5784
- type?: "table" | "matrix" | "kpi" | "line" | "bar" | "area" | "pie" | "detail_table" | undefined;
6225
+ cardId: string;
6226
+ type?: "table" | "matrix" | "kpi" | "bar" | "line" | "area" | "pie" | "detail_table" | undefined;
5785
6227
  description?: string | null | undefined;
5786
6228
  columns?: any;
5787
6229
  matrix?: {
@@ -5800,36 +6242,7 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
5800
6242
  } | undefined;
5801
6243
  })[];
5802
6244
  } | undefined;
5803
- text?: ({
5804
- type: "heading";
5805
- level: 1 | 2;
5806
- content: (string | {
5807
- bold?: boolean | undefined;
5808
- link?: string | undefined;
5809
- text?: string | undefined;
5810
- italic?: boolean | undefined;
5811
- variable?: string | undefined;
5812
- })[];
5813
- } | {
5814
- type: "paragraph";
5815
- content: (string | {
5816
- bold?: boolean | undefined;
5817
- link?: string | undefined;
5818
- text?: string | undefined;
5819
- italic?: boolean | undefined;
5820
- variable?: string | undefined;
5821
- })[];
5822
- } | {
5823
- type: "list";
5824
- style: "bulleted" | "numbered";
5825
- items: (string | {
5826
- bold?: boolean | undefined;
5827
- link?: string | undefined;
5828
- text?: string | undefined;
5829
- italic?: boolean | undefined;
5830
- variable?: string | undefined;
5831
- })[][];
5832
- })[] | undefined;
6245
+ text?: any;
5833
6246
  title?: string | undefined;
5834
6247
  query?: {
5835
6248
  domainId?: string | undefined;
@@ -6094,11 +6507,11 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6094
6507
  op: z.ZodLiteral<"card.remove">;
6095
6508
  cardId: z.ZodString;
6096
6509
  }, "strict", z.ZodTypeAny, {
6097
- cardId: string;
6098
6510
  op: "card.remove";
6099
- }, {
6100
6511
  cardId: string;
6512
+ }, {
6101
6513
  op: "card.remove";
6514
+ cardId: string;
6102
6515
  }>, z.ZodObject<{
6103
6516
  op: z.ZodLiteral<"filter.add">;
6104
6517
  handle: z.ZodOptional<z.ZodString>;
@@ -6267,8 +6680,8 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6267
6680
  field: string;
6268
6681
  op: "filter.add";
6269
6682
  selection?: "single" | "multiple" | undefined;
6270
- defaultValues?: (string | number | boolean)[] | undefined;
6271
6683
  handle?: string | undefined;
6684
+ defaultValues?: (string | number | boolean)[] | undefined;
6272
6685
  defaultPeriod?: {
6273
6686
  value: number;
6274
6687
  unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
@@ -6293,8 +6706,8 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6293
6706
  field: string;
6294
6707
  op: "filter.add";
6295
6708
  selection?: "single" | "multiple" | undefined;
6296
- defaultValues?: (string | number | boolean)[] | undefined;
6297
6709
  handle?: string | undefined;
6710
+ defaultValues?: (string | number | boolean)[] | undefined;
6298
6711
  defaultPeriod?: {
6299
6712
  value: number;
6300
6713
  unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
@@ -6545,28 +6958,28 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6545
6958
  name: string;
6546
6959
  };
6547
6960
  filterId: string;
6548
- cardId: string;
6549
6961
  op: "filter.bind";
6962
+ cardId: string;
6550
6963
  }, {
6551
6964
  field: string | {
6552
6965
  datasetName: string;
6553
6966
  name: string;
6554
6967
  };
6555
6968
  filterId: string;
6556
- cardId: string;
6557
6969
  op: "filter.bind";
6970
+ cardId: string;
6558
6971
  }>, z.ZodObject<{
6559
6972
  op: z.ZodLiteral<"filter.exclude">;
6560
6973
  filterId: z.ZodUnion<[z.ZodString, z.ZodString]>;
6561
6974
  cardId: z.ZodUnion<[z.ZodString, z.ZodString]>;
6562
6975
  }, "strict", z.ZodTypeAny, {
6563
6976
  filterId: string;
6564
- cardId: string;
6565
6977
  op: "filter.exclude";
6978
+ cardId: string;
6566
6979
  }, {
6567
6980
  filterId: string;
6568
- cardId: string;
6569
6981
  op: "filter.exclude";
6982
+ cardId: string;
6570
6983
  }>, z.ZodObject<{
6571
6984
  op: z.ZodLiteral<"layout.arrange">;
6572
6985
  sheetId: z.ZodOptional<z.ZodString>;
@@ -6592,11 +7005,11 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6592
7005
  op: z.ZodLiteral<"layout.untab">;
6593
7006
  cardId: z.ZodUnion<[z.ZodString, z.ZodString]>;
6594
7007
  }, "strict", z.ZodTypeAny, {
6595
- cardId: string;
6596
7008
  op: "layout.untab";
6597
- }, {
6598
7009
  cardId: string;
7010
+ }, {
6599
7011
  op: "layout.untab";
7012
+ cardId: string;
6600
7013
  }>, z.ZodObject<{
6601
7014
  op: z.ZodLiteral<"sheet.add">;
6602
7015
  handle: z.ZodOptional<z.ZodString>;
@@ -6704,15 +7117,13 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6704
7117
  apply: z.ZodOptional<z.ZodEnum<["cell", "row"]>>;
6705
7118
  }, "strict", z.ZodTypeAny, {
6706
7119
  column: string;
6707
- cardId: string;
6708
7120
  op: "highlight.add";
7121
+ cardId: string;
6709
7122
  scale?: Record<string, unknown> | {
6710
7123
  low: string;
6711
7124
  high: string;
6712
7125
  mid?: string | undefined;
6713
7126
  } | undefined;
6714
- color?: string | undefined;
6715
- apply?: "row" | "cell" | undefined;
6716
7127
  when?: Record<string, unknown> | {
6717
7128
  value: string | number;
6718
7129
  operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
@@ -6729,20 +7140,20 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6729
7140
  } | {
6730
7141
  bottom: number;
6731
7142
  } | undefined;
7143
+ color?: string | undefined;
7144
+ apply?: "row" | "cell" | undefined;
6732
7145
  bars?: Record<string, unknown> | {
6733
7146
  color?: string | undefined;
6734
7147
  } | undefined;
6735
7148
  } | {
6736
7149
  column: string;
6737
- cardId: string;
6738
7150
  op: "highlight.add";
7151
+ cardId: string;
6739
7152
  scale?: Record<string, unknown> | {
6740
7153
  low: string;
6741
7154
  high: string;
6742
7155
  mid?: string | undefined;
6743
7156
  } | undefined;
6744
- color?: string | undefined;
6745
- apply?: "row" | "cell" | undefined;
6746
7157
  when?: Record<string, unknown> | {
6747
7158
  value: string | number;
6748
7159
  operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
@@ -6759,20 +7170,20 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6759
7170
  } | {
6760
7171
  bottom: number;
6761
7172
  } | undefined;
7173
+ color?: string | undefined;
7174
+ apply?: "row" | "cell" | undefined;
6762
7175
  bars?: Record<string, unknown> | {
6763
7176
  color?: string | undefined;
6764
7177
  } | undefined;
6765
7178
  }, {
6766
7179
  column: string;
6767
- cardId: string;
6768
7180
  op: "highlight.add";
7181
+ cardId: string;
6769
7182
  scale?: Record<string, unknown> | {
6770
7183
  low: string;
6771
7184
  high: string;
6772
7185
  mid?: string | undefined;
6773
7186
  } | undefined;
6774
- color?: string | undefined;
6775
- apply?: "row" | "cell" | undefined;
6776
7187
  when?: Record<string, unknown> | {
6777
7188
  value: string | number;
6778
7189
  operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
@@ -6789,20 +7200,20 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6789
7200
  } | {
6790
7201
  bottom: number;
6791
7202
  } | undefined;
7203
+ color?: string | undefined;
7204
+ apply?: "row" | "cell" | undefined;
6792
7205
  bars?: Record<string, unknown> | {
6793
7206
  color?: string | undefined;
6794
7207
  } | undefined;
6795
7208
  } | {
6796
7209
  column: string;
6797
- cardId: string;
6798
7210
  op: "highlight.add";
7211
+ cardId: string;
6799
7212
  scale?: Record<string, unknown> | {
6800
7213
  low: string;
6801
7214
  high: string;
6802
7215
  mid?: string | undefined;
6803
7216
  } | undefined;
6804
- color?: string | undefined;
6805
- apply?: "row" | "cell" | undefined;
6806
7217
  when?: Record<string, unknown> | {
6807
7218
  value: string | number;
6808
7219
  operator: "=" | "!=" | ">" | ">=" | "<" | "<=";
@@ -6819,6 +7230,8 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6819
7230
  } | {
6820
7231
  bottom: number;
6821
7232
  } | undefined;
7233
+ color?: string | undefined;
7234
+ apply?: "row" | "cell" | undefined;
6822
7235
  bars?: Record<string, unknown> | {
6823
7236
  color?: string | undefined;
6824
7237
  } | undefined;
@@ -6827,12 +7240,12 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6827
7240
  cardId: z.ZodUnion<[z.ZodString, z.ZodString]>;
6828
7241
  ruleId: z.ZodString;
6829
7242
  }, "strict", z.ZodTypeAny, {
6830
- cardId: string;
6831
7243
  op: "highlight.remove";
7244
+ cardId: string;
6832
7245
  ruleId: string;
6833
7246
  }, {
6834
- cardId: string;
6835
7247
  op: "highlight.remove";
7248
+ cardId: string;
6836
7249
  ruleId: string;
6837
7250
  }>, z.ZodObject<{
6838
7251
  op: z.ZodLiteral<"dashboard.update">;
@@ -6846,6 +7259,244 @@ export declare const dashboardChangeSchema: z.ZodDiscriminatedUnion<"op", [z.Zod
6846
7259
  op: "dashboard.update";
6847
7260
  description?: string | null | undefined;
6848
7261
  title?: string | undefined;
7262
+ }>, z.ZodObject<{
7263
+ op: z.ZodLiteral<"variable.add">;
7264
+ name: z.ZodString;
7265
+ label: z.ZodTypeAny;
7266
+ query: z.ZodType<VariableQueryChange, z.ZodTypeDef, VariableQueryChange>;
7267
+ get: z.ZodUnion<[z.ZodEnum<["only", "first", "list", "aggregate"]>, z.ZodObject<{
7268
+ kind: z.ZodEnum<["only", "first", "list", "aggregate"]>;
7269
+ limit: z.ZodOptional<z.ZodNumber>;
7270
+ separator: z.ZodOptional<z.ZodString>;
7271
+ }, "strict", z.ZodTypeAny, {
7272
+ kind: "aggregate" | "first" | "only" | "list";
7273
+ limit?: number | undefined;
7274
+ separator?: string | undefined;
7275
+ }, {
7276
+ kind: "aggregate" | "first" | "only" | "list";
7277
+ limit?: number | undefined;
7278
+ separator?: string | undefined;
7279
+ }>]>;
7280
+ presentation: z.ZodOptional<z.ZodObject<{
7281
+ decimals: z.ZodOptional<z.ZodNumber>;
7282
+ temporal: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
7283
+ mode: z.ZodLiteral<"style">;
7284
+ dateStyle: z.ZodEnum<["short", "medium", "long"]>;
7285
+ }, "strict", z.ZodTypeAny, {
7286
+ mode: "style";
7287
+ dateStyle: "short" | "long" | "medium";
7288
+ }, {
7289
+ mode: "style";
7290
+ dateStyle: "short" | "long" | "medium";
7291
+ }>, z.ZodObject<{
7292
+ mode: z.ZodLiteral<"pattern">;
7293
+ dialect: z.ZodLiteral<"semaphor_tokens">;
7294
+ pattern: z.ZodString;
7295
+ }, "strict", z.ZodTypeAny, {
7296
+ pattern: string;
7297
+ dialect: "semaphor_tokens";
7298
+ mode: "pattern";
7299
+ }, {
7300
+ pattern: string;
7301
+ dialect: "semaphor_tokens";
7302
+ mode: "pattern";
7303
+ }>, z.ZodObject<{
7304
+ mode: z.ZodLiteral<"period_label">;
7305
+ }, "strict", z.ZodTypeAny, {
7306
+ mode: "period_label";
7307
+ }, {
7308
+ mode: "period_label";
7309
+ }>]>>;
7310
+ units: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
7311
+ signWords: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
7312
+ absolute: z.ZodOptional<z.ZodBoolean>;
7313
+ percent: z.ZodOptional<z.ZodBoolean>;
7314
+ }, "strict", z.ZodTypeAny, {
7315
+ percent?: boolean | undefined;
7316
+ decimals?: number | undefined;
7317
+ absolute?: boolean | undefined;
7318
+ signWords?: [string, string, string] | undefined;
7319
+ temporal?: {
7320
+ mode: "style";
7321
+ dateStyle: "short" | "long" | "medium";
7322
+ } | {
7323
+ pattern: string;
7324
+ dialect: "semaphor_tokens";
7325
+ mode: "pattern";
7326
+ } | {
7327
+ mode: "period_label";
7328
+ } | undefined;
7329
+ units?: [string, string] | undefined;
7330
+ }, {
7331
+ percent?: boolean | undefined;
7332
+ decimals?: number | undefined;
7333
+ absolute?: boolean | undefined;
7334
+ signWords?: [string, string, string] | undefined;
7335
+ temporal?: {
7336
+ mode: "style";
7337
+ dateStyle: "short" | "long" | "medium";
7338
+ } | {
7339
+ pattern: string;
7340
+ dialect: "semaphor_tokens";
7341
+ mode: "pattern";
7342
+ } | {
7343
+ mode: "period_label";
7344
+ } | undefined;
7345
+ units?: [string, string] | undefined;
7346
+ }>>;
7347
+ emptyText: z.ZodTypeAny;
7348
+ }, "strict", z.ZodTypeAny, {
7349
+ name: string;
7350
+ query: VariableQueryChange;
7351
+ get: "aggregate" | "first" | "only" | "list" | {
7352
+ kind: "aggregate" | "first" | "only" | "list";
7353
+ limit?: number | undefined;
7354
+ separator?: string | undefined;
7355
+ };
7356
+ op: "variable.add";
7357
+ presentation?: {
7358
+ percent?: boolean | undefined;
7359
+ decimals?: number | undefined;
7360
+ absolute?: boolean | undefined;
7361
+ signWords?: [string, string, string] | undefined;
7362
+ temporal?: {
7363
+ mode: "style";
7364
+ dateStyle: "short" | "long" | "medium";
7365
+ } | {
7366
+ pattern: string;
7367
+ dialect: "semaphor_tokens";
7368
+ mode: "pattern";
7369
+ } | {
7370
+ mode: "period_label";
7371
+ } | undefined;
7372
+ units?: [string, string] | undefined;
7373
+ } | undefined;
7374
+ label?: any;
7375
+ emptyText?: any;
7376
+ }, {
7377
+ name: string;
7378
+ query: VariableQueryChange;
7379
+ get: "aggregate" | "first" | "only" | "list" | {
7380
+ kind: "aggregate" | "first" | "only" | "list";
7381
+ limit?: number | undefined;
7382
+ separator?: string | undefined;
7383
+ };
7384
+ op: "variable.add";
7385
+ presentation?: {
7386
+ percent?: boolean | undefined;
7387
+ decimals?: number | undefined;
7388
+ absolute?: boolean | undefined;
7389
+ signWords?: [string, string, string] | undefined;
7390
+ temporal?: {
7391
+ mode: "style";
7392
+ dateStyle: "short" | "long" | "medium";
7393
+ } | {
7394
+ pattern: string;
7395
+ dialect: "semaphor_tokens";
7396
+ mode: "pattern";
7397
+ } | {
7398
+ mode: "period_label";
7399
+ } | undefined;
7400
+ units?: [string, string] | undefined;
7401
+ } | undefined;
7402
+ label?: any;
7403
+ emptyText?: any;
7404
+ }>, z.ZodObject<{
7405
+ op: z.ZodLiteral<"variable.update">;
7406
+ name: z.ZodString;
7407
+ rename: z.ZodOptional<z.ZodString>;
7408
+ label: z.ZodTypeAny;
7409
+ query: z.ZodOptional<z.ZodType<VariableQueryChange, z.ZodTypeDef, VariableQueryChange>>;
7410
+ get: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["only", "first", "list", "aggregate"]>, z.ZodObject<{
7411
+ kind: z.ZodEnum<["only", "first", "list", "aggregate"]>;
7412
+ limit: z.ZodOptional<z.ZodNumber>;
7413
+ separator: z.ZodOptional<z.ZodString>;
7414
+ }, "strict", z.ZodTypeAny, {
7415
+ kind: "aggregate" | "first" | "only" | "list";
7416
+ limit?: number | undefined;
7417
+ separator?: string | undefined;
7418
+ }, {
7419
+ kind: "aggregate" | "first" | "only" | "list";
7420
+ limit?: number | undefined;
7421
+ separator?: string | undefined;
7422
+ }>]>>;
7423
+ presentation: z.ZodTypeAny;
7424
+ emptyText: z.ZodTypeAny;
7425
+ }, "strict", z.ZodTypeAny, {
7426
+ name: string;
7427
+ op: "variable.update";
7428
+ presentation?: any;
7429
+ label?: any;
7430
+ emptyText?: any;
7431
+ query?: VariableQueryChange | undefined;
7432
+ get?: "aggregate" | "first" | "only" | "list" | {
7433
+ kind: "aggregate" | "first" | "only" | "list";
7434
+ limit?: number | undefined;
7435
+ separator?: string | undefined;
7436
+ } | undefined;
7437
+ rename?: string | undefined;
7438
+ }, {
7439
+ name: string;
7440
+ op: "variable.update";
7441
+ presentation?: any;
7442
+ label?: any;
7443
+ emptyText?: any;
7444
+ query?: VariableQueryChange | undefined;
7445
+ get?: "aggregate" | "first" | "only" | "list" | {
7446
+ kind: "aggregate" | "first" | "only" | "list";
7447
+ limit?: number | undefined;
7448
+ separator?: string | undefined;
7449
+ } | undefined;
7450
+ rename?: string | undefined;
7451
+ }>, z.ZodObject<{
7452
+ op: z.ZodLiteral<"variable.remove">;
7453
+ name: z.ZodString;
7454
+ }, "strict", z.ZodTypeAny, {
7455
+ name: string;
7456
+ op: "variable.remove";
7457
+ }, {
7458
+ name: string;
7459
+ op: "variable.remove";
7460
+ }>, z.ZodObject<{
7461
+ op: z.ZodLiteral<"document.text.update">;
7462
+ sheetId: z.ZodString;
7463
+ target: z.ZodUnion<[z.ZodObject<{
7464
+ region: z.ZodEnum<["header", "footer"]>;
7465
+ role: z.ZodEnum<["title", "metadata", "note", "pageInfo"]>;
7466
+ }, "strict", z.ZodTypeAny, {
7467
+ role: "title" | "metadata" | "note" | "pageInfo";
7468
+ region: "header" | "footer";
7469
+ }, {
7470
+ role: "title" | "metadata" | "note" | "pageInfo";
7471
+ region: "header" | "footer";
7472
+ }>, z.ZodObject<{
7473
+ sectionId: z.ZodString;
7474
+ }, "strict", z.ZodTypeAny, {
7475
+ sectionId: string;
7476
+ }, {
7477
+ sectionId: string;
7478
+ }>]>;
7479
+ text: z.ZodArray<z.ZodType<TextRun, z.ZodTypeDef, TextRun>, "many">;
7480
+ }, "strict", z.ZodTypeAny, {
7481
+ target: {
7482
+ role: "title" | "metadata" | "note" | "pageInfo";
7483
+ region: "header" | "footer";
7484
+ } | {
7485
+ sectionId: string;
7486
+ };
7487
+ text: TextRun[];
7488
+ op: "document.text.update";
7489
+ sheetId: string;
7490
+ }, {
7491
+ target: {
7492
+ role: "title" | "metadata" | "note" | "pageInfo";
7493
+ region: "header" | "footer";
7494
+ } | {
7495
+ sectionId: string;
7496
+ };
7497
+ text: TextRun[];
7498
+ op: "document.text.update";
7499
+ sheetId: string;
6849
7500
  }>]>;
6850
7501
  /** The ops of changes to a dashboard: the one list callers route by (semaphor-app's MCP change tools). */
6851
7502
  export declare const DASHBOARD_CHANGE_OPS: readonly DashboardChange['op'][];
@@ -6864,6 +7515,12 @@ export type MatrixColumns = z.infer<typeof matrixColumnsSchema>;
6864
7515
  export type Handle = `$${string}`;
6865
7516
  export type FilterValue = z.infer<typeof filterValueSchema>;
6866
7517
  export type DashboardChange = z.infer<typeof dashboardChangeSchema>;
7518
+ export type VariableMetricQuery = z.infer<typeof variableMetricQuerySchema>;
7519
+ export type VariableQueryChange = VariableMetricQuery | SqlCardQuery;
7520
+ export type VariableGetChange = z.infer<typeof variableGetSchema>;
7521
+ export type VariablePresentationChange = z.infer<typeof variablePresentationSchema>;
7522
+ export type RunPresentationChange = z.infer<typeof runPresentationSchema>;
7523
+ export type ChipColorChange = z.infer<typeof chipColorSchema>;
6867
7524
  export type DomainChange = z.infer<typeof relationshipAddSchema>;
6868
7525
  export type CreateTarget = z.infer<typeof createTargetSchema>;
6869
7526
  export type ProposedChange = DashboardChange | DomainChange;