@stndrds/schema 1.0.0-alpha.171 → 1.0.0-alpha.173

package/dist/{chunk-SS2NR6DH.mjs → chunk-U4JC7P6D.mjs}

@@ -96,7 +96,13 @@ var relationConfigSchema = baseConfigSchema.extend({
   targets: z.array(relationTargetSchema).min(1),
   cardinality: z.enum(["one", "many"]),
   minItems: z.number().int().min(0).optional(),
-  maxItems: z.number().int().min(1).optional()
+  maxItems: z.number().int().min(1).optional(),
+  /**
+   * PropertySchema declared via `.qualifyWith()`. Pass-through; structural
+   * validation happens at the builder level — see `propertySchemaPassthrough`
+   * comment further below for the rationale.
+   */
+  properties: z.object({ definitions: z.array(z.record(z.string(), z.unknown())) }).passthrough().optional()
 });
 var ratingConfigSchema = baseConfigSchema.extend({
   max: z.number().int().min(1).optional(),
@@ -139,10 +145,33 @@ var rollupConfigSchema = baseConfigSchema.extend({
     })
   ).optional()
 });
+var propertySchemaPassthrough = z.object({ definitions: z.array(z.record(z.string(), z.unknown())) }).passthrough();
+var attributePassthrough = z.record(z.string(), z.unknown());
+var documentSlotConfigPassthrough = z.object({
+  name: z.string(),
+  label: z.string().optional(),
+  description: z.string().optional(),
+  required: z.boolean().optional(),
+  acceptedMimeTypes: z.array(z.string()).optional(),
+  maxSizeBytes: z.number().optional()
+}).passthrough();
 var documentConfigSchema = baseConfigSchema.extend({
   multiple: z.boolean().optional(),
   maxDocuments: z.number().int().min(1).optional(),
-  autoProcess: z.boolean().optional()
+  autoProcess: z.boolean().optional(),
+  /**
+   * PropertySchema declared via `.qualifyWith()` on a document attribute.
+   * Drives hydration into `[{id, props}]` shape and write-time validation.
+   */
+  properties: propertySchemaPassthrough.optional(),
+  /**
+   * Legacy per-document attribute definitions via `.attribute(...)`.
+   * Kept for backward compatibility; the builder also mirrors property-typed
+   * entries into `properties.definitions`.
+   */
+  attributes: z.array(attributePassthrough).optional(),
+  /** File slots declared via `.slots(...)`. */
+  slots: z.array(documentSlotConfigPassthrough).optional()
 });
 var attributeConfigSchemas = {
   text: textConfigSchema,

package/dist/{chunk-V6DE3MXC.js → chunk-YQROI4IE.js}

@@ -98,7 +98,13 @@ var relationConfigSchema = baseConfigSchema.extend({
   targets: zod.z.array(relationTargetSchema).min(1),
   cardinality: zod.z.enum(["one", "many"]),
   minItems: zod.z.number().int().min(0).optional(),
-  maxItems: zod.z.number().int().min(1).optional()
+  maxItems: zod.z.number().int().min(1).optional(),
+  /**
+   * PropertySchema declared via `.qualifyWith()`. Pass-through; structural
+   * validation happens at the builder level — see `propertySchemaPassthrough`
+   * comment further below for the rationale.
+   */
+  properties: zod.z.object({ definitions: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())) }).passthrough().optional()
 });
 var ratingConfigSchema = baseConfigSchema.extend({
   max: zod.z.number().int().min(1).optional(),
@@ -141,10 +147,33 @@ var rollupConfigSchema = baseConfigSchema.extend({
     })
   ).optional()
 });
