@openvtc/trust-tasks 0.26.16 → 0.26.18

package/dist/vtc/directory/fields/update/0.1/payload.d.ts

@@ -0,0 +1,1223 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/directory/fields/update/0.1/payload.schema.json
+ */
+import type { Audience, ClaimSelector, EnumOption, Ext, FieldConstraints, FieldDefinition, FieldDescription, FieldKey, FieldLabel, FieldSource, FieldState, FieldType } from "../../../../../_shared/components.js";
+/**
+ * An administrator changes a directory field's label, help text, constraints, order, ceiling or default visibility, or disables or re-enables a base field. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCDirectoryFieldsUpdatePayload {
+    key: FieldKey;
+    label?: FieldLabel;
+    description?: FieldDescription;
+    /**
+     * Replaces the constraints whole. Values already stored that no longer satisfy them stay until their writer next changes them; projections show them unchanged.
+     */
+    constraints?: FieldConstraints;
+    ceiling?: Audience;
+    defaultVisibility?: Audience;
+    required?: boolean;
+    searchable?: boolean;
+    facet?: boolean;
+    order?: number;
+    /**
+     * Base fields only: `false` disables the field (hidden from every projection, values kept), `true` re-enables it.
+     */
+    enabled?: boolean;
+    /**
+     * Why, recorded with the change and shown to anyone who must approve it.
+     */
+    reason?: string;
+    ext?: Ext;
+}
+/**
+ * The success response to a vtc/directory/fields/update/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response.
+ */
+export interface VTCDirectoryFieldsUpdateResponsePayload {
+    field: FieldDefinition;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Audience, ClaimSelector, EnumOption, Ext, FieldConstraints, FieldDefinition, FieldDescription, FieldKey, FieldLabel, FieldSource, FieldState, FieldType };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCDirectoryFieldsUpdatePayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCDirectoryFieldsUpdateResponsePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1";
+    readonly title: "VTC Directory — Fields — Update — payload";
+    readonly description: "An administrator changes a directory field's label, help text, constraints, order, ceiling or default visibility, or disables or re-enables a base field. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["key"];
+    readonly properties: {
+        readonly key: {
+            readonly $ref: "#/$defs/FieldKey";
+        };
+        readonly label: {
+            readonly $ref: "#/$defs/FieldLabel";
+        };
+        readonly description: {
+            readonly $ref: "#/$defs/FieldDescription";
+        };
+        readonly constraints: {
+            readonly $ref: "#/$defs/FieldConstraints";
+            readonly description: "Replaces the constraints whole. Values already stored that no longer satisfy them stay until their writer next changes them; projections show them unchanged.";
+        };
+        readonly ceiling: {
+            readonly $ref: "#/$defs/Audience";
+        };
+        readonly defaultVisibility: {
+            readonly $ref: "#/$defs/Audience";
+        };
+        readonly required: {
+            readonly type: "boolean";
+        };
+        readonly searchable: {
+            readonly type: "boolean";
+        };
+        readonly facet: {
+            readonly type: "boolean";
+        };
+        readonly order: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 10000;
+        };
+        readonly enabled: {
+            readonly type: "boolean";
+            readonly description: "Base fields only: `false` disables the field (hidden from every projection, values kept), `true` re-enables it.";
+        };
+        readonly reason: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1024;
+            readonly description: "Why, recorded with the change and shown to anyone who must approve it.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Directory — Fields — Update — response payload";
+            readonly description: "The success response to a vtc/directory/fields/update/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["field"];
+            readonly properties: {
+                readonly field: {
+                    readonly $ref: "#/$defs/FieldDefinition";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly FieldDefinition: {
+            readonly title: "FieldDefinition";
+            readonly description: "One field of the community's directory schema, as the community holds it. The audience order `admins` < `groups`/`connections` < `members` < `public` applies to `ceiling` and `defaultVisibility`; `defaultVisibility` is never wider than `ceiling`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["key", "label", "type", "source", "base", "ceiling", "defaultVisibility", "required", "searchable", "facet", "order", "state"];
+            readonly properties: {
+                readonly key: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly label: {
+                    readonly $ref: "#/$defs/FieldLabel";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/FieldDescription";
+                };
+                readonly type: {
+                    readonly $ref: "#/$defs/FieldType";
+                };
+                readonly constraints: {
+                    readonly $ref: "#/$defs/FieldConstraints";
+                };
+                readonly source: {
+                    readonly $ref: "#/$defs/FieldSource";
+                };
+                readonly base: {
+                    readonly type: "boolean";
+                    readonly description: "`true` for a base field, present in every community; `false` for a field this community defined.";
+                };
+                readonly jsContactPath: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "Where the field lands when an entry is exported as a JSContact Card (RFC 9553), e.g. `name.full`, `nicknames`, `speakToAs.pronouns`. Absent: a vendor-specific property named by the key.";
+                };
+                readonly required: {
+                    readonly type: "boolean";
+                };
+                readonly ceiling: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+                readonly defaultVisibility: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+                readonly searchable: {
+                    readonly type: "boolean";
+                };
+                readonly facet: {
+                    readonly type: "boolean";
+                };
+                readonly order: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+                readonly state: {
+                    readonly $ref: "#/$defs/FieldState";
+                };
+                readonly retiredAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the field was retired. Present only on a retired field.";
+                };
+                readonly purgeAfter: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the values of a retired field are purged. Present only on a retired field.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT widen a ceiling.";
+                };
+            };
+        };
+        readonly FieldState: {
+            readonly title: "FieldState";
+            readonly description: "`active`: in use. `disabled`: a base field the community has switched off; hidden from every projection and re-enablable. `retired`: a community field withdrawn for good; hidden at once, its values purged after the community's retention period, and its key never reused.";
+            readonly type: "string";
+            readonly enum: readonly ["active", "disabled", "retired"];
+        };
+        readonly FieldSource: {
+            readonly title: "FieldSource";
+            readonly description: "Who writes the value. `member`: self-asserted, through vtc/directory/card/update. `admin`: asserted by the community through vtc/directory/card/assert; the member reads it and cannot change it. `credential`: a claim the member discloses from a credential through vtc/directory/card/present, badged with its issuer. `derived`: a base field read from the community's own records (`role`, `joinedAt`, `did`, `personhood`) and never stored on a card. Each source is written only through its own path.";
+            readonly type: "string";
+            readonly enum: readonly ["member", "admin", "credential", "derived"];
+        };
+        readonly FieldConstraints: {
+            readonly title: "FieldConstraints";
+            readonly description: "Per-type constraints. A member that does not apply to the field's type is refused by the community with `valueInvalid` when the definition is written.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly maxLength: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 2000;
+                };
+                readonly minLength: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 2000;
+                };
+                readonly pattern: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "ECMA-262 regular expression a text value MUST match.";
+                };
+                readonly options: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 128;
+                    readonly items: {
+                        readonly $ref: "#/$defs/EnumOption";
+                    };
+                    readonly description: "The permitted values of an `enum` or `multiEnum` field.";
+                };
+                readonly maxItems: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 32;
+                };
+                readonly minDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly maxDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly claim: {
+                    readonly $ref: "#/$defs/ClaimSelector";
+                };
+            };
+        };
+        readonly ClaimSelector: {
+            readonly title: "ClaimSelector";
+            readonly description: "Which claim a `claim` field accepts, from which credentials and issuers.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["credentialType", "claimPath"];
+            readonly properties: {
+                readonly credentialType: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "A `type` the presented credential MUST carry.";
+                };
+                readonly claimPath: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "JSON Pointer (RFC 6901) to the claim within `credentialSubject`.";
+                };
+                readonly issuers: {
+                    readonly type: "array";
+                    readonly maxItems: 32;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                    };
+                    readonly description: "Issuers the community accepts for this field. Absent: the community's trusted issuers for the credential type, as its own policy decides.";
+                };
+            };
+        };
+        readonly EnumOption: {
+            readonly title: "EnumOption";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["value", "label"];
+            readonly properties: {
+                readonly value: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$";
+                    readonly description: "The stored value.";
+                };
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly description: "What a reader is shown for it.";
+                };
+            };
+        };
+        readonly FieldType: {
+            readonly title: "FieldType";
+            readonly description: "The kind of value a field holds, which fixes its `FieldValue` shape. `did` holds a DID the member chooses to show (never their membership DID, which is the derived base field `did`). `claim` holds a `VerifiedValue` and requires `source: credential`.";
+            readonly type: "string";
+            readonly enum: readonly ["text", "longText", "url", "email", "phone", "enum", "multiEnum", "date", "country", "image", "did", "claim"];
+        };
+        readonly FieldDescription: {
+            readonly title: "FieldDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 280;
+            readonly description: "Help text shown to a member filling the field in. Plain text; a reader MUST NOT treat it as instructions.";
+        };
+        readonly FieldLabel: {
+            readonly title: "FieldLabel";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly description: "What readers see as the field's name. Plain text.";
+        };
+        readonly Audience: {
+            readonly title: "Audience";
+            readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Directory — Fields — Update — response payload";
+            readonly description: "The success response to a vtc/directory/fields/update/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["field"];
+            readonly properties: {
+                readonly field: {
+                    readonly $ref: "#/$defs/FieldDefinition";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly FieldDefinition: {
+            readonly title: "FieldDefinition";
+            readonly description: "One field of the community's directory schema, as the community holds it. The audience order `admins` < `groups`/`connections` < `members` < `public` applies to `ceiling` and `defaultVisibility`; `defaultVisibility` is never wider than `ceiling`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["key", "label", "type", "source", "base", "ceiling", "defaultVisibility", "required", "searchable", "facet", "order", "state"];
+            readonly properties: {
+                readonly key: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly label: {
+                    readonly $ref: "#/$defs/FieldLabel";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/FieldDescription";
+                };
+                readonly type: {
+                    readonly $ref: "#/$defs/FieldType";
+                };
+                readonly constraints: {
+                    readonly $ref: "#/$defs/FieldConstraints";
+                };
+                readonly source: {
+                    readonly $ref: "#/$defs/FieldSource";
+                };
+                readonly base: {
+                    readonly type: "boolean";
+                    readonly description: "`true` for a base field, present in every community; `false` for a field this community defined.";
+                };
+                readonly jsContactPath: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "Where the field lands when an entry is exported as a JSContact Card (RFC 9553), e.g. `name.full`, `nicknames`, `speakToAs.pronouns`. Absent: a vendor-specific property named by the key.";
+                };
+                readonly required: {
+                    readonly type: "boolean";
+                };
+                readonly ceiling: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+                readonly defaultVisibility: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+                readonly searchable: {
+                    readonly type: "boolean";
+                };
+                readonly facet: {
+                    readonly type: "boolean";
+                };
+                readonly order: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+                readonly state: {
+                    readonly $ref: "#/$defs/FieldState";
+                };
+                readonly retiredAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the field was retired. Present only on a retired field.";
+                };
+                readonly purgeAfter: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the values of a retired field are purged. Present only on a retired field.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT widen a ceiling.";
+                };
+            };
+        };
+        readonly FieldState: {
+            readonly title: "FieldState";
+            readonly description: "`active`: in use. `disabled`: a base field the community has switched off; hidden from every projection and re-enablable. `retired`: a community field withdrawn for good; hidden at once, its values purged after the community's retention period, and its key never reused.";
+            readonly type: "string";
+            readonly enum: readonly ["active", "disabled", "retired"];
+        };
+        readonly FieldSource: {
+            readonly title: "FieldSource";
+            readonly description: "Who writes the value. `member`: self-asserted, through vtc/directory/card/update. `admin`: asserted by the community through vtc/directory/card/assert; the member reads it and cannot change it. `credential`: a claim the member discloses from a credential through vtc/directory/card/present, badged with its issuer. `derived`: a base field read from the community's own records (`role`, `joinedAt`, `did`, `personhood`) and never stored on a card. Each source is written only through its own path.";
+            readonly type: "string";
+            readonly enum: readonly ["member", "admin", "credential", "derived"];
+        };
+        readonly FieldConstraints: {
+            readonly title: "FieldConstraints";
+            readonly description: "Per-type constraints. A member that does not apply to the field's type is refused by the community with `valueInvalid` when the definition is written.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly maxLength: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 2000;
+                };
+                readonly minLength: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 2000;
+                };
+                readonly pattern: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "ECMA-262 regular expression a text value MUST match.";
+                };
+                readonly options: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 128;
+                    readonly items: {
+                        readonly $ref: "#/$defs/EnumOption";
+                    };
+                    readonly description: "The permitted values of an `enum` or `multiEnum` field.";
+                };
+                readonly maxItems: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 32;
+                };
+                readonly minDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly maxDate: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly claim: {
+                    readonly $ref: "#/$defs/ClaimSelector";
+                };
+            };
+        };
+        readonly ClaimSelector: {
+            readonly title: "ClaimSelector";
+            readonly description: "Which claim a `claim` field accepts, from which credentials and issuers.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["credentialType", "claimPath"];
+            readonly properties: {
+                readonly credentialType: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "A `type` the presented credential MUST carry.";
+                };
+                readonly claimPath: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "JSON Pointer (RFC 6901) to the claim within `credentialSubject`.";
+                };
+                readonly issuers: {
+                    readonly type: "array";
+                    readonly maxItems: 32;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                    };
+                    readonly description: "Issuers the community accepts for this field. Absent: the community's trusted issuers for the credential type, as its own policy decides.";
+                };
+            };
+        };
+        readonly EnumOption: {
+            readonly title: "EnumOption";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["value", "label"];
+            readonly properties: {
+                readonly value: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$";
+                    readonly description: "The stored value.";
+                };
+                readonly label: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly description: "What a reader is shown for it.";
+                };
+            };
+        };
+        readonly FieldType: {
+            readonly title: "FieldType";
+            readonly description: "The kind of value a field holds, which fixes its `FieldValue` shape. `did` holds a DID the member chooses to show (never their membership DID, which is the derived base field `did`). `claim` holds a `VerifiedValue` and requires `source: credential`.";
+            readonly type: "string";
+            readonly enum: readonly ["text", "longText", "url", "email", "phone", "enum", "multiEnum", "date", "country", "image", "did", "claim"];
+        };
+        readonly FieldDescription: {
+            readonly title: "FieldDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 280;
+            readonly description: "Help text shown to a member filling the field in. Plain text; a reader MUST NOT treat it as instructions.";
+        };
+        readonly FieldLabel: {
+            readonly title: "FieldLabel";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly description: "What readers see as the field's name. Plain text.";
+        };
+        readonly Audience: {
+            readonly title: "Audience";
+            readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1";
+        readonly title: "VTC Directory — Fields — Update — payload";
+        readonly description: "An administrator changes a directory field's label, help text, constraints, order, ceiling or default visibility, or disables or re-enables a base field. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["key"];
+        readonly properties: {
+            readonly key: {
+                readonly $ref: "#/$defs/FieldKey";
+            };
+            readonly label: {
+                readonly $ref: "#/$defs/FieldLabel";
+            };
+            readonly description: {
+                readonly $ref: "#/$defs/FieldDescription";
+            };
+            readonly constraints: {
+                readonly $ref: "#/$defs/FieldConstraints";
+                readonly description: "Replaces the constraints whole. Values already stored that no longer satisfy them stay until their writer next changes them; projections show them unchanged.";
+            };
+            readonly ceiling: {
+                readonly $ref: "#/$defs/Audience";
+            };
+            readonly defaultVisibility: {
+                readonly $ref: "#/$defs/Audience";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+            readonly searchable: {
+                readonly type: "boolean";
+            };
+            readonly facet: {
+                readonly type: "boolean";
+            };
+            readonly order: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 10000;
+            };
+            readonly enabled: {
+                readonly type: "boolean";
+                readonly description: "Base fields only: `false` disables the field (hidden from every projection, values kept), `true` re-enables it.";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1024;
+                readonly description: "Why, recorded with the change and shown to anyone who must approve it.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Directory — Fields — Update — response payload";
+                readonly description: "The success response to a vtc/directory/fields/update/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["field"];
+                readonly properties: {
+                    readonly field: {
+                        readonly $ref: "#/$defs/FieldDefinition";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly FieldDefinition: {
+                readonly title: "FieldDefinition";
+                readonly description: "One field of the community's directory schema, as the community holds it. The audience order `admins` < `groups`/`connections` < `members` < `public` applies to `ceiling` and `defaultVisibility`; `defaultVisibility` is never wider than `ceiling`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["key", "label", "type", "source", "base", "ceiling", "defaultVisibility", "required", "searchable", "facet", "order", "state"];
+                readonly properties: {
+                    readonly key: {
+                        readonly $ref: "#/$defs/FieldKey";
+                    };
+                    readonly label: {
+                        readonly $ref: "#/$defs/FieldLabel";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/FieldDescription";
+                    };
+                    readonly type: {
+                        readonly $ref: "#/$defs/FieldType";
+                    };
+                    readonly constraints: {
+                        readonly $ref: "#/$defs/FieldConstraints";
+                    };
+                    readonly source: {
+                        readonly $ref: "#/$defs/FieldSource";
+                    };
+                    readonly base: {
+                        readonly type: "boolean";
+                        readonly description: "`true` for a base field, present in every community; `false` for a field this community defined.";
+                    };
+                    readonly jsContactPath: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "Where the field lands when an entry is exported as a JSContact Card (RFC 9553), e.g. `name.full`, `nicknames`, `speakToAs.pronouns`. Absent: a vendor-specific property named by the key.";
+                    };
+                    readonly required: {
+                        readonly type: "boolean";
+                    };
+                    readonly ceiling: {
+                        readonly $ref: "#/$defs/Audience";
+                    };
+                    readonly defaultVisibility: {
+                        readonly $ref: "#/$defs/Audience";
+                    };
+                    readonly searchable: {
+                        readonly type: "boolean";
+                    };
+                    readonly facet: {
+                        readonly type: "boolean";
+                    };
+                    readonly order: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 10000;
+                    };
+                    readonly state: {
+                        readonly $ref: "#/$defs/FieldState";
+                    };
+                    readonly retiredAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the field was retired. Present only on a retired field.";
+                    };
+                    readonly purgeAfter: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the values of a retired field are purged. Present only on a retired field.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT widen a ceiling.";
+                    };
+                };
+            };
+            readonly FieldState: {
+                readonly title: "FieldState";
+                readonly description: "`active`: in use. `disabled`: a base field the community has switched off; hidden from every projection and re-enablable. `retired`: a community field withdrawn for good; hidden at once, its values purged after the community's retention period, and its key never reused.";
+                readonly type: "string";
+                readonly enum: readonly ["active", "disabled", "retired"];
+            };
+            readonly FieldSource: {
+                readonly title: "FieldSource";
+                readonly description: "Who writes the value. `member`: self-asserted, through vtc/directory/card/update. `admin`: asserted by the community through vtc/directory/card/assert; the member reads it and cannot change it. `credential`: a claim the member discloses from a credential through vtc/directory/card/present, badged with its issuer. `derived`: a base field read from the community's own records (`role`, `joinedAt`, `did`, `personhood`) and never stored on a card. Each source is written only through its own path.";
+                readonly type: "string";
+                readonly enum: readonly ["member", "admin", "credential", "derived"];
+            };
+            readonly FieldConstraints: {
+                readonly title: "FieldConstraints";
+                readonly description: "Per-type constraints. A member that does not apply to the field's type is refused by the community with `valueInvalid` when the definition is written.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly maxLength: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 2000;
+                    };
+                    readonly minLength: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 2000;
+                    };
+                    readonly pattern: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "ECMA-262 regular expression a text value MUST match.";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 128;
+                        readonly items: {
+                            readonly $ref: "#/$defs/EnumOption";
+                        };
+                        readonly description: "The permitted values of an `enum` or `multiEnum` field.";
+                    };
+                    readonly maxItems: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 32;
+                    };
+                    readonly minDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly maxDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly claim: {
+                        readonly $ref: "#/$defs/ClaimSelector";
+                    };
+                };
+            };
+            readonly ClaimSelector: {
+                readonly title: "ClaimSelector";
+                readonly description: "Which claim a `claim` field accepts, from which credentials and issuers.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["credentialType", "claimPath"];
+                readonly properties: {
+                    readonly credentialType: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "A `type` the presented credential MUST carry.";
+                    };
+                    readonly claimPath: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "JSON Pointer (RFC 6901) to the claim within `credentialSubject`.";
+                    };
+                    readonly issuers: {
+                        readonly type: "array";
+                        readonly maxItems: 32;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^did:";
+                            readonly maxLength: 2048;
+                        };
+                        readonly description: "Issuers the community accepts for this field. Absent: the community's trusted issuers for the credential type, as its own policy decides.";
+                    };
+                };
+            };
+            readonly EnumOption: {
+                readonly title: "EnumOption";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["value", "label"];
+                readonly properties: {
+                    readonly value: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$";
+                        readonly description: "The stored value.";
+                    };
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly description: "What a reader is shown for it.";
+                    };
+                };
+            };
+            readonly FieldType: {
+                readonly title: "FieldType";
+                readonly description: "The kind of value a field holds, which fixes its `FieldValue` shape. `did` holds a DID the member chooses to show (never their membership DID, which is the derived base field `did`). `claim` holds a `VerifiedValue` and requires `source: credential`.";
+                readonly type: "string";
+                readonly enum: readonly ["text", "longText", "url", "email", "phone", "enum", "multiEnum", "date", "country", "image", "did", "claim"];
+            };
+            readonly FieldDescription: {
+                readonly title: "FieldDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 280;
+                readonly description: "Help text shown to a member filling the field in. Plain text; a reader MUST NOT treat it as instructions.";
+            };
+            readonly FieldLabel: {
+                readonly title: "FieldLabel";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly description: "What readers see as the field's name. Plain text.";
+            };
+            readonly Audience: {
+                readonly title: "Audience";
+                readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Directory — Fields — Update — response payload";
+                readonly description: "The success response to a vtc/directory/fields/update/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/fields/update/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["field"];
+                readonly properties: {
+                    readonly field: {
+                        readonly $ref: "#/$defs/FieldDefinition";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly FieldDefinition: {
+                readonly title: "FieldDefinition";
+                readonly description: "One field of the community's directory schema, as the community holds it. The audience order `admins` < `groups`/`connections` < `members` < `public` applies to `ceiling` and `defaultVisibility`; `defaultVisibility` is never wider than `ceiling`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["key", "label", "type", "source", "base", "ceiling", "defaultVisibility", "required", "searchable", "facet", "order", "state"];
+                readonly properties: {
+                    readonly key: {
+                        readonly $ref: "#/$defs/FieldKey";
+                    };
+                    readonly label: {
+                        readonly $ref: "#/$defs/FieldLabel";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/FieldDescription";
+                    };
+                    readonly type: {
+                        readonly $ref: "#/$defs/FieldType";
+                    };
+                    readonly constraints: {
+                        readonly $ref: "#/$defs/FieldConstraints";
+                    };
+                    readonly source: {
+                        readonly $ref: "#/$defs/FieldSource";
+                    };
+                    readonly base: {
+                        readonly type: "boolean";
+                        readonly description: "`true` for a base field, present in every community; `false` for a field this community defined.";
+                    };
+                    readonly jsContactPath: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "Where the field lands when an entry is exported as a JSContact Card (RFC 9553), e.g. `name.full`, `nicknames`, `speakToAs.pronouns`. Absent: a vendor-specific property named by the key.";
+                    };
+                    readonly required: {
+                        readonly type: "boolean";
+                    };
+                    readonly ceiling: {
+                        readonly $ref: "#/$defs/Audience";
+                    };
+                    readonly defaultVisibility: {
+                        readonly $ref: "#/$defs/Audience";
+                    };
+                    readonly searchable: {
+                        readonly type: "boolean";
+                    };
+                    readonly facet: {
+                        readonly type: "boolean";
+                    };
+                    readonly order: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 10000;
+                    };
+                    readonly state: {
+                        readonly $ref: "#/$defs/FieldState";
+                    };
+                    readonly retiredAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the field was retired. Present only on a retired field.";
+                    };
+                    readonly purgeAfter: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the values of a retired field are purged. Present only on a retired field.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT widen a ceiling.";
+                    };
+                };
+            };
+            readonly FieldState: {
+                readonly title: "FieldState";
+                readonly description: "`active`: in use. `disabled`: a base field the community has switched off; hidden from every projection and re-enablable. `retired`: a community field withdrawn for good; hidden at once, its values purged after the community's retention period, and its key never reused.";
+                readonly type: "string";
+                readonly enum: readonly ["active", "disabled", "retired"];
+            };
+            readonly FieldSource: {
+                readonly title: "FieldSource";
+                readonly description: "Who writes the value. `member`: self-asserted, through vtc/directory/card/update. `admin`: asserted by the community through vtc/directory/card/assert; the member reads it and cannot change it. `credential`: a claim the member discloses from a credential through vtc/directory/card/present, badged with its issuer. `derived`: a base field read from the community's own records (`role`, `joinedAt`, `did`, `personhood`) and never stored on a card. Each source is written only through its own path.";
+                readonly type: "string";
+                readonly enum: readonly ["member", "admin", "credential", "derived"];
+            };
+            readonly FieldConstraints: {
+                readonly title: "FieldConstraints";
+                readonly description: "Per-type constraints. A member that does not apply to the field's type is refused by the community with `valueInvalid` when the definition is written.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly maxLength: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 2000;
+                    };
+                    readonly minLength: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 2000;
+                    };
+                    readonly pattern: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "ECMA-262 regular expression a text value MUST match.";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 128;
+                        readonly items: {
+                            readonly $ref: "#/$defs/EnumOption";
+                        };
+                        readonly description: "The permitted values of an `enum` or `multiEnum` field.";
+                    };
+                    readonly maxItems: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 32;
+                    };
+                    readonly minDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly maxDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly claim: {
+                        readonly $ref: "#/$defs/ClaimSelector";
+                    };
+                };
+            };
+            readonly ClaimSelector: {
+                readonly title: "ClaimSelector";
+                readonly description: "Which claim a `claim` field accepts, from which credentials and issuers.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["credentialType", "claimPath"];
+                readonly properties: {
+                    readonly credentialType: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "A `type` the presented credential MUST carry.";
+                    };
+                    readonly claimPath: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "JSON Pointer (RFC 6901) to the claim within `credentialSubject`.";
+                    };
+                    readonly issuers: {
+                        readonly type: "array";
+                        readonly maxItems: 32;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^did:";
+                            readonly maxLength: 2048;
+                        };
+                        readonly description: "Issuers the community accepts for this field. Absent: the community's trusted issuers for the credential type, as its own policy decides.";
+                    };
+                };
+            };
+            readonly EnumOption: {
+                readonly title: "EnumOption";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["value", "label"];
+                readonly properties: {
+                    readonly value: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$";
+                        readonly description: "The stored value.";
+                    };
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly description: "What a reader is shown for it.";
+                    };
+                };
+            };
+            readonly FieldType: {
+                readonly title: "FieldType";
+                readonly description: "The kind of value a field holds, which fixes its `FieldValue` shape. `did` holds a DID the member chooses to show (never their membership DID, which is the derived base field `did`). `claim` holds a `VerifiedValue` and requires `source: credential`.";
+                readonly type: "string";
+                readonly enum: readonly ["text", "longText", "url", "email", "phone", "enum", "multiEnum", "date", "country", "image", "did", "claim"];
+            };
+            readonly FieldDescription: {
+                readonly title: "FieldDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 280;
+                readonly description: "Help text shown to a member filling the field in. Plain text; a reader MUST NOT treat it as instructions.";
+            };
+            readonly FieldLabel: {
+                readonly title: "FieldLabel";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly description: "What readers see as the field's name. Plain text.";
+            };
+            readonly Audience: {
+                readonly title: "Audience";
+                readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map