@wildo-ai/platform-config-lib 1.1.10 → 1.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts +1 -1
  2. package/dist/esm/_unimplemented/unimplemented-field-warning.js +1 -1
  3. package/dist/esm/_unimplemented/unimplemented-field-warning.js.map +1 -1
  4. package/dist/esm/blueprint/anchored-region.d.ts +83 -0
  5. package/dist/esm/blueprint/anchored-region.d.ts.map +1 -0
  6. package/dist/esm/blueprint/anchored-region.js +263 -0
  7. package/dist/esm/blueprint/anchored-region.js.map +1 -0
  8. package/dist/esm/blueprint/blueprint.schemas.d.ts +689 -0
  9. package/dist/esm/blueprint/blueprint.schemas.d.ts.map +1 -0
  10. package/dist/esm/blueprint/blueprint.schemas.js +638 -0
  11. package/dist/esm/blueprint/blueprint.schemas.js.map +1 -0
  12. package/dist/esm/bootstrap/application-backend-env.contracts.d.ts.map +1 -1
  13. package/dist/esm/bootstrap/bootstrap-planner.d.ts.map +1 -1
  14. package/dist/esm/bootstrap/bootstrap.contracts.d.ts +13 -1
  15. package/dist/esm/bootstrap/bootstrap.contracts.d.ts.map +1 -1
  16. package/dist/esm/bootstrap/bootstrap.contracts.js +6 -0
  17. package/dist/esm/bootstrap/bootstrap.contracts.js.map +1 -1
  18. package/dist/esm/bootstrap/bootstrap.schemas.d.ts +21 -3
  19. package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
  20. package/dist/esm/bootstrap/bootstrap.schemas.js +14 -3
  21. package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
  22. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +121 -0
  23. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
  24. package/dist/esm/bootstrap/platform-runtime-env.contracts.js +129 -0
  25. package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
  26. package/dist/esm/bootstrap/platform-store-preconnect.d.ts.map +1 -1
  27. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts.map +1 -1
  28. package/dist/esm/bootstrap/runtime-network-policy.d.ts.map +1 -1
  29. package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -1
  30. package/dist/esm/bootstrap/runtime-platform-access.d.ts.map +1 -1
  31. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts.map +1 -1
  32. package/dist/esm/bootstrap/runtime-response-integrity.d.ts +249 -0
  33. package/dist/esm/bootstrap/runtime-response-integrity.d.ts.map +1 -0
  34. package/dist/esm/bootstrap/runtime-response-integrity.js +353 -0
  35. package/dist/esm/bootstrap/runtime-response-integrity.js.map +1 -0
  36. package/dist/esm/bootstrap/runtime-secret-env.contracts.d.ts +32 -0
  37. package/dist/esm/bootstrap/runtime-secret-env.contracts.d.ts.map +1 -0
  38. package/dist/esm/bootstrap/runtime-secret-env.contracts.js +43 -0
  39. package/dist/esm/bootstrap/runtime-secret-env.contracts.js.map +1 -0
  40. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts.map +1 -1
  41. package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts.map +1 -1
  42. package/dist/esm/canonical-json/rfc8785-canonical-json.d.ts +51 -0
  43. package/dist/esm/canonical-json/rfc8785-canonical-json.d.ts.map +1 -0
  44. package/dist/esm/canonical-json/rfc8785-canonical-json.js +231 -0
  45. package/dist/esm/canonical-json/rfc8785-canonical-json.js.map +1 -0
  46. package/dist/esm/config-authoring.entry.d.ts.map +1 -1
  47. package/dist/esm/index.d.ts +15 -0
  48. package/dist/esm/index.d.ts.map +1 -1
  49. package/dist/esm/index.js +15 -0
  50. package/dist/esm/index.js.map +1 -1
  51. package/dist/esm/key-management/approval-seal-verifier.d.ts +216 -0
  52. package/dist/esm/key-management/approval-seal-verifier.d.ts.map +1 -0
  53. package/dist/esm/key-management/approval-seal-verifier.js +233 -0
  54. package/dist/esm/key-management/approval-seal-verifier.js.map +1 -0
  55. package/dist/esm/key-management/approval-seal.contracts.d.ts +131 -0
  56. package/dist/esm/key-management/approval-seal.contracts.d.ts.map +1 -0
  57. package/dist/esm/key-management/approval-seal.contracts.js +115 -0
  58. package/dist/esm/key-management/approval-seal.contracts.js.map +1 -0
  59. package/dist/esm/key-management/data-key.contracts.d.ts +108 -0
  60. package/dist/esm/key-management/data-key.contracts.d.ts.map +1 -0
  61. package/dist/esm/key-management/data-key.contracts.js +54 -0
  62. package/dist/esm/key-management/data-key.contracts.js.map +1 -0
  63. package/dist/esm/key-management/es256-jws.d.ts +60 -0
  64. package/dist/esm/key-management/es256-jws.d.ts.map +1 -0
  65. package/dist/esm/key-management/es256-jws.js +135 -0
  66. package/dist/esm/key-management/es256-jws.js.map +1 -0
  67. package/dist/esm/key-management/key-provider.spi.d.ts +151 -0
  68. package/dist/esm/key-management/key-provider.spi.d.ts.map +1 -0
  69. package/dist/esm/key-management/key-provider.spi.js +38 -0
  70. package/dist/esm/key-management/key-provider.spi.js.map +1 -0
  71. package/dist/esm/key-management/keyring-rotation.contracts.d.ts +93 -0
  72. package/dist/esm/key-management/keyring-rotation.contracts.d.ts.map +1 -0
  73. package/dist/esm/key-management/keyring-rotation.contracts.js +101 -0
  74. package/dist/esm/key-management/keyring-rotation.contracts.js.map +1 -0
  75. package/dist/esm/key-management/keyring-status.contracts.d.ts +66 -0
  76. package/dist/esm/key-management/keyring-status.contracts.d.ts.map +1 -0
  77. package/dist/esm/key-management/keyring-status.contracts.js +45 -0
  78. package/dist/esm/key-management/keyring-status.contracts.js.map +1 -0
  79. package/dist/esm/key-management/signature-request.contracts.d.ts +95 -0
  80. package/dist/esm/key-management/signature-request.contracts.d.ts.map +1 -0
  81. package/dist/esm/key-management/signature-request.contracts.js +96 -0
  82. package/dist/esm/key-management/signature-request.contracts.js.map +1 -0
  83. package/dist/esm/key-management/signing-log-export.contracts.d.ts +216 -0
  84. package/dist/esm/key-management/signing-log-export.contracts.d.ts.map +1 -0
  85. package/dist/esm/key-management/signing-log-export.contracts.js +268 -0
  86. package/dist/esm/key-management/signing-log-export.contracts.js.map +1 -0
  87. package/dist/esm/key-management/vault-custody.contracts.d.ts +55 -0
  88. package/dist/esm/key-management/vault-custody.contracts.d.ts.map +1 -0
  89. package/dist/esm/key-management/vault-custody.contracts.js +88 -0
  90. package/dist/esm/key-management/vault-custody.contracts.js.map +1 -0
  91. package/dist/esm/lockfile/file-lock-hold.d.ts.map +1 -1
  92. package/dist/esm/lockfile/lockfile-io.d.ts +7 -9
  93. package/dist/esm/lockfile/lockfile-io.d.ts.map +1 -1
  94. package/dist/esm/lockfile/lockfile-io.js +23 -22
  95. package/dist/esm/lockfile/lockfile-io.js.map +1 -1
  96. package/dist/esm/lockfile/materialize-infra-section.d.ts +17 -14
  97. package/dist/esm/lockfile/materialize-infra-section.d.ts.map +1 -1
  98. package/dist/esm/lockfile/materialize-infra-section.js +9 -9
  99. package/dist/esm/lockfile/materialize-infra-section.js.map +1 -1
  100. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +26 -2
  101. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -1
  102. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +27 -2
  103. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -1
  104. package/dist/esm/project-config/application-public-pricing-catalog.loader.d.ts.map +1 -1
  105. package/dist/esm/project-config/application-public-pricing-catalog.loader.js +9 -2
  106. package/dist/esm/project-config/application-public-pricing-catalog.loader.js.map +1 -1
  107. package/dist/esm/project-config/application-served-public-documents.loader.d.ts +26 -0
  108. package/dist/esm/project-config/application-served-public-documents.loader.d.ts.map +1 -0
  109. package/dist/esm/project-config/application-served-public-documents.loader.js +78 -0
  110. package/dist/esm/project-config/application-served-public-documents.loader.js.map +1 -0
  111. package/dist/esm/project-config/define-framework-config.d.ts.map +1 -1
  112. package/dist/esm/project-config/define-infra-env-config.d.ts +236 -15
  113. package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -1
  114. package/dist/esm/project-config/define-infra-env-config.js +104 -91
  115. package/dist/esm/project-config/define-infra-env-config.js.map +1 -1
  116. package/dist/esm/project-config/define-minion-config.d.ts.map +1 -1
  117. package/dist/esm/project-config/define-saas-config.d.ts +133 -3
  118. package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
  119. package/dist/esm/project-config/define-saas-config.js +170 -19
  120. package/dist/esm/project-config/define-saas-config.js.map +1 -1
  121. package/dist/esm/project-config/define-worker-config.d.ts.map +1 -1
  122. package/dist/esm/project-config/hosted-infra-env-config.d.ts.map +1 -1
  123. package/dist/esm/project-config/hosted-infra-env-config.js +3 -0
  124. package/dist/esm/project-config/hosted-infra-env-config.js.map +1 -1
  125. package/dist/esm/project-config/index.d.ts +3 -0
  126. package/dist/esm/project-config/index.d.ts.map +1 -1
  127. package/dist/esm/project-config/index.js +3 -0
  128. package/dist/esm/project-config/index.js.map +1 -1
  129. package/dist/esm/project-config/loader.d.ts.map +1 -1
  130. package/dist/esm/project-config/npm-version-range.d.ts.map +1 -1
  131. package/dist/esm/project-config/npm-version-range.js +39 -16
  132. package/dist/esm/project-config/npm-version-range.js.map +1 -1
  133. package/dist/esm/project-config/owning-package-tsconfig.d.ts +15 -0
  134. package/dist/esm/project-config/owning-package-tsconfig.d.ts.map +1 -0
  135. package/dist/esm/project-config/owning-package-tsconfig.js +29 -0
  136. package/dist/esm/project-config/owning-package-tsconfig.js.map +1 -0
  137. package/dist/esm/project-config/provider-catalog-types.d.ts.map +1 -1
  138. package/dist/esm/project-config/provider-companion-discovery.d.ts +4 -4
  139. package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -1
  140. package/dist/esm/project-config/provider-companion-discovery.js +13 -9
  141. package/dist/esm/project-config/provider-companion-discovery.js.map +1 -1
  142. package/dist/esm/project-config/provider-runtime-artifacts.d.ts +32 -3
  143. package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -1
  144. package/dist/esm/project-config/provider-runtime-artifacts.js +67 -13
  145. package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -1
  146. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts.map +1 -1
  147. package/dist/esm/project-config/shared/application-modules.schemas.d.ts.map +1 -1
  148. package/dist/esm/project-config/shared/application-modules.utils.d.ts.map +1 -1
  149. package/dist/esm/project-config/shared/auth.schemas.d.ts.map +1 -1
  150. package/dist/esm/project-config/shared/backing-service-servability.d.ts.map +1 -1
  151. package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
  152. package/dist/esm/project-config/shared/cdn.example.d.ts.map +1 -1
  153. package/dist/esm/project-config/shared/cdn.schemas.d.ts.map +1 -1
  154. package/dist/esm/project-config/shared/csp-defaults.d.ts +4 -5
  155. package/dist/esm/project-config/shared/csp-defaults.d.ts.map +1 -1
  156. package/dist/esm/project-config/shared/csp-defaults.js +4 -5
  157. package/dist/esm/project-config/shared/csp-defaults.js.map +1 -1
  158. package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -1
  159. package/dist/esm/project-config/shared/csp.schemas.d.ts +1 -2
  160. package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -1
  161. package/dist/esm/project-config/shared/csp.schemas.js +1 -2
  162. package/dist/esm/project-config/shared/csp.schemas.js.map +1 -1
  163. package/dist/esm/project-config/shared/data-services.schemas.d.ts.map +1 -1
  164. package/dist/esm/project-config/shared/environment.schemas.d.ts +6 -0
  165. package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
  166. package/dist/esm/project-config/shared/environment.schemas.js +8 -1
  167. package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
  168. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -1
  169. package/dist/esm/project-config/shared/infra-service.schemas.d.ts.map +1 -1
  170. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +1 -0
  171. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
  172. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +3 -0
  173. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
  174. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts +4 -0
  175. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts.map +1 -1
  176. package/dist/esm/project-config/shared/minion-resource-access.validation.js +6 -2
  177. package/dist/esm/project-config/shared/minion-resource-access.validation.js.map +1 -1
  178. package/dist/esm/project-config/shared/platform-key-management.schemas.d.ts +250 -0
  179. package/dist/esm/project-config/shared/platform-key-management.schemas.d.ts.map +1 -0
  180. package/dist/esm/project-config/shared/platform-key-management.schemas.js +194 -0
  181. package/dist/esm/project-config/shared/platform-key-management.schemas.js.map +1 -0
  182. package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
  183. package/dist/esm/project-config/shared/platform-storage.schemas.d.ts.map +1 -1
  184. package/dist/esm/project-config/shared/schema-version.schemas.d.ts.map +1 -1
  185. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts.map +1 -1
  186. package/dist/esm/project-config/shared/systems-of-record-env.schemas.d.ts.map +1 -1
  187. package/dist/esm/registry/artifact-domain.schemas.d.ts.map +1 -1
  188. package/dist/esm/registry/digest.schemas.d.ts.map +1 -1
  189. package/dist/esm/registry/index.d.ts +1 -0
  190. package/dist/esm/registry/index.d.ts.map +1 -1
  191. package/dist/esm/registry/index.js +1 -0
  192. package/dist/esm/registry/index.js.map +1 -1
  193. package/dist/esm/registry/local-checkout-source.d.ts +22 -2
  194. package/dist/esm/registry/local-checkout-source.d.ts.map +1 -1
  195. package/dist/esm/registry/local-checkout-source.js +66 -3
  196. package/dist/esm/registry/local-checkout-source.js.map +1 -1
  197. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts +10 -0
  198. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts.map +1 -1
  199. package/dist/esm/registry/module-artifact.schemas.d.ts +23 -0
  200. package/dist/esm/registry/module-artifact.schemas.d.ts.map +1 -1
  201. package/dist/esm/registry/module-manifest.schemas.d.ts +336 -18
  202. package/dist/esm/registry/module-manifest.schemas.d.ts.map +1 -1
  203. package/dist/esm/registry/module-manifest.schemas.js +245 -19
  204. package/dist/esm/registry/module-manifest.schemas.js.map +1 -1
  205. package/dist/esm/registry/module-search.schemas.d.ts +2 -0
  206. package/dist/esm/registry/module-search.schemas.d.ts.map +1 -1
  207. package/dist/esm/registry/module-search.schemas.js +14 -1
  208. package/dist/esm/registry/module-search.schemas.js.map +1 -1
  209. package/dist/esm/registry/registry-config.schemas.d.ts.map +1 -1
  210. package/dist/esm/registry/registry-errors.d.ts +22 -2
  211. package/dist/esm/registry/registry-errors.d.ts.map +1 -1
  212. package/dist/esm/registry/registry-errors.js +28 -2
  213. package/dist/esm/registry/registry-errors.js.map +1 -1
  214. package/dist/esm/registry/registry-keys.schemas.d.ts.map +1 -1
  215. package/dist/esm/registry/registry-section-schemas.constants.d.ts +5 -0
  216. package/dist/esm/registry/registry-section-schemas.constants.d.ts.map +1 -1
  217. package/dist/esm/registry/registry-url-resolution.d.ts +72 -0
  218. package/dist/esm/registry/registry-url-resolution.d.ts.map +1 -0
  219. package/dist/esm/registry/registry-url-resolution.js +157 -0
  220. package/dist/esm/registry/registry-url-resolution.js.map +1 -0
  221. package/dist/esm/schemas/framework-info.schemas.d.ts.map +1 -1
  222. package/dist/esm/schemas/framework-secrets.schemas.d.ts +55 -0
  223. package/dist/esm/schemas/framework-secrets.schemas.d.ts.map +1 -1
  224. package/dist/esm/schemas/framework-secrets.schemas.js +53 -0
  225. package/dist/esm/schemas/framework-secrets.schemas.js.map +1 -1
  226. package/dist/esm/schemas/platform-application-config.schemas.d.ts.map +1 -1
  227. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts.map +1 -1
  228. package/dist/esm/schemas/platform-config.schemas.d.ts.map +1 -1
  229. package/dist/esm/workspace-scope/application-subject-manifest.d.ts.map +1 -1
  230. package/dist/esm/workspace-scope/index.d.ts.map +1 -1
  231. package/package.json +7 -7
