react-semaphor 0.1.559 → 0.1.560

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 (134) hide show
  1. package/dist/analytics-protocol/index.js +368 -361
  2. package/dist/assistant-context/index.js +1 -1
  3. package/dist/assistant-protocol/index.js +5 -5
  4. package/dist/brand-studio/index.js +9 -9
  5. package/dist/briefings/index.js +5 -5
  6. package/dist/chunks/analytics-base-schemas-CHLxsPfX.js +630 -0
  7. package/dist/chunks/{assistant-chat-B_4bVE6I.js → assistant-chat-Bu2fFm_I.js} +206 -207
  8. package/dist/chunks/{bookmark-state-ssqrs5oP.js → bookmark-state-BFY9oNmr.js} +3 -3
  9. package/dist/chunks/{braces-Rdxa3H-s.js → braces-Da41xfUd.js} +1 -1
  10. package/dist/chunks/{comparison-window-caption-CKzQ5LcF.js → comparison-window-caption-4FNkMrzE.js} +166 -166
  11. package/dist/chunks/{context-DVy4HOU0.js → context-BgPDzLHZ.js} +1 -1
  12. package/dist/chunks/{custom-visual-inputs-zVa9wX_o.js → custom-visual-inputs-Dz-enUNR.js} +1 -1
  13. package/dist/chunks/{dashboard-BziwOVpZ.js → dashboard-_MeBuy67.js} +1 -1
  14. package/dist/chunks/{dashboard-briefing-launcher-CbeNR-YI.js → dashboard-briefing-launcher-CEi4Pr_v.js} +1152 -1166
  15. package/dist/chunks/{dashboard-controls-RD6UJs1r.js → dashboard-controls-Bi7fyG-4.js} +98 -98
  16. package/dist/chunks/{dashboard-json-DGpv17vL.js → dashboard-json-B1mU_OMa.js} +5 -5
  17. package/dist/chunks/{document-dashboard-inputs-ChVkcBuu.js → document-dashboard-inputs-CkWfDB8c.js} +64 -64
  18. package/dist/chunks/{edit-dashboard-visual-AQ2pQkFp.js → edit-dashboard-visual-0CJN31Y3.js} +8375 -8615
  19. package/dist/chunks/filter-reach-copy-BF4w4kI2.js +3738 -0
  20. package/dist/chunks/{filter-value-text-B4l-xqJT.js → filter-value-text-CRC-K_l_.js} +3 -3
  21. package/dist/chunks/{global-date-filter-utils-DBzEOX9M.js → global-date-filter-utils-D8365uPH.js} +4068 -3401
  22. package/dist/chunks/{index-B1Xr7W24.js → index-DtHidOPV.js} +579 -604
  23. package/dist/chunks/{layout-grid-Bbz3zKif.js → layout-grid-BvsH4RY2.js} +1 -1
  24. package/dist/chunks/{list-filter-3sbH0Uy1.js → list-filter-Dg0otx5E.js} +1 -1
  25. package/dist/chunks/{matrix-analytical-definition-CEe3PGEo.js → matrix-analytical-definition-CM18W8w6.js} +4 -4
  26. package/dist/chunks/{matrix-card-BRNGb1C4.js → matrix-card-HPskLaPy.js} +3 -3
  27. package/dist/chunks/{matrix-member-presentation-CEegvTqg.js → matrix-member-presentation-Bbrfrke4.js} +1 -1
  28. package/dist/chunks/{matrix-operation-contract-COxrfQTS.js → matrix-operation-contract-WPv4R-H_.js} +110 -110
  29. package/dist/chunks/{metric-comparison-DQx-uX__.js → metric-comparison-ljMKYZKa.js} +2 -2
  30. package/dist/chunks/{model-change-CJEj3ZD6.js → model-change-Ccn1zaxl.js} +1 -1
  31. package/dist/chunks/{palette-DMJtp3Vn.js → palette-Bsh376zO.js} +1 -1
  32. package/dist/chunks/{pivot-result-contract-expectations-DOYhqeZb.js → pivot-result-contract-expectations-Bl5suy4-.js} +602 -696
  33. package/dist/chunks/{pivot-result-identity-CAj8SiRL.js → pivot-result-identity-vS9TSh4f.js} +1 -1
  34. package/dist/chunks/{raw-temporal-presentation-BmT7z6NH.js → raw-temporal-presentation-BHm7s-hz.js} +230 -274
  35. package/dist/chunks/{report-preferences-dialog-0sc8B1lh.js → report-preferences-dialog-BV8L0SeS.js} +55 -55
  36. package/dist/chunks/{report-runtime-context-bYoExeWr.js → report-runtime-context-BZQh9ywy.js} +2 -2
  37. package/dist/chunks/{resolve-dashboard-input-context-B_C_VAJH.js → resolve-dashboard-input-context-CAMiWvyR.js} +1749 -1989
  38. package/dist/chunks/{save-DSb1jTtG.js → save-B5EAsgQF.js} +1 -1
  39. package/dist/chunks/{saved-dashboard-context-BQWM3ldX.js → saved-dashboard-context-n2Wn11cV.js} +57 -57
  40. package/dist/chunks/{selection-reducer-DSzMWb4x.js → selection-reducer-D0YnaAD9.js} +1 -1
  41. package/dist/chunks/{semaphor-ready-indicator-Bz14Oma5.js → semaphor-ready-indicator-XLBLOJ2V.js} +38374 -39104
  42. package/dist/chunks/{shelf-drop-preview-context-DBHAkgch.js → shelf-drop-preview-context-DHMa54a-.js} +570 -570
  43. package/dist/chunks/{source-entity-resolution-BOrmNCEM.js → source-entity-resolution-dUG5VWRm.js} +1 -1
  44. package/dist/chunks/{switch-Dq8XPFpT.js → switch-ByxH4M7t.js} +3 -3
  45. package/dist/chunks/{table-export-sheet-C_RvEUyO.js → table-export-sheet-C_GdeTYU.js} +1 -1
  46. package/dist/chunks/{table-settings-DXj_zXwS.js → table-settings-Imz0FgWi.js} +6 -6
  47. package/dist/chunks/{temporal-input-presentation-AhLSkGPf.js → temporal-input-presentation-uvNK_tM0.js} +1109 -820
  48. package/dist/chunks/{token-types-LCYMJ3pa.js → token-types-CQtXUVMy.js} +1 -1
  49. package/dist/chunks/{upload-Dr_WAxHQ.js → upload-wbR-NVzq.js} +1 -1
  50. package/dist/chunks/{use-create-flow-overlay-state-BK3YFkfc.js → use-create-flow-overlay-state-CEBaLOKC.js} +6 -6
  51. package/dist/chunks/{validators-C87JPd-_.js → validators-CXTneCA4.js} +1206 -1579
  52. package/dist/chunks/{zoned-wall-clock-E35Frf9v.js → zoned-wall-clock-B1n_WjW3.js} +1 -1
  53. package/dist/dashboard/index.js +2 -2
  54. package/dist/dashboard-authoring/index.js +2207 -1497
  55. package/dist/data-app-sdk/index.js +5 -5
  56. package/dist/data-app-sdk-adapters/index.js +3 -3
  57. package/dist/data-app-sdk-validation/index.js +6 -6
  58. package/dist/format-utils/index.js +181 -176
  59. package/dist/index.js +22 -22
  60. package/dist/report-runtime-context/index.js +2 -2
  61. package/dist/style.css +1 -1
  62. package/dist/surfboard/index.js +2 -2
  63. package/dist/types/components/editor/editor-aside/utils.d.ts +1 -1
  64. package/dist/types/components/visual/data-table/types/data-table.d.ts +5 -20
  65. package/dist/types/index.js +6 -6
  66. package/dist/types/lib/formatters/canonical-format-adapter.d.ts +2 -29
  67. package/dist/types/lib/formatters/raw-temporal-presentation.d.ts +0 -2
  68. package/dist/types/lib/formatters/table-column-settings.d.ts +47 -0
  69. package/dist/types/lib/matrix-table/matrix-card-adapter.d.ts +10 -188
  70. package/dist/types/lib/matrix-table/matrix-delivery-policy.d.ts +1 -1
  71. package/dist/types/lib/matrix-table/matrix-delivery.d.ts +16 -372
  72. package/dist/types/lib/stores/dashboard-store.d.ts +0 -1
  73. package/dist/types/lib/stores/editor-store.d.ts +39 -9
  74. package/dist/types/lib/stores/table-actions.d.ts +9 -3
  75. package/dist/types/lib/table-formatting/index.d.ts +0 -2
  76. package/dist/types/lib/table-formatting/table-conditional-formatting-range-source.d.ts +3 -2
  77. package/dist/types/lib/table-formatting/table-conditional-formatting-range.d.ts +3 -2
  78. package/dist/types/lib/table-formatting/table-formatting-normalize.d.ts +1 -2
  79. package/dist/types/lib/table-formatting/table-formatting-render-model.d.ts +9 -0
  80. package/dist/types/lib/table-formatting/table-formatting-types.d.ts +5 -95
  81. package/dist/types/lib/table-formatting/table-presentation-fields.d.ts +35 -0
  82. package/dist/types/lib/types/common-types.d.ts +40 -47
  83. package/dist/types/lib/types/explorer-types.d.ts +11 -43
  84. package/dist/types/lib/utils/card-config-utils.d.ts +8 -0
  85. package/dist/types/lib/utils/card-definition.d.ts +9 -187
  86. package/dist/types/shared/analytics-protocol/analytics-base-schemas.d.ts +159 -513
  87. package/dist/types/shared/analytics-protocol/contracts.d.ts +32 -9
  88. package/dist/types/shared/analytics-protocol/execution-input-schemas.d.ts +108 -980
  89. package/dist/types/shared/analytics-protocol/field-validation.d.ts +1 -0
  90. package/dist/types/shared/analytics-protocol/matrix-definition-contract.d.ts +281 -4624
  91. package/dist/types/shared/analytics-protocol/matrix-operation-contract.d.ts +20 -20
  92. package/dist/types/shared/analytics-protocol/matrix-operation-request.d.ts +18 -18
  93. package/dist/types/shared/analytics-protocol/matrix-path-contract.d.ts +40 -40
  94. package/dist/types/shared/analytics-protocol/matrix-window-contract.d.ts +3 -203
  95. package/dist/types/shared/analytics-protocol/scalar-value.d.ts +8 -8
  96. package/dist/types/shared/assistant-context/saved-dashboard-context.d.ts +8 -0
  97. package/dist/types/shared/assistant-protocol/context.d.ts +69 -69
  98. package/dist/types/shared/dashboard-authoring/canonical-result-keys.d.ts +13 -0
  99. package/dist/types/shared/dashboard-authoring/card-export-request.d.ts +4 -1
  100. package/dist/types/shared/dashboard-authoring/card-formats/sql-date-pattern.d.ts +10 -0
  101. package/dist/types/shared/dashboard-authoring/card-formats/upgrade-card-formats.d.ts +57 -0
  102. package/dist/types/shared/dashboard-authoring/changes/dashboard-change.d.ts +24 -24
  103. package/dist/types/shared/dashboard-authoring/conditional-formatting/editable.d.ts +14 -0
  104. package/dist/types/shared/dashboard-authoring/conditional-formatting/evaluate.d.ts +16 -0
  105. package/dist/types/shared/dashboard-authoring/conditional-formatting/index.d.ts +9 -0
  106. package/dist/types/shared/dashboard-authoring/conditional-formatting/kpi.d.ts +14 -0
  107. package/dist/types/shared/dashboard-authoring/conditional-formatting/resolve-card-column-ref.d.ts +17 -0
  108. package/dist/types/shared/dashboard-authoring/conditional-formatting/retain.d.ts +14 -0
  109. package/dist/types/shared/dashboard-authoring/conditional-formatting/schema.d.ts +4499 -0
  110. package/dist/types/shared/dashboard-authoring/conditional-formatting/store.d.ts +12 -0
  111. package/dist/types/shared/dashboard-authoring/conditional-formatting/types.d.ts +151 -0
  112. package/dist/types/shared/dashboard-authoring/conditional-formatting/upgrade.d.ts +35 -0
  113. package/dist/types/shared/dashboard-authoring/control-execution-contract.d.ts +62 -62
  114. package/dist/types/shared/dashboard-authoring/index.d.ts +5 -0
  115. package/dist/types/shared/dashboard-authoring/matrix-authoring.d.ts +4 -5
  116. package/dist/types/shared/dashboard-authoring/matrix-delivery.d.ts +24 -736
  117. package/dist/types/shared/dashboard-authoring/retired-presentation-fields.d.ts +31 -0
  118. package/dist/types/shared/dashboard-authoring/upgrade-card-presentation.d.ts +14 -0
  119. package/dist/types/shared/format-utils/formatters/matrix-formatter.d.ts +5 -1
  120. package/dist/types/shared/format-utils/formatters/number-formatter.d.ts +16 -0
  121. package/dist/types/shared/format-utils/index.d.ts +2 -0
  122. package/dist/types/shared/format-utils/matrix-export-presentation.d.ts +10 -366
  123. package/dist/types/shared/format-utils/raw-temporal.d.ts +15 -1
  124. package/dist/types/shared/format-utils/resolve-column-format.d.ts +43 -0
  125. package/dist/types/shared/format-utils/retired-format-adapters.d.ts +68 -0
  126. package/dist/types/shared/format-utils/semantic-format.d.ts +5 -1
  127. package/dist/types/shared/format-utils/stored-value-format.d.ts +16 -0
  128. package/dist/types/shared/format-utils/types/format-types.d.ts +10 -12
  129. package/package.json +1 -1
  130. package/dist/chunks/analytics-base-schemas-BUFUoO6G.js +0 -472
  131. package/dist/chunks/editor-draft-sync-BN5qYHPF.js +0 -15
  132. package/dist/chunks/filter-reach-copy-B5Y7FHzg.js +0 -3411
  133. package/dist/types/lib/table-formatting/table-conditional-formatting-evaluator.d.ts +0 -9
  134. package/dist/types/lib/table-formatting/table-formatting-validation.d.ts +0 -12
