pi-apexlang 0.2.2 → 0.4.0

package/skills/apexlang/templates/items/combobox/combobox.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native combobox `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/date-picker/date-picker._common.md

@@ -104,7 +104,7 @@ pageItem {{itemName}} (
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
 - Keep width, placeholder, and format-mask attributes absent unless the scenario explicitly asks for them.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native date-picker `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/date-picker/date-picker.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native date-picker `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/file-upload/file-upload._common.md

@@ -36,15 +36,20 @@ Define the canonical contract, conditional rules, and output skeleton for `file-
 | layout.alignment | optional | enum | Item alignment inside the slot. |
 | appearance.template | yes | alias | Family-appropriate template alias. |
 | appearance.templateOptions | optional | array/string | Template modifiers such as `#DEFAULT#` or compact options. |
-| settings.* | optional | variant | Normalized family settings such as `storageType`, `displayAs`, `allowMultipleFiles`, `fileTypes`, `maxFileSize`, `displayDownloadLink`, `downloadLinkText`, `contentDisposition`, `purgeFileAt`, `dropzoneTitle`, `dropzoneDescription`, and `captureUsing`. |
+| appearance.icon | optional | string | Font APEX icon class such as `fa-file`. |
+| display.displayAs | yes | enum | Upload UI mode: `blockDropzone`, `inlineDropzone`, or `nativeFileBrowse`. Emit `blockDropzone` when the user does not request another supported mode. |
+| display.dropzoneTitle | conditional | string | Required for dropzone modes; use `Drop files here` when custom copy is unavailable. |
+| display.dropzoneDesc | conditional | string | Required for dropzone modes; use `or click to browse` when custom copy is unavailable. |
+| display.allowCopyPaste | optional | boolean | Allows file copy/paste into supported dropzone UIs. |
+| display.captureUsing | optional | enum | Device capture source: `selfieCamera` or `mainCamera`. Omit when no capture source is required. |
+| storage.type | optional | enum | Proven storage type: `appTempFiles`. |
+| storage.allowMultipleFiles | optional | boolean | Allows multiple files. |
+| storage.fileTypes | optional | string | Free-form comma-delimited file type list such as `image/png,video/*`; do not emit as an array. |
+| storage.maxFileSize | optional | number | Maximum file size in KB. |
 | validation.valueRequired | optional | boolean | Set when the item value is mandatory. |
 | source.formRegion | conditional | alias | Required for form-bound upload items. |
 | source.column | conditional | string | Primary file payload column. |
 | source.dataType | conditional | enum | Data type for the stored payload, typically BLOB. |
-| source.mimeTypeColumn | optional | string | Column storing the MIME type. |
-| source.filenameColumn | optional | string | Column storing the uploaded file name. |
-| source.characterSetColumn | optional | string | Column storing the character set when applicable. |
-| source.blobLastUpdatedColumn | optional | string | Column storing the last-updated timestamp. |
 | help.helpText | required by default | string | Builder help text or assistive guidance for visible user-facing file-upload items; omit only for hidden items or a documented exemption. |
 | security.sessionStateProtection | optional | enum | Session state protection policy. |
 | security.authorizationScheme | optional | alias | Authorization scheme alias when the item is conditionally visible. |
@@ -69,20 +74,20 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
+        icon: {{appearance.icon}}
     }
