@prisma/orm-framework 8.0.0-rc.2-dev.3 → 8.0.0-rc.20-dev.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.
- package/README.md +1 -5
- package/dist/{apply-specifier-default-control-policy-CAxiXxKg.d.mts → apply-specifier-default-control-policy-Dlz0iwnK.d.mts} +2 -2
- package/dist/apply-specifier-default-control-policy-Dlz0iwnK.d.mts.map +1 -0
- package/dist/{assertions-Cz-GWH8P.mjs → assertions-Dw1lZz_Q.mjs} +2 -2
- package/dist/{assertions-Cz-GWH8P.mjs.map → assertions-Dw1lZz_Q.mjs.map} +1 -1
- package/dist/authoring-CNUti739.mjs +764 -0
- package/dist/authoring-CNUti739.mjs.map +1 -0
- package/dist/authoring-CjwinhU5.d.mts +206 -0
- package/dist/authoring-CjwinhU5.d.mts.map +1 -0
- package/dist/binder-D_4RBHbt-BJ6VKwEZ.d.mts +515 -0
- package/dist/binder-D_4RBHbt-BJ6VKwEZ.d.mts.map +1 -0
- package/dist/{canonicalization-DFpB09nP-4OdB2nsy.d.mts → canonicalization-CyrrXGmj-CeKUkht1.d.mts} +3 -3
- package/dist/{canonicalization-DFpB09nP-4OdB2nsy.d.mts.map → canonicalization-CyrrXGmj-CeKUkht1.d.mts.map} +1 -1
- package/dist/{hashing-utils-DQgS3nOe.mjs → canonicalization-path-match-D88xLEq6-BFQC39ZG.mjs} +23 -3
- package/dist/canonicalization-path-match-D88xLEq6-BFQC39ZG.mjs.map +1 -0
- package/dist/{utils-DMAM0unR.mjs → canonicalize-json-ZPawceQR-Dua1VNEB.mjs} +2 -2
- package/dist/canonicalize-json-ZPawceQR-Dua1VNEB.mjs.map +1 -0
- package/dist/codec-B4ypaota.d.mts +289 -0
- package/dist/codec-B4ypaota.d.mts.map +1 -0
- package/dist/codec-Do8tfXqk.mjs +457 -0
- package/dist/codec-Do8tfXqk.mjs.map +1 -0
- package/dist/codec-descriptor-D0oY-hgs-C5e11ola.mjs +93 -0
- package/dist/codec-descriptor-D0oY-hgs-C5e11ola.mjs.map +1 -0
- package/dist/codec-types-BXLUbk-Y-DpGfKGK0.mjs +22 -0
- package/dist/codec-types-BXLUbk-Y-DpGfKGK0.mjs.map +1 -0
- package/dist/codec-types-CPgEZoIq-BL9hisr8.d.mts +384 -0
- package/dist/codec-types-CPgEZoIq-BL9hisr8.d.mts.map +1 -0
- package/dist/{components-dZRz3T5y.mjs → components-BaV9iCkq.mjs} +34 -3
- package/dist/components-BaV9iCkq.mjs.map +1 -0
- package/dist/components-CRBcIta_.d.mts +86 -0
- package/dist/components-CRBcIta_.d.mts.map +1 -0
- package/dist/components.d.mts +19 -17
- package/dist/components.mjs +16 -12
- package/dist/components__authoring.d.mts +4 -3
- package/dist/components__authoring.mjs +3 -2
- package/dist/components__codec.d.mts +3 -3
- package/dist/components__codec.mjs +6 -4
- package/dist/components__components.d.mts +6 -4
- package/dist/components__components.mjs +4 -3
- package/dist/components__control.d.mts +5 -4
- package/dist/components__control.mjs +3 -2
- package/dist/components__emission.d.mts +4 -4
- package/dist/components__execution.d.mts +1 -1
- package/dist/components__ir.d.mts +1 -1
- package/dist/components__ir.mjs +2 -1
- package/dist/components__psl-ast.d.mts +4 -4
- package/dist/components__psl-ast.mjs +2 -2
- package/dist/components__runtime.d.mts +3 -2
- package/dist/components__runtime.mjs +2 -2
- package/dist/components__utils.mjs +1 -1
- package/dist/{config-types-CW4PDwMC.d.mts → config-types-BTFT7QfJ.d.mts} +73 -41
- package/dist/config-types-BTFT7QfJ.d.mts.map +1 -0
- package/dist/config-types-D0mYyP62.mjs +61 -0
- package/dist/config-types-D0mYyP62.mjs.map +1 -0
- package/dist/config.d.mts +2 -3
- package/dist/config.mjs +2 -3
- package/dist/config__config-types.d.mts +2 -2
- package/dist/config__config-types.mjs +2 -2
- package/dist/contract-authoring.d.mts +152 -17
- package/dist/contract-authoring.d.mts.map +1 -1
- package/dist/contract-authoring.mjs +190 -9
- package/dist/contract-authoring.mjs.map +1 -1
- package/dist/{contract-types-CkdMH7F7-9EHXSwbH.d.mts → contract-types-DEIEpzU_-DvAVuBr5.d.mts} +14 -8
- package/dist/contract-types-DEIEpzU_-DvAVuBr5.d.mts.map +1 -0
- package/dist/{contract-validation-error-DEiWp_EI-CRwtUgRw.mjs → contract-validation-error-CAnTGhkt-DSnujRaK.mjs} +6 -3
- package/dist/contract-validation-error-CAnTGhkt-DSnujRaK.mjs.map +1 -0
- package/dist/{contract-validation-error-R7cMoK04.d.mts → contract-validation-error-D1QAeOh5.d.mts} +4 -2
- package/dist/contract-validation-error-D1QAeOh5.d.mts.map +1 -0
- package/dist/contract.d.mts +13 -12
- package/dist/contract.mjs +9 -9
- package/dist/contract__apply-specifier-default-control-policy.d.mts +1 -1
- package/dist/contract__contract-validation-error.d.mts +1 -1
- package/dist/contract__contract-validation-error.mjs +1 -1
- package/dist/contract__default-namespace.mjs +1 -1
- package/dist/contract__enum-accessor.d.mts +2 -2
- package/dist/contract__enum-accessor.mjs +1 -1
- package/dist/contract__hashing-utils.d.mts +2 -2
- package/dist/contract__hashing-utils.mjs +2 -3
- package/dist/contract__hashing.d.mts +3 -3
- package/dist/contract__hashing.mjs +2 -2
- package/dist/contract__resolve-domain-model.d.mts +1 -1
- package/dist/contract__types.d.mts +5 -5
- package/dist/contract__types.mjs +3 -3
- package/dist/contract__validate-domain.d.mts +1 -1
- package/dist/contract__validate-domain.mjs +1 -1
- package/dist/contract__validate-once.d.mts +2 -0
- package/dist/contract__validate-once.mjs +2 -0
- package/dist/{control-ql9N9u4f-r3Vv41kZ.d.mts → control-B5ezUWD2-BIAYxeSk.d.mts} +34 -6
- package/dist/control-B5ezUWD2-BIAYxeSk.d.mts.map +1 -0
- package/dist/{control-DLEm6u5m.mjs → control-DMJqhnwU.mjs} +309 -36
- package/dist/control-DMJqhnwU.mjs.map +1 -0
- package/dist/control-DrDTlxCS.d.mts +1 -0
- package/dist/{control-BD96JZi8-NUhO5Kkw.mjs → control-KsXr4fYD-D2Ows0NI.mjs} +70 -24
- package/dist/control-KsXr4fYD-D2Ows0NI.mjs.map +1 -0
- package/dist/{control-BF8qzdnM.d.mts → control-s5ECUABR.d.mts} +635 -156
- package/dist/control-s5ECUABR.d.mts.map +1 -0
- package/dist/data-type-V6mcDhcG-DVQAPOQT.mjs +275 -0
- package/dist/data-type-V6mcDhcG-DVQAPOQT.mjs.map +1 -0
- package/dist/declarations-BgUAq1RG-Dz_-EI1Q.mjs +459 -0
- package/dist/declarations-BgUAq1RG-Dz_-EI1Q.mjs.map +1 -0
- package/dist/{default-namespace-D4vCwkXg-lzVN7gSc.mjs → default-namespace-D4vCwkXg-BEZbN38y.mjs} +2 -2
- package/dist/{default-namespace-D4vCwkXg-lzVN7gSc.mjs.map → default-namespace-D4vCwkXg-BEZbN38y.mjs.map} +1 -1
- package/dist/{dist-Dqbo77p7.mjs → dist-D1f6xr7F.mjs} +51 -24
- package/dist/dist-D1f6xr7F.mjs.map +1 -0
- package/dist/{domain-envelope-D6Wn9AmZ-BqZKTT9U.d.mts → domain-envelope-CN721GnP-4huRt7Wc.d.mts} +27 -13
- package/dist/domain-envelope-CN721GnP-4huRt7Wc.d.mts.map +1 -0
- package/dist/emission-BtJvV97M.d.mts +2 -0
- package/dist/{emission-types-DLXP34Ki-CFms3VrX.d.mts → emission-types-B-jKEbjI-D7BW8Gk1.d.mts} +17 -16
- package/dist/emission-types-B-jKEbjI-D7BW8Gk1.d.mts.map +1 -0
- package/dist/enum-accessor-2OZgavDX.d.mts +104 -0
- package/dist/enum-accessor-2OZgavDX.d.mts.map +1 -0
- package/dist/enum-accessor-B-A2wNok.mjs +122 -0
- package/dist/enum-accessor-B-A2wNok.mjs.map +1 -0
- package/dist/errors.d.mts +5 -4
- package/dist/errors.mjs +4 -4
- package/dist/errors__control.d.mts +3 -2
- package/dist/errors__control.mjs +2 -2
- package/dist/errors__execution.d.mts +2 -2
- package/dist/errors__execution.mjs +2 -2
- package/dist/errors__migration.d.mts +2 -2
- package/dist/errors__migration.mjs +2 -2
- package/dist/execution-CjX5CCTb.d.mts +76 -0
- package/dist/execution-CjX5CCTb.d.mts.map +1 -0
- package/dist/{execution-CSnQT8EX.d.mts → execution-lMPVFj5o.d.mts} +2 -2
- package/dist/{execution-CSnQT8EX.d.mts.map → execution-lMPVFj5o.d.mts.map} +1 -1
- package/dist/execution-vfY4d-SZ.mjs +138 -0
- package/dist/execution-vfY4d-SZ.mjs.map +1 -0
- package/dist/{declarations-DR6To8_k-BFwkCGeP.mjs → expressions-CMQzbnHk-BL2zN0Iv.mjs} +199 -350
- package/dist/expressions-CMQzbnHk-BL2zN0Iv.mjs.map +1 -0
- package/dist/framework-authoring-DDxddXZm-uZYdhoE0.d.mts +1096 -0
- package/dist/framework-authoring-DDxddXZm-uZYdhoE0.d.mts.map +1 -0
- package/dist/{framework-components-hZ2tO-KH-CdRXBOYd.d.mts → framework-components-DKoQnPdB-lax1COaf.d.mts} +28 -91
- package/dist/framework-components-DKoQnPdB-lax1COaf.d.mts.map +1 -0
- package/dist/generator-functions-CXbQfvYu-BIFU1Ryx.mjs +271 -0
- package/dist/generator-functions-CXbQfvYu-BIFU1Ryx.mjs.map +1 -0
- package/dist/{hash-content-DwEUh-Rx.d.mts → hash-content-Bde14N2-.d.mts} +2 -2
- package/dist/{hash-content-DwEUh-Rx.d.mts.map → hash-content-Bde14N2-.d.mts.map} +1 -1
- package/dist/{hash-content-Bugg_nZn.mjs → hash-content-Bdl-HSfq.mjs} +2 -2
- package/dist/hash-content-Bdl-HSfq.mjs.map +1 -0
- package/dist/{hashing-BtIZVNYX.mjs → hashing-CLRfNAxh.mjs} +28 -9
- package/dist/hashing-CLRfNAxh.mjs.map +1 -0
- package/dist/hashing-D-DHz0zl.d.mts +36 -0
- package/dist/hashing-D-DHz0zl.d.mts.map +1 -0
- package/dist/{hashing-utils-qKu59RSC.d.mts → hashing-utils-DiGHKd3b.d.mts} +4 -3
- package/dist/{hashing-utils-qKu59RSC.d.mts.map → hashing-utils-DiGHKd3b.d.mts.map} +1 -1
- package/dist/ids.d.mts +90 -13
- package/dist/ids.d.mts.map +1 -1
- package/dist/ids.mjs +45 -59
- package/dist/ids.mjs.map +1 -1
- package/dist/ids__runtime.d.mts +1 -1
- package/dist/ids__runtime.mjs +1 -1
- package/dist/{index-CDk9yEbw.d.mts → index-MU-ksXsh.d.mts} +23 -6
- package/dist/index-MU-ksXsh.d.mts.map +1 -0
- package/dist/{internal-error-kK8QvlDE.d.mts → internal-error-2fJ9fcZX.d.mts} +2 -2
- package/dist/{internal-error-kK8QvlDE.d.mts.map → internal-error-2fJ9fcZX.d.mts.map} +1 -1
- package/dist/{internal-error-BIc-ehme-ouBQPoEL.mjs → internal-error-ChGYPVpq-DhUD05u0.mjs} +3 -3
- package/dist/internal-error-ChGYPVpq-DhUD05u0.mjs.map +1 -0
- package/dist/{ir-BvE7L9FK.d.mts → ir-LV4tXsw3.d.mts} +6 -5
- package/dist/{ir-BvE7L9FK.d.mts.map → ir-LV4tXsw3.d.mts.map} +1 -1
- package/dist/{ir-ChmSSAhX.mjs → ir-uDGU9vaj.mjs} +7 -53
- package/dist/ir-uDGU9vaj.mjs.map +1 -0
- package/dist/{migration-BvrgDZXw.d.mts → migration-Dluwnqe9.d.mts} +20 -3
- package/dist/migration-Dluwnqe9.d.mts.map +1 -0
- package/dist/{migration-C57VKLUY.mjs → migration-uC-bSKA4.mjs} +30 -4
- package/dist/migration-uC-bSKA4.mjs.map +1 -0
- package/dist/namespace-VUH2dgnS-By5y75h9.mjs +53 -0
- package/dist/namespace-VUH2dgnS-By5y75h9.mjs.map +1 -0
- package/dist/operations.mjs +1 -1
- package/dist/{parse-GbZGfMUj-BFSrD2AN.mjs → parse-bZgfjovA-BNgYhylT.mjs} +311 -55
- package/dist/parse-bZgfjovA-BNgYhylT.mjs.map +1 -0
- package/dist/{parse-0ZJjj_2N-DhQpSVmQ.d.mts → parse-djL5wker-B610mXG4.d.mts} +181 -52
- package/dist/parse-djL5wker-B610mXG4.d.mts.map +1 -0
- package/dist/psl-ast-COcYtLlz.d.mts +2 -0
- package/dist/psl-ast-CyvE6CR-.mjs +116 -0
- package/dist/psl-ast-CyvE6CR-.mjs.map +1 -0
- package/dist/{psl-ast-CWJQF8LA-Vr5JNPdn.d.mts → psl-ast-rY25o3Ze-ClLY3CYt.d.mts} +10 -40
- package/dist/psl-ast-rY25o3Ze-ClLY3CYt.d.mts.map +1 -0
- package/dist/psl-parser.d.mts +415 -101
- package/dist/psl-parser.d.mts.map +1 -1
- package/dist/psl-parser.mjs +2451 -537
- package/dist/psl-parser.mjs.map +1 -1
- package/dist/psl-parser__format.d.mts +8 -2
- package/dist/psl-parser__format.d.mts.map +1 -1
- package/dist/psl-parser__format.mjs +65 -34
- package/dist/psl-parser__format.mjs.map +1 -1
- package/dist/psl-parser__interpret.d.mts +98 -10
- package/dist/psl-parser__interpret.d.mts.map +1 -1
- package/dist/psl-parser__interpret.mjs +393 -2
- package/dist/psl-parser__interpret.mjs.map +1 -1
- package/dist/psl-parser__syntax.d.mts +3 -3
- package/dist/psl-parser__syntax.mjs +4 -43
- package/dist/psl-parser__tokenizer.d.mts +1 -1
- package/dist/psl-parser__tokenizer.mjs +1 -1
- package/dist/psl-printer.d.mts +7 -17
- package/dist/psl-printer.d.mts.map +1 -1
- package/dist/psl-printer.mjs +35 -104
- package/dist/psl-printer.mjs.map +1 -1
- package/dist/resolve-codec-qqMjZrmn-Cok8elAo.mjs +74 -0
- package/dist/resolve-codec-qqMjZrmn-Cok8elAo.mjs.map +1 -0
- package/dist/{resolve-domain-model-BVSb5wS5-C6Yq0dsD.d.mts → resolve-domain-model-BNr1glea-BLuR-phK.d.mts} +3 -3
- package/dist/resolve-domain-model-BNr1glea-BLuR-phK.d.mts.map +1 -0
- package/dist/{result-CBZ8X9mU.mjs → result-8OXF26MN.mjs} +14 -3
- package/dist/{result-CBZ8X9mU.mjs.map → result-8OXF26MN.mjs.map} +1 -1
- package/dist/{result-Bpupv5vO.d.mts → result-BYCOANWy.d.mts} +4 -2
- package/dist/result-BYCOANWy.d.mts.map +1 -0
- package/dist/runtime-B-YYuWy2.d.mts +899 -0
- package/dist/runtime-B-YYuWy2.d.mts.map +1 -0
- package/dist/runtime-DSYSc98Y.mjs +1059 -0
- package/dist/runtime-DSYSc98Y.mjs.map +1 -0
- package/dist/runtime-error-CO4MA3Px-YW5SCUcH.d.mts +19 -0
- package/dist/runtime-error-CO4MA3Px-YW5SCUcH.d.mts.map +1 -0
- package/dist/{structured-error-CgiSMpdU.mjs → structured-error-BXbihKQ-.mjs} +3 -3
- package/dist/{structured-error-CgiSMpdU.mjs.map → structured-error-BXbihKQ-.mjs.map} +1 -1
- package/dist/{structured-error-BsNT4Hun.d.mts → structured-error-Cc7AIRsp.d.mts} +19 -5
- package/dist/structured-error-Cc7AIRsp.d.mts.map +1 -0
- package/dist/suppress-idle-connection-errors-CKrTbp5P.d.mts +18 -0
- package/dist/suppress-idle-connection-errors-CKrTbp5P.d.mts.map +1 -0
- package/dist/suppress-idle-connection-errors-DzApeUb3.mjs +22 -0
- package/dist/suppress-idle-connection-errors-DzApeUb3.mjs.map +1 -0
- package/dist/temporal-presets-5TK1pTYJ-DmhrnMP1.mjs +1276 -0
- package/dist/temporal-presets-5TK1pTYJ-DmhrnMP1.mjs.map +1 -0
- package/dist/temporal-presets-BuMqk7h8-DZSuu4Z_.d.mts +258 -0
- package/dist/temporal-presets-BuMqk7h8-DZSuu4Z_.d.mts.map +1 -0
- package/dist/text-C3TTEtgd.mjs +35 -0
- package/dist/text-C3TTEtgd.mjs.map +1 -0
- package/dist/text-C8_-rheN.d.mts +15 -0
- package/dist/text-C8_-rheN.d.mts.map +1 -0
- package/dist/{tokenizer-1hAHZzmp-QGPORvmA.mjs → tokenizer-C-GTKKjR-B1vOzJy0.mjs} +54 -10
- package/dist/tokenizer-C-GTKKjR-B1vOzJy0.mjs.map +1 -0
- package/dist/{tokenizer-DcYI0Xrq-C-nNE9mE.d.mts → tokenizer-i8RaVWVa-7fRwlCPP.d.mts} +9 -4
- package/dist/tokenizer-i8RaVWVa-7fRwlCPP.d.mts.map +1 -0
- package/dist/ts-render.d.mts +2 -2
- package/dist/ts-render.mjs +2 -2
- package/dist/type-constructor-calls-BLf-HsFy-D_jbIqj8.mjs +261 -0
- package/dist/type-constructor-calls-BLf-HsFy-D_jbIqj8.mjs.map +1 -0
- package/dist/{types-BnH4zYvN.mjs → types-B8ULzMAX.mjs} +36 -3
- package/dist/types-B8ULzMAX.mjs.map +1 -0
- package/dist/types-GNXJ7xW2.d.mts +131 -0
- package/dist/types-GNXJ7xW2.d.mts.map +1 -0
- package/dist/{types-import-spec-3mjbVBhI-DQI6BvKU.d.mts → types-import-spec-DQjfX-gM-zVncuzs0.d.mts} +6 -6
- package/dist/types-import-spec-DQjfX-gM-zVncuzs0.d.mts.map +1 -0
- package/dist/utils.d.mts +7 -5
- package/dist/utils.mjs +9 -7
- package/dist/utils__assertions.mjs +1 -1
- package/dist/utils__hash-content.d.mts +1 -1
- package/dist/utils__hash-content.mjs +1 -1
- package/dist/utils__internal-error.d.mts +1 -1
- package/dist/utils__internal-error.mjs +1 -1
- package/dist/utils__result.d.mts +2 -2
- package/dist/utils__result.mjs +2 -2
- package/dist/utils__structured-error.d.mts +2 -2
- package/dist/utils__structured-error.mjs +1 -1
- package/dist/utils__suppress-idle-connection-errors.d.mts +2 -0
- package/dist/utils__suppress-idle-connection-errors.mjs +2 -0
- package/dist/utils__text.d.mts +2 -0
- package/dist/utils__text.mjs +2 -0
- package/dist/{validate-domain-BNBs-TVv.d.mts → validate-domain-B5kmlBFB.d.mts} +10 -6
- package/dist/validate-domain-B5kmlBFB.d.mts.map +1 -0
- package/dist/{validate-domain-BkvFlY3B.mjs → validate-domain-CbXHDYpF.mjs} +43 -22
- package/dist/validate-domain-CbXHDYpF.mjs.map +1 -0
- package/dist/validate-once-D-IwXHYP.mjs +42 -0
- package/dist/validate-once-D-IwXHYP.mjs.map +1 -0
- package/dist/validate-once-gfCOHsDh.d.mts +16 -0
- package/dist/validate-once-gfCOHsDh.d.mts.map +1 -0
- package/package.json +24 -20
- package/dist/apply-specifier-default-control-policy-CAxiXxKg.d.mts.map +0 -1
- package/dist/authoring-B2H-9qCv.d.mts +0 -1
- package/dist/canonicalization-path-match-CNgHuwM_-CCPBeUuk.mjs +0 -25
- package/dist/canonicalization-path-match-CNgHuwM_-CCPBeUuk.mjs.map +0 -1
- package/dist/capabilities-BCEONw9w-C-lo3rF8.mjs +0 -120
- package/dist/capabilities-BCEONw9w-C-lo3rF8.mjs.map +0 -1
- package/dist/codec-Cd0QcxAx.mjs +0 -63
- package/dist/codec-Cd0QcxAx.mjs.map +0 -1
- package/dist/codec-Ce07W3Mz.d.mts +0 -112
- package/dist/codec-Ce07W3Mz.d.mts.map +0 -1
- package/dist/codec-types-D6VRj2RE-BLElXc-O.d.mts +0 -223
- package/dist/codec-types-D6VRj2RE-BLElXc-O.d.mts.map +0 -1
- package/dist/codec-types-DcNvNeY1-BO6kUiH0.mjs +0 -30
- package/dist/codec-types-DcNvNeY1-BO6kUiH0.mjs.map +0 -1
- package/dist/components-CGA_WwEG.d.mts +0 -50
- package/dist/components-CGA_WwEG.d.mts.map +0 -1
- package/dist/components-dZRz3T5y.mjs.map +0 -1
- package/dist/config-types-BqhNxw0z.mjs +0 -67
- package/dist/config-types-BqhNxw0z.mjs.map +0 -1
- package/dist/config-types-CW4PDwMC.d.mts.map +0 -1
- package/dist/config-validation-DPt5hwQx.mjs +0 -168
- package/dist/config-validation-DPt5hwQx.mjs.map +0 -1
- package/dist/config-validation-Wiqew2J9.d.mts +0 -21
- package/dist/config-validation-Wiqew2J9.d.mts.map +0 -1
- package/dist/config__config-validation.d.mts +0 -2
- package/dist/config__config-validation.mjs +0 -2
- package/dist/contract-types-CkdMH7F7-9EHXSwbH.d.mts.map +0 -1
- package/dist/contract-validation-error-DEiWp_EI-CRwtUgRw.mjs.map +0 -1
- package/dist/contract-validation-error-R7cMoK04.d.mts.map +0 -1
- package/dist/control-BD96JZi8-NUhO5Kkw.mjs.map +0 -1
- package/dist/control-BF8qzdnM.d.mts.map +0 -1
- package/dist/control-DLEm6u5m.mjs.map +0 -1
- package/dist/control-ql9N9u4f-r3Vv41kZ.d.mts.map +0 -1
- package/dist/declarations-DR6To8_k-BFwkCGeP.mjs.map +0 -1
- package/dist/dist-Dqbo77p7.mjs.map +0 -1
- package/dist/domain-envelope-D6Wn9AmZ-BqZKTT9U.d.mts.map +0 -1
- package/dist/emission-CmUO03gQ.d.mts +0 -2
- package/dist/emission-types-DLXP34Ki-CFms3VrX.d.mts.map +0 -1
- package/dist/enum-accessor-Db5DaTNX.mjs +0 -35
- package/dist/enum-accessor-Db5DaTNX.mjs.map +0 -1
- package/dist/enum-accessor-PH5vjghI.d.mts +0 -85
- package/dist/enum-accessor-PH5vjghI.d.mts.map +0 -1
- package/dist/execution-Crk6IfTs.mjs +0 -218
- package/dist/execution-Crk6IfTs.mjs.map +0 -1
- package/dist/execution-Cyl2dXxX.d.mts +0 -115
- package/dist/execution-Cyl2dXxX.d.mts.map +0 -1
- package/dist/framework-authoring-BhctBwih-DQ_6noDM.d.mts +0 -777
- package/dist/framework-authoring-BhctBwih-DQ_6noDM.d.mts.map +0 -1
- package/dist/framework-authoring-CDEvlouU-DKklu-fL.mjs +0 -698
- package/dist/framework-authoring-CDEvlouU-DKklu-fL.mjs.map +0 -1
- package/dist/framework-components-hZ2tO-KH-CdRXBOYd.d.mts.map +0 -1
- package/dist/hash-content-Bugg_nZn.mjs.map +0 -1
- package/dist/hashing-BtIZVNYX.mjs.map +0 -1
- package/dist/hashing-CccSPELN.d.mts +0 -25
- package/dist/hashing-CccSPELN.d.mts.map +0 -1
- package/dist/hashing-utils-DQgS3nOe.mjs.map +0 -1
- package/dist/index-CDk9yEbw.d.mts.map +0 -1
- package/dist/internal-error-BIc-ehme-ouBQPoEL.mjs.map +0 -1
- package/dist/ir-ChmSSAhX.mjs.map +0 -1
- package/dist/migration-BvrgDZXw.d.mts.map +0 -1
- package/dist/migration-C57VKLUY.mjs.map +0 -1
- package/dist/parse-0ZJjj_2N-DhQpSVmQ.d.mts.map +0 -1
- package/dist/parse-GbZGfMUj-BFSrD2AN.mjs.map +0 -1
- package/dist/psl-ast-BXZoFQBk.d.mts +0 -37
- package/dist/psl-ast-BXZoFQBk.d.mts.map +0 -1
- package/dist/psl-ast-CWJQF8LA-Vr5JNPdn.d.mts.map +0 -1
- package/dist/psl-ast-DUCvVXbB.mjs +0 -239
- package/dist/psl-ast-DUCvVXbB.mjs.map +0 -1
- package/dist/psl-parser__syntax.mjs.map +0 -1
- package/dist/resolve-codec-BZF8TZh_-D-xORT9Q.mjs +0 -59
- package/dist/resolve-codec-BZF8TZh_-D-xORT9Q.mjs.map +0 -1
- package/dist/resolve-domain-model-BVSb5wS5-C6Yq0dsD.d.mts.map +0 -1
- package/dist/result-Bpupv5vO.d.mts.map +0 -1
- package/dist/runtime-BqzioOmU.mjs +0 -670
- package/dist/runtime-BqzioOmU.mjs.map +0 -1
- package/dist/runtime-Cuxw8obj.d.mts +0 -1038
- package/dist/runtime-Cuxw8obj.d.mts.map +0 -1
- package/dist/structured-error-BsNT4Hun.d.mts.map +0 -1
- package/dist/symbol-table-CZ7EVCTL-CR-ncCpD.d.mts +0 -125
- package/dist/symbol-table-CZ7EVCTL-CR-ncCpD.d.mts.map +0 -1
- package/dist/tokenizer-1hAHZzmp-QGPORvmA.mjs.map +0 -1
- package/dist/tokenizer-DcYI0Xrq-C-nNE9mE.d.mts.map +0 -1
- package/dist/types-BnH4zYvN.mjs.map +0 -1
- package/dist/types-ByeQhU9p.d.mts +0 -17
- package/dist/types-ByeQhU9p.d.mts.map +0 -1
- package/dist/types-import-spec-3mjbVBhI-DQI6BvKU.d.mts.map +0 -1
- package/dist/utils-DMAM0unR.mjs.map +0 -1
- package/dist/validate-domain-BNBs-TVv.d.mts.map +0 -1
- package/dist/validate-domain-BkvFlY3B.mjs.map +0 -1
|
@@ -0,0 +1,1096 @@
|
|
|
1
|
+
import { B as JsonValue, N as ExecutionMutationDefaultPhases, P as ExecutionMutationDefaultValue, a as ColumnDefault } from "./domain-envelope-CN721GnP-4huRt7Wc.mjs";
|
|
2
|
+
import { T as DataTypeValue, b as DataTypeParams, m as CodecRef, p as CodecLookupWithDescriptors, v as DataTypeId, y as DataTypeLookup } from "./codec-types-CPgEZoIq-BL9hisr8.mjs";
|
|
3
|
+
import { r as Result } from "./result-BYCOANWy.mjs";
|
|
4
|
+
import { Type } from "arktype";
|
|
5
|
+
import { StandardSchemaV1 } from "@standard-schema/spec";
|
|
6
|
+
//#region ../../../1-framework/1-core/framework-components/dist/framework-authoring-DDxddXZm.d.mts
|
|
7
|
+
//#region src/shared/mutation-default-types.d.ts
|
|
8
|
+
interface SourcePosition {
|
|
9
|
+
readonly offset: number;
|
|
10
|
+
readonly line: number;
|
|
11
|
+
readonly column: number;
|
|
12
|
+
}
|
|
13
|
+
interface SourceSpan {
|
|
14
|
+
readonly start: SourcePosition;
|
|
15
|
+
readonly end: SourcePosition;
|
|
16
|
+
}
|
|
17
|
+
interface SourceDiagnostic {
|
|
18
|
+
readonly code: string;
|
|
19
|
+
readonly message: string;
|
|
20
|
+
readonly sourceId: string;
|
|
21
|
+
readonly span?: SourceSpan;
|
|
22
|
+
readonly data?: Readonly<Record<string, unknown>>;
|
|
23
|
+
}
|
|
24
|
+
interface DefaultFunctionLoweringContext {
|
|
25
|
+
readonly sourceId: string;
|
|
26
|
+
readonly modelName: string;
|
|
27
|
+
readonly fieldName: string;
|
|
28
|
+
readonly columnCodecId?: string;
|
|
29
|
+
}
|
|
30
|
+
/** What a default function lowers to: always a database default. A value the client generates is a generator function, which `@onCreate(fn())` and `@onUpdate(fn())` call. */
|
|
31
|
+
type LoweredDefaultValue = {
|
|
32
|
+
readonly kind: 'storage';
|
|
33
|
+
readonly defaultValue: ColumnDefault;
|
|
34
|
+
};
|
|
35
|
+
type LoweredDefaultResult = {
|
|
36
|
+
readonly ok: true;
|
|
37
|
+
readonly value: LoweredDefaultValue;
|
|
38
|
+
} | {
|
|
39
|
+
readonly ok: false;
|
|
40
|
+
readonly diagnostic: SourceDiagnostic;
|
|
41
|
+
};
|
|
42
|
+
interface MutationDefaultGeneratorDescriptor {
|
|
43
|
+
readonly id: string;
|
|
44
|
+
}
|
|
45
|
+
interface TypedDefaultFunctionCall {
|
|
46
|
+
readonly fn: string;
|
|
47
|
+
readonly span: SourceSpan;
|
|
48
|
+
readonly args: Readonly<Record<string, unknown>>;
|
|
49
|
+
}
|
|
50
|
+
interface ControlMutationDefaultEntry {
|
|
51
|
+
readonly signature?: unknown;
|
|
52
|
+
readonly lower: (input: {
|
|
53
|
+
readonly call: TypedDefaultFunctionCall;
|
|
54
|
+
readonly context: DefaultFunctionLoweringContext;
|
|
55
|
+
}) => LoweredDefaultResult;
|
|
56
|
+
readonly usageSignatures?: readonly string[];
|
|
57
|
+
}
|
|
58
|
+
type ControlMutationDefaultRegistry = ReadonlyMap<string, ControlMutationDefaultEntry>;
|
|
59
|
+
interface ControlMutationDefaults {
|
|
60
|
+
readonly defaultFunctionRegistry: ControlMutationDefaultRegistry;
|
|
61
|
+
readonly generatorDescriptors: readonly MutationDefaultGeneratorDescriptor[];
|
|
62
|
+
}
|
|
63
|
+
/** The mutation defaults of a composed stack. */
|
|
64
|
+
interface AssembledControlMutationDefaults extends ControlMutationDefaults {
|
|
65
|
+
/** For each registered generator id, the id of the component that registers it, or `undefined` when that component has no id. */
|
|
66
|
+
readonly componentIdsByGenerator: ReadonlyMap<string, string | undefined>;
|
|
67
|
+
}
|
|
68
|
+
//#endregion
|
|
69
|
+
//#region src/shared/generator-functions.d.ts
|
|
70
|
+
/** The phase a client generator runs in: when a row is created, or every time it is updated. */
|
|
71
|
+
type GeneratorPhase = 'onCreate' | 'onUpdate';
|
|
72
|
+
/** The codec and type params of the field a generator fills: a column in SQL, a document field in Mongo. */
|
|
73
|
+
interface GeneratorFunctionField {
|
|
74
|
+
readonly codecId: string;
|
|
75
|
+
readonly typeParams: Readonly<Record<string, unknown>> | undefined;
|
|
76
|
+
/** The column's length, in its data type's normal form, so a bare `Char` holds 1. `undefined` for a column with no length, or one whose database does not limit it; a binding then checks no length. */
|
|
77
|
+
readonly length: number | undefined;
|
|
78
|
+
}
|
|
79
|
+
/** A call of a generator function: what `@onCreate(fn(...))` and `gen.fn(...)` write, and what `contract print` writes back. */
|
|
80
|
+
interface GeneratorFunctionCall {
|
|
81
|
+
readonly name: string;
|
|
82
|
+
readonly args: Readonly<Record<string, unknown>>;
|
|
83
|
+
}
|
|
84
|
+
/** What one binding resolves a call to on a field: a generator, or a refusal with its reason. */
|
|
85
|
+
type BindingResolution = {
|
|
86
|
+
readonly ok: true;
|
|
87
|
+
readonly generator: ExecutionMutationDefaultValue;
|
|
88
|
+
} | {
|
|
89
|
+
readonly ok: false;
|
|
90
|
+
readonly message: string;
|
|
91
|
+
};
|
|
92
|
+
/** The arguments of a call, as values and as PSL text. */
|
|
93
|
+
interface PrintedArguments {
|
|
94
|
+
readonly args: Readonly<Record<string, unknown>>;
|
|
95
|
+
readonly text: string;
|
|
96
|
+
}
|
|
97
|
+
interface GeneratorFunctionBinding {
|
|
98
|
+
readonly codecIds: readonly string[];
|
|
99
|
+
/** Every generator id `resolve` can produce. */
|
|
100
|
+
readonly generatorIds: readonly string[];
|
|
101
|
+
readonly resolve: (input: {
|
|
102
|
+
readonly args: Readonly<Record<string, unknown>>;
|
|
103
|
+
readonly field: GeneratorFunctionField;
|
|
104
|
+
}) => BindingResolution;
|
|
105
|
+
/** The arguments that produce `generator` on `field`, or `undefined` when this binding never produces it. */
|
|
106
|
+
readonly printArguments: (generator: ExecutionMutationDefaultValue, field: GeneratorFunctionField) => PrintedArguments | undefined;
|
|
107
|
+
}
|
|
108
|
+
interface GeneratorFunctionContribution {
|
|
109
|
+
readonly name: string;
|
|
110
|
+
/** A `FuncCallSig`, typed `unknown` as `ControlMutationDefaultEntry.signature` is. Exactly one contribution per name sets it. */
|
|
111
|
+
readonly signature?: unknown;
|
|
112
|
+
readonly bindings: readonly GeneratorFunctionBinding[];
|
|
113
|
+
}
|
|
114
|
+
interface GeneratorFunctionSummary {
|
|
115
|
+
readonly name: string;
|
|
116
|
+
readonly signature: unknown;
|
|
117
|
+
}
|
|
118
|
+
type GeneratorFunctionResolution = {
|
|
119
|
+
readonly ok: true;
|
|
120
|
+
readonly generator: ExecutionMutationDefaultValue;
|
|
121
|
+
} | {
|
|
122
|
+
readonly ok: false;
|
|
123
|
+
readonly reason: 'refused';
|
|
124
|
+
readonly message: string;
|
|
125
|
+
} | {
|
|
126
|
+
readonly ok: false;
|
|
127
|
+
readonly reason: 'unknown-function' | 'not-bound';
|
|
128
|
+
readonly boundCodecIds: readonly string[];
|
|
129
|
+
};
|
|
130
|
+
/** The call that produces a stored generator, and its PSL text, such as `uuid(7)`. */
|
|
131
|
+
interface PrintedGeneratorCall {
|
|
132
|
+
readonly call: GeneratorFunctionCall;
|
|
133
|
+
readonly text: string;
|
|
134
|
+
}
|
|
135
|
+
interface GeneratorFunctionRegistry {
|
|
136
|
+
functionsFor(codecId: string): readonly GeneratorFunctionSummary[];
|
|
137
|
+
has(name: string): boolean;
|
|
138
|
+
resolve(call: GeneratorFunctionCall, field: GeneratorFunctionField): GeneratorFunctionResolution;
|
|
139
|
+
callFor(generator: ExecutionMutationDefaultValue, field: GeneratorFunctionField): PrintedGeneratorCall | undefined;
|
|
140
|
+
}
|
|
141
|
+
/** A component that contributes generator functions, generator descriptors, or both. */
|
|
142
|
+
interface GeneratorFunctionComponent {
|
|
143
|
+
readonly id?: string;
|
|
144
|
+
readonly generatorFunctions?: readonly GeneratorFunctionContribution[];
|
|
145
|
+
readonly controlMutationDefaults?: {
|
|
146
|
+
readonly generatorDescriptors: readonly MutationDefaultGeneratorDescriptor[];
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Assemble the generator functions of a composed stack: the control stack's components, or the pack refs of a TypeScript contract. Every generator a binding produces must be registered by a generator descriptor of one of the components.
|
|
151
|
+
*/
|
|
152
|
+
declare function assembleGeneratorFunctions(descriptors: ReadonlyArray<GeneratorFunctionComponent>): GeneratorFunctionRegistry;
|
|
153
|
+
/**
|
|
154
|
+
* A binding of a function that takes no arguments to one generator, with params read from the field's type params when `paramsFromField` gives any.
|
|
155
|
+
*/
|
|
156
|
+
declare function singleGeneratorBinding(input: {
|
|
157
|
+
readonly codecIds: readonly string[];
|
|
158
|
+
readonly generatorId: string;
|
|
159
|
+
readonly paramsFromField?: (field: GeneratorFunctionField) => Readonly<Record<string, unknown>> | undefined;
|
|
160
|
+
}): GeneratorFunctionBinding;
|
|
161
|
+
/** The generator functions of a stack that contributes none. */
|
|
162
|
+
declare const EMPTY_GENERATOR_FUNCTIONS: GeneratorFunctionRegistry;
|
|
163
|
+
//#endregion
|
|
164
|
+
//#region src/shared/option-descriptor.d.ts
|
|
165
|
+
interface AuthoringOption {
|
|
166
|
+
readonly kind: 'option';
|
|
167
|
+
readonly values: readonly string[];
|
|
168
|
+
}
|
|
169
|
+
//#endregion
|
|
170
|
+
//#region src/shared/written-value.d.ts
|
|
171
|
+
/** One written value, in the syntax a contract source wrote it in. ADR 254. */
|
|
172
|
+
type WrittenValue = {
|
|
173
|
+
readonly kind: 'tag';
|
|
174
|
+
readonly tag: string;
|
|
175
|
+
readonly text: string;
|
|
176
|
+
} | {
|
|
177
|
+
readonly kind: 'string';
|
|
178
|
+
readonly text: string;
|
|
179
|
+
} | {
|
|
180
|
+
readonly kind: 'boolean';
|
|
181
|
+
readonly value: boolean;
|
|
182
|
+
} | {
|
|
183
|
+
readonly kind: 'number';
|
|
184
|
+
readonly text: string;
|
|
185
|
+
} | {
|
|
186
|
+
readonly kind: 'list';
|
|
187
|
+
readonly elements: readonly WrittenValue[];
|
|
188
|
+
};
|
|
189
|
+
type WrittenScalar = Exclude<WrittenValue, {
|
|
190
|
+
readonly kind: 'list';
|
|
191
|
+
}>;
|
|
192
|
+
/** A stack's registered data types with their authoring entries, and the data type each of its codecs represents. */
|
|
193
|
+
interface DataTypeSupport {
|
|
194
|
+
readonly entries: Readonly<Record<string, DataTypeAuthoringEntry>>;
|
|
195
|
+
readonly lookup: DataTypeLookup;
|
|
196
|
+
readonly dataTypeOfCodec: (codecId: string) => DataTypeId | undefined;
|
|
197
|
+
/** Every component's {@link AuthoringContributions.textDataTypes}, each once: the data types whose values are text. None when the stack names none. */
|
|
198
|
+
readonly textDataTypes?: readonly DataTypeId[];
|
|
199
|
+
}
|
|
200
|
+
type ReadRefusal = {
|
|
201
|
+
readonly kind: 'unreadable';
|
|
202
|
+
readonly message: string;
|
|
203
|
+
} | {
|
|
204
|
+
readonly kind: 'unknown-tag';
|
|
205
|
+
readonly tag: string;
|
|
206
|
+
readonly known: readonly string[];
|
|
207
|
+
} | {
|
|
208
|
+
readonly kind: 'unwritable';
|
|
209
|
+
readonly syntax: 'string' | 'boolean' | 'number';
|
|
210
|
+
};
|
|
211
|
+
type CastRefusal = {
|
|
212
|
+
readonly kind: 'no-cast';
|
|
213
|
+
readonly receivingType: DataTypeId;
|
|
214
|
+
/** The parameters the receiving position holds its value under. */
|
|
215
|
+
readonly receivingParams: DataTypeParams;
|
|
216
|
+
readonly valueType: DataTypeId;
|
|
217
|
+
readonly casts: readonly string[];
|
|
218
|
+
} | {
|
|
219
|
+
readonly kind: 'unreadable';
|
|
220
|
+
readonly message: string;
|
|
221
|
+
} | {
|
|
222
|
+
/** The receiving type does not hold the value under the receiving position's parameters. */
|
|
223
|
+
readonly kind: 'refused-by-type';
|
|
224
|
+
readonly receivingType: DataTypeId;
|
|
225
|
+
readonly message: string;
|
|
226
|
+
};
|
|
227
|
+
/** A cast-rule refusal worded for a diagnostic. */
|
|
228
|
+
interface RefusalDescription {
|
|
229
|
+
readonly code: 'PSL_UNKNOWN_LITERAL_TAG' | 'PSL_VALUE_TYPE_INCOMPATIBLE' | 'PSL_INVALID_LITERAL' | 'PSL_VALUE_REFUSED';
|
|
230
|
+
readonly message: string;
|
|
231
|
+
}
|
|
232
|
+
/** A syntax a value is written in, with the phrase a diagnostic names it by. */
|
|
233
|
+
type WrittenForm = {
|
|
234
|
+
readonly kind: 'tag';
|
|
235
|
+
readonly tag: string;
|
|
236
|
+
readonly phrase: string;
|
|
237
|
+
} | {
|
|
238
|
+
readonly kind: 'string' | 'boolean' | 'number';
|
|
239
|
+
readonly phrase: string;
|
|
240
|
+
};
|
|
241
|
+
/** What a refusal tells the author to write: the forms the position admits, and an exact rewrite of the written value when there is one. */
|
|
242
|
+
interface RefusalGuidance {
|
|
243
|
+
/** Each form the position admits, as {@link admittedForms} lists them. */
|
|
244
|
+
readonly forms: readonly WrittenForm[];
|
|
245
|
+
/** The written value rewritten in an admitted form, as in ``sql`8` ``. */
|
|
246
|
+
readonly rewrite: string | undefined;
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* Words a refusal of the cast rule. The message leads with what to write; the types are named only when the value has a form the position admits and its type is still refused, such as a number too large for the receiving type.
|
|
250
|
+
*/
|
|
251
|
+
declare function describeRefusal(refusal: ReadRefusal | CastRefusal, support: DataTypeSupport, guidance: RefusalGuidance): RefusalDescription;
|
|
252
|
+
/** `Expected <forms>`, the forms joined with `or`: the start of every refusal that says what to write. */
|
|
253
|
+
declare function describeExpected(forms: readonly WrittenForm[]): string;
|
|
254
|
+
/**
|
|
255
|
+
* Words a value of type `valueType` that `receivingType` refuses, where `guidance.forms` may be written. The types are named only when the value has one of those forms.
|
|
256
|
+
*/
|
|
257
|
+
declare function describeRefusedValueType(refused: {
|
|
258
|
+
readonly receivingType: DataTypeId;
|
|
259
|
+
readonly valueType: DataTypeId;
|
|
260
|
+
}, support: DataTypeSupport, guidance: RefusalGuidance): string;
|
|
261
|
+
/**
|
|
262
|
+
* The literal to write in place of a quoted string that `receivingType` refuses under `receivingParams`: the string as a literal of the first tag the type admits, or else the string's text unquoted, as a number or a boolean. `undefined` when the value is not a quoted string, no such literal reads back as the same text, the type would refuse each of them too, or the number the text writes would be stored as another number, as `-0` is stored without its sign or `9007199254740993` as the nearest double.
|
|
263
|
+
*/
|
|
264
|
+
declare function exactRewrite(support: DataTypeSupport, receiving: {
|
|
265
|
+
readonly receivingType: DataTypeId;
|
|
266
|
+
readonly receivingParams: DataTypeParams;
|
|
267
|
+
}, written: WrittenScalar): string | undefined;
|
|
268
|
+
interface FoundEntry {
|
|
269
|
+
readonly key: string;
|
|
270
|
+
readonly entry: DataTypeAuthoringEntry;
|
|
271
|
+
}
|
|
272
|
+
/** The entry a tag names, or `undefined` when no pack registered that tag. */
|
|
273
|
+
declare function entryForTag(support: DataTypeSupport, tag: string): FoundEntry | undefined;
|
|
274
|
+
/** The entry that reads a plain string, boolean or number, or `undefined` when none does. */
|
|
275
|
+
declare function entryForPlain(support: DataTypeSupport, syntax: 'string' | 'boolean' | 'number'): FoundEntry | undefined;
|
|
276
|
+
/** Every tag a stack registers, in the order the entries were merged. */
|
|
277
|
+
declare function knownTags(support: DataTypeSupport): readonly string[];
|
|
278
|
+
/** Read one written value through the authoring entry for its syntax, as a value its type constructs. */
|
|
279
|
+
declare function readWrittenValue(support: DataTypeSupport, written: WrittenScalar): Result<DataTypeValue, ReadRefusal>;
|
|
280
|
+
/** Take a value into the receiving type, directly or through the cast that type declares; the receiving type constructs the result under `receivingParams`, the parameters of the position that receives it. */
|
|
281
|
+
declare function castTypedValue(support: DataTypeSupport, receivingType: DataTypeId, receivingParams: DataTypeParams, value: DataTypeValue): Result<DataTypeValue, CastRefusal>;
|
|
282
|
+
/**
|
|
283
|
+
* Reads `written` as a value of `receivingType`: through the authoring entry for its syntax, then into `receivingType` directly or through a cast it declares. A refusal is worded for a diagnostic at the written value. The read every value of a fixed receiving type takes: an attribute argument, a type-constructor argument, and its TypeScript counterpart. ADR 254.
|
|
284
|
+
*/
|
|
285
|
+
declare function readWrittenValueAs(support: DataTypeSupport, receivingType: DataTypeId, written: WrittenScalar): Result<DataTypeValue, RefusalDescription>;
|
|
286
|
+
/**
|
|
287
|
+
* Reads `written` into the codec `ref` names, built with `ref`'s type parameters: the authoring entry for its syntax reads it, the codec's data type takes it directly or through a cast, the data type constructs it under the type parameters, and the codec checks it. Returns the value as the data type stores it. A written list is read element by element into the element types of the data type's list cast, then through the list cast.
|
|
288
|
+
*
|
|
289
|
+
* A refusal is worded for a diagnostic, after `subject` and the element it is about, as in `enum "Ratio" member "Half" at element 2: Expected a number`: syntax no entry reads or a cast refuses is `PSL_INVALID_LITERAL`, a value of a type the data type neither is nor casts from is `PSL_VALUE_TYPE_INCOMPATIBLE`, and a value the data type under the type parameters or the codec refuses is `PSL_VALUE_REFUSED`. ADR 254.
|
|
290
|
+
*/
|
|
291
|
+
declare function readWrittenValueIntoCodec(input: {
|
|
292
|
+
readonly support: DataTypeSupport;
|
|
293
|
+
readonly codecLookup: Pick<CodecLookupWithDescriptors, 'descriptorFor'>;
|
|
294
|
+
readonly ref: CodecRef;
|
|
295
|
+
readonly written: WrittenValue;
|
|
296
|
+
readonly subject: string;
|
|
297
|
+
}): Result<JsonValue, RefusalDescription>;
|
|
298
|
+
/** The tags a position of `dataType` admits: its own tag, then the tags of the types it casts from. */
|
|
299
|
+
declare function admittedTags(support: DataTypeSupport, dataType: DataTypeId): readonly string[];
|
|
300
|
+
/** The form a value of a tagged literal's type is written in. */
|
|
301
|
+
declare function tagForm(tag: string): WrittenForm;
|
|
302
|
+
/** Each form a position receiving every one of `receivingTypes` admits, once, in order: ``sql`...` ``, `true or false`. */
|
|
303
|
+
declare function admittedForms(support: DataTypeSupport, receivingTypes: readonly DataTypeId[]): readonly WrittenForm[];
|
|
304
|
+
/** How a position of `dataType` can be written, for a diagnostic: ``sql`...` ``, `true or false`. */
|
|
305
|
+
declare function describeAdmittedForms(support: DataTypeSupport, dataType: DataTypeId): string;
|
|
306
|
+
//#endregion
|
|
307
|
+
//#region src/shared/psl-extension-block.d.ts
|
|
308
|
+
interface PslPosition {
|
|
309
|
+
readonly offset: number;
|
|
310
|
+
readonly line: number;
|
|
311
|
+
readonly column: number;
|
|
312
|
+
}
|
|
313
|
+
interface PslSpan {
|
|
314
|
+
readonly start: PslPosition;
|
|
315
|
+
readonly end: PslPosition;
|
|
316
|
+
}
|
|
317
|
+
type PslDiagnosticCode = 'PSL_UNTERMINATED_BLOCK' | 'PSL_UNSUPPORTED_TOP_LEVEL_BLOCK' | 'PSL_INVALID_NAMESPACE_BLOCK' | 'PSL_INVALID_ATTRIBUTE_SYNTAX' | 'PSL_INVALID_MODEL_MEMBER' | 'PSL_UNSUPPORTED_MODEL_ATTRIBUTE' | 'PSL_UNSUPPORTED_FIELD_ATTRIBUTE' | 'PSL_INVALID_RELATION_ATTRIBUTE' | 'PSL_INVALID_REFERENTIAL_ACTION' | 'PSL_INVALID_DEFAULT_VALUE' | 'PSL_INVALID_ENUM_MEMBER' | 'PSL_INVALID_TYPES_MEMBER' | 'PSL_INVALID_QUALIFIED_TYPE' |
|
|
318
|
+
/**
|
|
319
|
+
* A qualified name (e.g. a dotted type or attribute reference) is structurally
|
|
320
|
+
* invalid, such as an over-qualified or trailing-separator name.
|
|
321
|
+
*/
|
|
322
|
+
'PSL_INVALID_QUALIFIED_NAME' |
|
|
323
|
+
/**
|
|
324
|
+
* A reserved declaration keyword (`model`/`enum`/`namespace`/`type`) that
|
|
325
|
+
* committed the declaration kind on the keyword alone but is missing its name
|
|
326
|
+
* and/or opening brace. The recursive-descent parser produces a best-effort
|
|
327
|
+
* typed node for the malformed header and reports this code rather than
|
|
328
|
+
* `PSL_UNSUPPORTED_TOP_LEVEL_BLOCK`, which is reserved for a genuinely unknown
|
|
329
|
+
* top-level keyword.
|
|
330
|
+
*/
|
|
331
|
+
'PSL_INVALID_DECLARATION' |
|
|
332
|
+
/**
|
|
333
|
+
* A malformed line inside an extension-contributed top-level block body, or
|
|
334
|
+
* a structurally invalid element inside a `list` parameter value.
|
|
335
|
+
*
|
|
336
|
+
* Replaces the overloaded `PSL_UNSUPPORTED_TOP_LEVEL_BLOCK` code that the
|
|
337
|
+
* generic framework parser previously used for these two parse-error sites
|
|
338
|
+
* inside extension blocks — keeping `PSL_UNSUPPORTED_TOP_LEVEL_BLOCK` for
|
|
339
|
+
* its original meaning (an unknown keyword at the top level) and giving
|
|
340
|
+
* extension-block parse errors their own code.
|
|
341
|
+
*/
|
|
342
|
+
'PSL_INVALID_EXTENSION_BLOCK_MEMBER' |
|
|
343
|
+
/**
|
|
344
|
+
* A malformed JS-like object literal `{ key: value, … }` in value/argument
|
|
345
|
+
* position — a field missing its `:`, a field missing its value, or an
|
|
346
|
+
* unterminated `{`. The recursive-descent parser still produces a best-effort
|
|
347
|
+
* `ObjectLiteralExpr` node (preserving the lossless round-trip) and reports
|
|
348
|
+
* this code anchored on the offending token.
|
|
349
|
+
*/
|
|
350
|
+
'PSL_INVALID_OBJECT_LITERAL' |
|
|
351
|
+
/**
|
|
352
|
+
* A string literal with no closing quote — the tokenizer stops a `"` or `'`
|
|
353
|
+
* literal at a newline or at EOF, and a backtick literal before the next line
|
|
354
|
+
* that opens with `}` or at EOF. The recursive-descent parser still consumes
|
|
355
|
+
* the token (preserving the lossless round-trip) but reports this code
|
|
356
|
+
* anchored on the string token's span.
|
|
357
|
+
*/
|
|
358
|
+
'PSL_UNTERMINATED_STRING' |
|
|
359
|
+
/** A backtick string that is not the string literal of a tagged literal; anchored on the string. */
|
|
360
|
+
'PSL_BACKTICK_STRING_REQUIRES_TAG' |
|
|
361
|
+
/** A tagged literal whose tag no pack in the stack registered. */
|
|
362
|
+
'PSL_UNKNOWN_LITERAL_TAG' |
|
|
363
|
+
/** A written value has a data type the receiving position's type neither is nor casts from, or the target has no data type for its syntax. */
|
|
364
|
+
'PSL_VALUE_TYPE_INCOMPATIBLE' |
|
|
365
|
+
/** A written value that its authoring entry's parse or a cast refused. */
|
|
366
|
+
'PSL_INVALID_LITERAL' |
|
|
367
|
+
/** A written value the receiving type, under the receiving position's type parameters, or the receiving codec refused. */
|
|
368
|
+
'PSL_VALUE_REFUSED' |
|
|
369
|
+
/** A tagged literal body contains a NUL character. */
|
|
370
|
+
'PSL_TAGGED_LITERAL_NUL' |
|
|
371
|
+
/** A tagged literal body is larger than 65536 UTF-8 bytes. */
|
|
372
|
+
'PSL_TAGGED_LITERAL_TOO_LARGE' |
|
|
373
|
+
/**
|
|
374
|
+
* An unknown parameter key in an extension-contributed block — a key present
|
|
375
|
+
* in the source block but absent from the descriptor's `parameters` map.
|
|
376
|
+
*/
|
|
377
|
+
'PSL_EXTENSION_UNKNOWN_PARAMETER' |
|
|
378
|
+
/**
|
|
379
|
+
* A required parameter declared in the descriptor is absent from the parsed block.
|
|
380
|
+
*/
|
|
381
|
+
'PSL_EXTENSION_MISSING_REQUIRED_PARAMETER' | 'PSL_EXTENSION_INVALID_VALUE' |
|
|
382
|
+
/**
|
|
383
|
+
* A parameter key appears more than once in an extension block body.
|
|
384
|
+
* The first occurrence is kept; subsequent occurrences emit this diagnostic.
|
|
385
|
+
*/
|
|
386
|
+
'PSL_EXTENSION_DUPLICATE_PARAMETER' |
|
|
387
|
+
/**
|
|
388
|
+
* A `@@`-prefixed block-attribute line inside an extension block has invalid syntax.
|
|
389
|
+
*/
|
|
390
|
+
'PSL_INVALID_EXTENSION_BLOCK_ATTRIBUTE' | 'PSL_EXTENSION_UNKNOWN_BLOCK_ATTRIBUTE' |
|
|
391
|
+
/**
|
|
392
|
+
* Duplicate scopes are top level, namespace body, or block fields; diagnostics
|
|
393
|
+
* are first-wins and anchored on later name spans.
|
|
394
|
+
*/
|
|
395
|
+
'PSL_DUPLICATE_DECLARATION' | 'PSL_UNRESOLVED_REFERENCE';
|
|
396
|
+
/**
|
|
397
|
+
* A PSL diagnostic code contributed by a family or target package (e.g. an
|
|
398
|
+
* attribute-spec refine in a family's authoring layer). The framework union
|
|
399
|
+
* above stays the parser's own vocabulary; contributed codes share the
|
|
400
|
+
* `PSL_` pattern but their names are owned by the contributing package —
|
|
401
|
+
* no family or target vocabulary enters this module. Contributed codes
|
|
402
|
+
* must not reuse a framework code name; pick a domain-scoped prefix
|
|
403
|
+
* segment (e.g. `PSL_INDEX_`, `PSL_POLICY_`) to keep the namespaces
|
|
404
|
+
* collision-free.
|
|
405
|
+
*/
|
|
406
|
+
type ContributedPslDiagnosticCode = `PSL_${string}`;
|
|
407
|
+
interface PslExtensionBlockPrintEntry {
|
|
408
|
+
readonly expression?: string;
|
|
409
|
+
readonly span: PslSpan;
|
|
410
|
+
}
|
|
411
|
+
/**
|
|
412
|
+
* A positional argument on a block attribute, e.g. the `"pg/text@1"` in
|
|
413
|
+
* `@@type("pg/text@1")`.
|
|
414
|
+
*/
|
|
415
|
+
interface PslExtensionBlockAttributeArg {
|
|
416
|
+
readonly kind: 'positional';
|
|
417
|
+
readonly value: string;
|
|
418
|
+
readonly span: PslSpan;
|
|
419
|
+
}
|
|
420
|
+
/**
|
|
421
|
+
* A `@@`-prefixed block-level attribute parsed inside an extension block,
|
|
422
|
+
* e.g. `@@type("pg/text@1")`. Block attributes are captured generically
|
|
423
|
+
* — the parser does not validate attribute names or argument shapes; that
|
|
424
|
+
* is a concern of the block's interpreter.
|
|
425
|
+
*/
|
|
426
|
+
interface PslExtensionBlockAttribute {
|
|
427
|
+
readonly name: string;
|
|
428
|
+
readonly args: readonly PslExtensionBlockAttributeArg[];
|
|
429
|
+
readonly span: PslSpan;
|
|
430
|
+
}
|
|
431
|
+
interface PslExtensionBlockParsedAttribute {
|
|
432
|
+
readonly args: Readonly<Record<string, unknown>>;
|
|
433
|
+
readonly argSpans?: Readonly<Record<string, PslSpan>>;
|
|
434
|
+
readonly span: PslSpan;
|
|
435
|
+
}
|
|
436
|
+
interface PslExtensionBlock {
|
|
437
|
+
readonly kind: string;
|
|
438
|
+
/**
|
|
439
|
+
* The block's parse identity — the source PSL keyword it was declared
|
|
440
|
+
* with. `kind`/`discriminator` is its storage identity; several keywords
|
|
441
|
+
* can share one. E.g. the five `policy_*` keywords all lower to the
|
|
442
|
+
* `policy` entity kind.
|
|
443
|
+
*/
|
|
444
|
+
readonly keyword: string;
|
|
445
|
+
readonly name: string;
|
|
446
|
+
readonly parameters: Record<string, PslExtensionBlockPrintEntry>;
|
|
447
|
+
readonly blockAttributes: readonly PslExtensionBlockAttribute[];
|
|
448
|
+
readonly span: PslSpan;
|
|
449
|
+
}
|
|
450
|
+
interface ParsedPslExtensionBlock<Values = Readonly<Record<string, unknown>>> {
|
|
451
|
+
readonly kind: string;
|
|
452
|
+
readonly keyword: string;
|
|
453
|
+
readonly name: string;
|
|
454
|
+
readonly values: Values;
|
|
455
|
+
readonly parameterSpans: Readonly<Record<string, PslSpan>>;
|
|
456
|
+
/** Each entry whose value is a literal, by key, as it is written: its syntax and source text, so a reader takes it by the cast rule and keeps digits a JavaScript number loses. ADR 254. */
|
|
457
|
+
readonly writtenValues?: Readonly<Record<string, WrittenValue>>;
|
|
458
|
+
readonly attributes: Readonly<Record<string, PslExtensionBlockParsedAttribute>>;
|
|
459
|
+
readonly span: PslSpan;
|
|
460
|
+
}
|
|
461
|
+
//#endregion
|
|
462
|
+
//#region src/shared/framework-authoring.d.ts
|
|
463
|
+
type AuthoringArgRef = {
|
|
464
|
+
readonly kind: 'arg';
|
|
465
|
+
readonly index: number;
|
|
466
|
+
readonly path?: readonly string[];
|
|
467
|
+
readonly default?: AuthoringTemplateValue;
|
|
468
|
+
};
|
|
469
|
+
/**
|
|
470
|
+
* Selects among `cases` by the value of the referenced argument: the resolved
|
|
471
|
+
* value must be one of the case keys, and the node resolves to that case's
|
|
472
|
+
* recursively resolved template. An absent argument resolves to `undefined`,
|
|
473
|
+
* which the enclosing object template omits entirely.
|
|
474
|
+
*
|
|
475
|
+
* Case coverage is validated against the referenced option argument's
|
|
476
|
+
* `values` at pack-registration time, so the runtime miss-throw is an
|
|
477
|
+
* assertion for type-bypassing callers, not a user-facing diagnostic.
|
|
478
|
+
*
|
|
479
|
+
* Must not be used in the `codecId`/`nullable`/`id`/`unique` positions of a
|
|
480
|
+
* preset output: the type-level `ResolveTemplateValue` does not implement
|
|
481
|
+
* select, and those fields feed TS builder-state inference. See ADR 246.
|
|
482
|
+
*/
|
|
483
|
+
interface AuthoringSelectRef {
|
|
484
|
+
readonly kind: 'select';
|
|
485
|
+
readonly index: number;
|
|
486
|
+
readonly path?: readonly string[];
|
|
487
|
+
readonly cases: Readonly<Record<string, AuthoringTemplateValue>>;
|
|
488
|
+
}
|
|
489
|
+
type AuthoringTemplateValue = string | number | boolean | null | AuthoringArgRef | AuthoringSelectRef | readonly AuthoringTemplateValue[] | {
|
|
490
|
+
readonly [key: string]: AuthoringTemplateValue;
|
|
491
|
+
};
|
|
492
|
+
interface AuthoringArgumentDescriptorCommon {
|
|
493
|
+
readonly name?: string;
|
|
494
|
+
readonly optional?: boolean;
|
|
495
|
+
}
|
|
496
|
+
interface ValueArgumentKind {
|
|
497
|
+
readonly kind: 'value';
|
|
498
|
+
readonly dataType: string;
|
|
499
|
+
}
|
|
500
|
+
type AuthoringArgumentDescriptor = AuthoringArgumentDescriptorCommon & (ValueArgumentKind | {
|
|
501
|
+
readonly kind: 'number';
|
|
502
|
+
readonly integer?: boolean;
|
|
503
|
+
readonly minimum?: number;
|
|
504
|
+
readonly maximum?: number;
|
|
505
|
+
} | {
|
|
506
|
+
readonly kind: 'object';
|
|
507
|
+
readonly properties: Record<string, AuthoringArgumentDescriptor>;
|
|
508
|
+
} | AuthoringOption);
|
|
509
|
+
/** An argument that is a value of the data type `dataType`, read and cast as attribute arguments are. ADR 254. */
|
|
510
|
+
type AuthoringValueArgument = Extract<AuthoringArgumentDescriptor, {
|
|
511
|
+
readonly kind: 'value';
|
|
512
|
+
}>;
|
|
513
|
+
/**
|
|
514
|
+
* What a type constructor or field preset produces: a codec and its parameters. The database type
|
|
515
|
+
* is the codec's data type's, named by the family that writes the contract.
|
|
516
|
+
*/
|
|
517
|
+
interface AuthoringStorageTypeTemplate {
|
|
518
|
+
readonly codecId: string;
|
|
519
|
+
readonly typeParams?: Record<string, AuthoringTemplateValue>;
|
|
520
|
+
}
|
|
521
|
+
/**
|
|
522
|
+
* Declares that one positional argument of a
|
|
523
|
+
* {@link AuthoringTypeConstructorDescriptor} call names another entity
|
|
524
|
+
* parsed from the same document, rather than carrying a literal value (e.g.
|
|
525
|
+
* `pg.enum(AalLevel)` naming a `native_enum` entity). `index` is the
|
|
526
|
+
* argument's position in the call; `entityKind` is the entries-slot
|
|
527
|
+
* discriminator the interpreter looks the named entity up under (the same
|
|
528
|
+
* shape {@link AuthoringEntityTypeFactoryOutput.factory} output is collected
|
|
529
|
+
* into, keyed by discriminator then block name).
|
|
530
|
+
*
|
|
531
|
+
* The interpreter resolves the named argument to the entity instance
|
|
532
|
+
* generically, driven only by this declaration — it has no target-specific
|
|
533
|
+
* knowledge of which type constructors carry one. Converting the resolved
|
|
534
|
+
* entity into the constructor's params is a separate, codec-owned concern:
|
|
535
|
+
* the codec descriptor registered for `output.codecId` supplies that
|
|
536
|
+
* conversion, not this framework type.
|
|
537
|
+
*/
|
|
538
|
+
interface AuthoringTypeConstructorEntityRef {
|
|
539
|
+
readonly index: number;
|
|
540
|
+
readonly entityKind: string;
|
|
541
|
+
}
|
|
542
|
+
interface AuthoringTypeConstructorDescriptor {
|
|
543
|
+
readonly kind: 'typeConstructor';
|
|
544
|
+
readonly documentation?: string;
|
|
545
|
+
readonly args?: readonly AuthoringArgumentDescriptor[];
|
|
546
|
+
readonly output: AuthoringStorageTypeTemplate;
|
|
547
|
+
/** Present when one of this constructor's positional arguments names another document-local entity instead of carrying a literal value. Absent for ordinary literal-argument constructors. */
|
|
548
|
+
readonly entityRefArg?: AuthoringTypeConstructorEntityRef;
|
|
549
|
+
/** Present when this name is kept only as an alias of `replacement` and will be removed; it resolves as before, and a source may warn. */
|
|
550
|
+
readonly deprecated?: {
|
|
551
|
+
readonly replacement: string;
|
|
552
|
+
};
|
|
553
|
+
/** Marks the constructor written for a column of its codec's data type when no schema names one: `contract infer` writes it, and the Prisma 7 reader will. `contract print` writes it when it produces the column's codec, and otherwise the first constructor in the stack that does, so a `timestamptz` column with the `Temporal` codec prints `DateTime`. At most one per data type. */
|
|
554
|
+
readonly inferred?: true;
|
|
555
|
+
}
|
|
556
|
+
interface AuthoringColumnDefaultTemplateLiteral {
|
|
557
|
+
readonly kind: 'literal';
|
|
558
|
+
readonly value: AuthoringTemplateValue;
|
|
559
|
+
}
|
|
560
|
+
interface AuthoringColumnDefaultTemplateFunction {
|
|
561
|
+
readonly kind: 'function';
|
|
562
|
+
readonly expression: AuthoringTemplateValue;
|
|
563
|
+
}
|
|
564
|
+
type AuthoringColumnDefaultTemplate = AuthoringColumnDefaultTemplateLiteral | AuthoringColumnDefaultTemplateFunction;
|
|
565
|
+
interface AuthoringExecutionDefaultsTemplate {
|
|
566
|
+
readonly onCreate?: AuthoringTemplateValue;
|
|
567
|
+
readonly onUpdate?: AuthoringTemplateValue;
|
|
568
|
+
}
|
|
569
|
+
interface AuthoringFieldPresetOutput extends AuthoringStorageTypeTemplate {
|
|
570
|
+
/** Makes the column nullable without `?`. A preset cannot make a column not nullable: `?` always does. */
|
|
571
|
+
readonly nullable?: true;
|
|
572
|
+
readonly default?: AuthoringColumnDefaultTemplate;
|
|
573
|
+
readonly executionDefaults?: AuthoringExecutionDefaultsTemplate;
|
|
574
|
+
readonly id?: boolean;
|
|
575
|
+
readonly unique?: boolean;
|
|
576
|
+
}
|
|
577
|
+
interface AuthoringFieldPresetDescriptor {
|
|
578
|
+
readonly kind: 'fieldPreset';
|
|
579
|
+
readonly args?: readonly AuthoringArgumentDescriptor[];
|
|
580
|
+
readonly output: AuthoringFieldPresetOutput;
|
|
581
|
+
}
|
|
582
|
+
/**
|
|
583
|
+
* A type alias a pack contributes: a type with fixed params, and the generators every field typed by it takes. It takes no arguments, and is written bare, such as `temporal.CreatedAt`.
|
|
584
|
+
*/
|
|
585
|
+
interface AuthoringTypeAliasDescriptor {
|
|
586
|
+
readonly kind: 'typeAlias';
|
|
587
|
+
readonly documentation?: string;
|
|
588
|
+
readonly output: {
|
|
589
|
+
/** Assembly refuses params the codec's parameter schema refuses. */
|
|
590
|
+
readonly type: AuthoringStorageTypeTemplate;
|
|
591
|
+
/** Resolved by the field's codec, as `@onCreate(fn())` is. Assembly refuses a call that does not resolve. */
|
|
592
|
+
readonly onCreate?: GeneratorFunctionCall;
|
|
593
|
+
readonly onUpdate?: GeneratorFunctionCall;
|
|
594
|
+
};
|
|
595
|
+
}
|
|
596
|
+
type AuthoringTypeNamespace = {
|
|
597
|
+
readonly [name: string]: AuthoringTypeConstructorDescriptor | AuthoringTypeAliasDescriptor | AuthoringTypeNamespace;
|
|
598
|
+
};
|
|
599
|
+
/** The descriptor kinds a `type` namespace holds as leaves. */
|
|
600
|
+
declare const AUTHORING_TYPE_DESCRIPTOR_KINDS: readonly ["typeConstructor", "typeAlias"];
|
|
601
|
+
type AuthoringFieldNamespace = {
|
|
602
|
+
readonly [name: string]: AuthoringFieldPresetDescriptor | AuthoringFieldNamespace;
|
|
603
|
+
};
|
|
604
|
+
/**
|
|
605
|
+
* Context surfaced to entity-type factories at call time. Currently a
|
|
606
|
+
* placeholder — sharpened as concrete consumers (enum, namespace, …)
|
|
607
|
+
* discover what the factory actually needs to read (codec lookup,
|
|
608
|
+
* namespace registry, …).
|
|
609
|
+
*/
|
|
610
|
+
/**
|
|
611
|
+
* A write-only sink that a factory may push authoring-time diagnostics into.
|
|
612
|
+
* The concrete type pushed must be structurally compatible with whatever the
|
|
613
|
+
* consumer accumulates (typically `ContractSourceDiagnostic[]`); the framework
|
|
614
|
+
* layer deliberately does not depend on that concrete type.
|
|
615
|
+
*/
|
|
616
|
+
interface AuthoringDiagnosticSink {
|
|
617
|
+
push(d: {
|
|
618
|
+
readonly code: string;
|
|
619
|
+
readonly message: string;
|
|
620
|
+
readonly sourceId: string;
|
|
621
|
+
readonly span?: unknown;
|
|
622
|
+
}): void;
|
|
623
|
+
}
|
|
624
|
+
/**
|
|
625
|
+
* A non-fatal advisory minted at authoring time. Fully formed at the push
|
|
626
|
+
* site — the transport and the flush never learn family or target
|
|
627
|
+
* vocabulary. Warnings batch together iff `code` AND `summary` match: the
|
|
628
|
+
* batched rendering asserts the summary of every member, so the grouping
|
|
629
|
+
* key must cover everything the summary claims.
|
|
630
|
+
*/
|
|
631
|
+
interface AuthoringWarning {
|
|
632
|
+
/** Stable machine code — what the user greps and what `process.emitWarning` stamps. */
|
|
633
|
+
readonly code: string;
|
|
634
|
+
/** Full text emitted when the warning is itemized (group at or below the batch threshold). */
|
|
635
|
+
readonly message: string;
|
|
636
|
+
/** Short subject label listed under a batched group summary (e.g. `object "…"`). */
|
|
637
|
+
readonly item: string;
|
|
638
|
+
/**
|
|
639
|
+
* Group summary text — what a batched group asserts about EVERY member.
|
|
640
|
+
* An over-threshold group renders as `"<count> <summary>"` above the item
|
|
641
|
+
* lines, so this starts with the plural noun phrase (e.g.
|
|
642
|
+
* `objects use <feature>. <remediation>`).
|
|
643
|
+
*/
|
|
644
|
+
readonly summary: string;
|
|
645
|
+
}
|
|
646
|
+
/**
|
|
647
|
+
* A write-only sink for non-fatal authoring-time warnings a factory may
|
|
648
|
+
* emit. Entries travel verbatim to a single per-build flush — no
|
|
649
|
+
* narrowing, no per-kind fields; a plain `AuthoringWarning[]` satisfies
|
|
650
|
+
* this structurally.
|
|
651
|
+
*/
|
|
652
|
+
interface AuthoringWarningSink {
|
|
653
|
+
push(w: AuthoringWarning): void;
|
|
654
|
+
}
|
|
655
|
+
/**
|
|
656
|
+
* Emits collected authoring warnings once per build, grouped by `code`:
|
|
657
|
+
* a group at or below the threshold itemizes every `message`; above it,
|
|
658
|
+
* one summary — `"<count> <summary>"` followed by the `item` lines — so
|
|
659
|
+
* a build with many hits of one kind does not wall-of-text, and warnings
|
|
660
|
+
* of different codes never batch into each other's summary.
|
|
661
|
+
*/
|
|
662
|
+
declare function flushAuthoringWarnings(warnings: readonly AuthoringWarning[]): void;
|
|
663
|
+
interface AuthoringEntityContext {
|
|
664
|
+
readonly family: string;
|
|
665
|
+
readonly target: string;
|
|
666
|
+
/** Codec registry available to factories that need to validate or decode values. */
|
|
667
|
+
readonly codecLookup: CodecLookupWithDescriptors;
|
|
668
|
+
/** The stack's data types with their authoring entries: a factory reads the data type a codec represents from `lookup`, and a written value through the entries. */
|
|
669
|
+
readonly dataTypes: DataTypeSupport;
|
|
670
|
+
/** Source file identifier threaded into diagnostics emitted by the factory. */
|
|
671
|
+
readonly sourceId?: string;
|
|
672
|
+
/** Push channel for authoring-time diagnostics emitted by the factory. */
|
|
673
|
+
readonly diagnostics?: AuthoringDiagnosticSink;
|
|
674
|
+
/** Push channel for non-fatal authoring-time warnings emitted by the factory. */
|
|
675
|
+
readonly warnings?: AuthoringWarningSink;
|
|
676
|
+
/**
|
|
677
|
+
* The target's default codec ids for an `enum` block that omits `@@type`.
|
|
678
|
+
* `text` is used when every member is a bare name or a string value;
|
|
679
|
+
* `int` is used when every member is an integer value. Every target pack
|
|
680
|
+
* populates this so `@@type` omission can be inferred consistently.
|
|
681
|
+
*/
|
|
682
|
+
readonly enumInferenceCodecs?: {
|
|
683
|
+
readonly text: string;
|
|
684
|
+
readonly int: string;
|
|
685
|
+
};
|
|
686
|
+
}
|
|
687
|
+
declare function classifyEnumMemberType(values: Readonly<Record<string, unknown>>): 'text' | 'int' | null;
|
|
688
|
+
/**
|
|
689
|
+
* Resolves the codec id for an `enum` block. When `@@type` is absent, the codec
|
|
690
|
+
* is inferred from the members via {@link classifyEnumMemberType}; otherwise the
|
|
691
|
+
* explicit `@@type("codec")` argument is parsed. Pushes the appropriate
|
|
692
|
+
* diagnostic and returns `undefined` when neither yields a codec. `codecSpan` is
|
|
693
|
+
* the span downstream codec-validation diagnostics should anchor to. Shared by
|
|
694
|
+
* every family's enum factory so inference and the explicit path stay identical.
|
|
695
|
+
*/
|
|
696
|
+
declare function resolveEnumCodecId(block: ParsedPslExtensionBlock, ctx: AuthoringEntityContext): {
|
|
697
|
+
readonly codecId: string;
|
|
698
|
+
readonly codecSpan: PslSpan;
|
|
699
|
+
} | undefined;
|
|
700
|
+
interface AuthoringEntityTypeTemplateOutput {
|
|
701
|
+
readonly template: AuthoringTemplateValue;
|
|
702
|
+
}
|
|
703
|
+
/**
|
|
704
|
+
* Default `Input = never` is load-bearing for pack-bag-driven type
|
|
705
|
+
* narrowing. Factory parameter positions are contravariant, so a pack
|
|
706
|
+
* literal declaring `factory: (input: DemoEntityInput) => DemoEntity`
|
|
707
|
+
* is only assignable to the base descriptor's factory shape if the
|
|
708
|
+
* base's input is `never` (the bottom of the contravariant position).
|
|
709
|
+
* The concrete input/output types are recovered at the helper-derivation
|
|
710
|
+
* site via `EntityHelperFunction<Descriptor>`'s conditional inference,
|
|
711
|
+
* which reads them from the pack's `as const` literal factory signature
|
|
712
|
+
* — the base widening does not erase the literal because `satisfies`
|
|
713
|
+
* does not widen the declared type.
|
|
714
|
+
*/
|
|
715
|
+
interface AuthoringEntityTypeFactoryOutput<Input = never, Output = unknown> {
|
|
716
|
+
readonly factory: (input: Input, ctx: AuthoringEntityContext) => Output;
|
|
717
|
+
}
|
|
718
|
+
interface AuthoringEntityTypeDescriptor<Input = never, Output = unknown> {
|
|
719
|
+
readonly kind: 'entity';
|
|
720
|
+
readonly discriminator: string;
|
|
721
|
+
readonly args?: readonly AuthoringArgumentDescriptor[];
|
|
722
|
+
readonly output: AuthoringEntityTypeTemplateOutput | AuthoringEntityTypeFactoryOutput<Input, Output>;
|
|
723
|
+
/**
|
|
724
|
+
* arktype schema fragment for one entry whose envelope `kind` matches
|
|
725
|
+
* this descriptor's {@link discriminator}. The family validator composes
|
|
726
|
+
* contributed fragments into the per-namespace entry schema at
|
|
727
|
+
* validator construction time so the structural check covers
|
|
728
|
+
* pack-introduced kinds without the family core hard-coding the schema.
|
|
729
|
+
*
|
|
730
|
+
* Hydration uses {@link AuthoringEntityTypeFactoryOutput.factory}
|
|
731
|
+
* directly — the wire shape conforms structurally to the factory's
|
|
732
|
+
* `Input` after `validatorSchema` validates it.
|
|
733
|
+
*/
|
|
734
|
+
readonly validatorSchema?: Type<unknown>;
|
|
735
|
+
}
|
|
736
|
+
type AuthoringEntityTypeNamespace = {
|
|
737
|
+
readonly [name: string]: AuthoringEntityTypeDescriptor | AuthoringEntityTypeNamespace;
|
|
738
|
+
};
|
|
739
|
+
/**
|
|
740
|
+
* Declarative descriptor for an extension-contributed top-level PSL block.
|
|
741
|
+
*
|
|
742
|
+
* An extension registers one of these per keyword it contributes. The
|
|
743
|
+
* framework owns the generic parser, validator, and printer — no
|
|
744
|
+
* parsing or printing code runs from the extension.
|
|
745
|
+
*
|
|
746
|
+
* - `keyword` is the PSL top-level identifier this descriptor claims
|
|
747
|
+
* (`policy_select`, `role`, …).
|
|
748
|
+
* - `discriminator` is the routing key used by the printer dispatch and
|
|
749
|
+
* the `entityTypes` lowering factory lookup. Convention:
|
|
750
|
+
* `<target-or-family>-<kind>` (`postgres-policy-select`).
|
|
751
|
+
* - `name.required` declares whether the block must have a name token
|
|
752
|
+
* after the keyword. Currently always `true` — anonymous blocks are
|
|
753
|
+
* not part of the closed-grammar premise — but the field is explicit
|
|
754
|
+
* so the type can evolve without a breaking change.
|
|
755
|
+
*/
|
|
756
|
+
interface AuthoringPslBlockDescriptor {
|
|
757
|
+
readonly kind: 'pslBlock';
|
|
758
|
+
readonly documentation?: string;
|
|
759
|
+
readonly keyword: string;
|
|
760
|
+
readonly discriminator: string;
|
|
761
|
+
readonly name: {
|
|
762
|
+
readonly required: boolean;
|
|
763
|
+
};
|
|
764
|
+
readonly spec: unknown;
|
|
765
|
+
/**
|
|
766
|
+
* Declares that the model named by the block's ref parameter `parameter`
|
|
767
|
+
* must carry the bare `@@` model attribute `attribute`. The family
|
|
768
|
+
* interpreter enforces this generically over the whole parsed document —
|
|
769
|
+
* declaration order of the block and the model does not matter — and
|
|
770
|
+
* emits `PSL_EXTENSION_TARGET_MODEL_MISSING_ATTRIBUTE` naming the block
|
|
771
|
+
* and the model when the attribute is absent. A parameter that is
|
|
772
|
+
* missing or does not resolve to a model is not this rule's concern
|
|
773
|
+
* (missing-parameter and unresolved-ref diagnostics own those cases).
|
|
774
|
+
*/
|
|
775
|
+
readonly requiresModelAttribute?: {
|
|
776
|
+
readonly parameter: string;
|
|
777
|
+
readonly attribute: string;
|
|
778
|
+
};
|
|
779
|
+
/**
|
|
780
|
+
* Declares that the block's name is the name of the storage object the
|
|
781
|
+
* block declares, and that the block attribute `map` replaces that name.
|
|
782
|
+
*/
|
|
783
|
+
readonly nameIsStorageName?: boolean;
|
|
784
|
+
readonly attributes?: Readonly<Record<string, unknown>>;
|
|
785
|
+
}
|
|
786
|
+
type AuthoringPslBlockDescriptorNamespace = {
|
|
787
|
+
readonly [name: string]: AuthoringPslBlockDescriptor | AuthoringPslBlockDescriptorNamespace;
|
|
788
|
+
};
|
|
789
|
+
/**
|
|
790
|
+
* Context surfaced to a model-attribute lowering at call time: the entity
|
|
791
|
+
* context shared with entity-type factories, plus the declaring model's
|
|
792
|
+
* name, its mapped storage name (the name of the storage object the model
|
|
793
|
+
* maps to; which kind of object that is belongs to the family, not the
|
|
794
|
+
* framework), and the namespace id the lowered entity should be filed
|
|
795
|
+
* under.
|
|
796
|
+
*/
|
|
797
|
+
interface AuthoringModelAttributeContext extends AuthoringEntityContext {
|
|
798
|
+
readonly modelName: string;
|
|
799
|
+
readonly storageName: string;
|
|
800
|
+
readonly namespaceId: string;
|
|
801
|
+
/**
|
|
802
|
+
* The storage name a field of the declaring model maps to, or `undefined`
|
|
803
|
+
* when the model declares no such field. The interpreter owns the mapping
|
|
804
|
+
* — a lowering that renders storage-level text must ask for the name here
|
|
805
|
+
* rather than reusing the authored field name, which `@map` may rename.
|
|
806
|
+
*/
|
|
807
|
+
readonly fieldStorageName: (fieldName: string) => string | undefined;
|
|
808
|
+
/**
|
|
809
|
+
* The codec a field of the declaring model stores its values through, or
|
|
810
|
+
* `undefined` when the model declares no such field or the field is not a
|
|
811
|
+
* stored value at all. A lowering that only makes sense over certain value
|
|
812
|
+
* kinds checks this rather than guessing from the field's declared type.
|
|
813
|
+
*/
|
|
814
|
+
readonly fieldCodecId: (fieldName: string) => string | undefined;
|
|
815
|
+
}
|
|
816
|
+
/**
|
|
817
|
+
* What a model-attribute lowering returns when it produces an entity: `key`
|
|
818
|
+
* is the identity the entity is stored under within its `entries` slot
|
|
819
|
+
* (`entries[attribute][key]`); `entity` is the value stored there.
|
|
820
|
+
*/
|
|
821
|
+
interface AuthoringModelAttributeEntityOutput {
|
|
822
|
+
readonly key: string;
|
|
823
|
+
readonly entity: unknown;
|
|
824
|
+
}
|
|
825
|
+
/**
|
|
826
|
+
* What a model-attribute lowering returns when it produces an index on the
|
|
827
|
+
* declaring model's storage rather than a standalone entity. The framework
|
|
828
|
+
* never reads `index`: its shape is the family's authored-index input, which
|
|
829
|
+
* the family interpreter narrows and files through the same path its own
|
|
830
|
+
* index attribute uses, so naming and validation are shared.
|
|
831
|
+
*/
|
|
832
|
+
interface AuthoringModelAttributeIndexOutput {
|
|
833
|
+
readonly index: unknown;
|
|
834
|
+
}
|
|
835
|
+
/**
|
|
836
|
+
* What a model-attribute lowering returns. A lowering that instead pushed a
|
|
837
|
+
* diagnostic through {@link AuthoringModelAttributeContext.diagnostics}
|
|
838
|
+
* returns `undefined` — the same convention
|
|
839
|
+
* {@link AuthoringEntityTypeFactoryOutput} uses.
|
|
840
|
+
*/
|
|
841
|
+
type AuthoringModelAttributeLoweringOutput = AuthoringModelAttributeEntityOutput | AuthoringModelAttributeIndexOutput;
|
|
842
|
+
/**
|
|
843
|
+
* Declarative descriptor for an extension-contributed `@@` model attribute.
|
|
844
|
+
*
|
|
845
|
+
* An extension registers one of these per bare attribute name it
|
|
846
|
+
* contributes. The framework owns the generic consult in the interpreter's
|
|
847
|
+
* model-attribute loop; the contribution supplies only `spec` and `lower`.
|
|
848
|
+
*
|
|
849
|
+
* - `attribute` is the bare `@@` attribute name this descriptor claims and,
|
|
850
|
+
* by the one-string rule, the `entries` slot its lowered entities are
|
|
851
|
+
* grouped under (`entries[attribute][key]`).
|
|
852
|
+
* - `lower` receives the parsed arguments and the declaring model's
|
|
853
|
+
* context, and returns the entity to file into `entries`, or `undefined`
|
|
854
|
+
* after pushing a diagnostic via `ctx.diagnostics`.
|
|
855
|
+
*
|
|
856
|
+
* `Out` defaults to `never` — not `unknown` — for the same contravariance
|
|
857
|
+
* reason documented on {@link AuthoringEntityTypeFactoryOutput}: a concrete
|
|
858
|
+
* pack literal's narrower `lower(parsed: ConcreteOut, ctx)` is only
|
|
859
|
+
* assignable to this base shape when the base parameter is the bottom type.
|
|
860
|
+
*/
|
|
861
|
+
interface AuthoringModelAttributeDescriptor<Out = never> {
|
|
862
|
+
readonly kind: 'modelAttribute';
|
|
863
|
+
readonly attribute: string;
|
|
864
|
+
readonly spec: unknown;
|
|
865
|
+
/**
|
|
866
|
+
* Whether one model may declare this attribute more than once. Defaults to
|
|
867
|
+
* false, which is what the duplicate diagnostic enforces.
|
|
868
|
+
*/
|
|
869
|
+
readonly repeatable?: boolean;
|
|
870
|
+
readonly lower: (parsed: Out, ctx: AuthoringModelAttributeContext) => AuthoringModelAttributeLoweringOutput | undefined;
|
|
871
|
+
}
|
|
872
|
+
type AuthoringModelAttributeDescriptorNamespace = {
|
|
873
|
+
readonly [name: string]: AuthoringModelAttributeDescriptor | AuthoringModelAttributeDescriptorNamespace;
|
|
874
|
+
};
|
|
875
|
+
interface AuthoringAttributeSpecContributions {
|
|
876
|
+
readonly model: Readonly<Record<string, unknown>>;
|
|
877
|
+
readonly field: Readonly<Record<string, unknown>>;
|
|
878
|
+
}
|
|
879
|
+
/**
|
|
880
|
+
* How a contract source writes values of one data type, and how it reads the text back.
|
|
881
|
+
*
|
|
882
|
+
* A tag is a qualified name followed by a body in any of the quote styles. A plain form is one of
|
|
883
|
+
* the three pieces of syntax read without a tag: a quoted string, `true`/`false`, and a number.
|
|
884
|
+
*
|
|
885
|
+
* A number is the one plain form that yields several types, so instead of `parse` its arm carries a
|
|
886
|
+
* classifier, which picks the type from the digits and returns JSON of that type with it, and
|
|
887
|
+
* `types`, every type the classifier can return — which is how assembly knows those types can be
|
|
888
|
+
* written. The type constructs its value from what `parse` or the classifier returns. ADR 254.
|
|
889
|
+
*/
|
|
890
|
+
type DataTypeWrittenForm = {
|
|
891
|
+
readonly kind: 'tag';
|
|
892
|
+
readonly tag: string;
|
|
893
|
+
readonly parse: (text: string) => JsonValue;
|
|
894
|
+
} | {
|
|
895
|
+
readonly kind: 'plain';
|
|
896
|
+
readonly syntax: 'string' | 'boolean';
|
|
897
|
+
readonly parse: (text: string) => JsonValue;
|
|
898
|
+
} | {
|
|
899
|
+
readonly kind: 'plain';
|
|
900
|
+
readonly syntax: 'number';
|
|
901
|
+
readonly types: readonly DataTypeId[];
|
|
902
|
+
readonly classify: (text: string) => {
|
|
903
|
+
readonly type: DataTypeId;
|
|
904
|
+
readonly value: JsonValue;
|
|
905
|
+
} | undefined;
|
|
906
|
+
};
|
|
907
|
+
/**
|
|
908
|
+
* PSL support for one data type, keyed by its id and contributed by the component that registers
|
|
909
|
+
* the type.
|
|
910
|
+
*
|
|
911
|
+
* The written form reads text into JSON the type constructs its value from, throwing a structured
|
|
912
|
+
* error for text it cannot read; `print` is the reverse.
|
|
913
|
+
*/
|
|
914
|
+
interface DataTypeAuthoringEntry {
|
|
915
|
+
readonly written: DataTypeWrittenForm;
|
|
916
|
+
readonly print: (value: JsonValue) => string;
|
|
917
|
+
readonly documentation: string;
|
|
918
|
+
}
|
|
919
|
+
interface AuthoringContributions {
|
|
920
|
+
readonly type?: AuthoringTypeNamespace;
|
|
921
|
+
readonly field?: AuthoringFieldNamespace;
|
|
922
|
+
readonly entityTypes?: AuthoringEntityTypeNamespace;
|
|
923
|
+
/**
|
|
924
|
+
* Registry of declarative block descriptors this contribution registers,
|
|
925
|
+
* keyed by arbitrary path segments. Each leaf is an
|
|
926
|
+
* {@link AuthoringPslBlockDescriptor} that claims a PSL top-level keyword.
|
|
927
|
+
* The framework owns the generic parser, validator, and printer; the
|
|
928
|
+
* contribution supplies only these declarative descriptors.
|
|
929
|
+
*
|
|
930
|
+
* Contrast with the parsed block nodes themselves, which live in a
|
|
931
|
+
* namespace's `entries` under their discriminator key; this field holds the
|
|
932
|
+
* registry of descriptors that teach the parser how to read those blocks.
|
|
933
|
+
*/
|
|
934
|
+
readonly pslBlockDescriptors?: AuthoringPslBlockDescriptorNamespace;
|
|
935
|
+
/**
|
|
936
|
+
* Registry of declarative `@@` model attribute descriptors this
|
|
937
|
+
* contribution registers, keyed by arbitrary path segments. Each leaf is
|
|
938
|
+
* an {@link AuthoringModelAttributeDescriptor} that claims a bare model
|
|
939
|
+
* attribute name. The framework owns the generic consult in the family
|
|
940
|
+
* interpreter's model-attribute loop; the contribution supplies only the
|
|
941
|
+
* declarative spec and the lowering.
|
|
942
|
+
*/
|
|
943
|
+
readonly modelAttributes?: AuthoringModelAttributeDescriptorNamespace;
|
|
944
|
+
readonly attributeSpecs?: AuthoringAttributeSpecContributions;
|
|
945
|
+
/** PSL support for the data types this contribution registers, keyed by data type id. ADR 254. */
|
|
946
|
+
readonly dataTypes?: Readonly<Record<string, DataTypeAuthoringEntry>>;
|
|
947
|
+
/**
|
|
948
|
+
* Names the top-level type constructor that stores embedded value-object
|
|
949
|
+
* fields (fields typed as a value-object `type` block). A single named
|
|
950
|
+
* slot per component makes within-component ambiguity impossible by
|
|
951
|
+
* shape. Assembly rejects two components both declaring it, validates
|
|
952
|
+
* that the assembled namespace carries the named constructor as a
|
|
953
|
+
* top-level bare-eligible entry (see
|
|
954
|
+
* {@link collectScalarTypeConstructors}), and exposes the single value to
|
|
955
|
+
* family interpreters — so family layers never hardcode a target's type
|
|
956
|
+
* names.
|
|
957
|
+
*/
|
|
958
|
+
readonly valueObjectStorageType?: string;
|
|
959
|
+
/**
|
|
960
|
+
* The data types whose values are text, such as a target's variable-length, fixed-length and bounded text types. A family uses the list where only text is meaningful, such as a polymorphic model's discriminator column. Assembly takes every component's list.
|
|
961
|
+
*/
|
|
962
|
+
readonly textDataTypes?: readonly DataTypeId[];
|
|
963
|
+
}
|
|
964
|
+
declare function isAuthoringArgRef(value: unknown): value is AuthoringArgRef;
|
|
965
|
+
declare function isAuthoringSelectRef(value: unknown): value is AuthoringSelectRef;
|
|
966
|
+
declare function isAuthoringTypeConstructorDescriptor(value: AuthoringTypeConstructorDescriptor | AuthoringTypeAliasDescriptor | AuthoringTypeNamespace): value is AuthoringTypeConstructorDescriptor;
|
|
967
|
+
declare function isAuthoringTypeAliasDescriptor(value: AuthoringTypeConstructorDescriptor | AuthoringTypeAliasDescriptor | AuthoringTypeNamespace): value is AuthoringTypeAliasDescriptor;
|
|
968
|
+
/** Whether `value` is a leaf of a `type` namespace: a type constructor or a type alias. */
|
|
969
|
+
declare function isAuthoringTypeDescriptor(value: AuthoringTypeConstructorDescriptor | AuthoringTypeAliasDescriptor | AuthoringTypeNamespace): value is AuthoringTypeConstructorDescriptor | AuthoringTypeAliasDescriptor;
|
|
970
|
+
/** The type constructor at `path` in the contributions' type namespace, or `undefined` when none is there. */
|
|
971
|
+
declare function getAuthoringTypeConstructor(contributions: {
|
|
972
|
+
readonly type?: AuthoringTypeNamespace;
|
|
973
|
+
} | undefined, path: readonly string[]): AuthoringTypeConstructorDescriptor | undefined;
|
|
974
|
+
declare function isAuthoringFieldPresetDescriptor(value: AuthoringFieldPresetDescriptor | AuthoringFieldNamespace): value is AuthoringFieldPresetDescriptor;
|
|
975
|
+
declare function isAuthoringEntityTypeDescriptor(value: AuthoringEntityTypeDescriptor | AuthoringEntityTypeNamespace): value is AuthoringEntityTypeDescriptor;
|
|
976
|
+
declare function isAuthoringPslBlockDescriptor(value: AuthoringPslBlockDescriptor | AuthoringPslBlockDescriptorNamespace): value is AuthoringPslBlockDescriptor;
|
|
977
|
+
declare function isAuthoringModelAttributeDescriptor(value: AuthoringModelAttributeDescriptor | AuthoringModelAttributeDescriptorNamespace): value is AuthoringModelAttributeDescriptor;
|
|
978
|
+
/**
|
|
979
|
+
* Deep structural check run only at the composition boundary (the merge and
|
|
980
|
+
* collect walkers) to classify a raw namespace-tree node as a leaf descriptor.
|
|
981
|
+
* A node counts as a leaf iff its `kind` matches `descriptorKind` AND it
|
|
982
|
+
* carries that kind's required fields.
|
|
983
|
+
*
|
|
984
|
+
* This is boundary validation over `unknown`, NOT a type-predicate: the four
|
|
985
|
+
* exported `isAuthoring*Descriptor` predicates deliberately narrow on `kind`
|
|
986
|
+
* alone and trust the static types. The walkers, by contrast, also receive
|
|
987
|
+
* type-bypassing packs (`as unknown as never` in tests, untyped JS at runtime)
|
|
988
|
+
* whose descriptor-shaped-but-incomplete nodes must be rejected rather than
|
|
989
|
+
* silently treated as sub-namespaces — so the well-formedness check lives here.
|
|
990
|
+
*/
|
|
991
|
+
/** The `kind` of the leaves of one namespace, or several kinds when the namespace holds more than one, as `type` does. */
|
|
992
|
+
type AuthoringDescriptorKinds = string | readonly string[];
|
|
993
|
+
/**
|
|
994
|
+
* Merges `source` into `target` recursively at the descriptor-namespace
|
|
995
|
+
* level. `descriptorKind` is the `kind` value, or values, ('typeConstructor'
|
|
996
|
+
* and 'typeAlias', 'fieldPreset', 'entity', or 'pslBlock') that identifies a descriptor
|
|
997
|
+
* (terminal merge point; same-path registrations across components are
|
|
998
|
+
* reported as duplicates) as opposed to a sub-namespace (recursion target).
|
|
999
|
+
*
|
|
1000
|
+
* Path segments are validated against prototype-pollution names
|
|
1001
|
+
* (`__proto__`, `constructor`, `prototype`). A value that is neither a
|
|
1002
|
+
* recognized leaf nor a plain object — e.g. a malformed descriptor
|
|
1003
|
+
* where the canonical leaf guard rejected it for missing `output` —
|
|
1004
|
+
* is reported as an invalid contribution rather than recursed into,
|
|
1005
|
+
* which would either silently mangle state or infinite-loop on
|
|
1006
|
+
* primitive properties.
|
|
1007
|
+
*
|
|
1008
|
+
* Within-registry duplicate detection is this walker's job;
|
|
1009
|
+
* cross-registry detection runs separately via
|
|
1010
|
+
* `assertNoCrossRegistryCollisions` after merging completes.
|
|
1011
|
+
*/
|
|
1012
|
+
declare function mergeAuthoringNamespaces(target: Record<string, unknown>, source: Record<string, unknown>, path: readonly string[], descriptorKind: AuthoringDescriptorKinds, label: string): void;
|
|
1013
|
+
interface ScalarTypeConstructorOutput {
|
|
1014
|
+
readonly codecId: string;
|
|
1015
|
+
readonly typeParams?: Record<string, unknown>;
|
|
1016
|
+
}
|
|
1017
|
+
/**
|
|
1018
|
+
* Derives the scalar view of an assembled authoring type namespace: every
|
|
1019
|
+
* **top-level** type constructor that is instantiable with an empty argument
|
|
1020
|
+
* list — all declared args optional and no entity-ref argument. A bare type
|
|
1021
|
+
* name `T` in a schema is semantically the zero-arg instantiation `T()`, so
|
|
1022
|
+
* each entry is exactly what that call produces (defaulted template values
|
|
1023
|
+
* applied, absent optional-arg typeParams keys omitted). Constructors
|
|
1024
|
+
* registered under a namespace segment, constructors with required args, and
|
|
1025
|
+
* entity-ref constructors are not scalars and are excluded.
|
|
1026
|
+
*
|
|
1027
|
+
* Eligibility needs no template inspection: templates that cannot resolve
|
|
1028
|
+
* for their legal call shapes are rejected at the composition boundary by
|
|
1029
|
+
* {@link assertResolvableTypeConstructorTemplates}, so the zero-arg
|
|
1030
|
+
* instantiation below cannot fail for an eligible constructor.
|
|
1031
|
+
*/
|
|
1032
|
+
declare function collectScalarTypeConstructors(namespace: AuthoringTypeNamespace): ReadonlyMap<string, ScalarTypeConstructorOutput>;
|
|
1033
|
+
/**
|
|
1034
|
+
* Boundary validation for a contributed authoring type namespace, called
|
|
1035
|
+
* per contributing component at assembly (which supplies `contributedBy`
|
|
1036
|
+
* for attribution). Rejects what the types cannot express — entity-ref
|
|
1037
|
+
* constructors are skipped (their output derives from the referenced
|
|
1038
|
+
* entity): every `typeParams` arg-ref (including refs inside arg-ref
|
|
1039
|
+
* defaults) must point at a declared argument index.
|
|
1040
|
+
*/
|
|
1041
|
+
declare function assertResolvableTypeConstructorTemplates(namespace: AuthoringTypeNamespace, contributedBy: string, path?: readonly string[]): void;
|
|
1042
|
+
declare function assertNoCrossRegistryCollisions(typeNamespace: AuthoringTypeNamespace, fieldNamespace: AuthoringFieldNamespace, entityTypeNamespace?: AuthoringEntityTypeNamespace, pslBlockNamespace?: AuthoringPslBlockDescriptorNamespace, modelAttributeNamespace?: AuthoringModelAttributeDescriptorNamespace): void;
|
|
1043
|
+
declare function resolveAuthoringTemplateValue(template: AuthoringTemplateValue | undefined, args: readonly unknown[]): unknown;
|
|
1044
|
+
declare function validateAuthoringHelperArguments(helperPath: string, descriptors: readonly AuthoringArgumentDescriptor[] | undefined, args: readonly unknown[]): void;
|
|
1045
|
+
/** Why a constructor's or preset's type parameters fail its codec's parameter schema, and the argument the failing parameter came from. */
|
|
1046
|
+
interface AuthoringTypeParamsIssue {
|
|
1047
|
+
readonly message: string;
|
|
1048
|
+
readonly argumentIndex: number | undefined;
|
|
1049
|
+
}
|
|
1050
|
+
/**
|
|
1051
|
+
* Checks the type parameters a constructor or preset produced against its codec's parameter schema, which is where the bounds of a data type's parameters are written. A failure names the argument the failing parameter came from.
|
|
1052
|
+
*/
|
|
1053
|
+
declare function validateAuthoringTypeParams(helperPath: string, template: AuthoringStorageTypeTemplate, typeParams: Record<string, unknown> | undefined, paramsSchema: StandardSchemaV1<unknown> | undefined): void;
|
|
1054
|
+
declare function instantiateAuthoringTypeConstructor(descriptor: AuthoringTypeConstructorDescriptor, args: readonly unknown[]): ScalarTypeConstructorOutput;
|
|
1055
|
+
/** What a field typed by a contributed type alias takes: the type, and the alias's generator calls. */
|
|
1056
|
+
interface AuthoringTypeAliasOutput {
|
|
1057
|
+
readonly type: ScalarTypeConstructorOutput;
|
|
1058
|
+
readonly onCreate?: GeneratorFunctionCall;
|
|
1059
|
+
readonly onUpdate?: GeneratorFunctionCall;
|
|
1060
|
+
}
|
|
1061
|
+
declare function instantiateAuthoringTypeAlias(descriptor: AuthoringTypeAliasDescriptor): AuthoringTypeAliasOutput;
|
|
1062
|
+
/**
|
|
1063
|
+
* The generators the calls of the type alias at `path` resolve to for its column, or `undefined` when it calls none. A call that does not resolve is the pack's mistake, so it throws `CONTRACT.PACK_CONTRIBUTION_INVALID`. `length` is the column's length, in its data type's normal form, when the caller's family knows it.
|
|
1064
|
+
*/
|
|
1065
|
+
declare function resolveTypeAliasGenerators(input: {
|
|
1066
|
+
readonly path: string;
|
|
1067
|
+
readonly descriptor: AuthoringTypeAliasDescriptor;
|
|
1068
|
+
readonly generatorFunctions: GeneratorFunctionRegistry;
|
|
1069
|
+
readonly length: number | undefined;
|
|
1070
|
+
}): ExecutionMutationDefaultPhases | undefined;
|
|
1071
|
+
/** What assembly checks a contributed type alias against: the stack's generator functions, each codec's parameter schema, and the length the family gives a field of a type. */
|
|
1072
|
+
interface TypeAliasAssemblyLookups {
|
|
1073
|
+
readonly generatorFunctions: GeneratorFunctionRegistry;
|
|
1074
|
+
readonly paramsSchemaOf: (codecId: string) => StandardSchemaV1<unknown> | undefined;
|
|
1075
|
+
readonly fieldLength: (field: Omit<GeneratorFunctionField, 'length'>) => number | undefined;
|
|
1076
|
+
}
|
|
1077
|
+
/**
|
|
1078
|
+
* Refuses a type alias of `namespace` whose fixed type params its codec's parameter schema refuses, or whose generator call does not resolve for its codec and length. The control stack and the TypeScript builders call it on their assembled namespace, so PSL and TypeScript refuse the same packs, before any schema is read.
|
|
1079
|
+
*/
|
|
1080
|
+
declare function assertTypeAliasesValid(namespace: AuthoringTypeNamespace, lookups: TypeAliasAssemblyLookups): void;
|
|
1081
|
+
/**
|
|
1082
|
+
* The column a type constructor makes from the stored values of its arguments, as a reader that holds values rather than written arguments has them, or why its codec's parameter schema refuses the parameters they give. The schema check is {@link validateAuthoringTypeParams}'s.
|
|
1083
|
+
*/
|
|
1084
|
+
declare function instantiateAuthoringTypeConstructorFromValues(descriptor: AuthoringTypeConstructorDescriptor, values: readonly unknown[], paramsSchema: StandardSchemaV1<unknown> | undefined): Result<ScalarTypeConstructorOutput, AuthoringTypeParamsIssue>;
|
|
1085
|
+
declare function instantiateAuthoringEntityType<TOutput = unknown>(helperPath: string, descriptor: AuthoringEntityTypeDescriptor, args: readonly unknown[], ctx: AuthoringEntityContext): TOutput;
|
|
1086
|
+
declare function instantiateAuthoringFieldPreset(descriptor: AuthoringFieldPresetDescriptor, args: readonly unknown[]): {
|
|
1087
|
+
readonly descriptor: ScalarTypeConstructorOutput;
|
|
1088
|
+
readonly nullable: boolean;
|
|
1089
|
+
readonly default?: ColumnDefault;
|
|
1090
|
+
readonly executionDefaults?: ExecutionMutationDefaultPhases;
|
|
1091
|
+
readonly id: boolean;
|
|
1092
|
+
readonly unique: boolean;
|
|
1093
|
+
};
|
|
1094
|
+
//#endregion
|
|
1095
|
+
export { GeneratorFunctionContribution as $, isAuthoringEntityTypeDescriptor as $t, AuthoringTypeAliasDescriptor as A, admittedTags as At, CastRefusal as B, describeRefusal as Bt, AuthoringModelAttributeLoweringOutput as C, SourceDiagnostic as Ct, AuthoringSelectRef as D, WrittenScalar as Dt, AuthoringPslBlockDescriptorNamespace as E, WrittenForm as Et, AuthoringTypeParamsIssue as F, castTypedValue as Ft, DataTypeAuthoringEntry as G, flushAuthoringWarnings as Gt, ControlMutationDefaultEntry as H, entryForPlain as Ht, AuthoringValueArgument as I, classifyEnumMemberType as It, DefaultFunctionLoweringContext as J, instantiateAuthoringFieldPreset as Jt, DataTypeSupport as K, getAuthoringTypeConstructor as Kt, AuthoringWarning as L, collectScalarTypeConstructors as Lt, AuthoringTypeConstructorDescriptor as M, assertNoCrossRegistryCollisions as Mt, AuthoringTypeConstructorEntityRef as N, assertResolvableTypeConstructorTemplates as Nt, AuthoringStorageTypeTemplate as O, WrittenValue as Ot, AuthoringTypeNamespace as P, assertTypeAliasesValid as Pt, GeneratorFunctionComponent as Q, isAuthoringArgRef as Qt, AuthoringWarningSink as R, describeAdmittedForms as Rt, AuthoringModelAttributeIndexOutput as S, ScalarTypeConstructorOutput as St, AuthoringPslBlockDescriptor as T, TypedDefaultFunctionCall as Tt, ControlMutationDefaultRegistry as U, entryForTag as Ut, ContributedPslDiagnosticCode as V, describeRefusedValueType as Vt, ControlMutationDefaults as W, exactRewrite as Wt, GeneratorFunctionBinding as X, instantiateAuthoringTypeConstructor as Xt, EMPTY_GENERATOR_FUNCTIONS as Y, instantiateAuthoringTypeAlias as Yt, GeneratorFunctionCall as Z, instantiateAuthoringTypeConstructorFromValues as Zt, AuthoringFieldPresetOutput as _, validateAuthoringHelperArguments as _n, PslPosition as _t, AuthoringAttributeSpecContributions as a, isAuthoringTypeConstructorDescriptor as an, LoweredDefaultResult as at, AuthoringModelAttributeDescriptorNamespace as b, RefusalDescription as bt, AuthoringDescriptorKinds as c, mergeAuthoringNamespaces as cn, ParsedPslExtensionBlock as ct, AuthoringEntityTypeDescriptor as d, readWrittenValueIntoCodec as dn, PslDiagnosticCode as dt, isAuthoringFieldPresetDescriptor as en, GeneratorFunctionField as et, AuthoringEntityTypeFactoryOutput as f, resolveAuthoringTemplateValue as fn, PslExtensionBlock as ft, AuthoringFieldPresetDescriptor as g, tagForm as gn, PslExtensionBlockPrintEntry as gt, AuthoringFieldNamespace as h, singleGeneratorBinding as hn, PslExtensionBlockParsedAttribute as ht, AuthoringArgumentDescriptor as i, isAuthoringTypeAliasDescriptor as in, GeneratorPhase as it, AuthoringTypeAliasOutput as j, assembleGeneratorFunctions as jt, AuthoringTemplateValue as k, admittedForms as kt, AuthoringDiagnosticSink as l, readWrittenValue as ln, PrintedArguments as lt, AuthoringEntityTypeTemplateOutput as m, resolveTypeAliasGenerators as mn, PslExtensionBlockAttributeArg as mt, AssembledControlMutationDefaults as n, isAuthoringPslBlockDescriptor as nn, GeneratorFunctionResolution as nt, AuthoringColumnDefaultTemplate as o, isAuthoringTypeDescriptor as on, LoweredDefaultValue as ot, AuthoringEntityTypeNamespace as p, resolveEnumCodecId as pn, PslExtensionBlockAttribute as pt, DataTypeWrittenForm as q, instantiateAuthoringEntityType as qt, AuthoringArgRef as r, isAuthoringSelectRef as rn, GeneratorFunctionSummary as rt, AuthoringContributions as s, knownTags as sn, MutationDefaultGeneratorDescriptor as st, AUTHORING_TYPE_DESCRIPTOR_KINDS as t, isAuthoringModelAttributeDescriptor as tn, GeneratorFunctionRegistry as tt, AuthoringEntityContext as u, readWrittenValueAs as un, PrintedGeneratorCall as ut, AuthoringModelAttributeContext as v, validateAuthoringTypeParams as vn, PslSpan as vt, AuthoringOption as w, SourceSpan as wt, AuthoringModelAttributeEntityOutput as x, RefusalGuidance as xt, AuthoringModelAttributeDescriptor as y, ReadRefusal as yt, BindingResolution as z, describeExpected as zt };
|
|
1096
|
+
//# sourceMappingURL=framework-authoring-DDxddXZm-uZYdhoE0.d.mts.map
|