@@ -366,32 +366,32 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
366
366
  valueText: string;
367
367
  }>, "many">;
368
368
  }, "strict", z.ZodTypeAny, {
369
+ text: string;
369
370
  parameters: {
370
371
  name: string;
371
372
  valueText: string;
372
373
  }[];
373
- text: string;
374
374
  }, {
375
+ text: string;
375
376
  parameters: {
376
377
  name: string;
377
378
  valueText: string;
378
379
  }[];
379
- text: string;
380
380
  }>>;
381
381
  comparisons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
382
- omitted: z.ZodOptional<z.ZodObject<Record<"filters" | "controls" | "fields" | "drillSteps" | "comparisons" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
382
+ omitted: z.ZodOptional<z.ZodObject<Record<"filters" | "fields" | "comparisons" | "controls" | "drillSteps" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
383
383
  filters?: number | undefined;
384
- controls?: number | undefined;
385
384
  fields?: number | undefined;
386
- drillSteps?: number | undefined;
387
385
  comparisons?: number | undefined;
386
+ controls?: number | undefined;
387
+ drillSteps?: number | undefined;
388
388
  sqlParameters?: number | undefined;
389
389
  }, {
390
390
  filters?: number | undefined;
391
- controls?: number | undefined;
392
391
  fields?: number | undefined;
393
- drillSteps?: number | undefined;
394
392
  comparisons?: number | undefined;
393
+ controls?: number | undefined;
394
+ drillSteps?: number | undefined;
395
395
  sqlParameters?: number | undefined;
396
396
  }>>;
