buildx-cli 1.8.30 → 1.8.32

package/README.md

@@ -466,6 +466,10 @@ Writes:
 - `collections.manifest.json`
 - `SCHEMA_AS_CODE.md` (generated usage guide for human/AI collaborators)
 
+Source-of-truth behavior:
+- `collections.json` is pulled from remote `/project/:project_id/collections` payload directly (with only lightweight normalization for internal keys).
+- CLI does not reconstruct `collections.json` from `types.ts` during `schema:pull`.
+
 System-managed fields:
 - when `timestamps: true`, pulled `types.ts` includes `createdAt/updatedAt` (`BxDateTime`)
 - when `auditable: true`, pulled `types.ts` includes `createdBy/updatedBy` (`BxAuth`)
@@ -542,10 +546,25 @@ Field annotations (JSDoc in `types.ts`) are supported:
 - `@bx.required` or `@bx.required false`
 - `@bx.ref <collection_id_or_enum_key>`
 - `@bx.choices value1:Label 1|value2:Label 2` (for `Choices`/`MultipleChoices`)
+- `@bx.type <SchemaType>` (force schema field type, useful for unions)
+- `@bx.default <json>`
+- `@bx.format <json_or_string>`
+- `@bx.validate <json_or_string>`
+- `@bx.props <json-object>` (merge custom keys into `propertiesScheme`)
 
 System-managed fields:
 - `createdAt`, `updatedAt`, `createdBy`, `updatedBy` in `types.ts` are ignored by convert output and never synced back
 
+Embedded object fidelity:
+- inline object/list members are restored as structured `children` (not collapsed to `item: Text`).
+- nested relation refs are normalized to collection IDs (for example `Partial<Workflows>` -> `workflows`).
+- when merging with base `collections.json`, nested child metadata is preserved by child name when possible.
+- dynamic object/list fallback stays as `BxObject` / `BxList` at type layer and `Object` / `List` in collection schema layer.
+- temporary compatibility: `string[]` / `BxText[]` converts to `MultipleChoices` instead of generic `List`.
+- `schema:pull` annotation style:
+  - emits multiline JSDoc tags for readability
+  - emits `@bx.type` only for lossy relation kinds (`ReverseReference`, `ReverseReferences`, `Virtual`)
+
 Example:
 ```ts
 export type Employees = {

package/dist/README.md

@@ -466,6 +466,10 @@ Writes:
 - `collections.manifest.json`
 - `SCHEMA_AS_CODE.md` (generated usage guide for human/AI collaborators)
 
+Source-of-truth behavior:
+- `collections.json` is pulled from remote `/project/:project_id/collections` payload directly (with only lightweight normalization for internal keys).
+- CLI does not reconstruct `collections.json` from `types.ts` during `schema:pull`.
+
 System-managed fields:
 - when `timestamps: true`, pulled `types.ts` includes `createdAt/updatedAt` (`BxDateTime`)
 - when `auditable: true`, pulled `types.ts` includes `createdBy/updatedBy` (`BxAuth`)
@@ -542,10 +546,25 @@ Field annotations (JSDoc in `types.ts`) are supported:
 - `@bx.required` or `@bx.required false`
 - `@bx.ref <collection_id_or_enum_key>`
 - `@bx.choices value1:Label 1|value2:Label 2` (for `Choices`/`MultipleChoices`)
+- `@bx.type <SchemaType>` (force schema field type, useful for unions)
+- `@bx.default <json>`
+- `@bx.format <json_or_string>`
+- `@bx.validate <json_or_string>`
+- `@bx.props <json-object>` (merge custom keys into `propertiesScheme`)
 
 System-managed fields:
 - `createdAt`, `updatedAt`, `createdBy`, `updatedBy` in `types.ts` are ignored by convert output and never synced back
 
+Embedded object fidelity:
+- inline object/list members are restored as structured `children` (not collapsed to `item: Text`).
+- nested relation refs are normalized to collection IDs (for example `Partial<Workflows>` -> `workflows`).
+- when merging with base `collections.json`, nested child metadata is preserved by child name when possible.
+- dynamic object/list fallback stays as `BxObject` / `BxList` at type layer and `Object` / `List` in collection schema layer.
+- temporary compatibility: `string[]` / `BxText[]` converts to `MultipleChoices` instead of generic `List`.
+- `schema:pull` annotation style:
+  - emits multiline JSDoc tags for readability
+  - emits `@bx.type` only for lossy relation kinds (`ReverseReference`, `ReverseReferences`, `Virtual`)
+
 Example:
 ```ts
 export type Employees = {