@columnus/sdk 0.0.0-stage → 0.3.1

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 (386) hide show
  1. package/dist/blocknote-editor-FP33A6RJ.js +7 -0
  2. package/dist/blocknote-editor-FP33A6RJ.js.map +1 -0
  3. package/dist/blocknote-editor-YZEFMXLC.css +47 -0
  4. package/dist/blocknote-editor-YZEFMXLC.css.map +1 -0
  5. package/dist/blocknote-preview-6WRENQZD.css +47 -0
  6. package/dist/blocknote-preview-6WRENQZD.css.map +1 -0
  7. package/dist/blocknote-preview-QZ5SC2GJ.js +7 -0
  8. package/dist/blocknote-preview-QZ5SC2GJ.js.map +1 -0
  9. package/dist/chunk-5IPH2A64.js +23337 -0
  10. package/dist/chunk-5IPH2A64.js.map +1 -0
  11. package/dist/chunk-6LKVKI5O.js +494 -0
  12. package/dist/chunk-6LKVKI5O.js.map +1 -0
  13. package/dist/chunk-BXTTCBIK.js +11 -0
  14. package/dist/chunk-BXTTCBIK.js.map +1 -0
  15. package/dist/chunk-CKNRITN3.js +225 -0
  16. package/dist/chunk-CKNRITN3.js.map +1 -0
  17. package/dist/chunk-FKHOREJP.js +58 -0
  18. package/dist/chunk-FKHOREJP.js.map +1 -0
  19. package/dist/chunk-ICKWVUW7.js +134 -0
  20. package/dist/chunk-ICKWVUW7.js.map +1 -0
  21. package/dist/chunk-LTPU2AL3.js +18774 -0
  22. package/dist/chunk-LTPU2AL3.js.map +1 -0
  23. package/dist/chunk-PX6F3LHL.js +37 -0
  24. package/dist/chunk-PX6F3LHL.js.map +1 -0
  25. package/dist/chunk-QPQRNIKG.js +142 -0
  26. package/dist/chunk-QPQRNIKG.js.map +1 -0
  27. package/dist/chunk-UXUDOFKZ.js +4169 -0
  28. package/dist/chunk-UXUDOFKZ.js.map +1 -0
  29. package/dist/chunk-ZTWPGA37.js +68 -0
  30. package/dist/chunk-ZTWPGA37.js.map +1 -0
  31. package/dist/cms/builder/diff-view.js +70 -0
  32. package/dist/cms/builder/diff-view.js.map +1 -0
  33. package/dist/cms/builder/panel.js +1316 -0
  34. package/dist/cms/builder/panel.js.map +1 -0
  35. package/dist/cms/convex/index.css +47 -0
  36. package/dist/cms/convex/index.css.map +1 -0
  37. package/dist/cms/convex/index.js +370 -0
  38. package/dist/cms/convex/index.js.map +1 -0
  39. package/dist/cms/index.css +47 -0
  40. package/dist/cms/index.css.map +1 -0
  41. package/dist/cms/index.js +9 -0
  42. package/dist/cms/index.js.map +1 -0
  43. package/dist/cms/server/index.js +5 -0
  44. package/dist/cms/server/index.js.map +1 -0
  45. package/dist/cms/tables/tables-dialog.css +47 -0
  46. package/dist/cms/tables/tables-dialog.css.map +1 -0
  47. package/dist/cms/tables/tables-dialog.js +590 -0
  48. package/dist/cms/tables/tables-dialog.js.map +1 -0
  49. package/dist/cms/tailwind.css +4 -0
  50. package/dist/editor-54UG7BSP.css +47 -0
  51. package/dist/editor-54UG7BSP.css.map +1 -0
  52. package/dist/editor-HJ3UNV3Q.js +427 -0
  53. package/dist/editor-HJ3UNV3Q.js.map +1 -0
  54. package/dist/mcp-cli.js +61218 -0
  55. package/dist/primitives.css +143 -0
  56. package/dist/rich-text-editor/blocknote-preview-studio.css +54 -0
  57. package/dist/richtext.css +4 -0
  58. package/dist/types/cms/src/adapters/default-richtext.d.ts +24 -0
  59. package/dist/types/cms/src/adapters/projected-fields-adapter.d.ts +22 -0
  60. package/dist/types/cms/src/adapters/table-rows-context.d.ts +4 -0
  61. package/dist/types/cms/src/adapters/table-rows-richtext.d.ts +8 -0
  62. package/dist/types/cms/src/builder/annotate.d.ts +13 -0
  63. package/dist/types/cms/src/builder/diff-view.d.ts +10 -0
  64. package/dist/types/cms/src/builder/inspect.d.ts +32 -0
  65. package/dist/types/cms/src/builder/panel.d.ts +11 -0
  66. package/dist/types/cms/src/builder/sessions-menu.d.ts +37 -0
  67. package/dist/types/cms/src/builder/sidecar-json.d.ts +2 -0
  68. package/dist/types/cms/src/cache/html-cache.d.ts +12 -0
  69. package/dist/types/cms/src/chrome/changes-view.d.ts +15 -0
  70. package/dist/types/cms/src/chrome/confirm-panel.d.ts +10 -0
  71. package/dist/types/cms/src/chrome/floating-toolbar.d.ts +25 -0
  72. package/dist/types/cms/src/chrome/icons.d.ts +13 -0
  73. package/dist/types/cms/src/chrome/overlay-styles.d.ts +38 -0
  74. package/dist/types/cms/src/chrome/resolve-dialog.d.ts +26 -0
  75. package/dist/types/cms/src/chrome/session-storage.d.ts +3 -0
  76. package/dist/types/cms/src/convex/cms-convex-proposals.d.ts +19 -0
  77. package/dist/types/cms/src/convex/cms-convex-shell.d.ts +8 -0
  78. package/dist/types/cms/src/convex/cms-host-refs.d.ts +15 -0
  79. package/dist/types/cms/src/convex/index.d.ts +7 -0
  80. package/dist/types/cms/src/convex/proposal-refs.d.ts +20 -0
  81. package/dist/types/cms/src/convex/use-cms-display-fields-adapter.d.ts +17 -0
  82. package/dist/types/cms/src/convex/use-cms-display-values.d.ts +12 -0
  83. package/dist/types/cms/src/convex/use-cms-editor-auth.d.ts +12 -0
  84. package/dist/types/cms/src/convex/use-cms-storage-display.d.ts +19 -0
  85. package/dist/types/cms/src/convex/use-cms-storage-fields-adapter.d.ts +63 -0
  86. package/dist/types/cms/src/convex/use-fields-adapter-host.d.ts +4 -0
  87. package/dist/types/cms/src/create/compound-create.d.ts +56 -0
  88. package/dist/types/cms/src/draft/merge-draft.d.ts +31 -0
  89. package/dist/types/cms/src/edit/cms-compound-create.d.ts +12 -0
  90. package/dist/types/cms/src/edit/cms-create-button.d.ts +9 -0
  91. package/dist/types/cms/src/edit/edit-surface.d.ts +16 -0
  92. package/dist/types/cms/src/edit/field-editor-dialog.d.ts +22 -0
  93. package/dist/types/cms/src/edit/inplace-field-editor.d.ts +21 -0
  94. package/dist/types/cms/src/edit/inplace-switch-modal.d.ts +5 -0
  95. package/dist/types/cms/src/edit/insert-row-dialog.d.ts +20 -0
  96. package/dist/types/cms/src/index.d.ts +35 -0
  97. package/dist/types/cms/src/list/build-insert-draft.d.ts +13 -0
  98. package/dist/types/cms/src/manifest-index.d.ts +5 -0
  99. package/dist/types/cms/src/nav/content-ref-integrity.d.ts +18 -0
  100. package/dist/types/cms/src/nav/content-ref.d.ts +6 -0
  101. package/dist/types/cms/src/nav/infer-navigation-table.d.ts +20 -0
  102. package/dist/types/cms/src/nav/slugify-de.d.ts +4 -0
  103. package/dist/types/cms/src/pages/login-page.d.ts +5 -0
  104. package/dist/types/cms/src/profile/propose-gates.d.ts +12 -0
  105. package/dist/types/cms/src/profile/readable-tables.d.ts +13 -0
  106. package/dist/types/cms/src/projection/cms-projection.d.ts +63 -0
  107. package/dist/types/cms/src/proposals/types.d.ts +59 -0
  108. package/dist/types/cms/src/provider/builder-draft.d.ts +14 -0
  109. package/dist/types/cms/src/provider/cms-provider.d.ts +240 -0
  110. package/dist/types/cms/src/rich-doc/cms-rich-doc-view.d.ts +4 -0
  111. package/dist/types/cms/src/server/cookie.d.ts +11 -0
  112. package/dist/types/cms/src/server/index.d.ts +2 -0
  113. package/dist/types/cms/src/server/session.d.ts +53 -0
  114. package/dist/types/cms/src/stamps/attrs.d.ts +17 -0
  115. package/dist/types/cms/src/stamps/related.d.ts +11 -0
  116. package/dist/types/cms/src/stamps/resolve-display.d.ts +41 -0
  117. package/dist/types/cms/src/stamps/row.d.ts +41 -0
  118. package/dist/types/cms/src/stamps/stamp-media-drop.d.ts +23 -0
  119. package/dist/types/cms/src/stamps/stamp.d.ts +44 -0
  120. package/dist/types/cms/src/stamps/storage-display.d.ts +4 -0
  121. package/dist/types/cms/src/stamps/use-cms-projected-field.d.ts +6 -0
  122. package/dist/types/cms/src/stamps/use-cms-projected-table.d.ts +7 -0
  123. package/dist/types/cms/src/stamps/use-cms-related-row.d.ts +2 -0
  124. package/dist/types/cms/src/tables/tables-dialog.d.ts +6 -0
  125. package/dist/types/cms/src/tables/use-cms-grid.d.ts +78 -0
  126. package/dist/types/cms/src/tables/use-draft-commands.d.ts +35 -0
  127. package/dist/types/data-grid/src/components/balanced-preview-columns.d.ts +7 -0
  128. package/dist/types/data-grid/src/components/cell-formula-bar.d.ts +40 -0
  129. package/dist/types/data-grid/src/components/cell-renderer.d.ts +10 -0
  130. package/dist/types/data-grid/src/components/cell-selection.d.ts +72 -0
  131. package/dist/types/data-grid/src/components/column-filter-popover.d.ts +29 -0
  132. package/dist/types/data-grid/src/components/context-menu-selection.d.ts +24 -0
  133. package/dist/types/data-grid/src/components/data-grid-table.d.ts +49 -0
  134. package/dist/types/data-grid/src/components/delete-confirm-copy.d.ts +6 -0
  135. package/dist/types/data-grid/src/components/display-search-scope-notice.d.ts +4 -0
  136. package/dist/types/data-grid/src/components/draft-rows.d.ts +14 -0
  137. package/dist/types/data-grid/src/components/field-condition-editor.d.ts +71 -0
  138. package/dist/types/data-grid/src/components/fill-handle.d.ts +22 -0
  139. package/dist/types/data-grid/src/components/grid-action-bar.d.ts +8 -0
  140. package/dist/types/data-grid/src/components/grid-body-layout.d.ts +27 -0
  141. package/dist/types/data-grid/src/components/grid-body-row.d.ts +83 -0
  142. package/dist/types/data-grid/src/components/grid-editing.d.ts +158 -0
  143. package/dist/types/data-grid/src/components/grid-event-utils.d.ts +10 -0
  144. package/dist/types/data-grid/src/components/grid-filter-search-chips.d.ts +7 -0
  145. package/dist/types/data-grid/src/components/grid-filter-search-context.d.ts +135 -0
  146. package/dist/types/data-grid/src/components/grid-filter-search.d.ts +6 -0
  147. package/dist/types/data-grid/src/components/grid-row-menu.d.ts +23 -0
  148. package/dist/types/data-grid/src/components/grid-seam-island.d.ts +23 -0
  149. package/dist/types/data-grid/src/components/grid-sort-group.d.ts +25 -0
  150. package/dist/types/data-grid/src/components/grid-toolbar.d.ts +54 -0
  151. package/dist/types/data-grid/src/components/index-suggestion-banner.d.ts +11 -0
  152. package/dist/types/data-grid/src/components/inline-edit-draft.d.ts +18 -0
  153. package/dist/types/data-grid/src/components/keyboard-shortcuts-overlay.d.ts +7 -0
  154. package/dist/types/data-grid/src/components/measure-column-auto-width.d.ts +6 -0
  155. package/dist/types/data-grid/src/components/pending-edits.d.ts +25 -0
  156. package/dist/types/data-grid/src/components/perform-grid-row-delete.d.ts +27 -0
  157. package/dist/types/data-grid/src/components/query-plan-banner.d.ts +13 -0
  158. package/dist/types/data-grid/src/components/query-predicate-builder.d.ts +53 -0
  159. package/dist/types/data-grid/src/components/row-detail-dialog.d.ts +17 -0
  160. package/dist/types/data-grid/src/components/row-preview-content.d.ts +21 -0
  161. package/dist/types/data-grid/src/components/row-preview-drawer.d.ts +24 -0
  162. package/dist/types/data-grid/src/components/selection-value-chips.d.ts +12 -0
  163. package/dist/types/data-grid/src/components/selection.d.ts +46 -0
  164. package/dist/types/data-grid/src/components/table-cell-overlays.d.ts +33 -0
  165. package/dist/types/data-grid/src/components/table-color-marker.d.ts +10 -0
  166. package/dist/types/data-grid/src/components/use-column-visibility.d.ts +5 -0
  167. package/dist/types/data-grid/src/components/use-column-widths.d.ts +6 -0
  168. package/dist/types/data-grid/src/components/use-undo-redo.d.ts +46 -0
  169. package/dist/types/data-grid/src/hooks/plan-pending-edits.d.ts +41 -0
  170. package/dist/types/data-grid/src/hooks/use-grid-interactions.d.ts +100 -0
  171. package/dist/types/data-grid/src/hooks/use-grid-pending-state.d.ts +41 -0
  172. package/dist/types/data-grid/src/hooks/use-grid-selection-model.d.ts +28 -0
  173. package/dist/types/data-grid/src/hooks/use-grid-table-layout.d.ts +39 -0
  174. package/dist/types/data-grid/src/hooks/use-true-after-delay.d.ts +10 -0
  175. package/dist/types/data-grid/src/index.d.ts +47 -0
  176. package/dist/types/data-grid/src/lib/column-filter.d.ts +43 -0
  177. package/dist/types/data-grid/src/lib/display-search-scope.d.ts +2 -0
  178. package/dist/types/data-grid/src/lib/format-query-chips.d.ts +28 -0
  179. package/dist/types/data-grid/src/lib/grid-items.d.ts +63 -0
  180. package/dist/types/data-grid/src/lib/persistent-state.d.ts +6 -0
  181. package/dist/types/data-grid/src/lib/query-editor-draft.d.ts +15 -0
  182. package/dist/types/data-grid/src/lib/use-row-preview-collapsed.d.ts +9 -0
  183. package/dist/types/data-grid/src/lib/use-row-preview-title.d.ts +1 -0
  184. package/dist/types/fields/src/components/batch-edit-sheet.d.ts +10 -0
  185. package/dist/types/fields/src/components/cell-editor.d.ts +29 -0
  186. package/dist/types/fields/src/components/date-time-input.d.ts +21 -0
  187. package/dist/types/fields/src/components/date-time-picker-logic.d.ts +13 -0
  188. package/dist/types/fields/src/components/field-input-chrome.d.ts +11 -0
  189. package/dist/types/fields/src/components/field-input-inline.d.ts +30 -0
  190. package/dist/types/fields/src/components/field-input.d.ts +36 -0
  191. package/dist/types/fields/src/components/field-value-view.d.ts +10 -0
  192. package/dist/types/fields/src/components/file-array-cell.d.ts +5 -0
  193. package/dist/types/fields/src/components/file-array-upload-dialog.d.ts +19 -0
  194. package/dist/types/fields/src/components/file-cell.d.ts +5 -0
  195. package/dist/types/fields/src/components/file-input.d.ts +21 -0
  196. package/dist/types/fields/src/components/file-upload-dialog.d.ts +19 -0
  197. package/dist/types/fields/src/components/focus-text-input.d.ts +5 -0
  198. package/dist/types/fields/src/components/id-array-cell.d.ts +9 -0
  199. package/dist/types/fields/src/components/id-array-values.d.ts +1 -0
  200. package/dist/types/fields/src/components/id-cell.d.ts +4 -0
  201. package/dist/types/fields/src/components/id-picker.d.ts +28 -0
  202. package/dist/types/fields/src/components/image-array-cell.d.ts +7 -0
  203. package/dist/types/fields/src/components/image-cell.d.ts +7 -0
  204. package/dist/types/fields/src/components/image-preview-dialog.d.ts +8 -0
  205. package/dist/types/fields/src/components/media-compact-preview.d.ts +17 -0
  206. package/dist/types/fields/src/components/media-library-picker-dialog.d.ts +16 -0
  207. package/dist/types/fields/src/components/multi-id-picker.d.ts +24 -0
  208. package/dist/types/fields/src/components/picker-chrome.d.ts +28 -0
  209. package/dist/types/fields/src/components/picker-density.d.ts +5 -0
  210. package/dist/types/fields/src/components/picker-list-placeholder.d.ts +13 -0
  211. package/dist/types/fields/src/components/picker-menu-keyboard.d.ts +16 -0
  212. package/dist/types/fields/src/components/picker-menu-layout.d.ts +12 -0
  213. package/dist/types/fields/src/components/picker-menu-portal.d.ts +19 -0
  214. package/dist/types/fields/src/components/picker-option-row.d.ts +10 -0
  215. package/dist/types/fields/src/components/picker-overlay.d.ts +35 -0
  216. package/dist/types/fields/src/components/record-link-chip.d.ts +21 -0
  217. package/dist/types/fields/src/components/row-edit-panel.d.ts +38 -0
  218. package/dist/types/fields/src/components/row-editor.d.ts +21 -0
  219. package/dist/types/fields/src/components/row-popover.d.ts +11 -0
  220. package/dist/types/fields/src/components/use-flush-ref.d.ts +3 -0
  221. package/dist/types/fields/src/components/use-picker-combobox.d.ts +88 -0
  222. package/dist/types/fields/src/components/use-picker-highlight-scroll.d.ts +4 -0
  223. package/dist/types/fields/src/components/use-picker-menu-overlay.d.ts +7 -0
  224. package/dist/types/fields/src/fields-data-adapter.d.ts +111 -0
  225. package/dist/types/fields/src/fields-data-provider.d.ts +45 -0
  226. package/dist/types/fields/src/hooks/use-debounced-value.d.ts +1 -0
  227. package/dist/types/fields/src/hooks/use-row-edit-shortcuts.d.ts +15 -0
  228. package/dist/types/fields/src/index.d.ts +38 -0
  229. package/dist/types/fields/src/lib/is-row-doc-dirty.d.ts +2 -0
  230. package/dist/types/fields/src/lib/scroll-to-form-field.d.ts +6 -0
  231. package/dist/types/fields/src/media-library-query.d.ts +34 -0
  232. package/dist/types/fields/src/media-upload-limits.d.ts +18 -0
  233. package/dist/types/fields/src/record-actions-context.d.ts +17 -0
  234. package/dist/types/fields/src/storage-upload.d.ts +21 -0
  235. package/dist/types/primitives/src/components/ui/accordion.d.ts +6 -0
  236. package/dist/types/primitives/src/components/ui/alert-dialog.d.ts +12 -0
  237. package/dist/types/primitives/src/components/ui/badge.d.ts +9 -0
  238. package/dist/types/primitives/src/components/ui/button.d.ts +11 -0
  239. package/dist/types/primitives/src/components/ui/calendar.d.ts +8 -0
  240. package/dist/types/primitives/src/components/ui/card.d.ts +7 -0
  241. package/dist/types/primitives/src/components/ui/checkbox.d.ts +3 -0
  242. package/dist/types/primitives/src/components/ui/dialog.d.ts +15 -0
  243. package/dist/types/primitives/src/components/ui/dropdown-menu.d.ts +10 -0
  244. package/dist/types/primitives/src/components/ui/info-hint.d.ts +37 -0
  245. package/dist/types/primitives/src/components/ui/input.d.ts +2 -0
  246. package/dist/types/primitives/src/components/ui/label.d.ts +3 -0
  247. package/dist/types/primitives/src/components/ui/popover.d.ts +6 -0
  248. package/dist/types/primitives/src/components/ui/save-bar.d.ts +43 -0
  249. package/dist/types/primitives/src/components/ui/select.d.ts +8 -0
  250. package/dist/types/primitives/src/components/ui/separator.d.ts +3 -0
  251. package/dist/types/primitives/src/components/ui/sheet.d.ts +18 -0
  252. package/dist/types/primitives/src/components/ui/sonner.d.ts +1 -0
  253. package/dist/types/primitives/src/components/ui/switch.d.ts +3 -0
  254. package/dist/types/primitives/src/components/ui/table.d.ts +7 -0
  255. package/dist/types/primitives/src/components/ui/tabs.d.ts +6 -0
  256. package/dist/types/primitives/src/components/ui/tooltip.d.ts +6 -0
  257. package/dist/types/primitives/src/index.d.ts +28 -0
  258. package/dist/types/primitives/src/lib/animation-frame-batcher.d.ts +11 -0
  259. package/dist/types/primitives/src/lib/locale-week-start.d.ts +5 -0
  260. package/dist/types/primitives/src/lib/save-bar-logic.d.ts +52 -0
  261. package/dist/types/primitives/src/lib/use-raf-batched-pointer-drag.d.ts +31 -0
  262. package/dist/types/primitives/src/lib/use-save-bar.d.ts +36 -0
  263. package/dist/types/primitives/src/lib/use-unsaved-changes-guard.d.ts +15 -0
  264. package/dist/types/primitives/src/lib/utils.d.ts +6 -0
  265. package/dist/types/richtext/src/editor.d.ts +16 -0
  266. package/dist/types/richtext/src/host-adapter.d.ts +66 -0
  267. package/dist/types/richtext/src/index.d.ts +11 -0
  268. package/dist/types/richtext/src/markdown-editor/editor-styles.d.ts +7 -0
  269. package/dist/types/richtext/src/markdown-editor/markdown-editor-dialog.d.ts +16 -0
  270. package/dist/types/richtext/src/markdown-editor/markdown-editor.d.ts +2 -0
  271. package/dist/types/richtext/src/markdown-editor/markdown-field-input.d.ts +11 -0
  272. package/dist/types/richtext/src/markdown-editor/markdown-field-trigger.d.ts +8 -0
  273. package/dist/types/richtext/src/markdown-editor/markdown-insert-pickers-session.d.ts +5 -0
  274. package/dist/types/richtext/src/markdown-editor/markdown-insert-pickers.d.ts +9 -0
  275. package/dist/types/richtext/src/markdown-editor/markdown-preview.d.ts +7 -0
  276. package/dist/types/richtext/src/markdown-editor/markdown-rich-preview.d.ts +5 -0
  277. package/dist/types/richtext/src/markdown-editor/record-link-picker-session.d.ts +7 -0
  278. package/dist/types/richtext/src/markdown-editor/record-link-picker.d.ts +9 -0
  279. package/dist/types/richtext/src/markdown-editor/record-table-picker.d.ts +21 -0
  280. package/dist/types/richtext/src/markdown-editor/use-markdown-insert-pickers.d.ts +33 -0
  281. package/dist/types/richtext/src/record-table-view.d.ts +17 -0
  282. package/dist/types/richtext/src/rich-doc-view.d.ts +30 -0
  283. package/dist/types/richtext/src/rich-text-editor/blocknote-editor.d.ts +25 -0
  284. package/dist/types/richtext/src/rich-text-editor/blocknote-portaled-dropdown.d.ts +2 -0
  285. package/dist/types/richtext/src/rich-text-editor/blocknote-preview.d.ts +12 -0
  286. package/dist/types/richtext/src/rich-text-editor/record-link-inline.d.ts +15 -0
  287. package/dist/types/richtext/src/rich-text-editor/record-link-rows-context.d.ts +9 -0
  288. package/dist/types/richtext/src/rich-text-editor/record-table-block.d.ts +18 -0
  289. package/dist/types/richtext/src/rich-text-editor/studio-schema.d.ts +283 -0
  290. package/dist/types/richtext/src/rich-text-editor/studio-slash-menu.d.ts +8 -0
  291. package/dist/types/richtext/src/rich-text-editor/use-sync-blocknote-value.d.ts +2 -0
  292. package/dist/types/shared/src/apiProfile.d.ts +164 -0
  293. package/dist/types/shared/src/apiProfileDiscovery.d.ts +88 -0
  294. package/dist/types/shared/src/apiProfileSlug.d.ts +11 -0
  295. package/dist/types/shared/src/apiProfileSources.d.ts +112 -0
  296. package/dist/types/shared/src/apiProfileValidators.d.ts +310 -0
  297. package/dist/types/shared/src/apiToken.d.ts +6 -0
  298. package/dist/types/shared/src/assetFamily.d.ts +38 -0
  299. package/dist/types/shared/src/assetFieldValues.d.ts +21 -0
  300. package/dist/types/shared/src/assetGraph.d.ts +221 -0
  301. package/dist/types/shared/src/assetJobs.d.ts +99 -0
  302. package/dist/types/shared/src/assetSettings.d.ts +147 -0
  303. package/dist/types/shared/src/auditRedact.d.ts +36 -0
  304. package/dist/types/shared/src/betterAuthSession.d.ts +12 -0
  305. package/dist/types/shared/src/bffHost.d.ts +36 -0
  306. package/dist/types/shared/src/bffProtocol.d.ts +563 -0
  307. package/dist/types/shared/src/bffRedact.d.ts +30 -0
  308. package/dist/types/shared/src/ciPreviewEnv.d.ts +21 -0
  309. package/dist/types/shared/src/clipboardTransfer.d.ts +25 -0
  310. package/dist/types/shared/src/convexFacade.d.ts +44 -0
  311. package/dist/types/shared/src/convexSiteUrl.d.ts +73 -0
  312. package/dist/types/shared/src/csv.d.ts +65 -0
  313. package/dist/types/shared/src/dataTransfer.d.ts +21 -0
  314. package/dist/types/shared/src/dateValues.d.ts +21 -0
  315. package/dist/types/shared/src/deployOutput.d.ts +3 -0
  316. package/dist/types/shared/src/displayLabel.d.ts +17 -0
  317. package/dist/types/shared/src/displayTemplateGenerator.d.ts +11 -0
  318. package/dist/types/shared/src/displayTypes.d.ts +10 -0
  319. package/dist/types/shared/src/erdLayout.d.ts +27 -0
  320. package/dist/types/shared/src/facets.d.ts +109 -0
  321. package/dist/types/shared/src/failureMessage.d.ts +5 -0
  322. package/dist/types/shared/src/fieldTypeMeta.d.ts +110 -0
  323. package/dist/types/shared/src/fieldTypeText.d.ts +34 -0
  324. package/dist/types/shared/src/fieldValueEqual.d.ts +10 -0
  325. package/dist/types/shared/src/fieldValueShape.d.ts +24 -0
  326. package/dist/types/shared/src/fieldValueText.d.ts +32 -0
  327. package/dist/types/shared/src/gridQuery.d.ts +103 -0
  328. package/dist/types/shared/src/importMatch.d.ts +80 -0
  329. package/dist/types/shared/src/index.d.ts +78 -0
  330. package/dist/types/shared/src/inferIdentifier.d.ts +18 -0
  331. package/dist/types/shared/src/keyboard.d.ts +16 -0
  332. package/dist/types/shared/src/manifestDeploy.d.ts +31 -0
  333. package/dist/types/shared/src/manifestHash.d.ts +12 -0
  334. package/dist/types/shared/src/mcpOAuth.d.ts +182 -0
  335. package/dist/types/shared/src/postLoginPath.d.ts +21 -0
  336. package/dist/types/shared/src/previewDeployName.d.ts +27 -0
  337. package/dist/types/shared/src/proposalDraftMerge.d.ts +35 -0
  338. package/dist/types/shared/src/proposePolicy.d.ts +17 -0
  339. package/dist/types/shared/src/proposeRateLimit.d.ts +27 -0
  340. package/dist/types/shared/src/queryBetween.d.ts +21 -0
  341. package/dist/types/shared/src/queryConditions.d.ts +46 -0
  342. package/dist/types/shared/src/queryExecution.d.ts +12 -0
  343. package/dist/types/shared/src/queryFieldOps.d.ts +123 -0
  344. package/dist/types/shared/src/queryMerge.d.ts +30 -0
  345. package/dist/types/shared/src/queryPlan.d.ts +86 -0
  346. package/dist/types/shared/src/queryStudio.d.ts +28 -0
  347. package/dist/types/shared/src/queryTypes.d.ts +184 -0
  348. package/dist/types/shared/src/queryValidators.d.ts +233 -0
  349. package/dist/types/shared/src/readApiQuery.d.ts +10 -0
  350. package/dist/types/shared/src/readModelLimits.d.ts +23 -0
  351. package/dist/types/shared/src/recordTableColumns.d.ts +24 -0
  352. package/dist/types/shared/src/recordTablePreload.d.ts +19 -0
  353. package/dist/types/shared/src/refDisplayRequests.d.ts +17 -0
  354. package/dist/types/shared/src/refGraph.d.ts +97 -0
  355. package/dist/types/shared/src/refsRecompute.d.ts +16 -0
  356. package/dist/types/shared/src/richDoc.d.ts +80 -0
  357. package/dist/types/shared/src/rowPatchWire.d.ts +12 -0
  358. package/dist/types/shared/src/rowTrash.d.ts +26 -0
  359. package/dist/types/shared/src/savedView.d.ts +37 -0
  360. package/dist/types/shared/src/schemaGenerator.d.ts +36 -0
  361. package/dist/types/shared/src/schemaShrink.d.ts +82 -0
  362. package/dist/types/shared/src/schemaShrinkValidators.d.ts +72 -0
  363. package/dist/types/shared/src/schemaTypes.d.ts +311 -0
  364. package/dist/types/shared/src/share.d.ts +8 -0
  365. package/dist/types/shared/src/shareApiBridge.d.ts +13 -0
  366. package/dist/types/shared/src/shareGuestPolicy.d.ts +14 -0
  367. package/dist/types/shared/src/shareProposal.d.ts +141 -0
  368. package/dist/types/shared/src/shareProposalDiff.d.ts +13 -0
  369. package/dist/types/shared/src/shareScopes.d.ts +19 -0
  370. package/dist/types/shared/src/shareTokenCrypto.d.ts +9 -0
  371. package/dist/types/shared/src/shareTokens.d.ts +6 -0
  372. package/dist/types/shared/src/shareTypes.d.ts +113 -0
  373. package/dist/types/shared/src/shareWizard.d.ts +23 -0
  374. package/dist/types/shared/src/spaceBundle.d.ts +89 -0
  375. package/dist/types/shared/src/stagedApiAccess.d.ts +104 -0
  376. package/dist/types/shared/src/studioBoot.d.ts +63 -0
  377. package/dist/types/shared/src/syncChannel.d.ts +25 -0
  378. package/dist/types/shared/src/syncClampMembership.d.ts +22 -0
  379. package/dist/types/shared/src/tableSearch.d.ts +52 -0
  380. package/dist/types/shared/src/tenantHosts.d.ts +34 -0
  381. package/dist/types/shared/src/tenantSecretsCrypto.d.ts +31 -0
  382. package/dist/types/shared/src/useDebouncedCommit.d.ts +15 -0
  383. package/dist/types/shared/src/useDebouncedValue.d.ts +1 -0
  384. package/dist/types/shared/src/useModifierHeld.d.ts +2 -0
  385. package/package.json +85 -3
  386. package/README.md +0 -3