397
397
  }, "strict", z.ZodTypeAny, {
@@ -401,10 +401,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
401
401
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
402
402
  omittedValues?: number | undefined;
403
403
  }[];
404
- controls: {
405
- label: string;
406
- valueText: string;
407
- }[];
408
404
  fields: {
409
405
  label: string;
410
406
  name: string;
@@ -412,21 +408,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
412
408
  granularity?: string | undefined;
413
409
  aggregate?: string | undefined;
414
410
  }[];
411
+ controls: {
412
+ label: string;
413
+ valueText: string;
414
+ }[];
415
415
  drillPath: string[];
416
416
  sql?: {
417
+ text: string;
417
418
  parameters: {
418
419
  name: string;
419
420
  valueText: string;
420
421
  }[];
421
- text: string;
422
422
  } | undefined;
423
423
  comparisons?: string[] | undefined;
424
424
  omitted?: {
425
425
  filters?: number | undefined;
426
- controls?: number | undefined;
427
426
  fields?: number | undefined;
428
- drillSteps?: number | undefined;
429
427
  comparisons?: number | undefined;
428
+ controls?: number | undefined;
429
+ drillSteps?: number | undefined;
430
430
  sqlParameters?: number | undefined;
431
431
  } | undefined;
432
432
  }, {
@@ -436,10 +436,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
436
436
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
437
437
  omittedValues?: number | undefined;
438
438
  }[];
