npm - @fluid-app/portal-sdk - Versions diffs - 0.1.469 → 0.1.470 - Mend

@fluid-app/portal-sdk 0.1.469 → 0.1.470

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 (135) hide show

package/authoring/widget-api/core/src/registries/property-schema-types.md ADDED Viewed

@@ -0,0 +1,3769 @@
+# core/src/registries/property-schema-types
+## Interfaces
+### AlignmentFieldSchema
+Alignment field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `AlignOptions`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### options
+> **options**: `object`
+###### horizontalEnabled
+> **horizontalEnabled**: `boolean`
+###### verticalEnabled
+> **verticalEnabled**: `boolean`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"alignment"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### BackgroundFieldSchema
+Background field combines resource selection and color properties.
+Uses StrictOmit to exclude conflicting "type" discriminant from parents.
+#### Extends
+- `StrictOmit`\<[`ResourceFieldSchema`](#resourcefieldschema), `"type"`\>.`StrictOmit`\<[`ColorFieldSchema`](#colorfieldschema), `"type"`\>
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### allowedTypes?
+> `optional` **allowedTypes?**: `string`[]
+Optional filter to specific shareable types
+###### Inherited from
+[`ResourceFieldSchema`](#resourcefieldschema).[`allowedTypes`](#allowedtypes-1)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"background"`
+---
+### BooleanFieldSchema
+Boolean field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"boolean"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### BorderRadiusFieldSchema
+Border radius composite field schema for controlling 4 corners with a single field.
+Maps to 4 individual widget prop keys (topLeft, topRight, bottomLeft, bottomRight).
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `BorderRadiusOptions`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### keys
+> **keys**: `object`
+###### bottomLeft
+> **bottomLeft**: `string`
+###### bottomRight
+> **bottomRight**: `string`
+###### topLeft
+> **topLeft**: `string`
+###### topRight
+> **topRight**: `string`
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"borderRadius"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ButtonGroupFieldSchema
+Button group field schema.
+Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+#### Extends
+- `StrictOmit`\<[`PropertyFieldSchema`](#propertyfieldschema), `"defaultValue"`\>
+#### Type Parameters
+##### T
+`T` _extends_ `string` \| `number` = `string` \| `number`
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `T`
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### options
+> **options**: `object`[]
+###### ariaLabel?
+> `optional` **ariaLabel?**: `string`
+###### icon?
+> `optional` **icon?**: `LucideIcon`
+###### label?
+> `optional` **label?**: `string`
+###### value
+> **value**: `T`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"buttonGroup"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ~~ColorFieldSchema~~
+Legacy free-form color field schema.
+#### Deprecated
+Use [ColorSelectFieldSchema](#colorselectfieldschema) (`type: "colorSelect"`) so
+widget authors select a semantic color token supplied by the portal theme.
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### ~~advanced?~~
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### ~~defaultValue?~~
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### ~~description?~~
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### ~~group?~~
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### ~~key~~
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### ~~label~~
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### ~~requiresKeyValue?~~
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### ~~tab?~~
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### ~~type~~
+> **type**: `"color"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ColorPickerFieldSchema
+Color picker field schema with optional swatches
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### swatches?
+> `optional` **swatches?**: `string`[]
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"colorPicker"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ColorSelectFieldSchema
+Semantic theme-color token selector. Prefer this field over free-form color
+controls so widgets continue to work across portal themes and color modes.
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `ColorOptions`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### excludeColors?
+> `optional` **excludeColors?**: `ColorOptions`[]
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"colorSelect"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ContentPositionFieldSchema
+Content position field schema for 3x3 grid position picker
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `string`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"contentPosition"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### CssUnitFieldSchema
+CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### allowedUnits?
+> `optional` **allowedUnits?**: [`CssUnit`](#cssunit)[]
+##### defaultUnit?
+> `optional` **defaultUnit?**: [`CssUnit`](#cssunit)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### maxByUnit?
+> `optional` **maxByUnit?**: `Partial`\<`Record`\<[`CssUnit`](#cssunit), `number`\>\>
+##### minByUnit?
+> `optional` **minByUnit?**: `Partial`\<`Record`\<[`CssUnit`](#cssunit), `number`\>\>
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### stepByUnit?
+> `optional` **stepByUnit?**: `Partial`\<`Record`\<[`CssUnit`](#cssunit), `number`\>\>
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"cssUnit"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### DataSourceFieldSchema
+Data source field schema for configuring widget data sources
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### targetProps?
+> `optional` **targetProps?**: readonly `object`[]
+Widget props that this data-source editor can populate.
+##### type
+> **type**: `"dataSource"`
+Identifies this field as the data-source editor.
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### FontPickerFieldSchema
+Font picker field schema for Google Fonts selection
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### placeholder?
+> `optional` **placeholder?**: `string`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"fontPicker"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ImageFieldSchema
+Image field schema for selecting a single asset (image or video) from the
+image picker. Despite the legacy "image" name, this field supports video
+picking via the `accept` parameter — `VideoWidget`, `ListWidget` Featured
+Asset, and `NestedWidget` Primary Media all use it for video-or-mixed
+content.
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### accept?
+> `optional` **accept?**: `"image"` \| `"video"` \| `"any"`
+Restricts which MIME categories the picker offers. Defaults to "image".
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"image"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ItemConfigSchema
+Schema for per-item configuration in custom data sources.
+Widgets can define this to allow users to configure widget-specific
+settings for each selected item (e.g., title, description, button).
+#### Properties
+##### description?
+> `optional` **description?**: `string`
+Optional description shown at top of item config panel
+##### fields
+> **fields**: [`PropertyField`](#propertyfield)[]
+Fields available for per-item configuration
+---
+### NumberFieldSchema
+Number field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### max?
+> `optional` **max?**: `number`
+##### min?
+> `optional` **min?**: `number`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### step?
+> `optional` **step?**: `number`
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"number"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### PropertyFieldSchema
+Base schema for a property field
+#### Extended by
+- [`TextFieldSchema`](#textfieldschema)
+- [`TextareaFieldSchema`](#textareafieldschema)
+- [`NumberFieldSchema`](#numberfieldschema)
+- [`BooleanFieldSchema`](#booleanfieldschema)
+- [`ColorFieldSchema`](#colorfieldschema)
+- [`RangeFieldSchema`](#rangefieldschema)
+- [`DataSourceFieldSchema`](#datasourcefieldschema)
+- [`ResourceFieldSchema`](#resourcefieldschema)
+- [`ImageFieldSchema`](#imagefieldschema)
+- [`AlignmentFieldSchema`](#alignmentfieldschema)
+- [`SliderFieldSchema`](#sliderfieldschema)
+- [`ColorPickerFieldSchema`](#colorpickerfieldschema)
+- [`SectionHeaderFieldSchema`](#sectionheaderfieldschema)
+- [`SeparatorFieldSchema`](#separatorfieldschema)
+- [`ColorSelectFieldSchema`](#colorselectfieldschema)
+- [`SectionLayoutSelectFieldSchema`](#sectionlayoutselectfieldschema)
+- [`ContentPositionFieldSchema`](#contentpositionfieldschema)
+- [`TextSizeSelectFieldSchema`](#textsizeselectfieldschema)
+- [`CssUnitFieldSchema`](#cssunitfieldschema)
+- [`FontPickerFieldSchema`](#fontpickerfieldschema)
+- [`StringArrayFieldSchema`](#stringarrayfieldschema)
+- [`BorderRadiusFieldSchema`](#borderradiusfieldschema)
+- [`ScreenPickerFieldSchema`](#screenpickerfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+##### key
+> **key**: `string`
+Property key in the widget props
+##### label
+> **label**: `string`
+Display label for the field
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+##### type
+> **type**: [`PropertyFieldType`](#propertyfieldtype)
+Field type determines the input control
+---
+### RangeFieldSchema
+Range slider field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### max
+> **max**: `number`
+##### min
+> **min**: `number`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### step?
+> `optional` **step?**: `number`
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"range"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ResourceFieldSchema
+Resource field schema for selecting a single resource from the selection modal
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### allowedTypes?
+> `optional` **allowedTypes?**: `string`[]
+Optional filter to specific shareable types
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"resource"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### ScreenPickerFieldSchema
+Screen picker field schema for selecting a portal screen (navigation, system, or available)
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### includeSystemItems?
+> `optional` **includeSystemItems?**: `boolean`
+Whether to include system navigation items in the picker
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"screenPicker"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### SectionHeaderFieldSchema
+Section header field schema for visual grouping
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### subtitle?
+> `optional` **subtitle?**: `string`
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"sectionHeader"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### SectionLayoutSelectFieldSchema
+Section layout select field schema for visual masonry layout selector
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `"single-column"` \| `"2c-equal"` \| `"2c-left-wider"` \| `"2c-right-wider"` \| `"2c-left-narrow"` \| `"2c-right-narrow"` \| `"3c-equal"` \| `"3c-middle-wider"`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"sectionLayoutSelect"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### SelectFieldSchema
+Select field schema with type-safe option values.
+Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
+#### Extends
+- `StrictOmit`\<[`PropertyFieldSchema`](#propertyfieldschema), `"defaultValue"`\>
+#### Type Parameters
+##### T
+`T` _extends_ `string` \| `number` = `string` \| `number`
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `T`
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### options
+> **options**: `object`[]
+###### label
+> **label**: `string`
+###### value
+> **value**: `T`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"select"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### SeparatorFieldSchema
+Separator field schema for visual separation
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"separator"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### SliderFieldSchema
+Slider field schema with optional unit suffix (e.g., "rem", "px")
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### max
+> **max**: `number`
+##### min
+> **min**: `number`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### step?
+> `optional` **step?**: `number`
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"slider"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+##### unit?
+> `optional` **unit?**: `string`
+---
+### StringArrayFieldSchema
+String array field schema for managing lists of text items
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `string`[]
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### placeholder?
+> `optional` **placeholder?**: `string`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"stringArray"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### TabConfig
+Tab configuration for organizing properties
+#### Properties
+##### id
+> **id**: `string`
+Unique identifier for the tab
+##### label
+> **label**: `string`
+Display label for the tab
+---
+### TextareaFieldSchema
+Textarea field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### maxLength?
+> `optional` **maxLength?**: `number`
+##### placeholder?
+> `optional` **placeholder?**: `string`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### rows?
+> `optional` **rows?**: `number`
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"textarea"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### TextFieldSchema
+Text field schema
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `unknown`
+Optional default value
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### maxLength?
+> `optional` **maxLength?**: `number`
+##### placeholder?
+> `optional` **placeholder?**: `string`
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### tokenSuggestions?
+> `optional` **tokenSuggestions?**: readonly `object`[]
+Optional quick-insert chips rendered below the input. Clicking a chip
+inserts `{{value}}` at the caret. Used for URL template tokens
+(e.g. `{{username}}`, `{{replicated_url || /signup}}`) so admins
+don't have to remember the exact spelling.
+##### type
+> **type**: `"text"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### TextSizeSelectFieldSchema
+Text size select field schema for visual font size selector
+#### Extends
+- [`PropertyFieldSchema`](#propertyfieldschema)
+#### Properties
+##### advanced?
+> `optional` **advanced?**: `boolean`
+When true, this field is treated as an override of a value that can
+otherwise be inherited from the active theme (e.g. border radius,
+padding, border width). Advanced fields are automatically bucketed
+into the `CUSTOM_STYLING_GROUP` at the bottom of their tab and
+rendered collapsed by default so the default surface area stays
+minimal.
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`advanced`](#advanced-14)
+##### defaultValue?
+> `optional` **defaultValue?**: `FontSizeOptions`
+Optional default value
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`defaultValue`](#defaultvalue-14)
+##### description?
+> `optional` **description?**: `string`
+Optional description/help text
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`description`](#description-15)
+##### group?
+> `optional` **group?**: `string`
+Optional group for organizing fields within a tab
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`group`](#group-14)
+##### key
+> **key**: `string`
+Property key in the widget props
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`key`](#key-14)
+##### label
+> **label**: `string`
+Display label for the field
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`label`](#label-14)
+##### ~~requiresKeyToBeTrue?~~
+> `optional` **requiresKeyToBeTrue?**: `string`
+###### Deprecated
+Use requiresKeyValue instead
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyToBeTrue`](#requireskeytobetrue-14)
+##### requiresKeyValue?
+> `optional` **requiresKeyValue?**: \{ `key`: `string`; `value`: `unknown`; \} \| `object`[]
+Optional requires a specific key to have a specific value. Supports single condition or array (AND logic).
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`requiresKeyValue`](#requireskeyvalue-14)
+##### tab?
+> `optional` **tab?**: `string`
+Optional tab ID (must match a TabConfig id if widget has tabsConfig)
+###### Inherited from
+[`PropertyFieldSchema`](#propertyfieldschema).[`tab`](#tab-14)
+##### type
+> **type**: `"textSizeSelect"`
+Field type determines the input control
+###### Overrides
+[`PropertyFieldSchema`](#propertyfieldschema).[`type`](#type-14)
+---
+### WidgetPropertySchema
+Schema for a widget's editable properties
+#### Properties
+##### dataSourceTargetProps?
+> `optional` **dataSourceTargetProps?**: `string`[]
+Props that can be populated from data sources
+##### displayName
+> **displayName**: `string`
+Display name for the widget
+##### fields
+> **fields**: [`PropertyField`](#propertyfield)[]
+Editable property fields
+##### itemConfigSchema?
+> `optional` **itemConfigSchema?**: [`ItemConfigSchema`](#itemconfigschema)
+Optional schema for per-item configurations in custom data sources
+##### tabsConfig?
+> `optional` **tabsConfig?**: [`TabConfig`](#tabconfig)[]
+Optional tab configuration - if present, tabs are enabled
+##### validate?
+> `optional` **validate?**: (`props`) => `string` \| `null`
+Optional custom validator function
+###### Parameters
+###### props
+`Record`\<`string`, `unknown`\>
+###### Returns
+`string` \| `null`
+##### widgetType
+> **widgetType**: `string`
+Widget type this schema applies to
+## Type Aliases
+### CssUnit
+> **CssUnit** = `"px"` \| `"rem"` \| `"vh"` \| `"%"`
+CSS unit type for height/width fields
+---
+### PropertyField
+> **PropertyField** = [`TextFieldSchema`](#textfieldschema) \| [`TextareaFieldSchema`](#textareafieldschema) \| [`NumberFieldSchema`](#numberfieldschema) \| [`BooleanFieldSchema`](#booleanfieldschema) \| [`SelectFieldSchema`](#selectfieldschema)\<`string` \| `number`\> \| [`ColorFieldSchema`](#colorfieldschema) \| [`RangeFieldSchema`](#rangefieldschema) \| [`DataSourceFieldSchema`](#datasourcefieldschema) \| [`ResourceFieldSchema`](#resourcefieldschema) \| [`ImageFieldSchema`](#imagefieldschema) \| [`AlignmentFieldSchema`](#alignmentfieldschema) \| [`SliderFieldSchema`](#sliderfieldschema) \| [`ColorPickerFieldSchema`](#colorpickerfieldschema) \| [`SectionHeaderFieldSchema`](#sectionheaderfieldschema) \| [`SeparatorFieldSchema`](#separatorfieldschema) \| [`ButtonGroupFieldSchema`](#buttongroupfieldschema)\<`string` \| `number`\> \| [`ColorSelectFieldSchema`](#colorselectfieldschema) \| [`SectionLayoutSelectFieldSchema`](#sectionlayoutselectfieldschema) \| [`BackgroundFieldSchema`](#backgroundfieldschema) \| [`ContentPositionFieldSchema`](#contentpositionfieldschema) \| [`TextSizeSelectFieldSchema`](#textsizeselectfieldschema) \| [`CssUnitFieldSchema`](#cssunitfieldschema) \| [`FontPickerFieldSchema`](#fontpickerfieldschema) \| [`StringArrayFieldSchema`](#stringarrayfieldschema) \| [`BorderRadiusFieldSchema`](#borderradiusfieldschema) \| [`ScreenPickerFieldSchema`](#screenpickerfieldschema)
+Union of all field schema types
+---
+### PropertyFieldType
+> **PropertyFieldType** = _typeof_ [`PROPERTY_FIELD_TYPES`](#property_field_types)\[keyof _typeof_ [`PROPERTY_FIELD_TYPES`](#property_field_types)\]
+Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
+#### See
+deriving-typeof-for-object-keys pattern
+---
+### PropertySchemaRegistry
+> **PropertySchemaRegistry** = `Record`\<`WidgetType`, [`WidgetPropertySchema`](#widgetpropertyschema)\>
+Registry mapping widget types to their property schemas
+## Variables
+### CUSTOM_STYLING_GROUP
+> `const` **CUSTOM_STYLING_GROUP**: `"Custom styling"` = `"Custom styling"`
+Group label for fields that override theme-derived styling.
+Rendered last within a tab and collapsed by default so the primary
+configuration surface stays clean.
+---
+### PROPERTY_FIELD_TYPES
+> `const` **PROPERTY_FIELD_TYPES**: `object`
+Property field type constant - single source of truth for field types.
+Use PROPERTY_FIELD_TYPES.text instead of "text" for type-safe comparisons.
+#### Type Declaration
+##### alignment
+> `readonly` **alignment**: `"alignment"` = `"alignment"`
+##### background
+> `readonly` **background**: `"background"` = `"background"`
+##### boolean
+> `readonly` **boolean**: `"boolean"` = `"boolean"`
+##### borderRadius
+> `readonly` **borderRadius**: `"borderRadius"` = `"borderRadius"`
+##### buttonGroup
+> `readonly` **buttonGroup**: `"buttonGroup"` = `"buttonGroup"`
+##### ~~color~~
+> `readonly` **color**: `"color"` = `"color"`
+###### Deprecated
+Use `colorSelect` for semantic portal-theme colors.
+##### colorPicker
+> `readonly` **colorPicker**: `"colorPicker"` = `"colorPicker"`
+##### colorSelect
+> `readonly` **colorSelect**: `"colorSelect"` = `"colorSelect"`
+##### contentPosition
+> `readonly` **contentPosition**: `"contentPosition"` = `"contentPosition"`
+##### cssUnit
+> `readonly` **cssUnit**: `"cssUnit"` = `"cssUnit"`
+##### dataSource
+> `readonly` **dataSource**: `"dataSource"` = `"dataSource"`
+##### fontPicker
+> `readonly` **fontPicker**: `"fontPicker"` = `"fontPicker"`
+##### image
+> `readonly` **image**: `"image"` = `"image"`
+##### number
+> `readonly` **number**: `"number"` = `"number"`
+##### range
+> `readonly` **range**: `"range"` = `"range"`
+##### resource
+> `readonly` **resource**: `"resource"` = `"resource"`
+##### screenPicker
+> `readonly` **screenPicker**: `"screenPicker"` = `"screenPicker"`
+##### sectionHeader
+> `readonly` **sectionHeader**: `"sectionHeader"` = `"sectionHeader"`
+##### sectionLayoutSelect
+> `readonly` **sectionLayoutSelect**: `"sectionLayoutSelect"` = `"sectionLayoutSelect"`
+##### select
+> `readonly` **select**: `"select"` = `"select"`
+##### separator
+> `readonly` **separator**: `"separator"` = `"separator"`
+##### slider
+> `readonly` **slider**: `"slider"` = `"slider"`
+##### stringArray
+> `readonly` **stringArray**: `"stringArray"` = `"stringArray"`
+##### text
+> `readonly` **text**: `"text"` = `"text"`
+##### textarea
+> `readonly` **textarea**: `"textarea"` = `"textarea"`
+##### textSizeSelect
+> `readonly` **textSizeSelect**: `"textSizeSelect"` = `"textSizeSelect"`
+## Functions
+### applyPropertyValues()
+> **applyPropertyValues**(`widget`, `values`): `WidgetSchema`
+Apply property values to widget props
+#### Parameters
+##### widget
+`Readonly`\<`WidgetSchema`\>
+##### values
+`Readonly`\<`Record`\<`string`, `unknown`\>\>
+#### Returns
+`WidgetSchema`
+---
+### extractPropertyValues()
+> **extractPropertyValues**(`widget`, `fields`): `Record`\<`string`, `unknown`\>
+Extract current values from widget props based on property fields
+#### Parameters
+##### widget
+`Readonly`\<`WidgetSchema`\>
+##### fields
+readonly [`PropertyField`](#propertyfield)[]
+#### Returns
+`Record`\<`string`, `unknown`\>
+---
+### groupPropertyFields()
+> **groupPropertyFields**(`fields`): `Record`\<`string`, [`PropertyField`](#propertyfield)[]\>
+Group property fields by their group property.
+Fields flagged with `advanced: true` are collected into the
+`CUSTOM_STYLING_GROUP` bucket regardless of their declared `group`,
+and that bucket is always placed last so it renders at the bottom of
+the tab. Non-advanced fields keep their author-declared group and
+their relative insertion order, including fields that explicitly use
+`CUSTOM_STYLING_GROUP`.
+#### Parameters
+##### fields
+readonly [`PropertyField`](#propertyfield)[]
+#### Returns
+`Record`\<`string`, [`PropertyField`](#propertyfield)[]\>
+---
+### isPropertyFieldType()
+> **isPropertyFieldType**(`value`): `value is PropertyFieldType`
+Runtime validation for property field types.
+#### Parameters
+##### value
+`string`
+The value to check
+#### Returns
+`value is PropertyFieldType`
+true if value is a valid PropertyFieldType