+var propertySchemaPassthrough = zod.z.object({ definitions: zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown())) }).passthrough();
+var attributePassthrough = zod.z.record(zod.z.string(), zod.z.unknown());
+var documentSlotConfigPassthrough = zod.z.object({
+  name: zod.z.string(),
+  label: zod.z.string().optional(),
+  description: zod.z.string().optional(),
+  required: zod.z.boolean().optional(),
+  acceptedMimeTypes: zod.z.array(zod.z.string()).optional(),
+  maxSizeBytes: zod.z.number().optional()
+}).passthrough();
 var documentConfigSchema = baseConfigSchema.extend({
   multiple: zod.z.boolean().optional(),
   maxDocuments: zod.z.number().int().min(1).optional(),
-  autoProcess: zod.z.boolean().optional()
+  autoProcess: zod.z.boolean().optional(),
+  /**
+   * PropertySchema declared via `.qualifyWith()` on a document attribute.
+   * Drives hydration into `[{id, props}]` shape and write-time validation.
+   */
+  properties: propertySchemaPassthrough.optional(),
+  /**
+   * Legacy per-document attribute definitions via `.attribute(...)`.
+   * Kept for backward compatibility; the builder also mirrors property-typed
+   * entries into `properties.definitions`.
+   */
+  attributes: zod.z.array(attributePassthrough).optional(),
+  /** File slots declared via `.slots(...)`. */
+  slots: zod.z.array(documentSlotConfigPassthrough).optional()
 });
 var attributeConfigSchemas = {
   text: textConfigSchema,

package/dist/index.d.mts

@@ -4276,8 +4276,17 @@ declare class DocumentAttributeBuilder<TName extends string, TRequired extends b
      */
     slots(configs: DocumentSlotConfig[]): this;
     /**
-     * Add a child attribute definition for per-document metadata.
-     * Reuses existing attribute builders directly.
+     * Add a child attribute that qualifies the record→document edge.
+     *
+     * Equivalent to `.qualifyWith(builder)` for a single attribute, with the
+     * difference that the accepted type is broader (`Attribute`) and the
+     * accumulation is mutating rather than type-tracking. When the produced
+     * attribute is one of the `ALLOWED_PROPERTY_TYPES`, it is also pushed
+     * onto `attribute.properties.definitions`, so hydration and validation
+     * treat the document as qualified — same effect as `.qualifyWith()`.
+     *
+     * Both `attribute.attributes` and `attribute.properties` are populated to
+     * keep backwards compatibility with consumers that read either field.
      *
      * @example
      * document({ name: "invoices" })

package/dist/index.d.ts

@@ -4276,8 +4276,17 @@ declare class DocumentAttributeBuilder<TName extends string, TRequired extends b
      */
     slots(configs: DocumentSlotConfig[]): this;
     /**
-     * Add a child attribute definition for per-document metadata.
-     * Reuses existing attribute builders directly.
+     * Add a child attribute that qualifies the record→document edge.
+     *
+     * Equivalent to `.qualifyWith(builder)` for a single attribute, with the
+     * difference that the accepted type is broader (`Attribute`) and the
+     * accumulation is mutating rather than type-tracking. When the produced
+     * attribute is one of the `ALLOWED_PROPERTY_TYPES`, it is also pushed
+     * onto `attribute.properties.definitions`, so hydration and validation
+     * treat the document as qualified — same effect as `.qualifyWith()`.
+     *
+     * Both `attribute.attributes` and `attribute.properties` are populated to
+     * keep backwards compatibility with consumers that read either field.
      *
      * @example
      * document({ name: "invoices" })

package/dist/index.js

@@ -2,7 +2,7 @@
 
 var chunkFRCDMQER_js = require('./chunk-FRCDMQER.js');
 require('./chunk-PGERPYDR.js');
-var chunkV6DE3MXC_js = require('./chunk-V6DE3MXC.js');
+var chunkYQROI4IE_js = require('./chunk-YQROI4IE.js');
 var chunk64R5X3DF_js = require('./chunk-64R5X3DF.js');
 require('./chunk-MAKSIK3P.js');
 require('./chunk-J5HRK3WD.js');
@@ -2180,8 +2180,17 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
     return this;
   }
   /**
-   * Add a child attribute definition for per-document metadata.
-   * Reuses existing attribute builders directly.
+   * Add a child attribute that qualifies the record→document edge.
+   *
+   * Equivalent to `.qualifyWith(builder)` for a single attribute, with the
+   * difference that the accepted type is broader (`Attribute`) and the
+   * accumulation is mutating rather than type-tracking. When the produced
+   * attribute is one of the `ALLOWED_PROPERTY_TYPES`, it is also pushed
+   * onto `attribute.properties.definitions`, so hydration and validation
+   * treat the document as qualified — same effect as `.qualifyWith()`.
+   *
+   * Both `attribute.attributes` and `attribute.properties` are populated to
+   * keep backwards compatibility with consumers that read either field.
    *
    * @example
    * document({ name: "invoices" })
@@ -2189,10 +2198,17 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
    *   .attribute(select({ name: "status", label: "Statut" }).options([...]))
    */
   attribute(builder) {
-    if (!this.attr.attributes) {
-      this.attr.attributes = [];
+    const built = builder.build();
+    if (!this.attr.attributes) this.attr.attributes = [];
+    this.attr.attributes = [...this.attr.attributes, built];
+    if (ALLOWED_PROPERTY_TYPES.includes(built.type)) {
+      const props = this.attr.properties ?? {
+        definitions: []
+      };
+      this.attr.properties = {
+        definitions: [...props.definitions, built]
+      };
     }
-    this.attr.attributes = [...this.attr.attributes, builder.build()];
     return this;
   }
   /**
@@ -5593,7 +5609,7 @@ Object.defineProperty(exports, "indexBy", {
 });
 Object.defineProperty(exports, "parseAttributeConfig", {
   enumerable: true,
-  get: function () { return chunkV6DE3MXC_js.parseAttributeConfig; }
+  get: function () { return chunkYQROI4IE_js.parseAttributeConfig; }
 });
 Object.defineProperty(exports, "computeRecordStatus", {
   enumerable: true,

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { generateId } from './chunk-QY6QFRRV.mjs';
 export { asTenantId, asUserId, deepEqual, generateId, indexBy } from './chunk-QY6QFRRV.mjs';
 import './chunk-SP3PNHYF.mjs';
-export { parseAttributeConfig } from './chunk-SS2NR6DH.mjs';
+export { parseAttributeConfig } from './chunk-U4JC7P6D.mjs';
 import { createObjectValidator, createAttributeValidator } from './chunk-6JEQE4IP.mjs';
 export { computeRecordStatus, createFormAttributeValidator, validateDraft, validateDraftOrThrow, validateObject, validateObjectOrThrow } from './chunk-6JEQE4IP.mjs';
 import './chunk-TMYBEXBT.mjs';
@@ -2176,8 +2176,17 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
     return this;
   }
   /**
-   * Add a child attribute definition for per-document metadata.
-   * Reuses existing attribute builders directly.
+   * Add a child attribute that qualifies the record→document edge.
+   *
+   * Equivalent to `.qualifyWith(builder)` for a single attribute, with the
+   * difference that the accepted type is broader (`Attribute`) and the
+   * accumulation is mutating rather than type-tracking. When the produced
+   * attribute is one of the `ALLOWED_PROPERTY_TYPES`, it is also pushed
+   * onto `attribute.properties.definitions`, so hydration and validation
+   * treat the document as qualified — same effect as `.qualifyWith()`.
+   *
+   * Both `attribute.attributes` and `attribute.properties` are populated to
+   * keep backwards compatibility with consumers that read either field.
    *
    * @example
    * document({ name: "invoices" })
@@ -2185,10 +2194,17 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
    *   .attribute(select({ name: "status", label: "Statut" }).options([...]))
    */
   attribute(builder) {
-    if (!this.attr.attributes) {
-      this.attr.attributes = [];
+    const built = builder.build();
+    if (!this.attr.attributes) this.attr.attributes = [];
+    this.attr.attributes = [...this.attr.attributes, built];
+    if (ALLOWED_PROPERTY_TYPES.includes(built.type)) {
+      const props = this.attr.properties ?? {
+        definitions: []
+      };
+      this.attr.properties = {
+        definitions: [...props.definitions, built]
+      };
     }
-    this.attr.attributes = [...this.attr.attributes, builder.build()];
     return this;
   }
   /**

package/dist/validation/all.js

@@ -1,7 +1,7 @@
 'use strict';
 
 require('../chunk-PGERPYDR.js');
-var chunkV6DE3MXC_js = require('../chunk-V6DE3MXC.js');
+var chunkYQROI4IE_js = require('../chunk-YQROI4IE.js');
 var chunk64R5X3DF_js = require('../chunk-64R5X3DF.js');
 require('../chunk-MAKSIK3P.js');
 require('../chunk-J5HRK3WD.js');
@@ -24,7 +24,7 @@ var chunkT225DB55_js = require('../chunk-T225DB55.js');
 
 Object.defineProperty(exports, "parseAttributeConfig", {
   enumerable: true,
-  get: function () { return chunkV6DE3MXC_js.parseAttributeConfig; }
+  get: function () { return chunkYQROI4IE_js.parseAttributeConfig; }
 });
 Object.defineProperty(exports, "computeRecordStatus", {
   enumerable: true,

package/dist/validation/all.mjs

@@ -1,5 +1,5 @@
 import '../chunk-SP3PNHYF.mjs';
-export { parseAttributeConfig } from '../chunk-SS2NR6DH.mjs';
+export { parseAttributeConfig } from '../chunk-U4JC7P6D.mjs';
 export { computeRecordStatus, createFormAttributeValidator, validateDraft, validateDraftOrThrow, validateObject, validateObjectOrThrow } from '../chunk-6JEQE4IP.mjs';
 import '../chunk-TMYBEXBT.mjs';
 import '../chunk-4KRLCWJM.mjs';

package/dist/validation/config/index.js

@@ -1,18 +1,18 @@
 'use strict';
 
-var chunkV6DE3MXC_js = require('../../chunk-V6DE3MXC.js');
+var chunkYQROI4IE_js = require('../../chunk-YQROI4IE.js');
 
 
 
 Object.defineProperty(exports, "attributeConfigSchemas", {
   enumerable: true,
-  get: function () { return chunkV6DE3MXC_js.attributeConfigSchemas; }
+  get: function () { return chunkYQROI4IE_js.attributeConfigSchemas; }
 });
 Object.defineProperty(exports, "getAttributeConfigSchema", {
   enumerable: true,
-  get: function () { return chunkV6DE3MXC_js.getAttributeConfigSchema; }
+  get: function () { return chunkYQROI4IE_js.getAttributeConfigSchema; }
 });
 Object.defineProperty(exports, "parseAttributeConfig", {
   enumerable: true,
-  get: function () { return chunkV6DE3MXC_js.parseAttributeConfig; }
+  get: function () { return chunkYQROI4IE_js.parseAttributeConfig; }
 });

package/dist/validation/config/index.mjs

@@ -1 +1 @@
-export { attributeConfigSchemas, getAttributeConfigSchema, parseAttributeConfig } from '../../chunk-SS2NR6DH.mjs';
+export { attributeConfigSchemas, getAttributeConfigSchema, parseAttributeConfig } from '../../chunk-U4JC7P6D.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/schema",
-  "version": "1.0.0-alpha.171",
+  "version": "1.0.0-alpha.173",
   "description": "Standard schema definitions and utilities",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -131,7 +131,7 @@
     "expr-eval": "^2.0.2",
     "libphonenumber-js": "^1.12.31",
     "zod": "^4.2.1",
-    "@stndrds/constants": "1.0.0-alpha.171"
+    "@stndrds/constants": "1.0.0-alpha.173"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",