439
- controls: {
440
- label: string;
441
- valueText: string;
442
- }[];
443
439
  fields: {
444
440
  label: string;
445
441
  name: string;
@@ -447,21 +443,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
447
443
  granularity?: string | undefined;
448
444
  aggregate?: string | undefined;
449
445
  }[];
446
+ controls: {
447
+ label: string;
448
+ valueText: string;
449
+ }[];
450
450
  drillPath: string[];
451
451
  sql?: {
452
+ text: string;
452
453
  parameters: {
453
454
  name: string;
454
455
  valueText: string;
455
456
  }[];
456
- text: string;
457
457
  } | undefined;
458
458
  comparisons?: string[] | undefined;
459
459
  omitted?: {
460
460
  filters?: number | undefined;
461
- controls?: number | undefined;
462
461
  fields?: number | undefined;
463
- drillSteps?: number | undefined;
464
462
  comparisons?: number | undefined;
463
+ controls?: number | undefined;
464
+ drillSteps?: number | undefined;
465
465
  sqlParameters?: number | undefined;
466
466
  } | undefined;
467
467
  }>, z.ZodObject<{
@@ -490,10 +490,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
490
490
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
491
491
  omittedValues?: number | undefined;
492
492
  }[];
493
- controls: {
494
- label: string;
495
- valueText: string;
496
- }[];
497
493
  fields: {
498
494
  label: string;
499
495
  name: string;
@@ -501,21 +497,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
501
497
  granularity?: string | undefined;
502
498
  aggregate?: string | undefined;
503
499
  }[];
