primitive-admin 1.2.0-alpha.8 → 1.3.0-alpha.0
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 +258 -186
- package/assets/skill/skills/primitive-platform/SKILL.md +103 -29
- package/dist/bin/primitive.js +15 -89
- package/dist/bin/primitive.js.map +1 -1
- package/dist/src/commands/admins.js +80 -17
- package/dist/src/commands/admins.js.map +1 -1
- package/dist/src/commands/agent-sessions.d.ts +129 -0
- package/dist/src/commands/agent-sessions.js +532 -20
- package/dist/src/commands/agent-sessions.js.map +1 -1
- package/dist/src/commands/analytics.js +207 -155
- package/dist/src/commands/analytics.js.map +1 -1
- package/dist/src/commands/apps-children.d.ts +1 -1
- package/dist/src/commands/apps-children.js +56 -145
- package/dist/src/commands/apps-children.js.map +1 -1
- package/dist/src/commands/apps-transitions.d.ts +39 -0
- package/dist/src/commands/apps-transitions.js +198 -0
- package/dist/src/commands/apps-transitions.js.map +1 -0
- package/dist/src/commands/apps.d.ts +17 -0
- package/dist/src/commands/apps.js +108 -3
- package/dist/src/commands/apps.js.map +1 -1
- package/dist/src/commands/auth-sessions.js +2 -0
- package/dist/src/commands/auth-sessions.js.map +1 -1
- package/dist/src/commands/auth.js +138 -44
- package/dist/src/commands/auth.js.map +1 -1
- package/dist/src/commands/blob-buckets.js +2 -0
- package/dist/src/commands/blob-buckets.js.map +1 -1
- package/dist/src/commands/collections.js +318 -256
- package/dist/src/commands/collections.js.map +1 -1
- package/dist/src/commands/comparisons.js +2 -0
- package/dist/src/commands/comparisons.js.map +1 -1
- package/dist/src/commands/config.d.ts +2 -2
- package/dist/src/commands/config.js +59 -33
- package/dist/src/commands/config.js.map +1 -1
- package/dist/src/commands/connections.js +2 -0
- package/dist/src/commands/connections.js.map +1 -1
- package/dist/src/commands/database-type-configs.js +5 -3
- package/dist/src/commands/database-type-configs.js.map +1 -1
- package/dist/src/commands/database-types.js +13 -313
- package/dist/src/commands/database-types.js.map +1 -1
- package/dist/src/commands/databases.js +6 -4
- package/dist/src/commands/databases.js.map +1 -1
- package/dist/src/commands/db3-types.d.ts +15 -0
- package/dist/src/commands/db3-types.js +159 -0
- package/dist/src/commands/db3-types.js.map +1 -0
- package/dist/src/commands/db3.d.ts +24 -0
- package/dist/src/commands/db3.js +1444 -0
- package/dist/src/commands/db3.js.map +1 -0
- package/dist/src/commands/documents.d.ts +110 -10
- package/dist/src/commands/documents.js +1012 -748
- package/dist/src/commands/documents.js.map +1 -1
- package/dist/src/commands/email-templates.js +74 -0
- package/dist/src/commands/email-templates.js.map +1 -1
- package/dist/src/commands/env.js +8 -4
- package/dist/src/commands/env.js.map +1 -1
- package/dist/src/commands/function-trigger-commands.d.ts +28 -0
- package/dist/src/commands/function-trigger-commands.js +341 -0
- package/dist/src/commands/function-trigger-commands.js.map +1 -0
- package/dist/src/commands/functions.js +376 -30
- package/dist/src/commands/functions.js.map +1 -1
- package/dist/src/commands/groups.js +168 -50
- package/dist/src/commands/groups.js.map +1 -1
- package/dist/src/commands/guides.js +7 -5
- package/dist/src/commands/guides.js.map +1 -1
- package/dist/src/commands/hosting.d.ts +8 -0
- package/dist/src/commands/hosting.js +346 -0
- package/dist/src/commands/hosting.js.map +1 -0
- package/dist/src/commands/init.js +129 -38
- package/dist/src/commands/init.js.map +1 -1
- package/dist/src/commands/integrations.js +82 -53
- package/dist/src/commands/integrations.js.map +1 -1
- package/dist/src/commands/llm.js +9 -6
- package/dist/src/commands/llm.js.map +1 -1
- package/dist/src/commands/locks.d.ts +5 -3
- package/dist/src/commands/locks.js +19 -61
- package/dist/src/commands/locks.js.map +1 -1
- package/dist/src/commands/metadata-category-configs.d.ts +2 -2
- package/dist/src/commands/metadata-category-configs.js +4 -2
- package/dist/src/commands/metadata-category-configs.js.map +1 -1
- package/dist/src/commands/metadata.js +41 -0
- package/dist/src/commands/metadata.js.map +1 -1
- package/dist/src/commands/prompts.js +75 -52
- package/dist/src/commands/prompts.js.map +1 -1
- package/dist/src/commands/rate-counters.d.ts +19 -0
- package/dist/src/commands/rate-counters.js +104 -0
- package/dist/src/commands/rate-counters.js.map +1 -0
- package/dist/src/commands/rule-sets.d.ts +1 -1
- package/dist/src/commands/rule-sets.js +2 -1
- package/dist/src/commands/rule-sets.js.map +1 -1
- package/dist/src/commands/schemas.d.ts +15 -0
- package/dist/src/commands/schemas.js +122 -0
- package/dist/src/commands/schemas.js.map +1 -0
- package/dist/src/commands/scripts.d.ts +9 -17
- package/dist/src/commands/scripts.js +24 -479
- package/dist/src/commands/scripts.js.map +1 -1
- package/dist/src/commands/secrets.js +47 -3
- package/dist/src/commands/secrets.js.map +1 -1
- package/dist/src/commands/sessions.js +2 -0
- package/dist/src/commands/sessions.js.map +1 -1
- package/dist/src/commands/settings.d.ts +12 -9
- package/dist/src/commands/settings.js +31 -79
- package/dist/src/commands/settings.js.map +1 -1
- package/dist/src/commands/skill.js +2 -0
- package/dist/src/commands/skill.js.map +1 -1
- package/dist/src/commands/sync-schemas.d.ts +202 -0
- package/dist/src/commands/sync-schemas.js +629 -0
- package/dist/src/commands/sync-schemas.js.map +1 -0
- package/dist/src/commands/sync-user-properties.d.ts +118 -0
- package/dist/src/commands/sync-user-properties.js +276 -0
- package/dist/src/commands/sync-user-properties.js.map +1 -0
- package/dist/src/commands/sync.d.ts +519 -554
- package/dist/src/commands/sync.js +3010 -4909
- package/dist/src/commands/sync.js.map +1 -1
- package/dist/src/commands/tokens.js +5 -3
- package/dist/src/commands/tokens.js.map +1 -1
- package/dist/src/commands/transitions.d.ts +54 -0
- package/dist/src/commands/transitions.js +418 -0
- package/dist/src/commands/transitions.js.map +1 -0
- package/dist/src/commands/usage.d.ts +18 -0
- package/dist/src/commands/usage.js +343 -0
- package/dist/src/commands/usage.js.map +1 -0
- package/dist/src/commands/user-properties.d.ts +14 -0
- package/dist/src/commands/user-properties.js +79 -0
- package/dist/src/commands/user-properties.js.map +1 -0
- package/dist/src/commands/users.js +911 -18
- package/dist/src/commands/users.js.map +1 -1
- package/dist/src/commands/vars.js +2 -0
- package/dist/src/commands/vars.js.map +1 -1
- package/dist/src/commands/waitlist.js +39 -4
- package/dist/src/commands/waitlist.js.map +1 -1
- package/dist/src/commands/workflows.d.ts +5 -83
- package/dist/src/commands/workflows.js +57 -2282
- package/dist/src/commands/workflows.js.map +1 -1
- package/dist/src/lib/analytics-query.d.ts +58 -0
- package/dist/src/lib/analytics-query.js +134 -0
- package/dist/src/lib/analytics-query.js.map +1 -0
- package/dist/src/lib/api-client.d.ts +1830 -429
- package/dist/src/lib/api-client.js +1025 -546
- package/dist/src/lib/api-client.js.map +1 -1
- package/dist/src/lib/app-settings-descriptor.d.ts +1 -1
- package/dist/src/lib/app-settings-descriptor.js +6 -0
- package/dist/src/lib/app-settings-descriptor.js.map +1 -1
- package/dist/src/lib/auth-fixtures.d.ts +44 -0
- package/dist/src/lib/auth-fixtures.js +61 -0
- package/dist/src/lib/auth-fixtures.js.map +1 -0
- package/dist/src/lib/auth-flow.d.ts +34 -1
- package/dist/src/lib/auth-flow.js +429 -13
- package/dist/src/lib/auth-flow.js.map +1 -1
- package/dist/src/lib/block-layout.d.ts +12 -23
- package/dist/src/lib/block-layout.js +26 -92
- package/dist/src/lib/block-layout.js.map +1 -1
- package/dist/src/lib/block-selector.d.ts +8 -14
- package/dist/src/lib/block-selector.js +8 -19
- package/dist/src/lib/block-selector.js.map +1 -1
- package/dist/src/lib/child-apps-local.d.ts +3 -47
- package/dist/src/lib/child-apps-local.js +11 -73
- package/dist/src/lib/child-apps-local.js.map +1 -1
- package/dist/src/lib/cli-manifest.d.ts +9 -0
- package/dist/src/lib/cli-manifest.js +10 -1
- package/dist/src/lib/cli-manifest.js.map +1 -1
- package/dist/src/lib/cli-version.d.ts +14 -0
- package/dist/src/lib/cli-version.js +38 -0
- package/dist/src/lib/cli-version.js.map +1 -0
- package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
- package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
- package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
- package/dist/src/lib/collection-export.d.ts +76 -15
- package/dist/src/lib/collection-export.js +116 -23
- package/dist/src/lib/collection-export.js.map +1 -1
- package/dist/src/lib/collection-principal.d.ts +22 -0
- package/dist/src/lib/collection-principal.js +35 -0
- package/dist/src/lib/collection-principal.js.map +1 -0
- package/dist/src/lib/command-groups.d.ts +30 -0
- package/dist/src/lib/command-groups.js +109 -0
- package/dist/src/lib/command-groups.js.map +1 -0
- package/dist/src/lib/command-status.d.ts +147 -0
- package/dist/src/lib/command-status.js +266 -0
- package/dist/src/lib/command-status.js.map +1 -0
- package/dist/src/lib/config-object-descriptor.d.ts +9 -22
- package/dist/src/lib/config-object-descriptor.js +107 -276
- package/dist/src/lib/config-object-descriptor.js.map +1 -1
- package/dist/src/lib/config-surface.d.ts +3 -7
- package/dist/src/lib/config-surface.js +9 -13
- package/dist/src/lib/config-surface.js.map +1 -1
- package/dist/src/lib/config-toml.d.ts +11 -2
- package/dist/src/lib/config-toml.js +25 -2
- package/dist/src/lib/config-toml.js.map +1 -1
- package/dist/src/lib/credentials-home.d.ts +7 -0
- package/dist/src/lib/credentials-home.js +45 -10
- package/dist/src/lib/credentials-home.js.map +1 -1
- package/dist/src/lib/credentials-lock.d.ts +14 -6
- package/dist/src/lib/credentials-lock.js +90 -10
- package/dist/src/lib/credentials-lock.js.map +1 -1
- package/dist/src/lib/credentials-store.d.ts +123 -70
- package/dist/src/lib/credentials-store.js +358 -113
- package/dist/src/lib/credentials-store.js.map +1 -1
- package/dist/src/lib/custodian.d.ts +8 -0
- package/dist/src/lib/custodian.js +18 -0
- package/dist/src/lib/custodian.js.map +1 -0
- package/dist/src/lib/data-input.d.ts +1 -1
- package/dist/src/lib/data-input.js +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
- package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
- package/dist/src/lib/db-codegen/dbTypeIR.d.ts +38 -1
- package/dist/src/lib/db-codegen/dbTypeIR.js +29 -7
- package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
- package/dist/src/lib/db-type-records.d.ts +106 -0
- package/dist/src/lib/db-type-records.js +224 -0
- package/dist/src/lib/db-type-records.js.map +1 -0
- package/dist/src/lib/db3-export.d.ts +287 -0
- package/dist/src/lib/db3-export.js +647 -0
- package/dist/src/lib/db3-export.js.map +1 -0
- package/dist/src/lib/db3-index-output.d.ts +116 -0
- package/dist/src/lib/db3-index-output.js +223 -0
- package/dist/src/lib/db3-index-output.js.map +1 -0
- package/dist/src/lib/db3-type-models.d.ts +134 -0
- package/dist/src/lib/db3-type-models.js +452 -0
- package/dist/src/lib/db3-type-models.js.map +1 -0
- package/dist/src/lib/deprecation.d.ts +2 -2
- package/dist/src/lib/deprecation.js +2 -2
- package/dist/src/lib/document-ingest-artifact.d.ts +13 -0
- package/dist/src/lib/document-ingest-artifact.js +36 -6
- package/dist/src/lib/document-ingest-artifact.js.map +1 -1
- package/dist/src/lib/document-ingest-format2.d.ts +36 -0
- package/dist/src/lib/document-ingest-format2.js +78 -0
- package/dist/src/lib/document-ingest-format2.js.map +1 -0
- package/dist/src/lib/document-ingest-input.d.ts +9 -0
- package/dist/src/lib/document-ingest-input.js +28 -1
- package/dist/src/lib/document-ingest-input.js.map +1 -1
- package/dist/src/lib/document-ingest.d.ts +11 -1
- package/dist/src/lib/document-ingest.js +16 -0
- package/dist/src/lib/document-ingest.js.map +1 -1
- package/dist/src/lib/document-schema-rows.d.ts +42 -0
- package/dist/src/lib/document-schema-rows.js +53 -0
- package/dist/src/lib/document-schema-rows.js.map +1 -0
- package/dist/src/lib/experimental-apis.d.ts +36 -0
- package/dist/src/lib/experimental-apis.js +46 -0
- package/dist/src/lib/experimental-apis.js.map +1 -0
- package/dist/src/lib/file-attachment.d.ts +24 -0
- package/dist/src/lib/file-attachment.js +31 -0
- package/dist/src/lib/file-attachment.js.map +1 -0
- package/dist/src/lib/function-authorize-check.d.ts +142 -0
- package/dist/src/lib/function-authorize-check.js +311 -0
- package/dist/src/lib/function-authorize-check.js.map +1 -0
- package/dist/src/lib/function-authorize-view.d.ts +27 -0
- package/dist/src/lib/function-authorize-view.js +88 -0
- package/dist/src/lib/function-authorize-view.js.map +1 -0
- package/dist/src/lib/function-bundle.d.ts +27 -5
- package/dist/src/lib/function-bundle.js +142 -7
- package/dist/src/lib/function-bundle.js.map +1 -1
- package/dist/src/lib/function-collect.d.ts +90 -12
- package/dist/src/lib/function-collect.js +482 -12
- package/dist/src/lib/function-collect.js.map +1 -1
- package/dist/src/lib/function-db-types.d.ts +65 -11
- package/dist/src/lib/function-db-types.js +297 -157
- package/dist/src/lib/function-db-types.js.map +1 -1
- package/dist/src/lib/function-document-types.d.ts +19 -7
- package/dist/src/lib/function-document-types.js +24 -12
- package/dist/src/lib/function-document-types.js.map +1 -1
- package/dist/src/lib/function-lint.d.ts +57 -0
- package/dist/src/lib/function-lint.js +234 -0
- package/dist/src/lib/function-lint.js.map +1 -0
- package/dist/src/lib/function-log-row.js +21 -2
- package/dist/src/lib/function-log-row.js.map +1 -1
- package/dist/src/lib/function-run.d.ts +13 -21
- package/dist/src/lib/function-run.js +14 -27
- package/dist/src/lib/function-run.js.map +1 -1
- package/dist/src/lib/function-schema-codegen.d.ts +86 -22
- package/dist/src/lib/function-schema-codegen.js +194 -88
- package/dist/src/lib/function-schema-codegen.js.map +1 -1
- package/dist/src/lib/function-schema-refs.d.ts +98 -0
- package/dist/src/lib/function-schema-refs.js +177 -0
- package/dist/src/lib/function-schema-refs.js.map +1 -0
- package/dist/src/lib/function-sync.d.ts +109 -6
- package/dist/src/lib/function-sync.js +179 -26
- package/dist/src/lib/function-sync.js.map +1 -1
- package/dist/src/lib/function-trigger-listing.d.ts +11 -6
- package/dist/src/lib/function-trigger-listing.js +32 -11
- package/dist/src/lib/function-trigger-listing.js.map +1 -1
- package/dist/src/lib/function-triggers.d.ts +15 -3
- package/dist/src/lib/function-triggers.js +72 -10
- package/dist/src/lib/function-triggers.js.map +1 -1
- package/dist/src/lib/function-typecheck.d.ts +52 -0
- package/dist/src/lib/function-typecheck.js +174 -54
- package/dist/src/lib/function-typecheck.js.map +1 -1
- package/dist/src/lib/function-versions.d.ts +2 -0
- package/dist/src/lib/function-versions.js +1 -0
- package/dist/src/lib/function-versions.js.map +1 -1
- package/dist/src/lib/generated-build-flags.d.ts +13 -0
- package/dist/src/lib/generated-build-flags.js +14 -0
- package/dist/src/lib/generated-build-flags.js.map +1 -0
- package/dist/src/lib/generated-command-status.d.ts +6 -0
- package/dist/src/lib/generated-command-status.js +469 -0
- package/dist/src/lib/generated-command-status.js.map +1 -0
- package/dist/src/lib/generated-config-surfaces.d.ts +586 -152
- package/dist/src/lib/generated-config-surfaces.js +1919 -1883
- package/dist/src/lib/generated-config-surfaces.js.map +1 -1
- package/dist/src/lib/generated-sdk-types.d.ts +1 -1
- package/dist/src/lib/generated-sdk-types.js +1 -1
- package/dist/src/lib/generated-sdk-types.js.map +1 -1
- package/dist/src/lib/generated-workflow-model-fields.d.ts +20 -0
- package/dist/src/lib/generated-workflow-model-fields.js +53 -0
- package/dist/src/lib/generated-workflow-model-fields.js.map +1 -0
- package/dist/src/lib/hosting-build.d.ts +97 -0
- package/dist/src/lib/hosting-build.js +204 -0
- package/dist/src/lib/hosting-build.js.map +1 -0
- package/dist/src/lib/hosting-client.d.ts +167 -0
- package/dist/src/lib/hosting-client.js +340 -0
- package/dist/src/lib/hosting-client.js.map +1 -0
- package/dist/src/lib/hosting-environments.d.ts +32 -0
- package/dist/src/lib/hosting-environments.js +74 -0
- package/dist/src/lib/hosting-environments.js.map +1 -0
- package/dist/src/lib/hosting-errors.d.ts +30 -0
- package/dist/src/lib/hosting-errors.js +43 -0
- package/dist/src/lib/hosting-errors.js.map +1 -0
- package/dist/src/lib/hosting-token.d.ts +46 -0
- package/dist/src/lib/hosting-token.js +60 -0
- package/dist/src/lib/hosting-token.js.map +1 -0
- package/dist/src/lib/hosting-wait.d.ts +42 -0
- package/dist/src/lib/hosting-wait.js +84 -0
- package/dist/src/lib/hosting-wait.js.map +1 -0
- package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
- package/dist/src/lib/hosting-wfp-upload.js +149 -0
- package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
- package/dist/src/lib/init-assets.d.ts +2 -6
- package/dist/src/lib/init-assets.js +11 -27
- package/dist/src/lib/init-assets.js.map +1 -1
- package/dist/src/lib/init-ios-links.d.ts +11 -7
- package/dist/src/lib/init-ios-links.js +28 -22
- package/dist/src/lib/init-ios-links.js.map +1 -1
- package/dist/src/lib/init-login-note.d.ts +13 -0
- package/dist/src/lib/init-login-note.js +22 -0
- package/dist/src/lib/init-login-note.js.map +1 -0
- package/dist/src/lib/init-schema.d.ts +15 -0
- package/dist/src/lib/init-schema.js +54 -0
- package/dist/src/lib/init-schema.js.map +1 -1
- package/dist/src/lib/integration-test-request.d.ts +54 -0
- package/dist/src/lib/integration-test-request.js +207 -0
- package/dist/src/lib/integration-test-request.js.map +1 -0
- package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
- package/dist/src/lib/invoker-shared-enums.js +98 -0
- package/dist/src/lib/invoker-shared-enums.js.map +1 -0
- package/dist/src/lib/json-value.d.ts +6 -0
- package/dist/src/lib/json-value.js +13 -0
- package/dist/src/lib/json-value.js.map +1 -0
- package/dist/src/lib/load-routes.d.ts +33 -0
- package/dist/src/lib/load-routes.js +35 -0
- package/dist/src/lib/load-routes.js.map +1 -0
- package/dist/src/lib/log-inspection.d.ts +23 -4
- package/dist/src/lib/log-inspection.js +14 -5
- package/dist/src/lib/log-inspection.js.map +1 -1
- package/dist/src/lib/login-exchange-check.d.ts +18 -0
- package/dist/src/lib/login-exchange-check.js +27 -0
- package/dist/src/lib/login-exchange-check.js.map +1 -0
- package/dist/src/lib/login-scope-lines.d.ts +17 -7
- package/dist/src/lib/login-scope-lines.js +33 -10
- package/dist/src/lib/login-scope-lines.js.map +1 -1
- package/dist/src/lib/metadata-report.d.ts +85 -0
- package/dist/src/lib/metadata-report.js +81 -0
- package/dist/src/lib/metadata-report.js.map +1 -0
- package/dist/src/lib/object-status-filter.d.ts +9 -1
- package/dist/src/lib/object-status-filter.js +9 -1
- package/dist/src/lib/object-status-filter.js.map +1 -1
- package/dist/src/lib/output.d.ts +1 -1
- package/dist/src/lib/output.js +3 -1
- package/dist/src/lib/output.js.map +1 -1
- package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
- package/dist/src/lib/pin-refusal-hint.js +35 -0
- package/dist/src/lib/pin-refusal-hint.js.map +1 -0
- package/dist/src/lib/platform-owned.js +5 -0
- package/dist/src/lib/platform-owned.js.map +1 -1
- package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
- package/dist/src/lib/primitive-declaration-names.js +22 -0
- package/dist/src/lib/primitive-declaration-names.js.map +1 -0
- package/dist/src/lib/primitive-declaration.d.ts +174 -0
- package/dist/src/lib/primitive-declaration.js +792 -0
- package/dist/src/lib/primitive-declaration.js.map +1 -0
- package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
- package/dist/src/lib/primitive-env-plugin.js +408 -0
- package/dist/src/lib/primitive-env-plugin.js.map +1 -0
- package/dist/src/lib/project-login-apps.d.ts +8 -0
- package/dist/src/lib/project-login-apps.js +27 -0
- package/dist/src/lib/project-login-apps.js.map +1 -0
- package/dist/src/lib/prompt-schema-codegen.d.ts +46 -15
- package/dist/src/lib/prompt-schema-codegen.js +142 -108
- package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
- package/dist/src/lib/prompt-schema-document.d.ts +35 -0
- package/dist/src/lib/prompt-schema-document.js +92 -0
- package/dist/src/lib/prompt-schema-document.js.map +1 -0
- package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
- package/dist/src/lib/prompt-schema-refs.js +478 -0
- package/dist/src/lib/prompt-schema-refs.js.map +1 -0
- package/dist/src/lib/records-verbs.d.ts +79 -0
- package/dist/src/lib/records-verbs.js +45 -0
- package/dist/src/lib/records-verbs.js.map +1 -0
- package/dist/src/lib/register-commands.d.ts +36 -0
- package/dist/src/lib/register-commands.js +37 -0
- package/dist/src/lib/register-commands.js.map +1 -0
- package/dist/src/lib/retired-imports.d.ts +53 -0
- package/dist/src/lib/retired-imports.js +120 -0
- package/dist/src/lib/retired-imports.js.map +1 -0
- package/dist/src/lib/run-status.d.ts +1 -1
- package/dist/src/lib/run-status.generated.d.ts +2 -2
- package/dist/src/lib/run-status.generated.js +3 -1
- package/dist/src/lib/run-status.generated.js.map +1 -1
- package/dist/src/lib/run-status.js +1 -1
- package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +218 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js +397 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
- package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
- package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
- package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
- package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
- package/dist/src/lib/schema-codegen/naming.js +83 -0
- package/dist/src/lib/schema-codegen/naming.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
- package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
- package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
- package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
- package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
- package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
- package/dist/src/lib/schema-family-index.d.ts +228 -0
- package/dist/src/lib/schema-family-index.js +813 -0
- package/dist/src/lib/schema-family-index.js.map +1 -0
- package/dist/src/lib/schema-pins.d.ts +82 -0
- package/dist/src/lib/schema-pins.js +198 -0
- package/dist/src/lib/schema-pins.js.map +1 -0
- package/dist/src/lib/schema-preview.d.ts +244 -0
- package/dist/src/lib/schema-preview.js +498 -0
- package/dist/src/lib/schema-preview.js.map +1 -0
- package/dist/src/lib/scope-request.d.ts +23 -11
- package/dist/src/lib/scope-request.js +69 -31
- package/dist/src/lib/scope-request.js.map +1 -1
- package/dist/src/lib/session-scope.d.ts +26 -0
- package/dist/src/lib/session-scope.js +58 -0
- package/dist/src/lib/session-scope.js.map +1 -0
- package/dist/src/lib/skill-installer.d.ts +2 -2
- package/dist/src/lib/skill-installer.js +2 -21
- package/dist/src/lib/skill-installer.js.map +1 -1
- package/dist/src/lib/step-run-table.d.ts +1 -2
- package/dist/src/lib/step-run-table.js +1 -2
- package/dist/src/lib/step-run-table.js.map +1 -1
- package/dist/src/lib/swift-codegen/agentGenerator.d.ts +8 -3
- package/dist/src/lib/swift-codegen/agentGenerator.js +76 -22
- package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
- package/dist/src/lib/swift-codegen/banners.js +12 -0
- package/dist/src/lib/swift-codegen/banners.js.map +1 -1
- package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
- package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
- package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
- package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
- package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
- package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js +165 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
- package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
- package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
- package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
- package/dist/src/lib/sync-resource-types.d.ts +117 -31
- package/dist/src/lib/sync-resource-types.js +197 -189
- package/dist/src/lib/sync-resource-types.js.map +1 -1
- package/dist/src/lib/sync-selectors.d.ts +7 -0
- package/dist/src/lib/sync-selectors.js +22 -2
- package/dist/src/lib/sync-selectors.js.map +1 -1
- package/dist/src/lib/template.d.ts +39 -3
- package/dist/src/lib/template.js +103 -14
- package/dist/src/lib/template.js.map +1 -1
- package/dist/src/lib/test-case-file-names.d.ts +3 -5
- package/dist/src/lib/test-case-file-names.js +3 -5
- package/dist/src/lib/test-case-file-names.js.map +1 -1
- package/dist/src/lib/test-runs.d.ts +45 -0
- package/dist/src/lib/test-runs.js +150 -0
- package/dist/src/lib/test-runs.js.map +1 -0
- package/dist/src/lib/test-users.d.ts +25 -0
- package/dist/src/lib/test-users.js +36 -0
- package/dist/src/lib/test-users.js.map +1 -0
- package/dist/src/lib/toml-database-config.d.ts +4 -2
- package/dist/src/lib/toml-database-config.js +11 -6
- package/dist/src/lib/toml-database-config.js.map +1 -1
- package/dist/src/lib/toml-scalar-edit.js +6 -4
- package/dist/src/lib/toml-scalar-edit.js.map +1 -1
- package/dist/src/lib/transition-warnings.d.ts +21 -0
- package/dist/src/lib/transition-warnings.js +49 -0
- package/dist/src/lib/transition-warnings.js.map +1 -0
- package/dist/src/lib/user-index.d.ts +80 -0
- package/dist/src/lib/user-index.js +166 -0
- package/dist/src/lib/user-index.js.map +1 -0
- package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
- package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
- package/dist/src/lib/user-walk.d.ts +31 -0
- package/dist/src/lib/user-walk.js +102 -0
- package/dist/src/lib/user-walk.js.map +1 -0
- package/dist/src/lib/webhook-capture.d.ts +43 -0
- package/dist/src/lib/webhook-capture.js +91 -0
- package/dist/src/lib/webhook-capture.js.map +1 -0
- package/dist/src/lib/webhook-deliver.d.ts +18 -20
- package/dist/src/lib/webhook-deliver.js +34 -89
- package/dist/src/lib/webhook-deliver.js.map +1 -1
- package/dist/src/lib/webhook-test-run.d.ts +32 -0
- package/dist/src/lib/webhook-test-run.js +108 -0
- package/dist/src/lib/webhook-test-run.js.map +1 -0
- package/dist/src/lib/worker-perf-format.d.ts +22 -0
- package/dist/src/lib/worker-perf-format.js +27 -0
- package/dist/src/lib/worker-perf-format.js.map +1 -0
- package/dist/src/lib/workflow-field-descriptor.d.ts +91 -0
- package/dist/src/lib/workflow-field-descriptor.js +153 -0
- package/dist/src/lib/workflow-field-descriptor.js.map +1 -0
- package/dist/src/types/index.d.ts +20 -65
- package/dist/src/validators.d.ts +7 -55
- package/dist/src/validators.js +7 -53
- package/dist/src/validators.js.map +1 -1
- package/dist/src/vite.d.ts +17 -0
- package/dist/src/vite.js +18 -0
- package/dist/src/vite.js.map +1 -0
- package/package.json +20 -9
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Identifier-naming helpers for the schema codegens (issue #1442, written for
|
|
3
|
+
* `workflows codegen`; `functions codegen` and the prompt codegen read them
|
|
4
|
+
* since #3190 retired it).
|
|
5
|
+
*
|
|
6
|
+
* Keys resolve case-insensitively server-side and may contain
|
|
7
|
+
* characters that aren't valid TS identifiers (`.`, `-`). Only the emitted
|
|
8
|
+
* identifiers are sanitized — the runtime call always passes the ORIGINAL key
|
|
9
|
+
* string.
|
|
10
|
+
*
|
|
11
|
+
* Type names: `pascalCase(key) + "Input" | "Output"` (reuses `pascalCase` from
|
|
12
|
+
* the database codegen so the two commands share one PascalCase rule).
|
|
13
|
+
* Factory property: a camelCase form of the key.
|
|
14
|
+
*/
|
|
15
|
+
import { pascalCase } from "../db-codegen/dbNaming.js";
|
|
16
|
+
/**
|
|
17
|
+
* Ensure an identifier is a valid TS identifier start. The server accepts
|
|
18
|
+
* workflow keys matching `^[a-z0-9][a-z0-9-_]{2,}$`, so a digit-leading key
|
|
19
|
+
* like `123-job` PascalCases to `123Job` — not a legal TS type name or
|
|
20
|
+
* unquoted object property, since identifiers can't start with a digit.
|
|
21
|
+
* Prefix an underscore in that case (`123Job` → `_123Job`). Only the emitted
|
|
22
|
+
* identifier changes; the runtime call still passes the ORIGINAL key string.
|
|
23
|
+
*/
|
|
24
|
+
function ensureValidIdentifierStart(name) {
|
|
25
|
+
const first = name.charAt(0);
|
|
26
|
+
if (first >= "0" && first <= "9") {
|
|
27
|
+
return `_${name}`;
|
|
28
|
+
}
|
|
29
|
+
return name;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* `create-checkout-session` / `createCheckoutSession` → `CreateCheckoutSession`.
|
|
33
|
+
* A digit-leading key (`123-job` → `_123Job`) is prefixed with `_` so the
|
|
34
|
+
* emitted type name is a valid TS identifier.
|
|
35
|
+
*/
|
|
36
|
+
export function workflowTypeBaseName(key) {
|
|
37
|
+
return ensureValidIdentifierStart(pascalCase(key));
|
|
38
|
+
}
|
|
39
|
+
/** PascalCase base + `Input` (e.g. `CreateCheckoutSessionInput`). */
|
|
40
|
+
export function workflowInputTypeName(key) {
|
|
41
|
+
return `${workflowTypeBaseName(key)}Input`;
|
|
42
|
+
}
|
|
43
|
+
/** PascalCase base + `Output` (e.g. `CreateCheckoutSessionOutput`). */
|
|
44
|
+
export function workflowOutputTypeName(key) {
|
|
45
|
+
return `${workflowTypeBaseName(key)}Output`;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Reserved words that cannot be used as a bare `function <name>` declaration.
|
|
49
|
+
* The per-workflow factory is now a top-level exported function (not an
|
|
50
|
+
* object-literal property), so a key that camelCases to one of these must be
|
|
51
|
+
* escaped or `export function delete(client) {}` is a syntax error. Covers ES
|
|
52
|
+
* reserved words plus the strict-mode/future set — a workflow key resolves case
|
|
53
|
+
* -insensitively and matches `^[a-z0-9][a-z0-9-_]{2,}$`, so only the lowercase
|
|
54
|
+
* single-word forms can actually collide.
|
|
55
|
+
*/
|
|
56
|
+
const RESERVED_WORDS = new Set([
|
|
57
|
+
"break", "case", "catch", "class", "const", "continue", "debugger",
|
|
58
|
+
"default", "delete", "do", "else", "enum", "export", "extends", "false",
|
|
59
|
+
"finally", "for", "function", "if", "import", "in", "instanceof", "new",
|
|
60
|
+
"null", "return", "super", "switch", "this", "throw", "true", "try",
|
|
61
|
+
"typeof", "var", "void", "while", "with", "yield", "let", "static",
|
|
62
|
+
"implements", "interface", "package", "private", "protected", "public",
|
|
63
|
+
"await",
|
|
64
|
+
]);
|
|
65
|
+
/**
|
|
66
|
+
* camelCase factory function name for a workflow key: PascalCase, then lowercase
|
|
67
|
+
* the first character (`create-checkout-session` → `createCheckoutSession`,
|
|
68
|
+
* `refresh-sheet` → `refreshSheet`). Used as the top-level exported factory
|
|
69
|
+
* function name in the per-workflow generated file, so it must be a legal
|
|
70
|
+
* function identifier: a digit-leading key (`123-job` → `_123Job`) is
|
|
71
|
+
* underscore-prefixed, and a key that lands on a JS reserved word (`delete`,
|
|
72
|
+
* `new`, `import`) is underscore-suffixed (`delete_`). Only the emitted
|
|
73
|
+
* identifier changes; the runtime call still passes the ORIGINAL key string.
|
|
74
|
+
*/
|
|
75
|
+
export function workflowFactoryName(key) {
|
|
76
|
+
const pascal = pascalCase(key);
|
|
77
|
+
if (pascal.length === 0)
|
|
78
|
+
return pascal;
|
|
79
|
+
const camel = pascal.charAt(0).toLowerCase() + pascal.slice(1);
|
|
80
|
+
const safeStart = ensureValidIdentifierStart(camel);
|
|
81
|
+
return RESERVED_WORDS.has(safeStart) ? `${safeStart}_` : safeStart;
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=naming.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../../src/lib/schema-codegen/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;GAOG;AACH,SAAS,0BAA0B,CAAC,IAAY;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjC,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO,0BAA0B,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU;IAClE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;IACvE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK;IACvE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;IACnE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ;IAClE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ;IACtE,OAAO;CACR,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The schema change classifier `config diff` reads (#5543, project
|
|
3
|
+
* `unified-schemas` phase 9, criterion 11).
|
|
4
|
+
*
|
|
5
|
+
* `classifySchemaChange(stored, local)` compares a stored compiled schema with
|
|
6
|
+
* the local one a push would send, keyword by keyword, and classifies each
|
|
7
|
+
* change from the keyword table's `tightens` and `extractor` columns:
|
|
8
|
+
*
|
|
9
|
+
* - `breaking`: the change narrows what the schema accepts on a row the
|
|
10
|
+
* merge gate's breaking-change extractor compares (`type`, `enum`,
|
|
11
|
+
* `required`, `properties`, `items`, `format`, `$ref`, the applicators);
|
|
12
|
+
* - `tightening`: it narrows what the schema accepts on any other row
|
|
13
|
+
* (`minimum`, `pattern`, `nullable`, `additionalProperties`, …);
|
|
14
|
+
* - `additive`: anything else (a loosening, an annotation, a key that is not
|
|
15
|
+
* a row).
|
|
16
|
+
*
|
|
17
|
+
* The extractor's own structural rules are applied as it applies them, so the
|
|
18
|
+
* classifier never answers `additive` where the gate answers breaking: `type`
|
|
19
|
+
* compares exactly (a union reorder is a change), `oneOf`, `anyOf` and
|
|
20
|
+
* `allOf` compare as whole subtrees, any difference at a node that carries
|
|
21
|
+
* `$ref` beside another key is breaking, and every change in a schema whose
|
|
22
|
+
* stored side holds an object or array `enum` member is breaking (the gate's
|
|
23
|
+
* membership test cannot find such a member). Direction is not distinguished:
|
|
24
|
+
* a newly required output property is breaking too.
|
|
25
|
+
*/
|
|
26
|
+
/** The classes a change is given, weakest first. */
|
|
27
|
+
export declare const SCHEMA_CHANGE_CLASSES: readonly ["additive", "tightening", "breaking"];
|
|
28
|
+
/** One of `SCHEMA_CHANGE_CLASSES`. */
|
|
29
|
+
export type SchemaChangeClass = (typeof SCHEMA_CHANGE_CLASSES)[number];
|
|
30
|
+
/** One change between the stored and the local schema. */
|
|
31
|
+
export interface SchemaChange {
|
|
32
|
+
/** JSON pointer of the node the change is at (`""` for the root). */
|
|
33
|
+
pointer: string;
|
|
34
|
+
/** The keyword that changed; `(slot)` for the whole schema, `(schema)` for a node replaced by a non-object. */
|
|
35
|
+
keyword: string;
|
|
36
|
+
class: SchemaChangeClass;
|
|
37
|
+
/** What changed, in words (`minimum 1 → 5`, `property "note" added`). */
|
|
38
|
+
detail: string;
|
|
39
|
+
}
|
|
40
|
+
/** What `classifySchemaChange` answers. */
|
|
41
|
+
export interface SchemaChangeResult {
|
|
42
|
+
/** The strongest class among the changes; null when nothing changed. */
|
|
43
|
+
class: SchemaChangeClass | null;
|
|
44
|
+
changes: SchemaChange[];
|
|
45
|
+
}
|
|
46
|
+
/** How a slot the stored side lacks is read. */
|
|
47
|
+
export interface SchemaChangeOptions {
|
|
48
|
+
/**
|
|
49
|
+
* The slot belongs to a tool, event, config or def the stored side does not
|
|
50
|
+
* declare at all: nothing depended on it, so it is additive whatever it says.
|
|
51
|
+
*/
|
|
52
|
+
newOwner?: boolean;
|
|
53
|
+
}
|
|
54
|
+
/** Whether one keyword's change narrows what the schema accepts. */
|
|
55
|
+
export type KeywordChange = "none" | "tightens" | "loosens";
|
|
56
|
+
/** The reason a change under a non-scalar stored `enum` is breaking. */
|
|
57
|
+
export declare const NON_SCALAR_ENUM_REASON = "non-scalar enum members cannot be compared by the gate";
|
|
58
|
+
/**
|
|
59
|
+
* How one keyword changed between the stored and the local value (either may
|
|
60
|
+
* be `undefined`, for absent): `none` when equal, `tightens` when the change
|
|
61
|
+
* narrows what the schema accepts in the row's `tightens` direction, and
|
|
62
|
+
* `loosens` otherwise. A key that is not a row never tightens.
|
|
63
|
+
*/
|
|
64
|
+
export declare function keywordChange(keyword: string, stored: unknown, local: unknown): KeywordChange;
|
|
65
|
+
/** The strongest of `classes` (`breaking > tightening > additive`); null when none is given. */
|
|
66
|
+
export declare function maxChangeClass(...classes: Array<SchemaChangeClass | null | undefined>): SchemaChangeClass | null;
|
|
67
|
+
/**
|
|
68
|
+
* Classify the changes from the `stored` compiled schema to the `local` one
|
|
69
|
+
* (`undefined` for a side that declares none). A slot the local side no
|
|
70
|
+
* longer declares is cleared by push and is breaking; a slot the stored side
|
|
71
|
+
* lacks is compared against the empty schema, unless its owner is new
|
|
72
|
+
* (`options.newOwner`), when it is additive.
|
|
73
|
+
*/
|
|
74
|
+
export declare function classifySchemaChange(stored: unknown, local: unknown, options?: SchemaChangeOptions): SchemaChangeResult;
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The schema change classifier `config diff` reads (#5543, project
|
|
3
|
+
* `unified-schemas` phase 9, criterion 11).
|
|
4
|
+
*
|
|
5
|
+
* `classifySchemaChange(stored, local)` compares a stored compiled schema with
|
|
6
|
+
* the local one a push would send, keyword by keyword, and classifies each
|
|
7
|
+
* change from the keyword table's `tightens` and `extractor` columns:
|
|
8
|
+
*
|
|
9
|
+
* - `breaking`: the change narrows what the schema accepts on a row the
|
|
10
|
+
* merge gate's breaking-change extractor compares (`type`, `enum`,
|
|
11
|
+
* `required`, `properties`, `items`, `format`, `$ref`, the applicators);
|
|
12
|
+
* - `tightening`: it narrows what the schema accepts on any other row
|
|
13
|
+
* (`minimum`, `pattern`, `nullable`, `additionalProperties`, …);
|
|
14
|
+
* - `additive`: anything else (a loosening, an annotation, a key that is not
|
|
15
|
+
* a row).
|
|
16
|
+
*
|
|
17
|
+
* The extractor's own structural rules are applied as it applies them, so the
|
|
18
|
+
* classifier never answers `additive` where the gate answers breaking: `type`
|
|
19
|
+
* compares exactly (a union reorder is a change), `oneOf`, `anyOf` and
|
|
20
|
+
* `allOf` compare as whole subtrees, any difference at a node that carries
|
|
21
|
+
* `$ref` beside another key is breaking, and every change in a schema whose
|
|
22
|
+
* stored side holds an object or array `enum` member is breaking (the gate's
|
|
23
|
+
* membership test cannot find such a member). Direction is not distinguished:
|
|
24
|
+
* a newly required output property is breaking too.
|
|
25
|
+
*/
|
|
26
|
+
import { SCHEMA_KEYWORDS } from "./generated-schema-descriptor.js";
|
|
27
|
+
/** The classes a change is given, weakest first. */
|
|
28
|
+
export const SCHEMA_CHANGE_CLASSES = Object.freeze(["additive", "tightening", "breaking"]);
|
|
29
|
+
/** The reason a change under a non-scalar stored `enum` is breaking. */
|
|
30
|
+
export const NON_SCALAR_ENUM_REASON = "non-scalar enum members cannot be compared by the gate";
|
|
31
|
+
function isObject(value) {
|
|
32
|
+
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
33
|
+
}
|
|
34
|
+
function hasOwn(value, key) {
|
|
35
|
+
return Object.prototype.hasOwnProperty.call(value, key);
|
|
36
|
+
}
|
|
37
|
+
function rowOf(keyword) {
|
|
38
|
+
return hasOwn(SCHEMA_KEYWORDS, keyword) ? SCHEMA_KEYWORDS[keyword] : undefined;
|
|
39
|
+
}
|
|
40
|
+
/** JSON with object keys sorted, so a key reorder is no change. */
|
|
41
|
+
function canonical(value) {
|
|
42
|
+
if (Array.isArray(value))
|
|
43
|
+
return `[${value.map(canonical).join(",")}]`;
|
|
44
|
+
if (isObject(value)) {
|
|
45
|
+
return `{${Object.keys(value)
|
|
46
|
+
.sort()
|
|
47
|
+
.map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`)
|
|
48
|
+
.join(",")}}`;
|
|
49
|
+
}
|
|
50
|
+
return JSON.stringify(value) ?? "undefined";
|
|
51
|
+
}
|
|
52
|
+
const exact = (value) => JSON.stringify(value) ?? "undefined";
|
|
53
|
+
function members(list) {
|
|
54
|
+
return new Set(list.map(canonical));
|
|
55
|
+
}
|
|
56
|
+
/** The keywords compared as sets of members: a reorder is no change. */
|
|
57
|
+
const SET_KEYWORDS = new Set(["enum", "required"]);
|
|
58
|
+
function same(keyword, stored, local) {
|
|
59
|
+
if (SET_KEYWORDS.has(keyword) && Array.isArray(stored) && Array.isArray(local)) {
|
|
60
|
+
const a = members(stored);
|
|
61
|
+
const b = members(local);
|
|
62
|
+
return a.size === b.size && [...a].every((member) => b.has(member));
|
|
63
|
+
}
|
|
64
|
+
// The rows the gate compares are compared as it compares them: exactly.
|
|
65
|
+
return rowOf(keyword)?.extractor ? exact(stored) === exact(local) : canonical(stored) === canonical(local);
|
|
66
|
+
}
|
|
67
|
+
/** Whether a difference narrows what the schema accepts, in the row's direction. */
|
|
68
|
+
function tightensIn(direction, keyword, stored, local) {
|
|
69
|
+
switch (direction) {
|
|
70
|
+
case "raise":
|
|
71
|
+
case "lower":
|
|
72
|
+
if (local === undefined)
|
|
73
|
+
return false;
|
|
74
|
+
if (typeof stored !== "number" || typeof local !== "number")
|
|
75
|
+
return true;
|
|
76
|
+
return direction === "raise" ? local > stored : local < stored;
|
|
77
|
+
case "add": {
|
|
78
|
+
if (local === undefined)
|
|
79
|
+
return false;
|
|
80
|
+
if (!Array.isArray(local))
|
|
81
|
+
return true;
|
|
82
|
+
const before = Array.isArray(stored) ? members(stored) : new Set();
|
|
83
|
+
return local.some((member) => !before.has(canonical(member)));
|
|
84
|
+
}
|
|
85
|
+
case "remove": {
|
|
86
|
+
if (keyword === "properties") {
|
|
87
|
+
// A first map declares optional properties: nothing narrows.
|
|
88
|
+
if (stored === undefined)
|
|
89
|
+
return false;
|
|
90
|
+
if (!isObject(stored))
|
|
91
|
+
return true;
|
|
92
|
+
const after = isObject(local) ? local : {};
|
|
93
|
+
return Object.keys(stored).some((name) => !hasOwn(after, name));
|
|
94
|
+
}
|
|
95
|
+
// A list where there was none narrows from any value to the list; a
|
|
96
|
+
// list removed counts every member as gone, as the gate counts them.
|
|
97
|
+
if (stored === undefined || !Array.isArray(stored))
|
|
98
|
+
return true;
|
|
99
|
+
if (local !== undefined && !Array.isArray(local))
|
|
100
|
+
return true;
|
|
101
|
+
const after = members(Array.isArray(local) ? local : []);
|
|
102
|
+
return stored.some((member) => !after.has(canonical(member)));
|
|
103
|
+
}
|
|
104
|
+
case "set":
|
|
105
|
+
return local !== undefined;
|
|
106
|
+
case "on":
|
|
107
|
+
return local === true && stored !== true;
|
|
108
|
+
case "off":
|
|
109
|
+
return stored === true && local !== true;
|
|
110
|
+
case "close":
|
|
111
|
+
return (local === false || isObject(local)) && (stored === undefined || stored === true || isObject(stored));
|
|
112
|
+
case "any":
|
|
113
|
+
return true;
|
|
114
|
+
case "never":
|
|
115
|
+
return false;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* How one keyword changed between the stored and the local value (either may
|
|
120
|
+
* be `undefined`, for absent): `none` when equal, `tightens` when the change
|
|
121
|
+
* narrows what the schema accepts in the row's `tightens` direction, and
|
|
122
|
+
* `loosens` otherwise. A key that is not a row never tightens.
|
|
123
|
+
*/
|
|
124
|
+
export function keywordChange(keyword, stored, local) {
|
|
125
|
+
if (same(keyword, stored, local))
|
|
126
|
+
return "none";
|
|
127
|
+
const direction = rowOf(keyword)?.tightens ?? "never";
|
|
128
|
+
return tightensIn(direction, keyword, stored, local) ? "tightens" : "loosens";
|
|
129
|
+
}
|
|
130
|
+
/** The strongest of `classes` (`breaking > tightening > additive`); null when none is given. */
|
|
131
|
+
export function maxChangeClass(...classes) {
|
|
132
|
+
let strongest = -1;
|
|
133
|
+
for (const cls of classes) {
|
|
134
|
+
if (cls)
|
|
135
|
+
strongest = Math.max(strongest, SCHEMA_CHANGE_CLASSES.indexOf(cls));
|
|
136
|
+
}
|
|
137
|
+
return strongest < 0 ? null : SCHEMA_CHANGE_CLASSES[strongest];
|
|
138
|
+
}
|
|
139
|
+
const escapePointer = (segment) => segment.replace(/~/g, "~0").replace(/\//g, "~1");
|
|
140
|
+
function brief(value) {
|
|
141
|
+
const text = exact(value);
|
|
142
|
+
return text.length > 40 ? `${text.slice(0, 37)}…` : text;
|
|
143
|
+
}
|
|
144
|
+
function describe(keyword, stored, local) {
|
|
145
|
+
if (stored === undefined)
|
|
146
|
+
return `${keyword} set to ${brief(local)}`;
|
|
147
|
+
if (local === undefined)
|
|
148
|
+
return `${keyword} removed`;
|
|
149
|
+
if (SET_KEYWORDS.has(keyword) && Array.isArray(stored) && Array.isArray(local)) {
|
|
150
|
+
const before = members(stored);
|
|
151
|
+
const after = members(local);
|
|
152
|
+
const gone = stored.filter((member) => !after.has(canonical(member)));
|
|
153
|
+
const added = local.filter((member) => !before.has(canonical(member)));
|
|
154
|
+
const parts = keyword === "enum"
|
|
155
|
+
? [...gone.map((member) => `enum value ${brief(member)} removed`), ...added.map((member) => `enum value ${brief(member)} added`)]
|
|
156
|
+
: [...added.map((member) => `${brief(member)} required`), ...gone.map((member) => `${brief(member)} no longer required`)];
|
|
157
|
+
if (parts.length > 0)
|
|
158
|
+
return parts.join(", ");
|
|
159
|
+
}
|
|
160
|
+
return `${keyword} ${brief(stored)} → ${brief(local)}`;
|
|
161
|
+
}
|
|
162
|
+
/** A node the gate reads only as a whole: `$ref` beside another key. */
|
|
163
|
+
function constrainedRef(node) {
|
|
164
|
+
return hasOwn(node, "$ref") && Object.keys(node).length > 1;
|
|
165
|
+
}
|
|
166
|
+
function compareNode(stored, local, pointer, out) {
|
|
167
|
+
if (exact(stored) === exact(local))
|
|
168
|
+
return;
|
|
169
|
+
if (isObject(stored) && !isObject(local)) {
|
|
170
|
+
out.push({ pointer, keyword: "(schema)", class: "breaking", detail: local === undefined ? "removed" : `replaced by ${brief(local)}` });
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
if (!isObject(stored)) {
|
|
174
|
+
// A boolean (or malformed) stored schema: only `true`, or nothing, accepts as much.
|
|
175
|
+
out.push({ pointer, keyword: "(schema)", class: local === true ? "additive" : "tightening", detail: `${brief(stored)} → ${brief(local)}` });
|
|
176
|
+
return;
|
|
177
|
+
}
|
|
178
|
+
const node = local;
|
|
179
|
+
if (constrainedRef(stored) || constrainedRef(node)) {
|
|
180
|
+
out.push({ pointer, keyword: "$ref", class: "breaking", detail: "changed beside a $ref (compared as a whole)" });
|
|
181
|
+
return;
|
|
182
|
+
}
|
|
183
|
+
const keys = [...Object.keys(stored), ...Object.keys(node).filter((key) => !hasOwn(stored, key))];
|
|
184
|
+
for (const key of keys) {
|
|
185
|
+
const before = hasOwn(stored, key) ? stored[key] : undefined;
|
|
186
|
+
const after = hasOwn(node, key) ? node[key] : undefined;
|
|
187
|
+
if (key === "properties" && (before === undefined || isObject(before)) && (after === undefined || isObject(after))) {
|
|
188
|
+
const was = (before ?? {});
|
|
189
|
+
const now = (after ?? {});
|
|
190
|
+
for (const name of Object.keys(was)) {
|
|
191
|
+
const at = `${pointer}/properties/${escapePointer(name)}`;
|
|
192
|
+
if (!hasOwn(now, name))
|
|
193
|
+
out.push({ pointer: at, keyword: "properties", class: "breaking", detail: `property ${JSON.stringify(name)} removed` });
|
|
194
|
+
else
|
|
195
|
+
compareNode(was[name], now[name], at, out);
|
|
196
|
+
}
|
|
197
|
+
for (const name of Object.keys(now)) {
|
|
198
|
+
if (!hasOwn(was, name)) {
|
|
199
|
+
out.push({ pointer: `${pointer}/properties/${escapePointer(name)}`, keyword: "properties", class: "additive", detail: `property ${JSON.stringify(name)} added` });
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
continue;
|
|
203
|
+
}
|
|
204
|
+
if (key === "items" && isObject(before) && isObject(after)) {
|
|
205
|
+
compareNode(before, after, `${pointer}/items`, out);
|
|
206
|
+
continue;
|
|
207
|
+
}
|
|
208
|
+
const change = keywordChange(key, before, after);
|
|
209
|
+
if (change === "none")
|
|
210
|
+
continue;
|
|
211
|
+
const cls = change === "tightens" ? (rowOf(key)?.extractor ? "breaking" : "tightening") : "additive";
|
|
212
|
+
out.push({ pointer, keyword: key, class: cls, detail: describe(key, before, after) });
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* The first node the gate descends to (the root, each property, `items`) whose
|
|
217
|
+
* value the gate's identity comparisons can never match when both sides are
|
|
218
|
+
* parsed separately: an `enum` with an object or array member, or a non-string
|
|
219
|
+
* `format` or `$ref`.
|
|
220
|
+
*/
|
|
221
|
+
function gateBlindSpot(node, pointer) {
|
|
222
|
+
if (!isObject(node))
|
|
223
|
+
return null;
|
|
224
|
+
if (Array.isArray(node.enum) && node.enum.some((member) => member !== null && typeof member === "object"))
|
|
225
|
+
return { pointer, keyword: "enum" };
|
|
226
|
+
for (const keyword of ["format", "$ref"]) {
|
|
227
|
+
if (hasOwn(node, keyword) && node[keyword] !== null && typeof node[keyword] === "object")
|
|
228
|
+
return { pointer, keyword };
|
|
229
|
+
}
|
|
230
|
+
if (isObject(node.properties)) {
|
|
231
|
+
for (const [name, child] of Object.entries(node.properties)) {
|
|
232
|
+
const found = gateBlindSpot(child, `${pointer}/properties/${escapePointer(name)}`);
|
|
233
|
+
if (found)
|
|
234
|
+
return found;
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
return gateBlindSpot(node.items, `${pointer}/items`);
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Classify the changes from the `stored` compiled schema to the `local` one
|
|
241
|
+
* (`undefined` for a side that declares none). A slot the local side no
|
|
242
|
+
* longer declares is cleared by push and is breaking; a slot the stored side
|
|
243
|
+
* lacks is compared against the empty schema, unless its owner is new
|
|
244
|
+
* (`options.newOwner`), when it is additive.
|
|
245
|
+
*/
|
|
246
|
+
export function classifySchemaChange(stored, local, options = {}) {
|
|
247
|
+
if (stored === undefined && local === undefined)
|
|
248
|
+
return { class: null, changes: [] };
|
|
249
|
+
const changes = [];
|
|
250
|
+
if (local === undefined) {
|
|
251
|
+
changes.push({ pointer: "", keyword: "(slot)", class: "breaking", detail: "cleared by push" });
|
|
252
|
+
}
|
|
253
|
+
else if (stored === undefined) {
|
|
254
|
+
if (options.newOwner) {
|
|
255
|
+
changes.push({ pointer: "", keyword: "(slot)", class: "additive", detail: "declared with its owner" });
|
|
256
|
+
}
|
|
257
|
+
else {
|
|
258
|
+
compareNode({}, local, "", changes);
|
|
259
|
+
if (changes.length === 0)
|
|
260
|
+
changes.push({ pointer: "", keyword: "(slot)", class: "additive", detail: "declared" });
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
else {
|
|
264
|
+
compareNode(stored, local, "", changes);
|
|
265
|
+
const blind = changes.length > 0 ? gateBlindSpot(stored, "") : null;
|
|
266
|
+
if (blind) {
|
|
267
|
+
changes.push({
|
|
268
|
+
pointer: blind.pointer,
|
|
269
|
+
keyword: blind.keyword,
|
|
270
|
+
class: "breaking",
|
|
271
|
+
detail: blind.keyword === "enum" ? NON_SCALAR_ENUM_REASON : `a non-string ${blind.keyword} cannot be compared by the gate`,
|
|
272
|
+
});
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
return { class: maxChangeClass(...changes.map((change) => change.class)), changes };
|
|
276
|
+
}
|
|
277
|
+
//# sourceMappingURL=schemaChanges.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schemaChanges.js","sourceRoot":"","sources":["../../../../src/lib/schema-codegen/schemaChanges.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Doc comments for generated TypeScript and Swift types, from the keyword
|
|
3
|
+
* table (#5530, project `unified-schemas` phase 1).
|
|
4
|
+
*
|
|
5
|
+
* A schema's constraint and annotation keywords do not change a generated
|
|
6
|
+
* type's shape, but an app developer reading a hover needs them: `string`
|
|
7
|
+
* alone hides `maxLength: 40`. Both renderers call `schemaDocs` at each
|
|
8
|
+
* declaration site — an object member and a root type — and print the result
|
|
9
|
+
* with `renderJsDocLines` (TS) or `renderSwiftDocLines` (Swift).
|
|
10
|
+
*
|
|
11
|
+
* Which keywords become docs is the table's `render` column
|
|
12
|
+
* (`schemaKeywordRender`, `doc` for an unknown key), read from the vendored
|
|
13
|
+
* descriptor, so codegen keeps no keyword list of its own.
|
|
14
|
+
*
|
|
15
|
+
* The validator also enforces keywords on nodes the renderers give no
|
|
16
|
+
* declaration site: the properties of a type-union or untyped object, any
|
|
17
|
+
* single-schema `items`, every `oneOf` and `anyOf` member, and a tagged
|
|
18
|
+
* union's member objects. Their keywords are hoisted onto the nearest site
|
|
19
|
+
* with a path prefix (`items.minimum`, `oneOf/1.properties.id.minimum`), so
|
|
20
|
+
* nothing the validator enforces is dropped. An `anyOf` member renders as a
|
|
21
|
+
* type (#5544), so the properties of an object member keep their own sites.
|
|
22
|
+
*
|
|
23
|
+
* #5540 — a `$comment` that is a db3 projection marker (written by the db3
|
|
24
|
+
* bridge, and so on every compiled node a db3 ref inlined) renders as one
|
|
25
|
+
* `projection:` line naming the projection, the type and the model, in place
|
|
26
|
+
* of the plain `$comment` entry.
|
|
27
|
+
*/
|
|
28
|
+
/** One keyword line: the keyword (or hoisted path), its value as JSON, and its form. */
|
|
29
|
+
export interface SchemaDocEntry {
|
|
30
|
+
name: string;
|
|
31
|
+
value: string;
|
|
32
|
+
/**
|
|
33
|
+
* `tag` for a table keyword on the site's own node, which TS renders as
|
|
34
|
+
* `@<name> <value>`; `line` for an unknown key, a hoisted keyword, or a
|
|
35
|
+
* `deprecated` that is not exactly `true`, which renders as an inert
|
|
36
|
+
* `- <name>: <value>` line so it cannot mean anything to the TS compiler.
|
|
37
|
+
*/
|
|
38
|
+
kind: "tag" | "line";
|
|
39
|
+
}
|
|
40
|
+
/** What one declaration site's doc comment says. */
|
|
41
|
+
export interface SchemaDocs {
|
|
42
|
+
/** The node's own string `description`, one entry per line. */
|
|
43
|
+
prose: string[];
|
|
44
|
+
entries: SchemaDocEntry[];
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* `text` made safe for one comment line: `*\/` cannot close a block comment,
|
|
48
|
+
* and every line terminator becomes its escape written as plain text.
|
|
49
|
+
*/
|
|
50
|
+
export declare function commentSafe(text: string): string;
|
|
51
|
+
/**
|
|
52
|
+
* The doc comment for one declaration site's schema node: its own prose and
|
|
53
|
+
* keywords, then every keyword hoisted from beneath it.
|
|
54
|
+
*/
|
|
55
|
+
export declare function schemaDocs(node: unknown): SchemaDocs;
|
|
56
|
+
/**
|
|
57
|
+
* The doc comment for a site whose type is a reference to a declaration
|
|
58
|
+
* emitted elsewhere (#5544): the node's own prose and keywords only, since
|
|
59
|
+
* everything beneath it is documented on that declaration.
|
|
60
|
+
*/
|
|
61
|
+
export declare function schemaOwnDocs(node: unknown): SchemaDocs;
|
|
62
|
+
/**
|
|
63
|
+
* A JSDoc block at `pad`, or no lines when there is nothing to say. Only a
|
|
64
|
+
* `tag` entry carries a real `@`, and `deprecated` is a bare `@deprecated`;
|
|
65
|
+
* prose, names and values have theirs written as `@`.
|
|
66
|
+
*/
|
|
67
|
+
export declare function renderJsDocLines(docs: SchemaDocs, pad: string): string[];
|
|
68
|
+
/** `///` lines at `pad`, or none when there is nothing to say. */
|
|
69
|
+
export declare function renderSwiftDocLines(docs: SchemaDocs, pad: string): string[];
|