@@ -0,0 +1,689 @@
1
+ import { z } from 'zod';
2
+ import { ModuleRegistrationScenario } from '../registry/module-manifest.schemas';
3
+ /**
4
+ * Application BLUEPRINTS (epic #2856) — the contracts.
5
+ *
6
+ * A blueprint is a LAYER UPON the base `wildo init` skeleton, never a replacement of it (decision D3): it may
7
+ * pre-configure the application-shape init flags, add new files, bring modules (their files plus the registration
8
+ * that makes the application know them), set the values of named declarations in base files, append barrel exports,
9
+ * add runtime dependencies, and contribute text inside anchor slots. It never overwrites a
10
+ * file of the base or of a lower layer, unless an upper layer names that file in `overrides`.
11
+ *
12
+ * Two halves, deliberately separate:
13
+ *
14
+ * - the **definition** ({@link BlueprintDefinitionSchema}) lives ONLY in the application that defines the blueprint,
15
+ * at `blueprints/<name>/blueprint.definition.ts`. It SELECTS what belongs to the blueprint and declares its
16
+ * parameters. It never carries a value the application already holds: the exporter reads every byte and every
17
+ * config value from the application, and proves the export reproduces it (`wildo blueprint pack`);
18
+ * - the **manifest** ({@link BlueprintManifestSchema}) is what an export writes beside the artifact's `files/` tree,
19
+ * and what `wildo init --blueprint` reads. It is a compiled output, never authored.
20
+ *
21
+ * The split is the `playbook.definition.ts` → `playbook.json` split, for the same reason: the authored form is
22
+ * TypeScript a person can comment, the compiled form is JSON a machine validates.
23
+ */
24
+ /** @wildo_source:part:start blueprint.definition-contract facet:layer:shared facet:audience:app-developer */
25
+ /**
26
+ * Every flag `wildo init` accepts, as a closed vocabulary so each one is CLASSIFIED once
27
+ * ({@link INIT_FLAG_CLASSES}). A flag added to the command tomorrow must be added here and given a class, or the
28
+ * pinning test fails: a blueprint can then never start setting it by accident.
29
+ */
30
+ export declare enum InitFlag {
31
+ /** The application's name; the directory names it by default. */
32
+ NAME = "name",
33
+ /** The local infrastructure runtime (Docker Compose or a local Kubernetes). */
34
+ RUNTIME = "runtime",
35
+ /** The application's own database engine. Decides what the scaffold AUTHORS (`isPostgreSql` templates). */
36
+ DATABASE = "database",
37
+ /** Verify the developer's tools instead of scaffolding. */
38
+ CHECK = "check",
39
+ /** Write only `wildo.saas.config.ts`. */
40
+ CONFIG_ONLY = "config-only",
41
+ /** The base of the application's port block on this machine. */
42
+ PORT_BASE = "port-base",
43
+ /** The local platform administrator's email. */
44
+ ADMIN_EMAIL = "admin-email",
45
+ /** The local platform administrator's first name. */
46
+ ADMIN_FIRST_NAME = "admin-first-name",
47
+ /** The local platform administrator's last name. */
48
+ ADMIN_LAST_NAME = "admin-last-name",
49
+ /** The local platform administrator's initial password. */
50
+ ADMIN_PASSWORD = "admin-password",
51
+ /** Skip `pnpm install` and the initial builds. */
52
+ SKIP_INSTALL = "skip-install",
53
+ /** Where this environment's secrets live on this machine. */
54
+ SECRETS_PATH = "secrets-path",
55
+ /** How to treat the machine's shared platform credentials. */
56
+ LOCAL_DEFAULTS = "local-defaults",
57
+ /** Whether to seed the machine's provider API keys. */
58
+ PROVIDER_KEY_DEFAULTS = "provider-key-defaults",
59
+ /** The blueprint layers to apply on the base, in order (epic #2856). */
60
+ BLUEPRINT = "blueprint",
61
+ /** A blueprint parameter value, `name=value`. */
62
+ BLUEPRINT_PARAM = "blueprint-param",
63
+ /** The registry a `--blueprint <domain>/<scope>/<name>@<range>` entry is fetched from. */
64
+ BLUEPRINT_REGISTRY = "blueprint-registry",
65
+ /**
66
+ * The application line, when no blueprint is given (#1605): shorthand for `--blueprint wildo/<line>`, or `later`.
67
+ * A command mode, not application shape: a blueprint carries its line through `include.line`, never by setting a flag.
68
+ */
69
+ LINE = "line"
70
+ }
71
+ /**
72
+ * What kind of decision an init flag carries — and therefore whether a blueprint may make it.
73
+ */
74
+ export declare enum InitFlagClass {
75
+ /**
76
+ * A decision about what the APPLICATION is, the same on every machine. The only class a blueprint may lock or
77
+ * default: a corporate blueprint that targets PostgreSQL states it once, for every application made from it.
78
+ */
79
+ APPLICATION_SHAPE = "application-shape",
80
+ /**
81
+ * A decision about THIS MACHINE — ports, local runtime, where secrets live, whether to install now. A blueprint
82
+ * never touches one: it is applied on machines it has never seen.
83
+ */
84
+ MACHINE = "machine",
85
+ /**
86
+ * WHO the application or its local administrator is. Never a blueprint's: an application made from a blueprint is
87
+ * a new application with its own name and its own operator.
88
+ */
89
+ IDENTITY = "identity",
90
+ /** How the command runs (check only, config only, which blueprints). Not a property of the application at all. */
91
+ COMMAND_MODE = "command-mode"
92
+ }
93
+ /** The class of every init flag. Total over {@link InitFlag} by its type. */
94
+ export declare const INIT_FLAG_CLASSES: Readonly<Record<InitFlag, InitFlagClass>>;
95
+ /** The values an APPLICATION_SHAPE flag accepts. Total over the shape flags, checked by the pinning test. */
96
+ export declare const APPLICATION_SHAPE_INIT_FLAG_VALUES: Readonly<Partial<Record<InitFlag, readonly string[]>>>;
97
+ /** Whether a blueprint may lock or default `flag`. */
98
+ export declare function isBlueprintSettableInitFlag(flag: InitFlag): boolean;
99
+ /** How a blueprint pre-configures an application-shape init flag. */
100
+ export declare enum BlueprintInitConstraintMode {
101
+ /** The flag takes this value; `wildo init` refuses a flag that contradicts it. */
102
+ LOCK = "lock",
103
+ /** The flag takes this value unless the operator passes the flag. */
104
+ DEFAULT = "default"
105
+ }
106
+ /**
107
+ * Why this is not `CompositionScenarioVariableKind` (#2857 asked not to fork the scenario pieces): a blueprint
108
+ * parameter is chosen by the person creating an application, so it needs a CLOSED choice (`ENUM`, with members the
109
+ * apply refuses outside of), which a scenario variable has no use for; and a scenario variable can be DERIVED from
110
+ * another (#2810), which a blueprint parameter must never be, since its value is the operator's or a lower layer
111
+ * binding's. The three shared members keep the scenario's wire values, so a value moves between the two unchanged.
112
+ * The scenario vocabulary also lives in `application-creation-runtime`, which this contracts package cannot import.
113
+ */
114
+ /** @wildo_source:part:start blueprint.definition-contract facet:layer:shared facet:audience:app-developer */
115
+ /** The value kinds a blueprint parameter may declare. */
116
+ export declare enum BlueprintParameterKind {
117
+ STRING = "string",
118
+ NUMBER = "number",
119
+ BOOLEAN = "boolean",
120
+ /** One of `members`: a closed choice (an ERP vendor, a region), named so the choice is explained once. */
121
+ ENUM = "enum"
122
+ }
123
+ export type BlueprintParameterValue = string | number | boolean;
124
+ /**
125
+ * Parameter names a blueprint cannot declare, because the applier supplies them from the new application's
126
+ * identity. A template reads `{{slug}}` or `{{displayName}}` and gets the application being created.
127
+ */
128
+ export declare const BLUEPRINT_IDENTITY_VARIABLES: readonly ["slug", "displayName"];
129
+ /** @wildo_source:part:end blueprint.definition-contract */
130
+ /**
131
+ * Parse one serialized value per the parameter's declaration, or explain why it is not a value of it. Shared by the
132
+ * schema (a declared default) and the applier (a value passed on the command line), so both refuse the same values.
133
+ */
134
+ export declare function parseBlueprintParameterValue(parameter: {
135
+ readonly name: string;
136
+ readonly kind: BlueprintParameterKind;
137
+ readonly pattern?: string | undefined;
138
+ readonly members?: readonly string[] | undefined;
139
+ }, raw: BlueprintParameterValue): {
140
+ value: BlueprintParameterValue;
141
+ } | {
142
+ reason: string;
143
+ };
144
+ /** One declared blueprint parameter, as the published manifest carries it. */
145
+ export declare const BlueprintParameterSchema: z.ZodObject<{
146
+ name: z.ZodString;
147
+ description: z.ZodString;
148
+ kind: z.ZodEnum<typeof BlueprintParameterKind>;
149
+ required: z.ZodBoolean;
150
+ /** Serialized default, parsed per `kind`. Only on an optional parameter. */
151
+ default: z.ZodOptional<z.ZodString>;
152
+ /** RegExp source a STRING value must fully match. */
153
+ pattern: z.ZodOptional<z.ZodString>;
154
+ /** ENUM only: the allowed values. */
155
+ members: z.ZodOptional<z.ZodArray<z.ZodString>>;
156
+ }, z.core.$strict>;
157
+ export type BlueprintParameter = z.infer<typeof BlueprintParameterSchema>;
158
+ /** @wildo_source:part:start blueprint.definition-contract facet:layer:shared facet:audience:app-developer */
159
+ /**
160
+ * One declared parameter, as the DEFINITION carries it: the declaration plus the defining application's own value.
161
+ *
162
+ * `appValue` is the reproduction WITNESS, not a value the blueprint ships: the export renders every template with it
163
+ * and requires the result to equal the defining application's bytes. A wrong `appValue` therefore fails the pack
164
+ * instead of producing a blueprint that silently renders something else. It is never written into the manifest.
165
+ */
166
+ export declare const BlueprintDefinitionParameterSchema: z.ZodObject<{
167
+ appValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
168
+ name: z.ZodString;
169
+ description: z.ZodString;
170
+ kind: z.ZodEnum<typeof BlueprintParameterKind>;
171
+ required: z.ZodBoolean;
172
+ /** Serialized default, parsed per `kind`. Only on an optional parameter. */
173
+ default: z.ZodOptional<z.ZodString>;
174
+ /** RegExp source a STRING value must fully match. */
175
+ pattern: z.ZodOptional<z.ZodString>;
176
+ /** ENUM only: the allowed values. */
177
+ members: z.ZodOptional<z.ZodArray<z.ZodString>>;
178
+ }, z.core.$strict>;
179
+ export type BlueprintDefinitionParameter = z.infer<typeof BlueprintDefinitionParameterSchema>;
180
+ /** @wildo_source:part:start blueprint.definition-contract facet:layer:shared facet:audience:app-developer */
181
+ /** A lower blueprint this one is layered on, with the values it binds for that layer's parameters. */
182
+ export declare const BlueprintLayerReferenceSchema: z.ZodObject<{
183
+ id: z.ZodString;
184
+ /** npm-style semver range the lower layer's version must satisfy. */
185
+ range: z.ZodString;
186
+ /** Values this layer binds for the lower layer's parameters; the operator is not asked for them. */
187
+ parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
188
+ }, z.core.$strict>;
189
+ export type BlueprintLayerReference = z.infer<typeof BlueprintLayerReferenceSchema>;
190
+ /**
191
+ * The base files whose named DECLARATIONS a blueprint may set — the blueprint customization API (decision D3).
192
+ *
193
+ * A blueprint never replaces a base file; it sets values the base declares. Each member is a file the `wildo init`
194
+ * skeleton authors as a set of named declarations with an application-owned VALUE (an empty registry, a default
195
+ * profile, a theme), so setting one is a replacement at a path the config walker resolves, never a text edit.
196
+ * Measured on Wonder Procurement (#2860): every change it made to a base TypeScript file was the value of one of
197
+ * these declarations. A closed set, because a declaration operation is only safe on a file whose shape the framework
198
+ * owns: adding a member is deciding that the base will keep that declaration stable.
199
+ */
200
+ export declare enum BlueprintDeclarationFile {
201
+ /** `wildo.saas.config.ts`: modules, services, capabilities, organization types, providers, systems of record. */
202
+ SAAS_CONFIG = "wildo.saas.config.ts",
203
+ /** The backend-authored configuration: authentication posture, user types, registration, email. */
204
+ BACKEND_CONFIG = "backend-api/src/saas-config.backend.ts",
205
+ /** App-wide backend assembly: resource-server instances, organization-unit narrowing, own rows. */
206
+ BACKEND_BOOTSTRAP = "backend-api/src/bootstrap-config.ts",
207
+ /** The application's own roles (`CUSTOM_ROLES_CONFIGURATION`). */
208
+ ROLES = "shared-lib/src/engine/roles.ts",
209
+ /** Features, feature profiles and unavailability policy. */
210
+ FEATURES = "shared-lib/src/engine/features.ts",
211
+ /** Milestone definitions. */
212
+ MILESTONES = "shared-lib/src/engine/milestones.ts",
213
+ /** The product catalogue. */
214
+ PRODUCT = "shared-lib/src/engine/product.ts",
215
+ /** The frontend module list, whose ORDER is the sidebar's (`applicationFrontendModules`). */
216
+ FRONTEND_MODULES = "frontend/src/modules/index.ts",
217
+ /** The design system: theme, colours, surfaces. */
218
+ FRONTEND_DESIGN_SYSTEM = "frontend/src/config/design-system.config.ts",
219
+ /** Navigation zones and transitions. */
220
+ FRONTEND_NAVIGATION = "frontend/src/config/navigation.config.ts",
221
+ /** The application shell: menubar, sidebar, command menu. */
222
+ FRONTEND_APP_SHELL = "frontend/src/config/app-shell.config.ts",
223
+ /** The settings rail. */
224
+ FRONTEND_SETTINGS_HUB = "frontend/src/config/settings-hub.config.ts",
225
+ /** Application-level views. */
226
+ FRONTEND_GLOBAL_VIEWS = "frontend/src/config/global-views.config.ts"
227
+ }
228
+ /** The label a declaration target is reported under: `<file> <declaration>.<path>`. */
229
+ export declare function describeBlueprintDeclarationTarget(target: {
230
+ file: string;
231
+ declaration?: string | undefined;
232
+ path: readonly string[];
233
+ }): string;
234
+ /** What a definition selects in a declaration file. */
235
+ export declare const BlueprintDefinitionDeclarationSelectionSchema: z.ZodObject<{
236
+ /**
237
+ * The value as a template over the parameters, when the value depends on one. Rendered with each parameter's
238
+ * `appValue`, it must equal the defining application's value text exactly, or the pack refuses.
239
+ */
240
+ valueTemplate: z.ZodOptional<z.ZodString>;
241
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
242
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
243
+ declaration: z.ZodOptional<z.ZodString>;
244
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
245
+ path: z.ZodArray<z.ZodString>;
246
+ }, z.core.$strict>;
247
+ export type BlueprintDefinitionDeclarationSelection = z.infer<typeof BlueprintDefinitionDeclarationSelectionSchema>;
248
+ /** One declaration a blueprint sets: the value at the target, creating the final property when absent. */
249
+ export declare const BlueprintDeclarationOperationSchema: z.ZodObject<{
250
+ /** The value's expression text, verbatim; may read `{{parameter}}`. */
251
+ valueText: z.ZodString;
252
+ /** Import statements the value needs that the base file does not have (`import { X } from 'pkg';`). */
253
+ imports: z.ZodDefault<z.ZodArray<z.ZodString>>;
254
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
255
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
256
+ declaration: z.ZodOptional<z.ZodString>;
257
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
258
+ path: z.ZodArray<z.ZodString>;
259
+ }, z.core.$strict>;
260
+ export type BlueprintDeclarationOperation = z.infer<typeof BlueprintDeclarationOperationSchema>;
261
+ /**
262
+ * The barrels a blueprint may append `export` lines to — the package entry files every module's `add-module`
263
+ * registration already appends to. A blueprint carrying a new file (`shared-lib/src/system-of-record/…`) that the
264
+ * package must export appends its line here.
265
+ */
266
+ export declare enum BlueprintBarrelFile {
267
+ SHARED_LIB = "shared-lib/src/index.ts",
268
+ SPECIFICATIONS = "specifications/src/index.ts"
269
+ }
270
+ /** One `export … from '…';` line appended to a barrel. */
271
+ export declare const BlueprintBarrelExportSchema: z.ZodObject<{
272
+ file: z.ZodEnum<typeof BlueprintBarrelFile>;
273
+ line: z.ZodString;
274
+ }, z.core.$strict>;
275
+ export type BlueprintBarrelExport = z.infer<typeof BlueprintBarrelExportSchema>;
276
+ /**
277
+ * The workspace manifests a blueprint may add a runtime dependency to: the packages every `wildo init` base has.
278
+ * A carried minion's or worker's own `package.json` travels with its files instead.
279
+ */
280
+ export declare enum BlueprintWorkspaceManifest {
281
+ ROOT = "package.json",
282
+ SHARED_LIB = "shared-lib/package.json",
283
+ SPECIFICATIONS = "specifications/package.json",
284
+ BACKEND_API = "backend-api/package.json",
285
+ FRONTEND = "frontend/package.json"
286
+ }
287
+ /** One runtime dependency a blueprint adds to a workspace manifest (`dependencies` only). */
288
+ export declare const BlueprintDependencySchema: z.ZodObject<{
289
+ manifest: z.ZodEnum<typeof BlueprintWorkspaceManifest>;
290
+ name: z.ZodString;
291
+ specifier: z.ZodString;
292
+ }, z.core.$strict>;
293
+ export type BlueprintDependency = z.infer<typeof BlueprintDependencySchema>;
294
+ /**
295
+ * The base files that declare anchor SLOTS — the free-text extension points (`@wildo_anchor:slot`), for the few
296
+ * files that are not TypeScript declarations. Measured on Wonder Procurement (#2860), the one such need was the
297
+ * application's agent guide. Adding a member is deciding where free text may be extended; keep it small.
298
+ */
299
+ export declare enum BlueprintSlotFile {
300
+ /** The application's `CLAUDE.md`, read by every coding-agent session in it. */
301
+ APPLICATION_AGENT_GUIDE = "CLAUDE.md"
302
+ }
303
+ /** One slot a blueprint contributes to, and what it writes there. */
304
+ export declare const BlueprintSlotContributionSchema: z.ZodObject<{
305
+ file: z.ZodEnum<typeof BlueprintSlotFile>;
306
+ slot: z.ZodString;
307
+ /** The text this layer adds inside the slot, without its markers; may read `{{parameter}}`. */
308
+ body: z.ZodString;
309
+ }, z.core.$strict>;
310
+ export type BlueprintSlotContribution = z.infer<typeof BlueprintSlotContributionSchema>;
311
+ /** A declaration target with no value: what `overrides.declarations` names. */
312
+ export declare const BlueprintDeclarationTargetSchema: z.ZodObject<{
313
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
314
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
315
+ declaration: z.ZodOptional<z.ZodString>;
316
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
317
+ path: z.ZodArray<z.ZodString>;
318
+ }, z.core.$strict>;
319
+ export type BlueprintDeclarationTarget = z.infer<typeof BlueprintDeclarationTargetSchema>;
320
+ /** Whether two declaration targets address the same value. */
321
+ export declare function isSameBlueprintDeclarationTarget(a: {
322
+ file: string;
323
+ declaration?: string | undefined;
324
+ path: readonly string[];
325
+ }, b: {
326
+ file: string;
327
+ declaration?: string | undefined;
328
+ path: readonly string[];
329
+ }): boolean;
330
+ /**
331
+ * Whether two declaration targets address overlapping values: the same file and start, and one path a prefix of the
332
+ * other (`engineCapabilities` and `engineCapabilities.EngineCapability.BILLING`). Setting either replaces part of what
333
+ * the other set, so stacked layers treat an overlap as a collision exactly like an identical target.
334
+ */
335
+ export declare function blueprintDeclarationTargetsOverlap(a: {
336
+ file: string;
337
+ declaration?: string | undefined;
338
+ path: readonly string[];
339
+ }, b: {
340
+ file: string;
341
+ declaration?: string | undefined;
342
+ path: readonly string[];
343
+ }): boolean;
344
+ /**
345
+ * A registry module a blueprint REFERENCES (#2879): installed into the new application from the registry by
346
+ * `wildo init`, through the same pipeline as `wildo registry add`, rather than copied. Its files are never carried —
347
+ * the lockfile records them with their install hashes, and `wildo registry update` / `remove` act on them, which a copy
348
+ * would silently defeat.
349
+ *
350
+ * The range is the one the defining application asked for (its lockfile `requestedRange`), so the new application
351
+ * resolves the same way the defining one did; the version it gets is whatever that range resolves to on the day.
352
+ */
353
+ export declare const BlueprintModuleReferenceSchema: z.ZodObject<{
354
+ domain: z.ZodString;
355
+ moduleId: z.ZodString;
356
+ range: z.ZodString;
357
+ }, z.core.$strict>;
358
+ export type BlueprintModuleReference = z.infer<typeof BlueprintModuleReferenceSchema>;
359
+ /** What an upper layer deliberately replaces from a lower one. Never anything of the base (D3). */
360
+ export declare const BlueprintOverridesSchema: z.ZodObject<{
361
+ /** App-relative files a lower layer wrote that this layer writes again. */
362
+ files: z.ZodDefault<z.ZodArray<z.ZodString>>;
363
+ /** Init flags a lower layer locked that this layer sets differently. */
364
+ init: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof InitFlag>>>;
365
+ /** Declarations a lower layer set that this layer sets again. */
366
+ declarations: z.ZodDefault<z.ZodArray<z.ZodObject<{
367
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
368
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
369
+ declaration: z.ZodOptional<z.ZodString>;
370
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
371
+ path: z.ZodArray<z.ZodString>;
372
+ }, z.core.$strict>>>;
373
+ }, z.core.$strict>;
374
+ export type BlueprintOverrides = z.infer<typeof BlueprintOverridesSchema>;
375
+ /** Where definitions live in the application that defines them; `<name>` is the folder. */
376
+ export declare const BLUEPRINT_DEFINITIONS_DIRECTORY = "blueprints";
377
+ export declare const BLUEPRINT_DEFINITION_FILE_NAME = "blueprint.definition.ts";
378
+ /** The exported constant a definition file declares. */
379
+ export declare const BLUEPRINT_DEFINITION_EXPORT_NAME = "blueprintDefinition";
380
+ /** `.hbs` sources beside the definition, for exported files that read a parameter. */
381
+ export declare const BLUEPRINT_TEMPLATES_DIRECTORY = "templates";
382
+ /**
383
+ * The authored blueprint definition (`blueprints/<name>/blueprint.definition.ts`, exporting
384
+ * {@link BLUEPRINT_DEFINITION_EXPORT_NAME}). It SELECTS; it never carries a value the application holds.
385
+ */
386
+ export declare const BlueprintDefinitionSchema: z.ZodObject<{
387
+ id: z.ZodString;
388
+ version: z.ZodString;
389
+ description: z.ZodString;
390
+ extends: z.ZodDefault<z.ZodArray<z.ZodObject<{
391
+ id: z.ZodString;
392
+ /** npm-style semver range the lower layer's version must satisfy. */
393
+ range: z.ZodString;
394
+ /** Values this layer binds for the lower layer's parameters; the operator is not asked for them. */
395
+ parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
396
+ }, z.core.$strict>>>;
397
+ /** Per application-shape init flag: lock or default it to the defining application's value. */
398
+ init: z.ZodDefault<z.ZodArray<z.ZodObject<{
399
+ flag: z.ZodEnum<typeof InitFlag>;
400
+ mode: z.ZodEnum<typeof BlueprintInitConstraintMode>;
401
+ }, z.core.$strict>>>;
402
+ parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
403
+ appValue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
404
+ name: z.ZodString;
405
+ description: z.ZodString;
406
+ kind: z.ZodEnum<typeof BlueprintParameterKind>;
407
+ required: z.ZodBoolean;
408
+ /** Serialized default, parsed per `kind`. Only on an optional parameter. */
409
+ default: z.ZodOptional<z.ZodString>;
410
+ /** RegExp source a STRING value must fully match. */
411
+ pattern: z.ZodOptional<z.ZodString>;
412
+ /** ENUM only: the allowed values. */
413
+ members: z.ZodOptional<z.ZodArray<z.ZodString>>;
414
+ }, z.core.$strict>>>;
415
+ include: z.ZodObject<{
416
+ /** App-relative globs of NEW files (specifications, assets, documentation, …). */
417
+ files: z.ZodDefault<z.ZodArray<z.ZodString>>;
418
+ /** Domain module directories (`shared-lib/src/modules/<dir>` and its sibling layers). */
419
+ modules: z.ZodDefault<z.ZodArray<z.ZodString>>;
420
+ /** Minion package directories (`minions/<dir>`). */
421
+ minions: z.ZodDefault<z.ZodArray<z.ZodString>>;
422
+ /** Worker package directories (`workers/<dir>`). */
423
+ workers: z.ZodDefault<z.ZodArray<z.ZodString>>;
424
+ /**
425
+ * Modules this application installed from the module registry, by module id (`acme/billing`,
426
+ * `providers/asana`): carried as references and installed by `wildo init`, never copied (#2879).
427
+ */
428
+ registryModules: z.ZodDefault<z.ZodArray<z.ZodString>>;
429
+ declarations: z.ZodDefault<z.ZodArray<z.ZodObject<{
430
+ /**
431
+ * The value as a template over the parameters, when the value depends on one. Rendered with each parameter's
432
+ * `appValue`, it must equal the defining application's value text exactly, or the pack refuses.
433
+ */
434
+ valueTemplate: z.ZodOptional<z.ZodString>;
435
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
436
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
437
+ declaration: z.ZodOptional<z.ZodString>;
438
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
439
+ path: z.ZodArray<z.ZodString>;
440
+ }, z.core.$strict>>>;
441
+ /** Barrels whose `export` lines (beyond the base's and the modules' own) the blueprint carries. */
442
+ barrelExports: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof BlueprintBarrelFile>>>;
443
+ /** Runtime dependencies, by package name, carried with the specifier each workspace manifest declares. */
444
+ dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
445
+ /** Anchor slots whose content the blueprint carries. */
446
+ slots: z.ZodDefault<z.ZodArray<z.ZodObject<{
447
+ file: z.ZodEnum<typeof BlueprintSlotFile>;
448
+ slot: z.ZodString;
449
+ }, z.core.$strict>>>;
450
+ /**
451
+ * Carry the defining application's APPLICATION LINE (#2863): `wildo blueprint pack` reads it from the defining
452
+ * application's dossier (its answer to the line question) and refuses when none is declared; `wildo init` answers
453
+ * that question for the new application, so it is not asked again. Selected, never written: the value is the
454
+ * defining application's, like every other value a blueprint carries.
455
+ */
456
+ line: z.ZodDefault<z.ZodBoolean>;
457
+ }, z.core.$strict>;
458
+ overrides: z.ZodDefault<z.ZodObject<{
459
+ /** App-relative files a lower layer wrote that this layer writes again. */
460
+ files: z.ZodDefault<z.ZodArray<z.ZodString>>;
461
+ /** Init flags a lower layer locked that this layer sets differently. */
462
+ init: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof InitFlag>>>;
463
+ /** Declarations a lower layer set that this layer sets again. */
464
+ declarations: z.ZodDefault<z.ZodArray<z.ZodObject<{
465
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
466
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
467
+ declaration: z.ZodOptional<z.ZodString>;
468
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
469
+ path: z.ZodArray<z.ZodString>;
470
+ }, z.core.$strict>>>;
471
+ }, z.core.$strict>>;
472
+ }, z.core.$strict>;
473
+ export type BlueprintDefinition = z.infer<typeof BlueprintDefinitionSchema>;
474
+ /** The authoring shape, before defaults: what a `blueprint.definition.ts` writes `satisfies` against. */
475
+ export type BlueprintDefinitionInput = z.input<typeof BlueprintDefinitionSchema>;
476
+ /** @wildo_source:part:end blueprint.definition-contract */
477
+ /** The manifest at the root of a packed blueprint, beside {@link BLUEPRINT_FILES_DIRECTORY}. */
478
+ export declare const BLUEPRINT_MANIFEST_FILE_NAME = "blueprint.json";
479
+ /** The packed files, laid out as they land in the application (`.hbs` rendered, `__param__` segments interpolated). */
480
+ export declare const BLUEPRINT_FILES_DIRECTORY = "files";
481
+ /**
482
+ * An embedded module: its directories and the registration that makes the application know it. A domain module, a
483
+ * minion or a worker. Never a PROVIDER: a provider module is one vendor's package, distributed and versioned by the
484
+ * registry, and wired by each installing application from its own declarations — copying it into a blueprint would
485
+ * freeze one application's wiring into every application made from it.
486
+ */
487
+ export declare const BlueprintEmbeddedModuleSchema: z.ZodObject<{
488
+ boundaries: z.ZodObject<{
489
+ specifications: z.ZodDefault<z.ZodArray<z.ZodString>>;
490
+ shared: z.ZodDefault<z.ZodArray<z.ZodString>>;
491
+ frontend: z.ZodDefault<z.ZodArray<z.ZodString>>;
492
+ backend: z.ZodDefault<z.ZodArray<z.ZodString>>;
493
+ minions: z.ZodDefault<z.ZodArray<z.ZodString>>;
494
+ workers: z.ZodDefault<z.ZodArray<z.ZodString>>;
495
+ providers: z.ZodDefault<z.ZodArray<z.ZodString>>;
496
+ }, z.core.$strict>;
497
+ registration: z.ZodObject<{
498
+ scenario: z.ZodEnum<typeof ModuleRegistrationScenario>;
499
+ moduleId: z.ZodString;
500
+ moduleCamel: z.ZodString;
501
+ layers: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("..").DomainModuleLayer>>>;
502
+ providerWiring: z.ZodOptional<z.ZodObject<{
503
+ backendPackage: z.ZodOptional<z.ZodString>;
504
+ backendOwners: z.ZodArray<z.ZodObject<{
505
+ serviceKey: z.ZodString;
506
+ path: z.ZodString;
507
+ }, z.core.$strict>>;
508
+ frontendPackage: z.ZodOptional<z.ZodString>;
509
+ frontendOwners: z.ZodArray<z.ZodObject<{
510
+ serviceKey: z.ZodString;
511
+ path: z.ZodString;
512
+ }, z.core.$strict>>;
513
+ augments: z.ZodOptional<z.ZodString>;
514
+ vendorPins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
515
+ heldVendorPins: z.ZodOptional<z.ZodArray<z.ZodString>>;
516
+ onlyBuiltDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
517
+ heldOnlyBuiltDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
518
+ }, z.core.$strict>>;
519
+ }, z.core.$strict>;
520
+ }, z.core.$strict>;
521
+ export type BlueprintEmbeddedModule = z.infer<typeof BlueprintEmbeddedModuleSchema>;
522
+ /**
523
+ * The packed blueprint manifest (`blueprint.json`). Compiled by `wildo blueprint pack`, read by
524
+ * `wildo init --blueprint`. Never authored.
525
+ */
526
+ export declare const BlueprintManifestSchema: z.ZodObject<{
527
+ schemaVersion: z.ZodLiteral<1>;
528
+ id: z.ZodString;
529
+ version: z.ZodString;
530
+ description: z.ZodString;
531
+ /** The framework version the defining application ran when it was packed. */
532
+ frameworkVersion: z.ZodString;
533
+ /**
534
+ * The DEFINING application's identity. Text files carrying these values have them replaced by the new
535
+ * application's own on apply — a module that imports `@<slug>/shared-lib` imports the new application's.
536
+ */
537
+ identity: z.ZodObject<{
538
+ slug: z.ZodString;
539
+ displayName: z.ZodString;
540
+ }, z.core.$strict>;
541
+ extends: z.ZodDefault<z.ZodArray<z.ZodObject<{
542
+ id: z.ZodString;
543
+ /** npm-style semver range the lower layer's version must satisfy. */
544
+ range: z.ZodString;
545
+ /** Values this layer binds for the lower layer's parameters; the operator is not asked for them. */
546
+ parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
547
+ }, z.core.$strict>>>;
548
+ init: z.ZodDefault<z.ZodArray<z.ZodObject<{
549
+ flag: z.ZodEnum<typeof InitFlag>;
550
+ mode: z.ZodEnum<typeof BlueprintInitConstraintMode>;
551
+ value: z.ZodString;
552
+ }, z.core.$strict>>>;
553
+ parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
554
+ name: z.ZodString;
555
+ description: z.ZodString;
556
+ kind: z.ZodEnum<typeof BlueprintParameterKind>;
557
+ required: z.ZodBoolean;
558
+ /** Serialized default, parsed per `kind`. Only on an optional parameter. */
559
+ default: z.ZodOptional<z.ZodString>;
560
+ /** RegExp source a STRING value must fully match. */
561
+ pattern: z.ZodOptional<z.ZodString>;
562
+ /** ENUM only: the allowed values. */
563
+ members: z.ZodOptional<z.ZodArray<z.ZodString>>;
564
+ }, z.core.$strict>>>;
565
+ modules: z.ZodDefault<z.ZodArray<z.ZodObject<{
566
+ boundaries: z.ZodObject<{
567
+ specifications: z.ZodDefault<z.ZodArray<z.ZodString>>;
568
+ shared: z.ZodDefault<z.ZodArray<z.ZodString>>;
569
+ frontend: z.ZodDefault<z.ZodArray<z.ZodString>>;
570
+ backend: z.ZodDefault<z.ZodArray<z.ZodString>>;
571
+ minions: z.ZodDefault<z.ZodArray<z.ZodString>>;
572
+ workers: z.ZodDefault<z.ZodArray<z.ZodString>>;
573
+ providers: z.ZodDefault<z.ZodArray<z.ZodString>>;
574
+ }, z.core.$strict>;
575
+ registration: z.ZodObject<{
576
+ scenario: z.ZodEnum<typeof ModuleRegistrationScenario>;
577
+ moduleId: z.ZodString;
578
+ moduleCamel: z.ZodString;
579
+ layers: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("..").DomainModuleLayer>>>;
580
+ providerWiring: z.ZodOptional<z.ZodObject<{
581
+ backendPackage: z.ZodOptional<z.ZodString>;
582
+ backendOwners: z.ZodArray<z.ZodObject<{
583
+ serviceKey: z.ZodString;
584
+ path: z.ZodString;
585
+ }, z.core.$strict>>;
586
+ frontendPackage: z.ZodOptional<z.ZodString>;
587
+ frontendOwners: z.ZodArray<z.ZodObject<{
588
+ serviceKey: z.ZodString;
589
+ path: z.ZodString;
590
+ }, z.core.$strict>>;
591
+ augments: z.ZodOptional<z.ZodString>;
592
+ vendorPins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
593
+ heldVendorPins: z.ZodOptional<z.ZodArray<z.ZodString>>;
594
+ onlyBuiltDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
595
+ heldOnlyBuiltDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
596
+ }, z.core.$strict>>;
597
+ }, z.core.$strict>;
598
+ }, z.core.$strict>>>;
599
+ /** Registry modules installed by `wildo init` before this layer's own content, in order (#2879). */
600
+ moduleReferences: z.ZodDefault<z.ZodArray<z.ZodObject<{
601
+ domain: z.ZodString;
602
+ moduleId: z.ZodString;
603
+ range: z.ZodString;
604
+ }, z.core.$strict>>>;
605
+ /**
606
+ * The application line this blueprint makes (#2863): `wildo init` records it as the new application's answer to
607
+ * the line question. A value of `ApplicationLine` from `@wildo-ai/saas-specifications/application-creation`, which
608
+ * this contracts package cannot import (it does not depend on saas-specifications, and must not: that package sits
609
+ * above it). It is a string here and checked against that vocabulary by the CLI, which depends on both, when it
610
+ * packs a blueprint and when it reads one. A stack of layers names at most one line.
611
+ */
612
+ line: z.ZodOptional<z.ZodString>;
613
+ declarationOperations: z.ZodDefault<z.ZodArray<z.ZodObject<{
614
+ /** The value's expression text, verbatim; may read `{{parameter}}`. */
615
+ valueText: z.ZodString;
616
+ /** Import statements the value needs that the base file does not have (`import { X } from 'pkg';`). */
617
+ imports: z.ZodDefault<z.ZodArray<z.ZodString>>;
618
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
619
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
620
+ declaration: z.ZodOptional<z.ZodString>;
621
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
622
+ path: z.ZodArray<z.ZodString>;
623
+ }, z.core.$strict>>>;
624
+ barrelExports: z.ZodDefault<z.ZodArray<z.ZodObject<{
625
+ file: z.ZodEnum<typeof BlueprintBarrelFile>;
626
+ line: z.ZodString;
627
+ }, z.core.$strict>>>;
628
+ dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
629
+ manifest: z.ZodEnum<typeof BlueprintWorkspaceManifest>;
630
+ name: z.ZodString;
631
+ specifier: z.ZodString;
632
+ }, z.core.$strict>>>;
633
+ slotContributions: z.ZodDefault<z.ZodArray<z.ZodObject<{
634
+ file: z.ZodEnum<typeof BlueprintSlotFile>;
635
+ slot: z.ZodString;
636
+ /** The text this layer adds inside the slot, without its markers; may read `{{parameter}}`. */
637
+ body: z.ZodString;
638
+ }, z.core.$strict>>>;
639
+ overrides: z.ZodDefault<z.ZodObject<{
640
+ /** App-relative files a lower layer wrote that this layer writes again. */
641
+ files: z.ZodDefault<z.ZodArray<z.ZodString>>;
642
+ /** Init flags a lower layer locked that this layer sets differently. */
643
+ init: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof InitFlag>>>;
644
+ /** Declarations a lower layer set that this layer sets again. */
645
+ declarations: z.ZodDefault<z.ZodArray<z.ZodObject<{
646
+ file: z.ZodEnum<typeof BlueprintDeclarationFile>;
647
+ /** A top-level variable of the file (`CUSTOM_ROLES_CONFIGURATION`). Absent: start at the file's `export default`. */
648
+ declaration: z.ZodOptional<z.ZodString>;
649
+ /** Property segments below the start; empty only with `declaration`, to set the variable as a whole. */
650
+ path: z.ZodArray<z.ZodString>;
651
+ }, z.core.$strict>>>;
652
+ }, z.core.$strict>>;
653
+ }, z.core.$strict>;
654
+ export type BlueprintManifest = z.infer<typeof BlueprintManifestSchema>;
655
+ /**
656
+ * Whether `appRelativePath` (POSIX, relative to the application root) may be carried by a blueprint, in its
657
+ * `files/` tree or as a module file. Checked when a blueprint is packed AND when it is applied, so a hand-made
658
+ * artifact cannot plant what pack would never have written.
659
+ *
660
+ * On top of the module rule (no dot segment — `.git`, `.env`, `.wildo-saas`, traversal — and no `node_modules`):
661
+ * - nothing under `blueprints/`: a definition lives only in the application that defines it (decision D5);
662
+ * - no `dist/` build output;
663
+ * - no secret-shaped file or directory (`secrets.json`, `secrets/`, `*.pem`, `*.key`, …), at any depth.
664
+ *
665
+ * Names compare case-insensitively: on a case-insensitive filesystem (macOS, Windows) `Node_Modules/` and
666
+ * `Blueprints/` ARE those directories.
667
+ */
668
+ export declare function isBlueprintArtifactPathAllowed(appRelativePath: string): boolean;
669
+ /** The `wildo-saas.lock.json` section `wildo init` records how the application was scaffolded in. */
670
+ export declare const SCAFFOLD_LOCK_SECTION_KEY = "scaffold";
671
+ /**
672
+ * `sections.scaffold`: the application-shape init flags the application was created with, and the blueprint
673
+ * layers applied on its base, in order. Written by every `wildo init`, with or without a blueprint, because an export
674
+ * rebuilds the defining application's base from it.
675
+ *
676
+ * It records no file hashes and no digests on purpose: an init-time apply has nothing to upgrade or remove (D2), and
677
+ * git already holds what each layer wrote — one commit per layer.
678
+ */
679
+ export declare const ScaffoldLockSectionSchema: z.ZodObject<{
680
+ /** Only APPLICATION_SHAPE flags: a machine or identity value is not how the application was shaped. */
681
+ applicationShape: z.ZodDefault<z.ZodRecord<z.ZodEnum<typeof InitFlag> & z.core.$partial, z.ZodString>>;
682
+ blueprints: z.ZodDefault<z.ZodArray<z.ZodObject<{
683
+ id: z.ZodString;
684
+ version: z.ZodString;
685
+ parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
686
+ }, z.core.$strict>>>;
687
+ }, z.core.$strict>;
688
+ export type ScaffoldLockSection = z.infer<typeof ScaffoldLockSectionSchema>;
689
+ //# sourceMappingURL=blueprint.schemas.d.ts.map