500
+ controls: {
501
+ label: string;
502
+ valueText: string;
503
+ }[];
504
504
  drillPath: string[];
505
505
  sql?: {
506
+ text: string;
506
507
  parameters: {
507
508
  name: string;
508
509
  valueText: string;
509
510
  }[];
510
- text: string;
511
511
  } | undefined;
512
512
  comparisons?: string[] | undefined;
513
513
  omitted?: {
514
514
  filters?: number | undefined;
515
- controls?: number | undefined;
516
515
  fields?: number | undefined;
517
- drillSteps?: number | undefined;
518
516
  comparisons?: number | undefined;
517
+ controls?: number | undefined;
518
+ drillSteps?: number | undefined;
519
519
  sqlParameters?: number | undefined;
520
520
  } | undefined;
521
521
  } | {
@@ -524,8 +524,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
524
524
  message?: string | undefined;
525
525
  };
526
526
  title: string;
527
- fingerprint: string;
528
527
  visualType: string;
528
+ fingerprint: string;
529
529
  source?: SemaphorSourceRef | undefined;
530
530
  }, {
531
531
  id: string;
@@ -536,10 +536,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
536
536
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
537
537
  omittedValues?: number | undefined;
538
538
  }[];
539
- controls: {
540
- label: string;
541
- valueText: string;
542
- }[];
543
539
  fields: {
544
540
  label: string;
545
541
  name: string;
@@ -547,21 +543,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
547
543
  granularity?: string | undefined;
548
544
  aggregate?: string | undefined;
549
545
  }[];
546
+ controls: {
547
+ label: string;
548
+ valueText: string;
549
+ }[];
550
550
  drillPath: string[];
551
551
  sql?: {
552
+ text: string;
552
553
  parameters: {
553
554
  name: string;
554
555
  valueText: string;
555
556
  }[];
556
- text: string;
557
557
  } | undefined;
558
558
  comparisons?: string[] | undefined;
559
559
  omitted?: {
560
560
  filters?: number | undefined;
561
- controls?: number | undefined;
562
561
  fields?: number | undefined;
563
- drillSteps?: number | undefined;
564
562
  comparisons?: number | undefined;
563
+ controls?: number | undefined;
564
+ drillSteps?: number | undefined;
565
565
  sqlParameters?: number | undefined;
566
566
  } | undefined;
567
567
  } | {
@@ -570,8 +570,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
570
570
  message?: string | undefined;
571
571
  };
572
572
  title: string;
573
- fingerprint: string;
574
573
  visualType: string;
574
+ fingerprint: string;
575
575
  source?: SemaphorSourceRef | undefined;
576
576
  }>>;
577
577
  editing: z.ZodOptional<z.ZodObject<{
@@ -642,10 +642,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
642
642
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
643
643
  omittedValues?: number | undefined;
644
644
  }[];