@@ -0,0 +1,21 @@
1
+ export type BetweenValue = {
2
+ min: unknown;
3
+ max: unknown;
4
+ };
5
+ export type BetweenIndexBound = {
6
+ op: "gte";
7
+ value: unknown;
8
+ } | {
9
+ op: "lte";
10
+ value: unknown;
11
+ } | {
12
+ op: "between";
13
+ min: unknown;
14
+ max: unknown;
15
+ };
16
+ export declare function isCompleteBetween(value: BetweenValue): boolean;
17
+ /** Convert inclusive `between` UI state into the strongest available index range. */
18
+ export declare function betweenToIndexBound(value: BetweenValue): BetweenIndexBound | null;
19
+ /** A missing value matches only a between without bounds. */
20
+ export declare function matchesBetween(value: unknown, between: BetweenValue): boolean;
21
+ export declare function compareOrdered(a: unknown, b: unknown): number;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Walking a query's condition tree (plan 103 D6): `Query.predicates` holds predicates and
3
+ * `or`/`and` groups of them, ANDed at the top level. Matching stays in
4
+ * `documentMatchesPredicates`; SQL is the read model's `conditionsSql`.
5
+ */
6
+ import type { Condition, Predicate } from "./queryTypes.ts";
7
+ export type GroupOp = "or" | "and";
8
+ type GroupParts = {
9
+ op: GroupOp;
10
+ children: Condition[];
11
+ };
12
+ /** Whether `condition` is a predicate rather than a group. */
13
+ export declare function isPredicate(condition: Condition): condition is Predicate;
14
+ /** A group's operator and children; null for a predicate. */
15
+ export declare function groupOf(condition: Exclude<Condition, Predicate>): GroupParts;
16
+ export declare function groupOf(condition: Condition): GroupParts | null;
17
+ /** `children` joined by `op`: callers keep it within MAX_GROUP_DEPTH, so it is a `Condition`. */
18
+ export declare function makeGroup(op: GroupOp, children: Condition[]): Condition;
19
+ /** A group's children; none for a predicate. */
20
+ export declare function groupChildren(condition: Condition): Condition[];
21
+ /**
22
+ * A group's children as text, joined by its operator, nested groups in brackets; `leaf` writes a
23
+ * predicate and is told whether its group is an `or`.
24
+ */
25
+ export declare function groupText(group: Condition, leaf: (pred: Predicate, inOr: boolean) => string): string;
26
+ /** Every predicate in `conditions`, at any depth, in order. */
27
+ export declare function conditionPredicates(conditions: readonly Condition[]): Predicate[];
28
+ /**
29
+ * `conditions` with each predicate replaced by `fn`'s result, or removed when it returns null;
30
+ * a group left without children is removed too.
31
+ */
32
+ export declare function mapConditions(conditions: readonly Condition[], fn: (predicate: Predicate) => Predicate | null): Condition[];
33
+ /**
34
+ * The same conditions, simpler, in the author's order: a one-child group becomes its child, and
35
+ * an `and` inside the top level or an `and`, or an `or` inside an `or`, gives up its children.
36
+ * An empty group stays (an empty `or` matches nothing).
37
+ */
38
+ export declare function normalizeConditions(conditions: readonly Condition[]): Condition[];
39
+ /**
40
+ * `conditions` for comparison only: normalized, in canonical order at every level (values
41
+ * included), so reordered conditions compare equal. Structural, not Boolean, equivalence.
42
+ */
43
+ export declare function compareConditions(conditions: readonly Condition[]): Condition[];
44
+ /** A condition's identity: equal for the same structure in any order, values included. */
45
+ export declare function conditionKey(condition: Condition): string;
46
+ export {};
@@ -0,0 +1,12 @@
1
+ import type { Condition, Predicate, Query, QueryOrder } from "./queryTypes.ts";
2
+ /** The value at a field or object sub-field path (`Place.city`); missing when a segment is. */
3
+ export declare function readPath(doc: Record<string, unknown>, path: string): unknown;
4
+ /** Whether a document matches every condition, groups at any depth included. */
5
+ export declare function documentMatchesPredicates(doc: Record<string, unknown>, conditions: readonly Condition[]): boolean;
6
+ export declare function documentMatchesPredicate(doc: Record<string, unknown>, predicate: Predicate): boolean;
7
+ /** Missing, `null`, `""` and `[]` are empty; whitespace-only strings are not. */
8
+ export declare function isEmptyValue(value: unknown): boolean;
9
+ /** Stable sort by `order`; missing values sort last in both directions. */
10
+ export declare function sortDocuments<T extends Record<string, unknown>>(docs: T[], order: QueryOrder): T[];
11
+ /** Rows already in memory that match `query`'s predicates, in its order. */
12
+ export declare function filterSortDocuments<T extends Record<string, unknown>>(docs: readonly T[], query: Pick<Query, "predicates" | "order"> | null | undefined): T[];
@@ -0,0 +1,123 @@
1
+ import type { Field, FieldType, Table } from "./schemaTypes.ts";
2
+ /** One edit surface for each predicate operation's wire shape and UI label. */
3
+ export declare const PREDICATE_VARIANTS: readonly [{
4
+ readonly value: "unknown";
5
+ readonly ops: readonly [{
6
+ readonly op: "eq";
7
+ readonly label: "=";
8
+ }, {
9
+ readonly op: "neq";
10
+ readonly label: "≠";
11
+ }];
12
+ }, {
13
+ readonly value: "string";
14
+ readonly ops: readonly [{
15
+ readonly op: "contains";
16
+ readonly label: "contains";
17
+ }];
18
+ }, {
19
+ readonly value: "unknownArray";
20
+ readonly ops: readonly [{
21
+ readonly op: "in";
22
+ readonly label: "in";
23
+ }];
24
+ }, {
25
+ readonly value: "unknown";
26
+ readonly ops: readonly [{
27
+ readonly op: "gt";
28
+ readonly label: ">";
29
+ }, {
30
+ readonly op: "gte";
31
+ readonly label: "≥";
32
+ }, {
33
+ readonly op: "lt";
34
+ readonly label: "<";
35
+ }, {
36
+ readonly op: "lte";
37
+ readonly label: "≤";
38
+ }];
39
+ }, {
40
+ readonly value: "between";
41
+ readonly ops: readonly [{
42
+ readonly op: "between";
43
+ readonly label: "between";
44
+ }];
45
+ }, {
46
+ readonly value: "unknownArray";
47
+ readonly ops: readonly [{
48
+ readonly op: "containsAll";
49
+ readonly label: "contains all";
50
+ }, {
51
+ readonly op: "containsAny";
52
+ readonly label: "contains any";
53
+ }];
54
+ }, {
55
+ readonly value: "none";
56
+ readonly ops: readonly [{
57
+ readonly op: "isEmpty";
58
+ readonly label: "is empty";
59
+ }, {
60
+ readonly op: "isNotEmpty";
61
+ readonly label: "is not empty";
62
+ }];
63
+ }];
64
+ export type PredicateVariant = (typeof PREDICATE_VARIANTS)[number];
65
+ type PredicateOperator = PredicateVariant["ops"][number];
66
+ export type PredicateOp = PredicateOperator["op"];
67
+ export declare const PREDICATE_OPS: PredicateOp[];
68
+ export declare function predicateOpLabel(op: PredicateOp): string;
69
+ export type FieldOpSupport = {
70
+ eq: boolean;
71
+ neq: boolean;
72
+ in: boolean;
73
+ ranges: boolean;
74
+ sort: boolean;
75
+ /** `containsAll` and `containsAny`: lists of ids or short scalars. */
76
+ containsAll: boolean;
77
+ /** Text, or a text list's elements, holding a substring: case- and accent-insensitive. */
78
+ contains: boolean;
79
+ };
80
+ /**
81
+ * The fields along a dotted path: `Place.city` is `Place`, then its object sub-field `city`, at
82
+ * any depth; with `throughLists` also into the objects of a list (search paths, plan 106). Null
83
+ * when a segment is unknown or follows a field without sub-fields.
84
+ */
85
+ export declare function fieldsAlongPath(table: Pick<Table, "fields">, path: string, throughLists?: boolean): Field[] | null;
86
+ /**
87
+ * Every queryable path: each field, then its object sub-fields at any depth (with `throughLists`
88
+ * also those of objects in lists), as fields named by their path; `fieldLabel` labels them. A
89
+ * sub-field is optional when any segment is.
90
+ */
91
+ export declare function queryFields(table: Pick<Table, "fields">, throughLists?: boolean): Field[];
92
+ /**
93
+ * Resolve type + optionality of a field, an object sub-field path (`Place.city`) or a system
94
+ * field (`_id`, `_creationTime`; always required). A sub-field is optional when any segment is.
95
+ */
96
+ export declare function resolveQueryField(table: Pick<Table, "name" | "fields">, path: string): Pick<Field, "type" | "optional"> | null;
97
+ export declare function resolveQueryFieldType(table: Pick<Table, "name" | "fields">, path: string): FieldType | null;
98
+ /** Effective type used for operator eligibility (unwraps homogeneous unions). */
99
+ export declare function effectiveQueryFieldType(t: FieldType): FieldType | null;
100
+ export declare function fieldOpSupport(type: FieldType): FieldOpSupport;
101
+ export declare function opAllowedForType(type: FieldType, op: PredicateOp): boolean;
102
+ /** Like {@link opAllowedForType}, but a missing optional field also counts as empty. */
103
+ export declare function opAllowedForField(field: Pick<Field, "type" | "optional">, op: PredicateOp): boolean;
104
+ export declare function isEmptinessOp(op: PredicateOp): op is "isEmpty" | "isNotEmpty";
105
+ export declare function fieldSupportsSort(type: FieldType): boolean;
106
+ /**
107
+ * Whether the read model groups by this type (plan 098): a sortable value, or a list of ids or
108
+ * short scalars, whose rows count once per distinct element. Other lists and objects are opaque.
109
+ */
110
+ export declare function fieldSupportsGroup(type: FieldType): boolean;
111
+ /** Whether a group level on this type takes a date bucket: single dates and date-times. */
112
+ export declare function fieldSupportsGroupBucket(type: FieldType): boolean;
113
+ /** How a field facets (plan 101): its values, date buckets, or a min/max range. */
114
+ export type FacetKind = "values" | "dateBuckets" | "range";
115
+ /** Facetable fields are the groupable ones; numbers that aren't choices are ranges. */
116
+ export declare function facetKind(type: FieldType): FacetKind | null;
117
+ export declare function isRangeOp(op: PredicateOp): boolean;
118
+ /** Body of the per-column header filter popover (Empty / Not empty is offered separately). */
119
+ export type ColumnFilterEditor = "enumChecklist" | "idChecklist"
120
+ /** `id[]` columns: checked ids map to `containsAll` (row has all of them). */
121
+ | "idListChecklist" | "boolean" | "text" | "number" | "date" | "none";
122
+ export declare function columnFilterEditor(type: FieldType): ColumnFilterEditor;
123
+ export {};
@@ -0,0 +1,30 @@
1
+ import { type ClampQuery, type Condition, type Query, type QueryError } from "./queryTypes.ts";
2
+ export type MergedQuery = {
3
+ /** Logical caller query after predicate/default merge; preserves explicit caller options. */
4
+ query: Query;
5
+ /** Execution ceiling after applying the profile/share limit to the caller request. */
6
+ effectiveMaxScan: number;
7
+ };
8
+ export type MergeQueryInput = {
9
+ caller?: Query | null;
10
+ clamp?: ClampQuery | null;
11
+ /** Profile/share ceiling; defaults to {@link DEFAULT_MAX_SCAN_LIMIT}. */
12
+ maxScanLimit?: number;
13
+ };
14
+ /** Same predicate, or the same group in any order (values included). */
15
+ export declare function predicatesEqual(a: Condition, b: Condition): boolean;
16
+ /** Detect contradictory equality / membership on the same field, among top-level predicates. */
17
+ export declare function findUnsatisfiablePredicates(conditions: Condition[]): QueryError | null;
18
+ /**
19
+ * AND-merge clamp with caller query.
20
+ * Clamp supplies the default order (caller may override).
21
+ * The caller's optional `maxScan` stays in the AST; `effectiveMaxScan` applies the ceiling.
22
+ * `indexHint` comes from the caller only.
23
+ */
24
+ export declare function mergeQuery(input: MergeQueryInput): {
25
+ ok: true;
26
+ merged: MergedQuery;
27
+ } | {
28
+ ok: false;
29
+ error: QueryError;
30
+ };
@@ -0,0 +1,86 @@
1
+ import type { Table } from "./schemaTypes.ts";
2
+ import { type MergedQuery } from "./queryMerge.ts";
3
+ import { type Condition, type ListMeta, type Predicate, type Query, type QueryError, type QueryOrder } from "./queryTypes.ts";
4
+ export type IndexRangeBound = {
5
+ op: "gt" | "gte" | "lt" | "lte";
6
+ value: unknown;
7
+ } | {
8
+ op: "between";
9
+ min: unknown;
10
+ max: unknown;
11
+ } | {
12
+ op: "bounded";
13
+ lower: {
14
+ op: "gt" | "gte";
15
+ value: unknown;
16
+ };
17
+ upper: {
18
+ op: "lt" | "lte";
19
+ value: unknown;
20
+ };
21
+ };
22
+ export type PlannedIndexAccess = {
23
+ name: string;
24
+ eqs: {
25
+ field: string;
26
+ value: unknown;
27
+ }[];
28
+ /** Optional range on the next index field after eqs (Convex-native). */
29
+ range?: {
30
+ field: string;
31
+ bound: IndexRangeBound;
32
+ };
33
+ /** Convex `.order` when the index order satisfies `query.order`. */
34
+ direction?: "asc" | "desc";
35
+ };
36
+ export type PlannedAccess = {
37
+ mode: "index";
38
+ index: PlannedIndexAccess;
39
+ } | {
40
+ mode: "table";
41
+ direction?: "asc" | "desc";
42
+ };
43
+ export type PlannedPage = {
44
+ mode: "paginate";
45
+ } | {
46
+ mode: "boundedSort";
47
+ order: QueryOrder;
48
+ maxScan: number;
49
+ };
50
+ export type QueryPlan = {
51
+ access: PlannedAccess;
52
+ page: PlannedPage;
53
+ /** Conditions applied after index access (post-filter); every group is one. */
54
+ postFilters: Condition[];
55
+ };
56
+ export type PlanQueryResult = {
57
+ ok: true;
58
+ plan: QueryPlan;
59
+ } | {
60
+ ok: false;
61
+ error: QueryError;
62
+ };
63
+ export type PlanQueryOptions = {
64
+ /** Effective execution ceiling after applying profile/share policy. */
65
+ effectiveMaxScan?: number;
66
+ };
67
+ /**
68
+ * Build public list explain metadata from an executable plan.
69
+ * Call once when constructing {@link ListMeta} on a list result — not stored on {@link QueryPlan}.
70
+ */
71
+ export declare function deriveListMeta(access: PlannedAccess, page: PlannedPage, order?: QueryOrder): ListMeta;
72
+ /** Share scopes that resolve rows from an explicit ID list (outside the Query planner). */
73
+ export declare function idListMeta(scanned: number, truncated?: boolean): ListMeta;
74
+ /**
75
+ * Build an executable plan for a (already merged) query against a table manifest.
76
+ */
77
+ export declare function planQuery(table: Pick<Table, "name" | "fields" | "indexes">, query: Query | null | undefined, options?: PlanQueryOptions): PlanQueryResult;
78
+ /** Plan a caller query with optional clamp using {@link mergeQuery} semantics externally. */
79
+ export declare function planMergedQuery(table: Pick<Table, "name" | "fields" | "indexes">, merged: MergedQuery): PlanQueryResult;
80
+ /** Whether a condition is an `_id eq` / `_id in` predicate. */
81
+ export declare function isIdLookupPredicate(condition: Condition): condition is Predicate;
82
+ /**
83
+ * Ids every `_id eq` / `_id in` predicate allows (intersection; non-string
84
+ * values never match), or null when no predicate looks up ids.
85
+ */
86
+ export declare function idLookupIds(predicates: readonly Predicate[]): Set<string> | null;
@@ -0,0 +1,28 @@
1
+ import type { ClampQuery, Condition, Query, QueryOrder } from "./queryTypes.ts";
2
+ import { queriesEqual } from "./queryTypes.ts";
3
+ import type { Table } from "./schemaTypes.ts";
4
+ import type { GridQuery } from "./gridQuery.ts";
5
+ export declare function isEmptyQuery(query: GridQuery | null | undefined): boolean;
6
+ /** `query` with `predicates` replaced; null when nothing (not even sort) is left. */
7
+ export declare function withPredicates<Q extends GridQuery>(query: Q | null, predicates: Condition[]): Q | null;
8
+ export declare function queryHasActiveConstraints(query: Query | null | undefined): boolean;
9
+ /**
10
+ * Clamp conditions that would only apply as post-filters (not index-backed), groups
11
+ * always. Used for authoring warnings; residual clamps are still executable.
12
+ */
13
+ export declare function residualClampPredicates(table: Pick<Table, "name" | "fields" | "indexes">, clamp: ClampQuery | null | undefined): Condition[];
14
+ /** Suggest index fields from active predicates + sort for create-index CTA. */
15
+ export declare function suggestIndexFields(query: Query | null | undefined): string[];
16
+ /** User fields that support sort, plus system `_creationTime` and `_id`. */
17
+ export declare function sortableQueryFields(table: Pick<Table, "name" | "fields">): string[];
18
+ /** Set or clear `Query.order`. Returns null when the result is empty. */
19
+ export declare function setQueryOrder(query: Query | null, order: QueryOrder | null): Query | null;
20
+ /**
21
+ * Field select for order editors: `null` clears order; a new field keeps the
22
+ * current direction when present, otherwise defaults to `asc`.
23
+ */
24
+ export declare function setQueryOrderField(query: Query | null, field: string | null): Query | null;
25
+ export declare function setQueryOrderDirection(query: Query | null, direction: QueryOrder["direction"]): Query | null;
26
+ /** `query` without what the table no longer supports: predicates go at any depth. */
27
+ export declare function validateQueryForTable(table: Table, query: Query): Query | null;
28
+ export { queriesEqual };
@@ -0,0 +1,184 @@
1
+ import { z } from "zod";
2
+ import type { BetweenValue } from "./queryBetween.ts";
3
+ import type { GridQuery } from "./gridQuery.ts";
4
+ import { PREDICATE_OPS, type PredicateOp, type PredicateVariant } from "./queryFieldOps.ts";
5
+ export { PREDICATE_OPS, type PredicateOp };
6
+ /** Platform default scan ceiling when profile/share omits `maxScanLimit`. */
7
+ export declare const DEFAULT_MAX_SCAN_LIMIT = 1000;
8
+ /** How rows are accessed before residual filters / page mode. */
9
+ export declare const listAccessKindSchema: z.ZodEnum<{
10
+ table: "table";
11
+ index: "index";
12
+ idList: "idList";
13
+ }>;
14
+ export type ListAccessKind = z.infer<typeof listAccessKindSchema>;
15
+ /** How the page is materialized from the access stream. */
16
+ export declare const listPageKindSchema: z.ZodEnum<{
17
+ paginate: "paginate";
18
+ boundedSort: "boundedSort";
19
+ }>;
20
+ export type ListPageKind = z.infer<typeof listPageKindSchema>;
21
+ export declare const queryErrorCodeSchema: z.ZodEnum<{
22
+ query_invalid: "query_invalid";
23
+ query_unsupported: "query_unsupported";
24
+ query_unsatisfiable: "query_unsatisfiable";
25
+ }>;
26
+ export type QueryErrorCode = z.infer<typeof queryErrorCodeSchema>;
27
+ /** Each value kind's TypeScript type; Zod, Convex and codegen each map the same keys. */
28
+ type PredicateValues = {
29
+ unknown: unknown;
30
+ unknownArray: unknown[];
31
+ between: BetweenValue;
32
+ none: null;
33
+ string: string;
34
+ };
35
+ type PredicateValue<Kind extends PredicateVariant["value"]> = PredicateValues[Kind];
36
+ export type Predicate = PredicateVariant extends infer Variant ? Variant extends PredicateVariant ? {
37
+ field: string;
38
+ op: Variant["ops"][number]["op"];
39
+ value: PredicateValue<Variant["value"]>;
40
+ } : never : never;
41
+ export declare const predicateOpSchema: z.ZodEnum<{
42
+ gte: "gte";
43
+ lte: "lte";
44
+ between: "between";
45
+ eq: "eq";
46
+ neq: "neq";
47
+ contains: "contains";
48
+ in: "in";
49
+ gt: "gt";
50
+ lt: "lt";
51
+ containsAll: "containsAll";
52
+ containsAny: "containsAny";
53
+ isEmpty: "isEmpty";
54
+ isNotEmpty: "isNotEmpty";
55
+ }>;
56
+ export declare const predicateSchema: z.ZodType<Predicate>;
57
+ type Group<C> = {
58
+ or: C[];
59
+ } | {
60
+ and: C[];
61
+ };
62
+ /**
63
+ * A leaf `P`, or a non-empty `or`/`and` group of conditions, up to {@link MAX_GROUP_DEPTH} group
64
+ * levels deep (plan 103 D7): the depth of `conditionSchema`, `conditionValidator` and so of the
65
+ * component API Convex generates from it.
66
+ */
67
+ export type ConditionOf<P> = P | Group<P | Group<P | Group<P>>>;
68
+ /** One item of `Query.predicates`, ANDed at the top level. */
69
+ export type Condition = ConditionOf<Predicate>;
70
+ /** Group levels a condition holds at most below the top-level list. */
71
+ export declare const MAX_GROUP_DEPTH = 3;
72
+ export declare const conditionSchema: z.ZodType<Condition>;
73
+ export declare const queryOrderSchema: z.ZodObject<{
74
+ field: z.ZodString;
75
+ direction: z.ZodEnum<{
76
+ asc: "asc";
77
+ desc: "desc";
78
+ }>;
79
+ }, z.core.$strip>;
80
+ export type QueryOrder = z.infer<typeof queryOrderSchema>;
81
+ export declare const querySchema: z.ZodObject<{
82
+ predicates: z.ZodOptional<z.ZodArray<z.ZodType<Condition, unknown, z.core.$ZodTypeInternals<Condition, unknown>>>>;
83
+ order: z.ZodOptional<z.ZodObject<{
84
+ field: z.ZodString;
85
+ direction: z.ZodEnum<{
86
+ asc: "asc";
87
+ desc: "desc";
88
+ }>;
89
+ }, z.core.$strip>>;
90
+ maxScan: z.ZodOptional<z.ZodNumber>;
91
+ indexHint: z.ZodOptional<z.ZodString>;
92
+ }, z.core.$strip>;
93
+ export type Query = z.infer<typeof querySchema>;
94
+ /** `in`, `containsAll` and `containsAny`: the predicates whose value is a list. */
95
+ export declare function isListPredicate(predicate: Predicate): predicate is Extract<Predicate, {
96
+ value: unknown[];
97
+ }>;
98
+ export declare function makePredicate(field: string, op: PredicateOp, value: unknown): Predicate;
99
+ /** Profile/share clamp: predicates and an optional default order. */
100
+ export declare const clampQuerySchema: z.ZodObject<{
101
+ predicates: z.ZodOptional<z.ZodArray<z.ZodType<Condition, unknown, z.core.$ZodTypeInternals<Condition, unknown>>>>;
102
+ order: z.ZodOptional<z.ZodObject<{
103
+ field: z.ZodString;
104
+ direction: z.ZodEnum<{
105
+ asc: "asc";
106
+ desc: "desc";
107
+ }>;
108
+ }, z.core.$strip>>;
109
+ }, z.core.$strip>;
110
+ export type ClampQuery = z.infer<typeof clampQuerySchema>;
111
+ export declare const listMetaSchema: z.ZodObject<{
112
+ access: z.ZodEnum<{
113
+ table: "table";
114
+ index: "index";
115
+ idList: "idList";
116
+ }>;
117
+ page: z.ZodEnum<{
118
+ paginate: "paginate";
119
+ boundedSort: "boundedSort";
120
+ }>;
121
+ order: z.ZodOptional<z.ZodObject<{
122
+ field: z.ZodString;
123
+ direction: z.ZodEnum<{
124
+ asc: "asc";
125
+ desc: "desc";
126
+ }>;
127
+ }, z.core.$strip>>;
128
+ indexName: z.ZodOptional<z.ZodString>;
129
+ scanned: z.ZodOptional<z.ZodNumber>;
130
+ truncated: z.ZodOptional<z.ZodBoolean>;
131
+ }, z.core.$strip>;
132
+ export type ListMeta = z.infer<typeof listMetaSchema>;
133
+ export type ListResult<T> = {
134
+ page: T[];
135
+ isDone: boolean;
136
+ continueCursor: string;
137
+ meta: ListMeta;
138
+ };
139
+ export type QueryError = {
140
+ code: QueryErrorCode;
141
+ message: string;
142
+ };
143
+ /** A top-level empty `containsAll` / `containsAny` is no filter; drop before plan/URL. */
144
+ export declare function stripEmptyContainsAllPredicates(conditions: Condition[]): Condition[];
145
+ /** Simplify groups and drop no-op list predicates so list planning and URLs stay stable. */
146
+ export declare function normalizeQuery(query: Query): Query;
147
+ /** A `query_invalid` error listing a failed parse's issues, or `fallback` without any. */
148
+ export declare function queryInvalidError(issues: readonly {
149
+ message: string;
150
+ }[], fallback: string): QueryError;
151
+ export declare function parseQuery(input: unknown): {
152
+ ok: true;
153
+ query: Query;
154
+ } | {
155
+ ok: false;
156
+ error: QueryError;
157
+ };
158
+ export declare function parseClampQuery(input: unknown): {
159
+ ok: true;
160
+ query: ClampQuery;
161
+ } | {
162
+ ok: false;
163
+ error: QueryError;
164
+ };
165
+ /**
166
+ * Refuses (`query_invalid`) a row clamp that listing would refuse (plan 103 D3). Sync, proposals
167
+ * and CMS save match a stored clamp as it is, so every clamp write checks it; it is stored as sent.
168
+ * A clamp stored before plan 106 may still carry a fixed `search`: readers ignore it, and a write
169
+ * refuses it (D8).
170
+ */
171
+ export declare function assertClampQuery(rowQuery: ClampQuery | undefined): void;
172
+ /**
173
+ * Share scopes or profile table access as stored, each clamp without the fixed `search` one saved
174
+ * before plan 106 may carry: readers ignore it, so editors and merges save the clamp without it.
175
+ */
176
+ export declare function withoutClampSearch<T extends {
177
+ rowQuery?: ClampQuery;
178
+ }>(entries: T[]): T[];
179
+ /** Parse a persisted Query JSON payload through the canonical schema. */
180
+ export declare function parseQueryJson(raw: string): Query | null;
181
+ /** Stable compact JSON used by URLs and rich-document record-table blocks. */
182
+ export declare function stringifyQuery(query: GridQuery): string;
183
+ /** Same filter, sort keys and groups: one sort key equals a list of just that key. */
184
+ export declare function queriesEqual(a: GridQuery | null | undefined, b: GridQuery | null | undefined): boolean;