-    settings {
-        storageType: {{settings.storageType}}
-        displayAs: {{settings.displayAs}}
-        allowMultipleFiles: {{settings.allowMultipleFiles}}
-        fileTypes: {{settings.fileTypes}}
-        maxFileSize: {{settings.maxFileSize}}
-        displayDownloadLink: {{settings.displayDownloadLink}}
-        downloadLinkText: {{settings.downloadLinkText}}
-        contentDisposition: {{settings.contentDisposition}}
-        purgeFileAt: {{settings.purgeFileAt}}
-        dropzoneTitle: {{settings.dropzoneTitle}}
-        dropzoneDescription: {{settings.dropzoneDescription}}
-        captureUsing: {{settings.captureUsing}}
+    display {
+        displayAs: {{display.displayAs}}
+        dropzoneTitle: {{display.dropzoneTitle}}
+        dropzoneDesc: {{display.dropzoneDesc}}
+        allowCopyPaste: {{display.allowCopyPaste}}
+        captureUsing: {{display.captureUsing}}
+    }
+    storage {
+        type: {{storage.type}}
+        allowMultipleFiles: {{storage.allowMultipleFiles}}
+        fileTypes: {{storage.fileTypes}}
+        maxFileSize: {{storage.maxFileSize}}
     }
     validation {
         valueRequired: {{validation.valueRequired}}
@@ -91,10 +96,6 @@ pageItem {{itemName}} (
         formRegion: @{{source.formRegion}}
         column: {{source.column}}
         dataType: {{source.dataType}}
-        mimeTypeColumn: {{source.mimeTypeColumn}}
-        filenameColumn: {{source.filenameColumn}}
-        characterSetColumn: {{source.characterSetColumn}}
-        blobLastUpdatedColumn: {{source.blobLastUpdatedColumn}}
     }
     help {
         helpText: {{help.helpText}}
@@ -113,7 +114,11 @@ pageItem {{itemName}} (
 - Remove unsupported or unused blocks before finalizing the DSL.
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Always emit a grouped `display {}` block with an explicit `displayAs` value.
+- Use `displayAs: blockDropzone` when the user does not request `inlineDropzone` or `nativeFileBrowse`.
+- For dropzone modes, provide `dropzoneTitle` and `dropzoneDesc` when user-specific copy is available; otherwise emit `Drop files here` and `or click to browse`.
+- Keep `storage.fileTypes` as one free-form comma-delimited text scalar, for example `image/png,video/*`.
+- Keep `storage.maxFileSize` as a positive integer number of KB.
 
 ---
 
@@ -122,4 +127,5 @@ pageItem {{itemName}} (
 - Follow guardrails in `references/policies/memory-bank/00-guard/ai.guard.md`.
 - Do not invent unsupported attributes or UT classes.
 - Keep placeholder names aligned with `templates/items/items._common.md`.
-- Validate the storage strategy and metadata column mappings before finalizing upload items.
+- Validate the storage strategy before finalizing upload items.
+- Do not reintroduce legacy flat `settings.storageType`, `settings.displayAs`, or related file-upload settings.

package/skills/apexlang/templates/items/file-upload/file-upload.compact-template.md

@@ -57,6 +57,11 @@ pageItem {{itemName}} (
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
     }
+    display {
+        displayAs: blockDropzone
+        dropzoneTitle: Drop files here
+        dropzoneDesc: or click to browse
+    }
     security {
         sessionStateProtection: {{security.sessionStateProtection}}
     }
@@ -69,6 +74,7 @@ pageItem {{itemName}} (
 
 - Use `appearance.templateOptions` only when the requested control needs compact or condensed rendering.
 - Keep the rest of the item aligned with the inherited family contract.
+- Keep the explicit `blockDropzone` display block unless the user requests another supported upload mode.
 
 ---
 

package/skills/apexlang/templates/items/file-upload/file-upload.explicit-defaults.md

@@ -35,10 +35,14 @@ Inherits the full family contract from `file-upload._common.md`. Base family req
 - `layout.slot`
 - `layout.alignment`
 - `appearance.templateOptions`
+- `appearance.icon`
 - `security.sessionStateProtection`
-- `settings.storageType`
-- `settings.displayAs`
-- `settings.allowMultipleFiles`
+- `display.allowCopyPaste`
+- `display.captureUsing`
+- `storage.type`
+- `storage.allowMultipleFiles`
+- `storage.fileTypes`
+- `storage.maxFileSize`
 
 ---
 
@@ -60,11 +64,20 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
+        icon: {{appearance.icon}}
     }
-    settings {
-        storageType: {{settings.storageType}}
-        displayAs: {{settings.displayAs}}
-        allowMultipleFiles: {{settings.allowMultipleFiles}}
+    display {
+        displayAs: blockDropzone
+        dropzoneTitle: Drop files here
+        dropzoneDesc: or click to browse
+        allowCopyPaste: {{display.allowCopyPaste}}
+        captureUsing: {{display.captureUsing}}
+    }
+    storage {
+        type: {{storage.type}}
+        allowMultipleFiles: {{storage.allowMultipleFiles}}
+        fileTypes: {{storage.fileTypes}}
+        maxFileSize: {{storage.maxFileSize}}
     }
     security {
         sessionStateProtection: {{security.sessionStateProtection}}
@@ -77,7 +90,9 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Always emit the `display {}` block. Keep its explicit `blockDropzone` defaults unless the user requests another supported mode or custom dropzone copy.
+- Emit `storage {}` only when the generator needs those file-upload plugin attributes visible in the final output.
+- Keep `storage.fileTypes` as one free-form comma-delimited text scalar and `storage.maxFileSize` as a positive integer number of KB.
 
 ---
 

package/skills/apexlang/templates/items/file-upload/file-upload.minimal.md

@@ -51,6 +51,11 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
     }
+    display {
+        displayAs: blockDropzone
+        dropzoneTitle: Drop files here
+        dropzoneDesc: or click to browse
+    }
     security {
         sessionStateProtection: {{security.sessionStateProtection}}
     }
@@ -62,6 +67,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Keep the item block minimal and rely on the inherited family contract for anything not shown here.
+- Keep the explicit `blockDropzone` display block unless the user requests another supported upload mode.
 - Remove optional blocks that are not populated by the final prompt.
 
 ---

package/skills/apexlang/templates/items/hidden-item/hidden-item._common.md

@@ -81,7 +81,7 @@ pageItem {{itemName}} (
 - If a hidden item appears in dynamic-action `itemsToReturn` or as a `setValue` target, treat that as a hard signal that the item is client-owned post-render state rather than protected hidden data.
 - Remove unsupported or unused blocks before finalizing the DSL.
 - Omit `source {}` when the item is not bound to persisted data or a form region.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native hidden-item `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/hidden-item/hidden-item.explicit-defaults.md

@@ -64,7 +64,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native hidden-item `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/items._common.md

@@ -31,7 +31,7 @@ Define the shared variable contract, guardrails, and base `pageItem` skeleton us
 | type | yes | enum | Family-specific item type token such as `textField`, `selectList`, or `displayOnly`. |
 | label.* | conditional | variant | Label attributes when the family supports visible labels. |
 | layout.* | yes | variant | Placement attributes such as `region`, `sequence`, `slot`, and alignment. When `layout.region` is present, `layout.slot` should usually be the host region slot such as `regionBody`, not a page-level slot like `body`. `layout.labelColumnSpan` is an optional deliberate override when label-grid width must be controlled explicitly. |
-| appearance.* | conditional | variant | Template, template options, size hints, placeholder text, and format masks when supported. |
+| appearance.* | conditional | variant | Template, template options, icon, size hints, placeholder text, and format masks when supported. |
 | lov.* | conditional | variant | LOV source attributes for LOV-based item families. |
 | settings.* | optional | variant | Family-specific settings emitted by the routed family template. |
 | validation.* | optional | variant | Declarative validation attributes supported by the selected family. |
@@ -60,6 +60,7 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
+        icon: {{appearance.icon}}
         width: {{appearance.width}}
         height: {{appearance.height}}
         valuePlaceholder: {{appearance.valuePlaceholder}}
@@ -115,7 +116,7 @@ pageItem {{itemName}} (
    order by ...
   ```
 - Emit `source {}` only for form-bound or persisted items.
-- Keep `settings {}` reserved for family-specific attributes exposed by the routed family template.
+- Keep `settings {}` reserved for family-specific attributes exposed by the routed family template and backed by compiler/export evidence.
 - When `layout.region` is present, use the host region slot rather than a page-level slot. The default for items rendered inside a standard host region is usually `regionBody`, not `body` or `BODY`.
 - Only apply validation.maxLength to text fields
 - Emit `help { helpText: ... }` by default for visible editable, filter/control, and other user-facing items unless the item is hidden or a documented exemption applies.

package/skills/apexlang/templates/items/list-manager/list-manager.explicit-defaults.md

@@ -75,7 +75,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native list-manager `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/markdown-editor/markdown-editor._common.md

@@ -95,7 +95,7 @@ pageItem {{itemName}} (
 - Remove unsupported or unused blocks before finalizing the DSL.
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native markdown-editor `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/markdown-editor/markdown-editor.explicit-defaults.md

@@ -75,7 +75,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native markdown-editor `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/number-field/number-field._common.md

@@ -39,10 +39,12 @@ Define the canonical contract, conditional rules, and output skeleton for `numbe
 | appearance.width | optional | number | Width or character width when the family supports it. |
 | appearance.valuePlaceholder | optional | string | Placeholder or helper text shown before a value is entered. |
 | appearance.formatMask | optional | string | Format mask used when the family supports formatted input or display. |
-| settings.* | optional | variant | Normalized family settings such as `minValue`, `maxValue`, `numberAlignment`, and `virtualKeyboard`. |
+| appearance.icon | optional | string | Font APEX icon class such as `fa-american-sign-language-interpreting` when an icon is intentionally shown. |
+| settings.minValue | optional | number | Minimum accepted value when compiler/export evidence proves number-field settings are available. |
+| settings.maxValue | optional | number | Maximum accepted value when compiler/export evidence proves number-field settings are available. |
+| settings.numberAlignment | optional | enum | Text alignment for numeric values, for example `start`, `end`, or `left` as accepted by the active compiler/export evidence. |
+| settings.virtualKeyboard | optional | boolean | Controls numeric virtual keyboard behavior when compiler/export evidence proves the setting is available. |
 | validation.valueRequired | optional | boolean | Set when the item value is mandatory. |
-| validation.minimumValue | optional | number | Minimum numeric value when the scenario enforces it. |
-| validation.maximumValue | optional | number | Maximum numeric value when the scenario enforces it. |
 | source.formRegion | conditional | alias | Required for form-bound items. |
 | source.column | conditional | string | Target column for form-bound items. |
 | source.dataType | conditional | enum | Data type for DML binding. |
@@ -70,6 +72,7 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
+        icon: {{appearance.icon}}
         width: {{appearance.width}}
         valuePlaceholder: {{appearance.valuePlaceholder}}
         formatMask: {{appearance.formatMask}}
@@ -82,8 +85,6 @@ pageItem {{itemName}} (
     }
     validation {
         valueRequired: {{validation.valueRequired}}
-        minimumValue: {{validation.minimumValue}}
-        maximumValue: {{validation.maximumValue}}
     }
     source {
         formRegion: @{{source.formRegion}}
@@ -108,7 +109,8 @@ pageItem {{itemName}} (
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
 - Keep width, placeholder, and format-mask attributes absent unless the scenario explicitly asks for them.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native number-field `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
+- Do not emit `validation.minimumValue` or `validation.maximumValue`; current item validation supports `valueRequired` and `maxLength`.
 
 ---
 

package/skills/apexlang/templates/items/number-field/number-field.explicit-defaults.md

@@ -35,10 +35,15 @@ Inherits the full family contract from `number-field._common.md`. Base family re
 - `layout.slot`
 - `layout.alignment`
 - `appearance.templateOptions`
-- `security.sessionStateProtection`
+- `appearance.icon`
+- `appearance.formatMask`
+- `appearance.width`
+- `appearance.valuePlaceholder`
 - `settings.minValue`
 - `settings.maxValue`
 - `settings.numberAlignment`
+- `settings.virtualKeyboard`
+- `security.sessionStateProtection`
 
 ---
 
@@ -60,11 +65,16 @@ pageItem {{itemName}} (
     appearance {
         template: {{appearance.template}}
         templateOptions: {{appearance.templateOptions}}
+        icon: {{appearance.icon}}
+        formatMask: {{appearance.formatMask}}
+        width: {{appearance.width}}
+        valuePlaceholder: {{appearance.valuePlaceholder}}
     }
     settings {
         minValue: {{settings.minValue}}
         maxValue: {{settings.maxValue}}
         numberAlignment: {{settings.numberAlignment}}
+        virtualKeyboard: {{settings.virtualKeyboard}}
     }
     security {
         sessionStateProtection: {{security.sessionStateProtection}}
@@ -77,7 +87,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native number-field `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/popup-lov/popup-lov.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native popup LOV `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/rich-text-editor/rich-text-editor._common.md

@@ -100,7 +100,7 @@ pageItem {{itemName}} (
 - Remove unsupported or unused blocks before finalizing the DSL.
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native rich-text-editor `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/rich-text-editor/rich-text-editor.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native rich-text-editor `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/select-many/standard.md

@@ -138,7 +138,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Choose one LOV source per item and remove the unused LOV attributes.
-- Keep `settings.display` aligned with the interaction pattern requested by the prompt.
+- Emit native select-many display settings only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/shuttle/shuttle.explicit-defaults.md

@@ -73,7 +73,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native shuttle `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/switch/switch._common.md

@@ -67,12 +67,12 @@ pageItem {{itemName}} (
         templateOptions: {{appearance.templateOptions}}
     }
     settings {
-            useDefaults: {{settings.useDefaults}}
-            onValue: {{settings.onValue}}
-            onLabel: {{settings.onLabel}}
-            offValue: {{settings.offValue}}
-            offLabel: {{settings.offLabel}}
-        }
+        useDefaults: {{settings.useDefaults}}
+        onValue: {{settings.onValue}}
+        onLabel: {{settings.onLabel}}
+        offValue: {{settings.offValue}}
+        offLabel: {{settings.offLabel}}
+    }
     validation {
         valueRequired: {{validation.valueRequired}}
     }
@@ -98,8 +98,8 @@ pageItem {{itemName}} (
 - Remove unsupported or unused blocks before finalizing the DSL.
 - Omit `source {}` when the item is not bound to persisted data or a form region.
 - Emit `validation {}` only when the scenario requires declarative checks.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
-- Use `useDefaults:false` always unless you are asked not to. Determine on/off value based on the table or source. can be `Yes`/`No` or `0`/`1`
+- Emit native switch `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
+- Use `useDefaults: false` when custom on/off values or labels are intentionally emitted and backed by compiler/export evidence.
 
 ---
 

package/skills/apexlang/templates/items/switch/switch.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native switch `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/text-area/text-area._common.md

@@ -40,7 +40,6 @@ Define the canonical contract, conditional rules, and output skeleton for `text-
 | appearance.valuePlaceholder | optional | string | Placeholder or helper text shown before a value is entered. |
 | settings.* | optional | variant | Normalized family settings such as `resizable`, `autoHeight`, `characterCounter`, and `trimSpaces`. |
 | validation.valueRequired | optional | boolean | Set when the item value is mandatory. |
-| validation.minLength | optional | number | Minimum character length when the scenario enforces it. |
 | validation.maxLength | optional | number | Maximum character length when the scenario enforces it. |
 | source.formRegion | conditional | alias | Required for form-bound items. |
 | source.column | conditional | string | Target column for form-bound items. |
@@ -80,7 +79,6 @@ pageItem {{itemName}} (
     }
     validation {
         valueRequired: {{validation.valueRequired}}
-        minLength: {{validation.minLength}}
         maxLength: {{validation.maxLength}}
     }
     source {
@@ -107,7 +105,8 @@ pageItem {{itemName}} (
 - Emit `validation {}` only when the scenario requires declarative checks.
 - For form-bound textual columns, `validation.maxLength` should match the bound column length exactly.
 - Keep width, placeholder, and format-mask attributes absent unless the scenario explicitly asks for them.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native text-area `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
+- Do not emit `validation.minLength`; current item validation supports `valueRequired` and `maxLength`.
 
 ---
 

package/skills/apexlang/templates/items/text-area/text-area.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native text-area `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/text-area/text-area.required-length.md

@@ -32,7 +32,6 @@ Inherits the full family contract from `text-area._common.md`. Base family requi
 
 ## Optional Variables
 
-- `validation.minLength`
 - `appearance.templateOptions`
 - `security.sessionStateProtection`
 
@@ -59,7 +58,6 @@ pageItem {{itemName}} (
     }
     validation {
         valueRequired: {{validation.valueRequired}}
-        minLength: {{validation.minLength}}
         maxLength: {{validation.maxLength}}
     }
     security {
@@ -73,7 +71,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Use this overlay only for textual families where declarative length checks are relevant.
-- Keep validation limited to the requested length requirements.
+- Keep validation limited to `valueRequired` and `maxLength` under the current grammar.
 
 ---
 

package/skills/apexlang/templates/items/text-autocomplete/text-autocomplete.explicit-defaults.md

@@ -85,7 +85,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific `settings` and `search` properties that are not relevant to the requested prompt.
+- Emit native text-autocomplete `settings {}` or `search {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---
 

package/skills/apexlang/templates/items/text-autocomplete/text-autocomplete.required-length.md

@@ -32,7 +32,6 @@ Inherits the full family contract from `text-autocomplete._common.md`. Base fami
 
 ## Optional Variables
 
-- `validation.minLength`
 - `appearance.templateOptions`
 - `security.sessionStateProtection`
 
@@ -59,7 +58,6 @@ pageItem {{itemName}} (
     }
     validation {
         valueRequired: {{validation.valueRequired}}
-        minLength: {{validation.minLength}}
         maxLength: {{validation.maxLength}}
     }
     security {
@@ -73,7 +71,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Use this overlay only for textual families where declarative length checks are relevant.
-- Keep validation limited to the requested length requirements.
+- Keep validation limited to `valueRequired` and `maxLength` under the current grammar.
 
 ---
 

package/skills/apexlang/templates/items/text-field/text-field._common.md

@@ -40,7 +40,6 @@ Define the canonical contract, conditional rules, and output skeleton for `text-
 | appearance.valuePlaceholder | optional | string | Placeholder or helper text shown before a value is entered. |
 | settings.* | optional | variant | Normalized family settings such as `submitWhenEnterPressed`, `disabled`, `sendOnPageSubmit`, `subtype`, `trimSpaces`, and `textCase`. |
 | validation.valueRequired | optional | boolean | Set when the item value is mandatory. |
-| validation.minLength | optional | number | Minimum character length when the scenario enforces it. |
 | validation.maxLength | optional | number | Maximum character length when the scenario enforces it. |
 | source.formRegion | conditional | alias | Required for form-bound items. |
 | source.column | conditional | string | Target column for form-bound items. |
@@ -82,7 +81,6 @@ pageItem {{itemName}} (
     }
     validation {
         valueRequired: {{validation.valueRequired}}
-        minLength: {{validation.minLength}}
         maxLength: {{validation.maxLength}}
     }
     source {
@@ -109,7 +107,8 @@ pageItem {{itemName}} (
 - Emit `validation {}` only when the scenario requires declarative checks.
 - For form-bound textual columns, `validation.maxLength` is not optional in practice: set it to the bound column length exactly.
 - Keep width, placeholder, and format-mask attributes absent unless the scenario explicitly asks for them.
-- Keep the settings block lean and emit only the family-specific properties that are actually needed.
+- Emit native text-field `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
+- Do not emit `validation.minLength`; current item validation supports `valueRequired` and `maxLength`.
 
 ---
 

package/skills/apexlang/templates/items/text-field/text-field.explicit-defaults.md

@@ -77,7 +77,7 @@ pageItem {{itemName}} (
 # Conditional Rendering Rules
 
 - Show optional defaults only when the generator needs them visible in the final output.
-- Remove family-specific settings that are not relevant to the requested prompt.
+- Emit native text-field `settings {}` properties only when compiler/export evidence proves the specific plugin attributes; absence from the generic page-item grammar is not a rejection.
 
 ---