645
- controls: {
646
- label: string;
647
- valueText: string;
648
- }[];
649
645
  fields: {
650
646
  label: string;
651
647
  name: string;
@@ -653,21 +649,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
653
649
  granularity?: string | undefined;
654
650
  aggregate?: string | undefined;
655
651
  }[];
652
+ controls: {
653
+ label: string;
654
+ valueText: string;
655
+ }[];
656
656
  drillPath: string[];
657
657
  sql?: {
658
+ text: string;
658
659
  parameters: {
659
660
  name: string;
660
661
  valueText: string;
661
662
  }[];
662
- text: string;
663
663
  } | undefined;
664
664
  comparisons?: string[] | undefined;
665
665
  omitted?: {
666
666
  filters?: number | undefined;
667
- controls?: number | undefined;
668
667
  fields?: number | undefined;
669
- drillSteps?: number | undefined;
670
668
  comparisons?: number | undefined;
669
+ controls?: number | undefined;
670
+ drillSteps?: number | undefined;
671
671
  sqlParameters?: number | undefined;
672
672
  } | undefined;
673
673
  } | {
@@ -676,8 +676,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
676
676
  message?: string | undefined;
677
677
  };
678
678
  title: string;
679
- fingerprint: string;
680
679
  visualType: string;
680
+ fingerprint: string;
681
681
  source?: SemaphorSourceRef | undefined;
682
682
  } | undefined;
683
683
  editing?: {
@@ -734,10 +734,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
734
734
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
735
735
  omittedValues?: number | undefined;
736
736
  }[];
737
- controls: {
738
- label: string;
739
- valueText: string;
740
- }[];
741
737
  fields: {
742
738
  label: string;
743
739
  name: string;
@@ -745,21 +741,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
745
741
  granularity?: string | undefined;
746
742
  aggregate?: string | undefined;
747
743
  }[];
744
+ controls: {
745
+ label: string;
746
+ valueText: string;
747
+ }[];
748
748
  drillPath: string[];
749
749
  sql?: {
750
+ text: string;
750
751
  parameters: {
751
752
  name: string;
752
753
  valueText: string;
753
754
  }[];
754
- text: string;
755
755
  } | undefined;
756
756
  comparisons?: string[] | undefined;
757
757
  omitted?: {
758
758
  filters?: number | undefined;
759
- controls?: number | undefined;
760
759
  fields?: number | undefined;
761
- drillSteps?: number | undefined;
762
760
  comparisons?: number | undefined;
761
+ controls?: number | undefined;
762
+ drillSteps?: number | undefined;
763
763
  sqlParameters?: number | undefined;
764
764
  } | undefined;
765
765
  } | {
@@ -768,8 +768,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
768
768
  message?: string | undefined;
769
769
  };
770
770
  title: string;
771
- fingerprint: string;
772
771
  visualType: string;
772
+ fingerprint: string;
773
773
  source?: SemaphorSourceRef | undefined;
774
774
  } | undefined;
775
775
  editing?: {
@@ -826,10 +826,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
826
826
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
827
827
  omittedValues?: number | undefined;
828
828
  }[];
829
- controls: {
830
- label: string;
831
- valueText: string;
832
- }[];
833
829
  fields: {
834
830
  label: string;
835
831
  name: string;
@@ -837,21 +833,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
837
833
  granularity?: string | undefined;
838
834
  aggregate?: string | undefined;
839
835
  }[];
836
+ controls: {
837
+ label: string;
838
+ valueText: string;
839
+ }[];
840
840
  drillPath: string[];
841
841
  sql?: {
842
+ text: string;
842
843
  parameters: {
843
844
  name: string;
844
845
  valueText: string;
845
846
  }[];
846
- text: string;
847
847
  } | undefined;
848
848
  comparisons?: string[] | undefined;
849
849
  omitted?: {
850
850
  filters?: number | undefined;
851
- controls?: number | undefined;
852
851
  fields?: number | undefined;
853
- drillSteps?: number | undefined;
854
852
  comparisons?: number | undefined;
853
+ controls?: number | undefined;
854
+ drillSteps?: number | undefined;
855
855
  sqlParameters?: number | undefined;
856
856
  } | undefined;
857
857
  } | {
@@ -860,8 +860,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
860
860
  message?: string | undefined;
861
861
  };
862
862
  title: string;
863
- fingerprint: string;
864
863
  visualType: string;
864
+ fingerprint: string;
865
865
  source?: SemaphorSourceRef | undefined;
866
866
  } | undefined;
867
867
  editing?: {
@@ -918,10 +918,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
918
918
  origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
919
919
  omittedValues?: number | undefined;
920
920
  }[];
921
- controls: {
922
- label: string;
923
- valueText: string;
924
- }[];
925
921
  fields: {
926
922
  label: string;
927
923
  name: string;
@@ -929,21 +925,25 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
929
925
  granularity?: string | undefined;
930
926
  aggregate?: string | undefined;
931
927
  }[];
928
+ controls: {
929
+ label: string;
930
+ valueText: string;
931
+ }[];
932
932
  drillPath: string[];
933
933
  sql?: {
934
+ text: string;
934
935
  parameters: {
935
936
  name: string;
936
937
  valueText: string;
937
938
  }[];
938
- text: string;
939
939
  } | undefined;
940
940
  comparisons?: string[] | undefined;
941
941
  omitted?: {
942
942
  filters?: number | undefined;
943
- controls?: number | undefined;
944
943
  fields?: number | undefined;
945
- drillSteps?: number | undefined;
946
944
  comparisons?: number | undefined;
945
+ controls?: number | undefined;
946
+ drillSteps?: number | undefined;
947
947
  sqlParameters?: number | undefined;
948
948
  } | undefined;
949
949
  } | {
@@ -952,8 +952,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
952
952
  message?: string | undefined;
953
953
  };
954
954
  title: string;
955
- fingerprint: string;
956
955
  visualType: string;
956
+ fingerprint: string;
957
957
  source?: SemaphorSourceRef | undefined;
958
958
  } | undefined;
959
959
  editing?: {
@@ -23,3 +23,16 @@ export declare function resolveCanonicalResultOutputKey(input: {
23
23
  rawKey: string;
24
24
  rawKeys: ReadonlySet<string>;
25
25
  }): string;
26
+ /**
27
+ * The canonical response key of each of a card's config fields: the key the
28
+ * result names its column by, and a table reads its column settings by. One
29
+ * assembly for every offline reader (the temporal snapshot, the column formats
30
+ * upgrade): group-bys, measures, pivots and detail columns decide the raw keys
31
+ * and the label counts together.
32
+ */
33
+ export declare function resolveCanonicalResultOutputKeys(config: {
34
+ groupByColumns?: readonly CanonicalDetailResultFieldIdentity[];
35
+ metricColumns?: readonly CanonicalDetailResultFieldIdentity[];
36
+ pivotByColumns?: readonly CanonicalDetailResultFieldIdentity[];
37
+ detailColumns?: readonly CanonicalDetailResultFieldIdentity[];
38
+ }): Map<CanonicalDetailResultFieldIdentity, string>;
@@ -9,6 +9,7 @@ import { ReportRuntimeContext } from '../report-runtime-context/index.js';
9
9
  import { CsvDelimiter, CsvEncoding, ExportFileFormat, PresentationExecutionSnapshot } from '../format-utils/index.js';
10
10
  import { TemporalResultOwner } from './temporal-result-owner.js';
11
11
  import { ExportViewerTable } from '../../lib/dashboard-viewer/export-table-view.js';
12
+ import { ModelFormats } from '../format-utils/resolve-column-format.js';
12
13
  /** Formatting configuration passed to the export job */
13
14
  export interface ExportFormattingConfig {
14
15
  useFormattedValues: boolean;
@@ -69,6 +70,8 @@ export type CardResultFacts = {
69
70
  resultColumns: readonly SemaphorResultColumn[];
70
71
  columnKeyMap?: QueryColumnKeyMap;
71
72
  comparisonMetadata?: ComparisonMetadataMap;
73
+ /** The response's live model formats, by card field id (column formats CF-D23). */
74
+ modelFormats?: ModelFormats;
72
75
  };
73
76
  /** File options a viewer or an attachment chose. */
74
77
  export type CardExportFileOptions = {
@@ -109,7 +112,7 @@ export declare function buildTableExportFormatOptions(input: {
109
112
  delimiter: "," | ";" | "\t";
110
113
  csvEncoding: "utf-8-bom" | "utf-8";
111
114
  includeHeaders: boolean;
112
- columnSettings: Record<string, unknown> | undefined;
115
+ columnSettings: Record<string, unknown>;
113
116
  visibleColumns: string[];
114
117
  columnLabels: {
115
118
  [k: string]: string;
@@ -0,0 +1,10 @@
1
+ import { CardConfig } from '../../../lib/types/explorer-types.js';
2
+ /** Which pattern a field's dates take: a raw date's, or a grain-less grouped date's. */
3
+ export type SqlDates = 'raw' | 'grouped';
4
+ /**
5
+ * The field with the SQL date pattern its format calls for: a pattern that
6
+ * names a preset is that preset, any other is a custom pattern.
7
+ */
8
+ export declare function withSqlDatePattern<T extends object>(field: T, format: unknown, dates: SqlDates): T;
9
+ /** A card config whose fields carry the SQL date patterns their formats call for, as `executeQuery` builds SQL from it. */
10
+ export declare function withCardConfigSqlDatePatterns<T extends CardConfig | undefined>(config: T): T;
@@ -0,0 +1,57 @@
1
+ import { TCard } from '../../../lib/types/common-types.js';
2
+ import { Field } from '../../../lib/types/explorer-types.js';
3
+ import { SemaphorValueFormat } from '../../analytics-protocol/contracts.js';
4
+ /** One rewrite the upgrade made, by JSON path within the card. */
5
+ export type CardFormatChange = {
6
+ path: string;
7
+ action: 'cleaned' | 'moved' | 'removed' | 'marked';
8
+ /** Where a moved format now lives. */
9
+ to?: string;
10
+ };
11
+ export type CardFormatGapReason =
12
+ /** A column settings format for one pivot value's column: no store holds one. */
13
+ 'per_pivot_value_format'
14
+ /** What one pivot value's format adds to its measure's format of the same kind, which every pivot value now shows (ledger P5-56). */
15
+ | 'pivot_value_format_difference'
16
+ /** A pivot value's format on a table with no measure: it formats the row count the query adds, which no card column holds (ledger P5-59). */
17
+ | 'generated_count_pivot_format'
18
+ /** A column settings format whose key names no card column; it may apply to a result column the template can't name. */
19
+ | 'unmatched_column_setting'
20
+ /** Two column settings entries resolve to one card column. */
21
+ | 'ambiguous_column_setting'
22
+ /** A config table's column settings date that only its download applies. */
23
+ | 'config_column_date_setting'
24
+ /** A config chart's column settings format read by its comparison tooltip only. */
25
+ | 'chart_comparison_column_setting'
26
+ /** A card-wide format on a SQL or Python table or chart: its result keys are unknown without running the query. */
27
+ | 'sql_card_wide_format'
28
+ /** A card-wide format on a chart, where axis and live paths default digits differently (CF-D27). */
29
+ | 'chart_card_wide_format'
30
+ /** Formatting switched off (`formatNumber.enabled: false`, data labels `format: 'none'`): no stored equivalent. */
31
+ | 'raw_display'
32
+ /** A detail date pattern on a column whose own format differs: today SQL formats the date and the format applies after; one format can't hold both. */
33
+ | 'detail_date_beside_format';
34
+ /** A retired field that decides what a viewer sees and has no exact home (CF-D18). */
35
+ export type CardFormatGap = {
36
+ path: string;
37
+ reason: CardFormatGapReason;
38
+ detail: string;
39
+ };
40
+ export type UpgradeCardFormatsOptions = {
41
+ /**
42
+ * The column's current model format, for CF-D17's settling of formats with
43
+ * no `formatOrigin`: equal, `semantic`; different or none, `override`.
44
+ * Without it (the GitHub restore) every unmarked format is an override.
45
+ */
46
+ modelFormatFor?: (column: Field) => SemaphorValueFormat | undefined;
47
+ };
48
+ export type UpgradeCardFormatsResult = {
49
+ card: TCard;
50
+ changes: CardFormatChange[];
51
+ unconverted: CardFormatGap[];
52
+ };
53
+ /**
54
+ * Rewrites one card's retired format fields into the contract's stores.
55
+ * Returns the input card itself when nothing changes.
56
+ */
57
+ export declare function upgradeCardFormats(card: TCard, options?: UpgradeCardFormatsOptions): UpgradeCardFormatsResult;