@mhmo91/schmancy 0.10.34 → 0.10.36

package/custom-elements.json

@@ -441,30 +441,17 @@
     {
       "name": "schmancy-boat",
       "path": "./src/boat/boat.ts",
-      "description": "Material-3 extended FAB that delegates its expanded panel to the `show()`\noverlay service. Collapsed: a draggable, corner-anchored pill (icon + label,\ncircular when no label). Activated: the default-slot content blooms from the\nFAB as an overlay (backdrop / Esc / back-button / sheet-on-narrow handled by\nthe overlay primitive).",
+      "description": "Corner-anchored launcher that delegates its expanded panel to the `show()`\noverlay service.\n\nThree slots, three non-overlapping intents — no element-type sniffing,\never:\n\n  - `trigger`  — pure consumer content. A native click anywhere on it\n    opens the panel; interactive children (buttons, FABs, inputs) work\n    with zero special-casing because the boat never calls\n    `preventDefault` / `stopPropagation` / `setPointerCapture` here.\n  - `drag-handle` — opt-in. Pointer-drag is wired ONLY to this slot's\n    boat-owned wrapper. Slot it to make the boat draggable; omit it and\n    the boat is static at its corner. (A no-move tap on the handle also\n    opens, so the grip doubles as a launcher.)\n  - _(default)_ — the panel body; parked hidden while collapsed,\n    relocated into the `show()` overlay on open.\n\nThe boat owns drag, corner-snapping, position persistence and the glass\nsurface — never the collapsed shape.",
       "attributes": [
         {
           "name": "id",
+          "description": "Identity for localStorage drag-position persistence.",
           "type": "string",
           "default": "\"default\""
         },
-        {
-          "name": "icon",
-          "type": "string | undefined"
-        },
-        {
-          "name": "label",
-          "type": "string | undefined"
-        },
-        {
-          "name": "lowered",
-          "description": "When true, uses a lower elevation shadow on the FAB.",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "corner",
-          "description": "Corner the FAB is anchored to.",
+          "description": "Corner the launcher is anchored to.",
           "type": "Corner",
           "default": "\"bottom-right\""
         },
@@ -476,38 +463,17 @@
         }
       ],
       "properties": [
-        {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
-        },
         {
           "name": "id",
           "attribute": "id",
+          "description": "Identity for localStorage drag-position persistence.",
           "type": "string",
           "default": "\"default\""
         },
-        {
-          "name": "icon",
-          "attribute": "icon",
-          "type": "string | undefined"
-        },
-        {
-          "name": "label",
-          "attribute": "label",
-          "type": "string | undefined"
-        },
-        {
-          "name": "lowered",
-          "attribute": "lowered",
-          "description": "When true, uses a lower elevation shadow on the FAB.",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "corner",
           "attribute": "corner",
-          "description": "Corner the FAB is anchored to.",
+          "description": "Corner the launcher is anchored to.",
           "type": "Corner",
           "default": "\"bottom-right\""
         },
@@ -1147,45 +1113,30 @@
       ]
     },
     {
-      "name": "schmancy-assist-chip",
-      "path": "./src/chips/assist-chip.ts",
-      "description": "Assist chip component - prompts user actions like opening calendar events or sharing content\nPure Schmancy implementation with Tailwind CSS and RxJS state management",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "Value identifier for the chip",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "icon",
-          "description": "Optional icon name (Material Symbols)",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "href",
-          "description": "Optional href for navigation",
-          "type": "string",
-          "default": "\"\""
-        },
+      "name": "schmancy-connectivity-status",
+      "path": "./src/connectivity/connectivity-status.ts",
+      "properties": [
         {
-          "name": "target",
-          "description": "Target for navigation (e.g., '_blank')",
-          "type": "string",
-          "default": "\"\""
-        },
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[null]"
+        }
+      ]
+    },
+    {
+      "name": "schmancy-content-drawer",
+      "path": "./src/content-drawer/drawer.ts",
+      "attributes": [
         {
-          "name": "disabled",
-          "description": "Disable the chip",
-          "type": "boolean",
-          "default": "false"
+          "name": "minWidth",
+          "description": "The minimum width of the sheet",
+          "type": "number",
+          "default": "{\"main\":360,\"sheet\":576}"
         },
         {
-          "name": "elevated",
-          "description": "Elevated style variant - true by default per M3 spec for assist chips",
-          "type": "boolean",
-          "default": "true"
+          "name": "open",
+          "description": "The state of the sheet",
+          "type": "TSchmancyContentDrawerSheetState"
         }
       ],
       "properties": [
@@ -1195,88 +1146,89 @@
           "default": "[null]"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Value identifier for the chip",
-          "type": "string",
-          "default": "\"\""
+          "name": "minWidth",
+          "attribute": "minWidth",
+          "description": "The minimum width of the sheet",
+          "type": "number",
+          "default": "{\"main\":360,\"sheet\":576}"
         },
         {
-          "name": "icon",
-          "attribute": "icon",
-          "description": "Optional icon name (Material Symbols)",
-          "type": "string",
-          "default": "\"\""
+          "name": "open",
+          "attribute": "open",
+          "description": "The state of the sheet",
+          "type": "TSchmancyContentDrawerSheetState"
         },
         {
-          "name": "href",
-          "attribute": "href",
-          "description": "Optional href for navigation",
+          "name": "schmancyContentDrawerID",
           "type": "string",
-          "default": "\"\""
+          "default": "\"Math.floor(Math.random() * Date.now()).toString()\""
         },
         {
-          "name": "target",
-          "attribute": "target",
-          "description": "Target for navigation (e.g., '_blank')",
+          "name": "maxHeight",
           "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Disable the chip",
-          "type": "boolean",
-          "default": "false"
+          "default": "\"100%\""
         },
         {
-          "name": "elevated",
-          "attribute": "elevated",
-          "description": "Elevated style variant - true by default per M3 spec for assist chips",
-          "type": "boolean",
-          "default": "true"
+          "name": "assignedElements",
+          "type": "HTMLElement[]"
         }
       ],
-      "events": [
+      "slots": [
         {
-          "name": "action"
+          "name": "appbar",
+          "description": "The appbar slot"
         },
         {
-          "name": "click"
+          "name": "",
+          "description": "The content slot"
         }
       ]
     },
     {
-      "name": "schmancy-chips",
-      "path": "./src/chips/chips.ts",
+      "name": "schmancy-content-drawer-main",
+      "path": "./src/content-drawer/main.ts",
       "attributes": [
         {
-          "name": "multi",
-          "type": "boolean",
-          "deprecatedMessage": "Use .values for multi-selection or .value for single-selection instead.\nThe mode is now automatically determined based on which property is used."
-        },
+          "name": "minWidth",
+          "type": "number"
+        }
+      ],
+      "properties": [
         {
-          "name": "values",
-          "type": "string[]"
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[null]"
         },
         {
-          "name": "value",
-          "type": "string"
+          "name": "minWidth",
+          "attribute": "minWidth",
+          "type": "number"
         },
         {
-          "name": "wrap",
-          "type": "boolean",
-          "default": "false"
+          "name": "drawerMinWidth",
+          "type": "{ main: number; sheet: number; }"
         },
         {
-          "name": "required",
-          "type": "boolean",
-          "default": "false"
+          "name": "mode",
+          "type": "TSchmancyContentDrawerSheetMode"
         },
         {
-          "name": "justify",
-          "type": "\"start\" | \"center\" | \"end\"",
-          "default": "\"start\""
+          "name": "maxHeight",
+          "type": "string"
+        }
+      ],
+      "events": [
+        {
+          "name": "ContentDrawerResize"
+        }
+      ]
+    },
+    {
+      "name": "schmancy-content-drawer-sheet",
+      "path": "./src/content-drawer/sheet.ts",
+      "attributes": [
+        {
+          "name": "minWidth"
         }
       ],
       "properties": [
@@ -1286,179 +1238,298 @@
           "default": "[null]"
         },
         {
-          "name": "multi",
-          "attribute": "multi",
-          "type": "boolean",
-          "deprecatedMessage": "Use .values for multi-selection or .value for single-selection instead.\nThe mode is now automatically determined based on which property is used."
+          "name": "minWidth",
+          "attribute": "minWidth"
         },
         {
-          "name": "values",
-          "attribute": "values",
-          "type": "string[]"
+          "name": "mode",
+          "type": "TSchmancyContentDrawerSheetMode"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "type": "string"
+          "name": "state",
+          "type": "TSchmancyContentDrawerSheetState"
         },
         {
-          "name": "chips",
-          "type": "(HTMLElement | SchmancyFilterChip)[]"
+          "name": "schmancyContentDrawerID"
         },
         {
-          "name": "wrap",
-          "attribute": "wrap",
-          "type": "boolean",
-          "default": "false"
+          "name": "sheet",
+          "type": "HTMLElement"
         },
         {
-          "name": "required",
-          "attribute": "required",
-          "type": "boolean",
-          "default": "false"
+          "name": "defaultSlot",
+          "type": "HTMLElement[]"
         },
         {
-          "name": "justify",
-          "attribute": "justify",
-          "type": "\"start\" | \"center\" | \"end\"",
-          "default": "\"start\""
+          "name": "drawerMinWidth",
+          "type": "{ main: number; sheet: number; }"
+        },
+        {
+          "name": "maxHeight"
         }
       ],
       "events": [
         {
-          "name": "change"
+          "name": "ContentDrawerResize"
+        },
+        {
+          "name": "schmancy-content-drawer-overlay-dismiss"
         }
       ]
     },
     {
-      "name": "schmancy-filter-chip",
-      "path": "./src/chips/filter-chip.ts",
-      "description": "Filter chip component for content filtering.\n\nFilter chips are the ONLY chip type that maintains persistent selected state.\nThey are used for filtering content by toggling on/off different filter criteria.",
+      "name": "schmancy-date-range-inline",
+      "path": "./src/date-range-inline/date-range-inline.ts",
+      "description": "Smart inline date range picker that handles all the heavy lifting.\r\nAuto-corrects invalid ranges, provides smart defaults, and validates dates.",
       "attributes": [
         {
-          "name": "value",
-          "description": "Unique identifier for this filter chip",
-          "type": "string",
-          "default": "\"\""
+          "name": "type",
+          "description": "Input type - 'date' or 'datetime-local'",
+          "type": "\"date\" | \"datetime-local\"",
+          "default": "\"date\""
         },
         {
-          "name": "selected",
-          "type": "boolean"
+          "name": "dateFrom",
+          "description": "From date configuration",
+          "type": "{ label: string; value: string; }",
+          "default": "{\"label\":\"From\",\"value\":\"\"}"
         },
         {
-          "name": "removable",
-          "description": "Whether to show a remove button",
-          "type": "boolean",
-          "default": "false"
+          "name": "dateTo",
+          "description": "To date configuration",
+          "type": "{ label: string; value: string; }",
+          "default": "{\"label\":\"To\",\"value\":\"\"}"
         },
         {
-          "name": "disabled",
-          "description": "Whether the chip is disabled",
+          "name": "minDate",
+          "description": "Minimum allowed date",
+          "type": "string | undefined"
+        },
+        {
+          "name": "maxDate",
+          "description": "Maximum allowed date",
+          "type": "string | undefined"
+        },
+        {
+          "name": "compact",
+          "description": "Compact mode for smaller UI",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "elevated",
-          "description": "Whether to use elevated style with shadow",
+          "name": "autoCorrect",
+          "description": "Auto-correct invalid date ranges",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "minGap",
+          "description": "Minimum gap between dates (in days)",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "maxGap",
+          "description": "Maximum gap between dates (in days)",
+          "type": "number | undefined"
+        },
+        {
+          "name": "defaultGap",
+          "description": "Default gap when auto-setting dates (in days)",
+          "type": "number",
+          "default": "1"
+        },
+        {
+          "name": "allowSameDate",
+          "description": "Whether to allow same date selection",
           "type": "boolean",
           "default": "false"
         }
       ],
       "properties": [
         {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
+          "name": "type",
+          "attribute": "type",
+          "description": "Input type - 'date' or 'datetime-local'",
+          "type": "\"date\" | \"datetime-local\"",
+          "default": "\"date\""
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Unique identifier for this filter chip",
-          "type": "string",
-          "default": "\"\""
+          "name": "dateFrom",
+          "attribute": "dateFrom",
+          "description": "From date configuration",
+          "type": "{ label: string; value: string; }",
+          "default": "{\"label\":\"From\",\"value\":\"\"}"
         },
         {
-          "name": "selected",
-          "attribute": "selected",
-          "type": "boolean"
+          "name": "dateTo",
+          "attribute": "dateTo",
+          "description": "To date configuration",
+          "type": "{ label: string; value: string; }",
+          "default": "{\"label\":\"To\",\"value\":\"\"}"
         },
         {
-          "name": "removable",
-          "attribute": "removable",
-          "description": "Whether to show a remove button",
-          "type": "boolean",
-          "default": "false"
+          "name": "minDate",
+          "attribute": "minDate",
+          "description": "Minimum allowed date",
+          "type": "string | undefined"
         },
         {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Whether the chip is disabled",
-          "type": "boolean",
-          "default": "false"
+          "name": "maxDate",
+          "attribute": "maxDate",
+          "description": "Maximum allowed date",
+          "type": "string | undefined"
         },
         {
-          "name": "elevated",
-          "attribute": "elevated",
-          "description": "Whether to use elevated style with shadow",
+          "name": "compact",
+          "attribute": "compact",
+          "description": "Compact mode for smaller UI",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "formAssociated",
+          "name": "autoCorrect",
+          "attribute": "autoCorrect",
+          "description": "Auto-correct invalid date ranges",
           "type": "boolean",
           "default": "true"
         },
         {
-          "name": "internals",
-          "type": "ElementInternals | undefined"
+          "name": "minGap",
+          "attribute": "minGap",
+          "description": "Minimum gap between dates (in days)",
+          "type": "number",
+          "default": "0"
         },
         {
-          "name": "form",
-          "type": "HTMLFormElement | null | undefined"
+          "name": "maxGap",
+          "attribute": "maxGap",
+          "description": "Maximum gap between dates (in days)",
+          "type": "number | undefined"
+        },
+        {
+          "name": "defaultGap",
+          "attribute": "defaultGap",
+          "description": "Default gap when auto-setting dates (in days)",
+          "type": "number",
+          "default": "1"
+        },
+        {
+          "name": "allowSameDate",
+          "attribute": "allowSameDate",
+          "description": "Whether to allow same date selection",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "events": [
         {
-          "name": "change",
-          "description": "Dispatched when selection state changes with {value, selected}"
+          "name": "change"
+        }
+      ]
+    },
+    {
+      "name": "schmancy-delay",
+      "path": "./src/delay/delay.ts",
+      "attributes": [
+        {
+          "name": "delay",
+          "type": "number",
+          "default": "0"
         },
         {
-          "name": "remove",
-          "description": "Dispatched when remove button is clicked (if removable)"
+          "name": "motion",
+          "type": "string",
+          "default": "\"flyBelow\""
+        },
+        {
+          "name": "once",
+          "type": "boolean | undefined",
+          "default": "true"
+        }
+      ],
+      "properties": [
+        {
+          "name": "delay",
+          "attribute": "delay",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "motion",
+          "attribute": "motion",
+          "type": "string",
+          "default": "\"flyBelow\""
+        },
+        {
+          "name": "parentDelay",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "effectiveDelay",
+          "type": "number",
+          "default": "0"
+        },
+        {
+          "name": "once",
+          "attribute": "once",
+          "type": "boolean | undefined",
+          "default": "true"
+        },
+        {
+          "name": "assignedElements",
+          "type": "HTMLElement[]"
         }
       ]
     },
     {
-      "name": "schmancy-chip",
-      "path": "./src/chips/filter-chip.ts",
+      "name": "schmancy-details",
+      "path": "./src/details/details.ts",
       "attributes": [
         {
-          "name": "value",
-          "description": "Unique identifier for this filter chip",
+          "name": "summary",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "selected",
+          "name": "open",
           "type": "boolean"
         },
         {
-          "name": "removable",
-          "description": "Whether to show a remove button",
+          "name": "indicator-placement",
+          "type": "\"start\" | \"end\"",
+          "default": "\"end\""
+        },
+        {
+          "name": "hide-indicator",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "disabled",
-          "description": "Whether the chip is disabled",
+          "name": "indicator-rotate",
+          "type": "number",
+          "default": "90"
+        },
+        {
+          "name": "locked",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "elevated",
-          "description": "Whether to use elevated style with shadow",
+          "name": "overlay",
           "type": "boolean",
           "default": "false"
+        },
+        {
+          "name": "summary-padding",
+          "type": "string",
+          "default": "\"p-3\""
+        },
+        {
+          "name": "content-padding",
+          "type": "string",
+          "default": "\"p-3\""
         }
       ],
       "properties": [
@@ -1468,103 +1539,93 @@
           "default": "[null]"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Unique identifier for this filter chip",
+          "name": "summary",
+          "attribute": "summary",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "selected",
-          "attribute": "selected",
+          "name": "open",
+          "attribute": "open",
           "type": "boolean"
         },
         {
-          "name": "removable",
-          "attribute": "removable",
-          "description": "Whether to show a remove button",
-          "type": "boolean",
-          "default": "false"
+          "name": "indicatorPlacement",
+          "attribute": "indicator-placement",
+          "type": "\"start\" | \"end\"",
+          "default": "\"end\""
         },
         {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Whether the chip is disabled",
+          "name": "hideIndicator",
+          "attribute": "hide-indicator",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "elevated",
-          "attribute": "elevated",
-          "description": "Whether to use elevated style with shadow",
+          "name": "indicatorRotate",
+          "attribute": "indicator-rotate",
+          "type": "number",
+          "default": "90"
+        },
+        {
+          "name": "locked",
+          "attribute": "locked",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "formAssociated",
+          "name": "overlay",
+          "attribute": "overlay",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "internals",
-          "type": "ElementInternals | undefined"
+          "name": "summaryPadding",
+          "attribute": "summary-padding",
+          "type": "string",
+          "default": "\"p-3\""
         },
         {
-          "name": "form",
-          "type": "HTMLFormElement | null | undefined"
-        }
-      ],
-      "events": [
+          "name": "contentPadding",
+          "attribute": "content-padding",
+          "type": "string",
+          "default": "\"p-3\""
+        },
         {
-          "name": "change",
-          "description": "Dispatched when selection state changes with {value, selected}"
+          "name": "type",
+          "type": "string",
+          "default": "\"solid\""
         },
         {
-          "name": "remove",
-          "description": "Dispatched when remove button is clicked (if removable)"
+          "name": "rounded",
+          "type": "string",
+          "default": "\"all\""
         }
       ]
     },
     {
-      "name": "schmancy-input-chip",
-      "path": "./src/chips/input-chip.ts",
-      "description": "Input chip component - represents user-provided information that can be removed.\n\nIMPORTANT: Per Material Design 3 specification, input chips do NOT have selected state.\nThey represent discrete pieces of user input (like entered tags, selections from lists, etc.)\nthat can only be removed, not toggled on/off.\n\nUse cases:\n- Displaying selected recipients in an email\n- Showing applied filters that can be removed\n- Tags or keywords entered by the user\n- Selected items from a multi-select dropdown",
+      "name": "schmancy-divider",
+      "path": "./src/divider/divider.ts",
       "attributes": [
         {
-          "name": "value",
-          "description": "Value identifier for the chip",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "icon",
-          "description": "Optional icon name (Material Symbols)",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "avatar",
-          "description": "Optional avatar image URL",
-          "type": "string",
-          "default": "\"\""
+          "name": "outline",
+          "type": "\"default\" | \"variant\"",
+          "default": "\"variant\""
         },
         {
-          "name": "removable",
-          "description": "Whether to show remove button (default true for input chips)",
+          "name": "vertical",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "disabled",
-          "description": "Disable the chip",
-          "type": "boolean",
-          "default": "false"
+          "name": "grow",
+          "type": "\"start\" | \"end\" | \"both\"",
+          "default": "\"start\""
         },
         {
-          "name": "elevated",
-          "description": "Elevated style variant",
-          "type": "boolean",
-          "default": "false"
+          "name": "orientation",
+          "type": "\"horizontal\" | \"vertical\"",
+          "deprecatedMessage": "Use `vertical` property instead. Will be removed in next major version."
         }
       ],
       "properties": [
@@ -1574,117 +1635,133 @@
           "default": "[null]"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Value identifier for the chip",
-          "type": "string",
-          "default": "\"\""
+          "name": "outline",
+          "attribute": "outline",
+          "type": "\"default\" | \"variant\"",
+          "default": "\"variant\""
         },
         {
-          "name": "icon",
-          "attribute": "icon",
-          "description": "Optional icon name (Material Symbols)",
-          "type": "string",
-          "default": "\"\""
+          "name": "vertical",
+          "attribute": "vertical",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "avatar",
-          "attribute": "avatar",
-          "description": "Optional avatar image URL",
-          "type": "string",
-          "default": "\"\""
+          "name": "grow",
+          "attribute": "grow",
+          "type": "\"start\" | \"end\" | \"both\"",
+          "default": "\"start\""
         },
         {
-          "name": "removable",
-          "attribute": "removable",
-          "description": "Whether to show remove button (default true for input chips)",
-          "type": "boolean",
-          "default": "true"
-        },
+          "name": "orientation",
+          "attribute": "orientation",
+          "type": "\"horizontal\" | \"vertical\"",
+          "deprecatedMessage": "Use `vertical` property instead. Will be removed in next major version."
+        }
+      ]
+    },
+    {
+      "name": "schmancy-dropdown",
+      "path": "./src/dropdown/dropdown-component.ts",
+      "description": "A dropdown component that displays content when triggered.",
+      "attributes": [
         {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Disable the chip",
+          "name": "open",
+          "description": "Whether the dropdown is currently open",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "elevated",
-          "attribute": "elevated",
-          "description": "Elevated style variant",
+          "name": "placement",
+          "description": "Placement of the dropdown relative to the trigger",
+          "type": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"",
+          "default": "\"bottom-start\""
+        },
+        {
+          "name": "distance",
+          "description": "Offset distance in pixels",
+          "type": "number",
+          "default": "8"
+        }
+      ],
+      "properties": [
+        {
+          "name": "open",
+          "attribute": "open",
+          "description": "Whether the dropdown is currently open",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "uiState",
-          "type": "{ chipHover: boolean; removeHover: boolean; focused: boolean; pressed: boolean; }",
-          "default": "{\"chipHover\":false,\"removeHover\":false,\"focused\":false,\"pressed\":false}"
+          "name": "placement",
+          "attribute": "placement",
+          "description": "Placement of the dropdown relative to the trigger",
+          "type": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"",
+          "default": "\"bottom-start\""
         },
         {
-          "name": "formAssociated",
-          "type": "boolean",
-          "default": "true"
+          "name": "distance",
+          "attribute": "distance",
+          "description": "Offset distance in pixels",
+          "type": "number",
+          "default": "8"
         },
         {
-          "name": "internals",
-          "type": "ElementInternals | undefined"
+          "name": "triggerContainer",
+          "type": "HTMLElement"
         },
         {
-          "name": "form",
-          "type": "HTMLFormElement | null | undefined"
+          "name": "contentContainer",
+          "type": "HTMLElement"
+        },
+        {
+          "name": "contentElements",
+          "type": "HTMLElement[]"
+        },
+        {
+          "name": "triggerElements",
+          "type": "HTMLElement[]"
         }
       ],
-      "events": [
+      "slots": [
         {
-          "name": "click",
-          "description": "Optional click event on chip body (value)"
+          "name": "trigger",
+          "description": "The element that triggers the dropdown"
         },
         {
-          "name": "remove",
-          "description": "Dispatched when remove button is clicked (value)"
+          "name": "",
+          "description": "Default slot for the dropdown content"
         }
       ]
     },
     {
-      "name": "schmancy-suggestion-chip",
-      "path": "./src/chips/suggestion-chip.ts",
-      "description": "Suggestion chip component - provides contextual recommendations to users\n\nIMPORTANT: Suggestion chips do NOT have a selected state. They are designed to\nprovide suggestions and recommendations that trigger actions when clicked.\nUnlike filter chips, they cannot be toggled on/off.\n\nPure Schmancy implementation with Tailwind CSS and RxJS state management",
+      "name": "schmancy-dropdown-content",
+      "path": "./src/dropdown/dropdown-content.ts",
+      "description": "Content container for the schmancy-dropdown component.",
       "attributes": [
         {
-          "name": "value",
-          "description": "Value identifier for the chip",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "icon",
-          "description": "Optional icon name (Material Symbols)",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "href",
-          "description": "Optional href for navigation",
+          "name": "width",
+          "description": "Width of the dropdown content",
           "type": "string",
-          "default": "\"\""
+          "default": "\"auto\""
         },
         {
-          "name": "target",
-          "description": "Target for navigation (e.g., '_blank')",
+          "name": "maxHeight",
+          "description": "Maximum height of the dropdown content",
           "type": "string",
-          "default": "\"\""
+          "default": "\"80vh\""
         },
         {
-          "name": "disabled",
-          "description": "Disable the chip",
+          "name": "shadow",
+          "description": "Whether to render with a shadow",
           "type": "boolean",
-          "default": "false"
+          "default": "true"
         },
         {
-          "name": "elevated",
-          "description": "Elevated style variant - flat by default per M3 spec",
-          "type": "boolean",
-          "default": "false"
+          "name": "radius",
+          "description": "Border radius style",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"none\" | \"full\"",
+          "default": "\"md\""
         }
       ],
       "properties": [
@@ -1694,82 +1771,119 @@
           "default": "[null]"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Value identifier for the chip",
+          "name": "width",
+          "attribute": "width",
+          "description": "Width of the dropdown content",
           "type": "string",
-          "default": "\"\""
+          "default": "\"auto\""
         },
         {
-          "name": "icon",
-          "attribute": "icon",
-          "description": "Optional icon name (Material Symbols)",
+          "name": "maxHeight",
+          "attribute": "maxHeight",
+          "description": "Maximum height of the dropdown content",
           "type": "string",
-          "default": "\"\""
+          "default": "\"80vh\""
         },
         {
-          "name": "href",
-          "attribute": "href",
-          "description": "Optional href for navigation",
-          "type": "string",
-          "default": "\"\""
+          "name": "shadow",
+          "attribute": "shadow",
+          "description": "Whether to render with a shadow",
+          "type": "boolean",
+          "default": "true"
         },
         {
-          "name": "target",
-          "attribute": "target",
-          "description": "Target for navigation (e.g., '_blank')",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Disable the chip",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "elevated",
-          "attribute": "elevated",
-          "description": "Elevated style variant - flat by default per M3 spec",
-          "type": "boolean",
-          "default": "false"
+          "name": "radius",
+          "attribute": "radius",
+          "description": "Border radius style",
+          "type": "\"sm\" | \"md\" | \"lg\" | \"none\" | \"full\"",
+          "default": "\"md\""
         }
       ],
-      "events": [
+      "slots": [
         {
-          "name": "action"
-        },
+          "name": "",
+          "description": "Default slot for dropdown content."
+        }
+      ],
+      "cssParts": [
         {
-          "name": "click"
+          "name": "content",
+          "description": "The inner wrapper element; style to override panel\nbackgrounds, shadows, padding, or borders without shadow-root piercing."
         }
       ]
     },
     {
-      "name": "schmancy-connectivity-status",
-      "path": "./src/connectivity/connectivity-status.ts",
+      "name": "schmancy-expand-root",
+      "path": "./src/expand/expand-root.component.ts",
+      "attributes": [
+        {
+          "name": "type",
+          "type": "TSurfaceColor",
+          "default": "\"solid\""
+        }
+      ],
       "properties": [
         {
           "name": "styles",
           "type": "CSSResult[]",
           "default": "[null]"
+        },
+        {
+          "name": "type",
+          "attribute": "type",
+          "type": "TSurfaceColor",
+          "default": "\"solid\""
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "default": "false"
         }
       ]
     },
     {
-      "name": "schmancy-content-drawer",
-      "path": "./src/content-drawer/drawer.ts",
+      "name": "schmancy-expand",
+      "path": "./src/expand/expand.component.ts",
       "attributes": [
         {
-          "name": "minWidth",
-          "description": "The minimum width of the sheet",
-          "type": "number",
-          "default": "{\"main\":360,\"sheet\":576}"
+          "name": "summary",
+          "type": "string",
+          "default": "\"\""
         },
         {
           "name": "open",
-          "description": "The state of the sheet",
-          "type": "TSchmancyContentDrawerSheetState"
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "summary-padding",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "content-padding",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "hide-indicator",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "indicator-rotate",
+          "type": "number",
+          "default": "90"
+        },
+        {
+          "name": "backdrop",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "inline",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "properties": [
@@ -1779,91 +1893,95 @@
           "default": "[null]"
         },
         {
-          "name": "minWidth",
-          "attribute": "minWidth",
-          "description": "The minimum width of the sheet",
-          "type": "number",
-          "default": "{\"main\":360,\"sheet\":576}"
+          "name": "summary",
+          "attribute": "summary",
+          "type": "string",
+          "default": "\"\""
         },
         {
           "name": "open",
           "attribute": "open",
-          "description": "The state of the sheet",
-          "type": "TSchmancyContentDrawerSheetState"
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "schmancyContentDrawerID",
+          "name": "summaryPadding",
+          "attribute": "summary-padding",
           "type": "string",
-          "default": "\"Math.floor(Math.random() * Date.now()).toString()\""
+          "default": "\"\""
         },
         {
-          "name": "maxHeight",
+          "name": "contentPadding",
+          "attribute": "content-padding",
           "type": "string",
-          "default": "\"100%\""
+          "default": "\"\""
         },
         {
-          "name": "assignedElements",
-          "type": "HTMLElement[]"
-        }
-      ],
-      "slots": [
+          "name": "hideIndicator",
+          "attribute": "hide-indicator",
+          "type": "boolean",
+          "default": "false"
+        },
         {
-          "name": "appbar",
-          "description": "The appbar slot"
+          "name": "indicatorRotate",
+          "attribute": "indicator-rotate",
+          "type": "number",
+          "default": "90"
         },
         {
-          "name": "",
-          "description": "The content slot"
+          "name": "backdrop",
+          "attribute": "backdrop",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "inline",
+          "attribute": "inline",
+          "type": "boolean",
+          "default": "false"
         }
       ]
     },
     {
-      "name": "schmancy-content-drawer-main",
-      "path": "./src/content-drawer/main.ts",
+      "name": "schmancy-fab",
+      "path": "./src/fab/fab.ts",
+      "description": "Material 3 Floating Action Button.\n\nMirrors the `md-fab` reference implementation\n(github.com/material-components/material-web) and the M3 spec\n(m3.material.io/components/floating-action-button): four colour\nvariants, three container sizes, an extended form (set `label`),\nand a `lowered` elevation register. Per M3 guidance a FAB is never\ndisabled, so there is no `disabled` property.\n\nSizing, shape, icon size and elevation are M3 design tokens expressed\nas `:host` rules (the same token-driven model as `md-fab`'s SCSS);\ncolour roles and the state layer are schmancy theme utilities. The\nhost shrink-wraps the inner button and clips its rounded shape.",
       "attributes": [
         {
-          "name": "minWidth",
-          "type": "number"
-        }
-      ],
-      "properties": [
+          "name": "variant",
+          "description": "Colour variant. M3 maps each to a container + on-container role.",
+          "type": "FabVariant",
+          "default": "\"'surface'\""
+        },
         {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
+          "name": "size",
+          "description": "Container size. Ignored while extended (extended is always 56dp tall).",
+          "type": "FabSize",
+          "default": "\"'medium'\""
         },
         {
-          "name": "minWidth",
-          "attribute": "minWidth",
-          "type": "number"
+          "name": "label",
+          "description": "Extended-FAB label. A non-empty value switches the FAB to its\nextended form (icon + text), exactly as `md-fab` derives extended\nfrom a truthy label.",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "drawerMinWidth",
-          "type": "{ main: number; sheet: number; }"
+          "name": "extended",
+          "description": "Reflected mirror of \"label is non-empty\" so `:host([extended])`\ncan drive the extended geometry. Synced from `label`; read it,\ndon't set it.",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "mode",
-          "type": "TSchmancyContentDrawerSheetMode"
+          "name": "lowered",
+          "description": "Lowers the FAB's elevation register (M3 lowered FAB).",
+          "type": "boolean",
+          "default": "\"false\""
         },
         {
-          "name": "maxHeight",
+          "name": "aria-label",
           "type": "string"
         }
       ],
-      "events": [
-        {
-          "name": "ContentDrawerResize"
-        }
-      ]
-    },
-    {
-      "name": "schmancy-content-drawer-sheet",
-      "path": "./src/content-drawer/sheet.ts",
-      "attributes": [
-        {
-          "name": "minWidth"
-        }
-      ],
       "properties": [
         {
           "name": "styles",
@@ -1871,530 +1989,457 @@
           "default": "[null]"
         },
         {
-          "name": "minWidth",
-          "attribute": "minWidth"
-        },
-        {
-          "name": "mode",
-          "type": "TSchmancyContentDrawerSheetMode"
-        },
-        {
-          "name": "state",
-          "type": "TSchmancyContentDrawerSheetState"
+          "name": "variant",
+          "attribute": "variant",
+          "description": "Colour variant. M3 maps each to a container + on-container role.",
+          "type": "FabVariant",
+          "default": "\"'surface'\""
         },
         {
-          "name": "schmancyContentDrawerID"
+          "name": "size",
+          "attribute": "size",
+          "description": "Container size. Ignored while extended (extended is always 56dp tall).",
+          "type": "FabSize",
+          "default": "\"'medium'\""
         },
         {
-          "name": "sheet",
-          "type": "HTMLElement"
+          "name": "label",
+          "attribute": "label",
+          "description": "Extended-FAB label. A non-empty value switches the FAB to its\nextended form (icon + text), exactly as `md-fab` derives extended\nfrom a truthy label.",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "defaultSlot",
-          "type": "HTMLElement[]"
+          "name": "extended",
+          "attribute": "extended",
+          "description": "Reflected mirror of \"label is non-empty\" so `:host([extended])`\ncan drive the extended geometry. Synced from `label`; read it,\ndon't set it.",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "drawerMinWidth",
-          "type": "{ main: number; sheet: number; }"
+          "name": "lowered",
+          "attribute": "lowered",
+          "description": "Lowers the FAB's elevation register (M3 lowered FAB).",
+          "type": "boolean",
+          "default": "\"false\""
         },
         {
-          "name": "maxHeight"
+          "name": "ariaLabel",
+          "attribute": "aria-label",
+          "type": "string"
         }
       ],
-      "events": [
+      "slots": [
         {
-          "name": "ContentDrawerResize"
-        },
+          "name": "",
+          "description": "The icon (typically `<schmancy-icon>`)."
+        }
+      ],
+      "cssParts": [
         {
-          "name": "schmancy-content-drawer-overlay-dismiss"
+          "name": "base",
+          "description": "The underlying native `<button>`."
         }
       ]
     },
     {
-      "name": "schmancy-date-range-inline",
-      "path": "./src/date-range-inline/date-range-inline.ts",
-      "description": "Smart inline date range picker that handles all the heavy lifting.\r\nAuto-corrects invalid ranges, provides smart defaults, and validates dates.",
+      "name": "schmancy-float",
+      "path": "./src/float/float.ts",
       "attributes": [
         {
-          "name": "type",
-          "description": "Input type - 'date' or 'datetime-local'",
-          "type": "\"date\" | \"datetime-local\"",
-          "default": "\"date\""
+          "name": "id",
+          "type": "string",
+          "default": "\"default\""
         },
         {
-          "name": "dateFrom",
-          "description": "From date configuration",
-          "type": "{ label: string; value: string; }",
-          "default": "{\"label\":\"From\",\"value\":\"\"}"
+          "name": "expandedWidth",
+          "description": "Override the expanded panel width (e.g. '320px', '24rem'). Defaults to responsive sizing.",
+          "type": "string | undefined"
         },
         {
-          "name": "dateTo",
-          "description": "To date configuration",
-          "type": "{ label: string; value: string; }",
-          "default": "{\"label\":\"To\",\"value\":\"\"}"
+          "name": "expandedHeight",
+          "description": "Override the expanded panel height (e.g. '400px', '50vh').",
+          "type": "string | undefined"
         },
         {
-          "name": "minDate",
-          "description": "Minimum allowed date",
-          "type": "string | undefined"
+          "name": "lowered",
+          "description": "When true, uses a lower elevation shadow in the collapsed state.",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "maxDate",
-          "description": "Maximum allowed date",
-          "type": "string | undefined"
+          "name": "corner",
+          "description": "Corner the window is anchored to.",
+          "type": "SnapCorner",
+          "default": "\"bottom-right\""
         },
         {
-          "name": "compact",
-          "description": "Compact mode for smaller UI",
+          "name": "resizable",
+          "description": "When true, window can be resized by the user.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "autoCorrect",
-          "description": "Auto-correct invalid date ranges",
+          "name": "freePosition",
+          "description": "When true, window stays at its dragged position instead of snapping to a corner.",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "minGap",
-          "description": "Minimum gap between dates (in days)",
-          "type": "number",
-          "default": "0"
+          "name": "visualState",
+          "description": "Visual state of the window (minimized, normal, maximized).",
+          "type": "WindowVisualState",
+          "default": "\"normal\""
         },
         {
-          "name": "maxGap",
-          "description": "Maximum gap between dates (in days)",
-          "type": "number | undefined"
+          "name": "minWidth",
+          "description": "Minimum width in pixels.",
+          "type": "number",
+          "default": "280"
         },
         {
-          "name": "defaultGap",
-          "description": "Default gap when auto-setting dates (in days)",
+          "name": "minHeight",
+          "description": "Minimum height in pixels.",
           "type": "number",
-          "default": "1"
+          "default": "200"
         },
         {
-          "name": "allowSameDate",
-          "description": "Whether to allow same date selection",
+          "name": "open",
+          "description": "Whether the body is expanded.",
           "type": "boolean",
           "default": "false"
         }
       ],
       "properties": [
         {
-          "name": "type",
-          "attribute": "type",
-          "description": "Input type - 'date' or 'datetime-local'",
-          "type": "\"date\" | \"datetime-local\"",
-          "default": "\"date\""
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[null]"
         },
         {
-          "name": "dateFrom",
-          "attribute": "dateFrom",
-          "description": "From date configuration",
-          "type": "{ label: string; value: string; }",
-          "default": "{\"label\":\"From\",\"value\":\"\"}"
+          "name": "id",
+          "attribute": "id",
+          "type": "string",
+          "default": "\"default\""
         },
         {
-          "name": "dateTo",
-          "attribute": "dateTo",
-          "description": "To date configuration",
-          "type": "{ label: string; value: string; }",
-          "default": "{\"label\":\"To\",\"value\":\"\"}"
+          "name": "expandedWidth",
+          "attribute": "expandedWidth",
+          "description": "Override the expanded panel width (e.g. '320px', '24rem'). Defaults to responsive sizing.",
+          "type": "string | undefined"
         },
         {
-          "name": "minDate",
-          "attribute": "minDate",
-          "description": "Minimum allowed date",
+          "name": "expandedHeight",
+          "attribute": "expandedHeight",
+          "description": "Override the expanded panel height (e.g. '400px', '50vh').",
           "type": "string | undefined"
         },
         {
-          "name": "maxDate",
-          "attribute": "maxDate",
-          "description": "Maximum allowed date",
-          "type": "string | undefined"
+          "name": "lowered",
+          "attribute": "lowered",
+          "description": "When true, uses a lower elevation shadow in the collapsed state.",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "compact",
-          "attribute": "compact",
-          "description": "Compact mode for smaller UI",
+          "name": "corner",
+          "attribute": "corner",
+          "description": "Corner the window is anchored to.",
+          "type": "SnapCorner",
+          "default": "\"bottom-right\""
+        },
+        {
+          "name": "resizable",
+          "attribute": "resizable",
+          "description": "When true, window can be resized by the user.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "autoCorrect",
-          "attribute": "autoCorrect",
-          "description": "Auto-correct invalid date ranges",
+          "name": "freePosition",
+          "attribute": "freePosition",
+          "description": "When true, window stays at its dragged position instead of snapping to a corner.",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "minGap",
-          "attribute": "minGap",
-          "description": "Minimum gap between dates (in days)",
-          "type": "number",
-          "default": "0"
+          "name": "visualState",
+          "attribute": "visualState",
+          "description": "Visual state of the window (minimized, normal, maximized).",
+          "type": "WindowVisualState",
+          "default": "\"normal\""
         },
         {
-          "name": "maxGap",
-          "attribute": "maxGap",
-          "description": "Maximum gap between dates (in days)",
-          "type": "number | undefined"
+          "name": "minWidth",
+          "attribute": "minWidth",
+          "description": "Minimum width in pixels.",
+          "type": "number",
+          "default": "280"
         },
         {
-          "name": "defaultGap",
-          "attribute": "defaultGap",
-          "description": "Default gap when auto-setting dates (in days)",
+          "name": "minHeight",
+          "attribute": "minHeight",
+          "description": "Minimum height in pixels.",
           "type": "number",
-          "default": "1"
+          "default": "200"
         },
         {
-          "name": "allowSameDate",
-          "attribute": "allowSameDate",
-          "description": "Whether to allow same date selection",
+          "name": "open",
+          "attribute": "open",
+          "description": "Whether the body is expanded.",
           "type": "boolean",
           "default": "false"
         }
-      ],
-      "events": [
-        {
-          "name": "change"
-        }
       ]
     },
     {
-      "name": "schmancy-delay",
-      "path": "./src/delay/delay.ts",
+      "name": "schmancy-autocomplete",
+      "path": "./src/form/fields/autocomplete/autocomplete.ts",
+      "description": "Autocomplete input component with filtering and multi-select support.",
       "attributes": [
         {
-          "name": "delay",
-          "type": "number",
-          "default": "0"
+          "name": "maxHeight",
+          "type": "string",
+          "default": "\"300px\""
         },
         {
-          "name": "motion",
+          "name": "description",
           "type": "string",
-          "default": "\"flyBelow\""
+          "default": "\"\""
         },
         {
-          "name": "once",
-          "type": "boolean | undefined",
-          "default": "true"
-        }
-      ],
-      "properties": [
-        {
-          "name": "delay",
-          "attribute": "delay",
-          "type": "number",
-          "default": "0"
+          "name": "size",
+          "type": "InputSize",
+          "default": "\"md\""
         },
         {
-          "name": "motion",
-          "attribute": "motion",
+          "name": "autocomplete",
           "type": "string",
-          "default": "\"flyBelow\""
+          "default": "\"off\""
         },
         {
-          "name": "parentDelay",
+          "name": "debounceMs",
           "type": "number",
-          "default": "0"
+          "default": "200"
         },
         {
-          "name": "effectiveDelay",
+          "name": "similarityThreshold",
           "type": "number",
-          "default": "0"
-        },
-        {
-          "name": "once",
-          "attribute": "once",
-          "type": "boolean | undefined",
-          "default": "true"
+          "default": "0.3"
         },
         {
-          "name": "assignedElements",
-          "type": "HTMLElement[]"
-        }
-      ]
-    },
-    {
-      "name": "schmancy-details",
-      "path": "./src/details/details.ts",
-      "attributes": [
-        {
-          "name": "summary",
+          "name": "placeholder",
+          "description": "Placeholder text for the input",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "open",
-          "type": "boolean"
-        },
-        {
-          "name": "indicator-placement",
-          "type": "\"start\" | \"end\"",
-          "default": "\"end\""
-        },
-        {
-          "name": "hide-indicator",
+          "name": "multi",
+          "description": "Enable multi-select mode",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "indicator-rotate",
-          "type": "number",
-          "default": "90"
+          "name": "value",
+          "description": "Selected value (single select mode)",
+          "type": "string"
         },
         {
-          "name": "locked",
-          "type": "boolean",
-          "default": "false"
+          "name": "values",
+          "description": "Selected values (multi-select mode)",
+          "type": "string[]"
+        }
+      ],
+      "properties": [
+        {
+          "name": "maxHeight",
+          "attribute": "maxHeight",
+          "type": "string",
+          "default": "\"300px\""
         },
         {
-          "name": "overlay",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "summary-padding",
-          "type": "string",
-          "default": "\"p-3\""
-        },
-        {
-          "name": "content-padding",
-          "type": "string",
-          "default": "\"p-3\""
-        }
-      ],
-      "properties": [
-        {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
-        },
-        {
-          "name": "summary",
-          "attribute": "summary",
+          "name": "description",
+          "attribute": "description",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "open",
-          "attribute": "open",
-          "type": "boolean"
-        },
-        {
-          "name": "indicatorPlacement",
-          "attribute": "indicator-placement",
-          "type": "\"start\" | \"end\"",
-          "default": "\"end\""
+          "name": "size",
+          "attribute": "size",
+          "type": "InputSize",
+          "default": "\"md\""
         },
         {
-          "name": "hideIndicator",
-          "attribute": "hide-indicator",
-          "type": "boolean",
-          "default": "false"
+          "name": "autocomplete",
+          "attribute": "autocomplete",
+          "type": "string",
+          "default": "\"off\""
         },
         {
-          "name": "indicatorRotate",
-          "attribute": "indicator-rotate",
+          "name": "debounceMs",
+          "attribute": "debounceMs",
           "type": "number",
-          "default": "90"
-        },
-        {
-          "name": "locked",
-          "attribute": "locked",
-          "type": "boolean",
-          "default": "false"
+          "default": "200"
         },
         {
-          "name": "overlay",
-          "attribute": "overlay",
-          "type": "boolean",
-          "default": "false"
+          "name": "similarityThreshold",
+          "attribute": "similarityThreshold",
+          "type": "number",
+          "default": "0.3"
         },
         {
-          "name": "summaryPadding",
-          "attribute": "summary-padding",
-          "type": "string",
-          "default": "\"p-3\""
+          "name": "name",
+          "description": "Name attribute for form submission",
+          "type": "string"
         },
         {
-          "name": "contentPadding",
-          "attribute": "content-padding",
-          "type": "string",
-          "default": "\"p-3\""
+          "name": "label",
+          "description": "Label text displayed above the input",
+          "type": "string"
         },
         {
-          "name": "type",
+          "name": "placeholder",
+          "attribute": "placeholder",
+          "description": "Placeholder text for the input",
           "type": "string",
-          "default": "\"solid\""
+          "default": "\"\""
         },
         {
-          "name": "rounded",
-          "type": "string",
-          "default": "\"all\""
-        }
-      ]
-    },
-    {
-      "name": "schmancy-divider",
-      "path": "./src/divider/divider.ts",
-      "attributes": [
-        {
-          "name": "outline",
-          "type": "\"default\" | \"variant\"",
-          "default": "\"variant\""
+          "name": "required",
+          "description": "Whether the field is required",
+          "type": "boolean"
         },
         {
-          "name": "vertical",
+          "name": "multi",
+          "attribute": "multi",
+          "description": "Enable multi-select mode",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "grow",
-          "type": "\"start\" | \"end\" | \"both\"",
-          "default": "\"start\""
-        },
-        {
-          "name": "orientation",
-          "type": "\"horizontal\" | \"vertical\"",
-          "deprecatedMessage": "Use `vertical` property instead. Will be removed in next major version."
-        }
-      ],
-      "properties": [
-        {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
+          "name": "value",
+          "attribute": "value",
+          "description": "Selected value (single select mode)",
+          "type": "string"
         },
         {
-          "name": "outline",
-          "attribute": "outline",
-          "type": "\"default\" | \"variant\"",
-          "default": "\"variant\""
+          "name": "values",
+          "attribute": "values",
+          "description": "Selected values (multi-select mode)",
+          "type": "string[]"
         },
         {
-          "name": "vertical",
-          "attribute": "vertical",
-          "type": "boolean",
-          "default": "false"
+          "name": "cssText",
+          "type": "string"
         },
         {
-          "name": "grow",
-          "attribute": "grow",
-          "type": "\"start\" | \"end\" | \"both\"",
-          "default": "\"start\""
-        },
+          "name": "styleSheet",
+          "type": "CSSStyleSheet | undefined"
+        }
+      ],
+      "events": [
         {
-          "name": "orientation",
-          "attribute": "orientation",
-          "type": "\"horizontal\" | \"vertical\"",
-          "deprecatedMessage": "Use `vertical` property instead. Will be removed in next major version."
+          "name": "change"
         }
       ]
     },
     {
-      "name": "schmancy-dropdown",
-      "path": "./src/dropdown/dropdown-component.ts",
-      "description": "A dropdown component that displays content when triggered.",
+      "name": "schmancy-checkbox",
+      "path": "./src/form/fields/checkbox/checkbox.ts",
       "attributes": [
         {
-          "name": "open",
-          "description": "Whether the dropdown is currently open",
+          "name": "value",
+          "description": "Boolean checked state. Test contract: `cb.value = true` flips the state.\nThe FormData *string* is read from `true-value` attribute (or `'on'`\ndefault) — kept separate from `value` to keep the boolean-state ergonomic.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "placement",
-          "description": "Placement of the dropdown relative to the trigger",
-          "type": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"",
-          "default": "\"bottom-start\""
+          "name": "checked",
+          "description": "Alias for `value` for read-side ergonomics.",
+          "type": "boolean"
         },
         {
-          "name": "distance",
-          "description": "Offset distance in pixels",
-          "type": "number",
-          "default": "8"
+          "name": "size",
+          "description": "M3-aligned sizes: 24dp (xxs) → 32dp (xs) → 40dp (sm) → 48dp (md) → 56dp (lg).",
+          "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xxs\"",
+          "default": "\"md\""
         }
       ],
       "properties": [
         {
-          "name": "open",
-          "attribute": "open",
-          "description": "Whether the dropdown is currently open",
+          "name": "value",
+          "attribute": "value",
+          "description": "Boolean checked state. Test contract: `cb.value = true` flips the state.\nThe FormData *string* is read from `true-value` attribute (or `'on'`\ndefault) — kept separate from `value` to keep the boolean-state ergonomic.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "placement",
-          "attribute": "placement",
-          "description": "Placement of the dropdown relative to the trigger",
-          "type": "\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"",
-          "default": "\"bottom-start\""
-        },
-        {
-          "name": "distance",
-          "attribute": "distance",
-          "description": "Offset distance in pixels",
-          "type": "number",
-          "default": "8"
-        },
-        {
-          "name": "triggerContainer",
-          "type": "HTMLElement"
-        },
-        {
-          "name": "contentContainer",
-          "type": "HTMLElement"
+          "name": "checked",
+          "attribute": "checked",
+          "description": "Alias for `value` for read-side ergonomics.",
+          "type": "boolean"
         },
         {
-          "name": "contentElements",
-          "type": "HTMLElement[]"
-        },
+          "name": "size",
+          "attribute": "size",
+          "description": "M3-aligned sizes: 24dp (xxs) → 32dp (xs) → 40dp (sm) → 48dp (md) → 56dp (lg).",
+          "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xxs\"",
+          "default": "\"md\""
+        }
+      ],
+      "events": [
         {
-          "name": "triggerElements",
-          "type": "HTMLElement[]"
+          "name": "change",
+          "description": "Event fired when the checkbox value changes."
         }
       ],
       "slots": [
-        {
-          "name": "trigger",
-          "description": "The element that triggers the dropdown"
-        },
         {
           "name": "",
-          "description": "Default slot for the dropdown content"
+          "description": "The label for the checkbox."
         }
       ]
     },
     {
-      "name": "schmancy-dropdown-content",
-      "path": "./src/dropdown/dropdown-content.ts",
-      "description": "Content container for the schmancy-dropdown component.",
+      "name": "schmancy-assist-chip",
+      "path": "./src/form/fields/chips/assist-chip.ts",
+      "description": "Assist chip component - prompts user actions like opening calendar events or sharing content\nPure Schmancy implementation with Tailwind CSS and RxJS state management",
       "attributes": [
         {
-          "name": "width",
-          "description": "Width of the dropdown content",
+          "name": "value",
+          "description": "Value identifier for the chip",
           "type": "string",
-          "default": "\"auto\""
+          "default": "\"\""
         },
         {
-          "name": "maxHeight",
-          "description": "Maximum height of the dropdown content",
+          "name": "icon",
+          "description": "Optional icon name (Material Symbols)",
           "type": "string",
-          "default": "\"80vh\""
+          "default": "\"\""
         },
         {
-          "name": "shadow",
-          "description": "Whether to render with a shadow",
+          "name": "href",
+          "description": "Optional href for navigation",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "target",
+          "description": "Target for navigation (e.g., '_blank')",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "disabled",
+          "description": "Disable the chip",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "radius",
-          "description": "Border radius style",
-          "type": "\"sm\" | \"md\" | \"lg\" | \"none\" | \"full\"",
-          "default": "\"md\""
+          "name": "elevated",
+          "description": "Elevated style variant - true by default per M3 spec for assist chips",
+          "type": "boolean",
+          "default": "true"
         }
       ],
       "properties": [
@@ -2404,117 +2449,148 @@
           "default": "[null]"
         },
         {
-          "name": "width",
-          "attribute": "width",
-          "description": "Width of the dropdown content",
+          "name": "value",
+          "attribute": "value",
+          "description": "Value identifier for the chip",
           "type": "string",
-          "default": "\"auto\""
+          "default": "\"\""
         },
         {
-          "name": "maxHeight",
-          "attribute": "maxHeight",
-          "description": "Maximum height of the dropdown content",
+          "name": "icon",
+          "attribute": "icon",
+          "description": "Optional icon name (Material Symbols)",
           "type": "string",
-          "default": "\"80vh\""
+          "default": "\"\""
         },
         {
-          "name": "shadow",
-          "attribute": "shadow",
-          "description": "Whether to render with a shadow",
+          "name": "href",
+          "attribute": "href",
+          "description": "Optional href for navigation",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "target",
+          "attribute": "target",
+          "description": "Target for navigation (e.g., '_blank')",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Disable the chip",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "radius",
-          "attribute": "radius",
-          "description": "Border radius style",
-          "type": "\"sm\" | \"md\" | \"lg\" | \"none\" | \"full\"",
-          "default": "\"md\""
+          "name": "elevated",
+          "attribute": "elevated",
+          "description": "Elevated style variant - true by default per M3 spec for assist chips",
+          "type": "boolean",
+          "default": "true"
         }
       ],
-      "slots": [
+      "events": [
         {
-          "name": "",
-          "description": "Default slot for dropdown content."
-        }
-      ],
-      "cssParts": [
+          "name": "action"
+        },
         {
-          "name": "content",
-          "description": "The inner wrapper element; style to override panel\nbackgrounds, shadows, padding, or borders without shadow-root piercing."
+          "name": "click"
         }
       ]
     },
     {
-      "name": "schmancy-expand-root",
-      "path": "./src/expand/expand-root.component.ts",
+      "name": "schmancy-chips",
+      "path": "./src/form/fields/chips/chips.ts",
       "attributes": [
         {
-          "name": "type",
-          "type": "TSurfaceColor",
-          "default": "\"solid\""
+          "name": "multi",
+          "description": "Whether multiple chips can be selected simultaneously.",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "value",
+          "type": "string | string[]"
+        },
+        {
+          "name": "wrap",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "justify",
+          "type": "\"start\" | \"end\" | \"center\"",
+          "default": "\"start\""
         }
       ],
       "properties": [
         {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
+          "name": "multi",
+          "attribute": "multi",
+          "description": "Whether multiple chips can be selected simultaneously.",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "type",
-          "attribute": "type",
-          "type": "TSurfaceColor",
-          "default": "\"solid\""
+          "name": "value",
+          "attribute": "value",
+          "type": "string | string[]"
+        },
+        {
+          "name": "values",
+          "description": "Typed convenience alias for multi-mode consumers.",
+          "type": "string[]"
+        },
+        {
+          "name": "wrap",
+          "attribute": "wrap",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "justify",
+          "attribute": "justify",
+          "type": "\"start\" | \"end\" | \"center\"",
+          "default": "\"start\""
         },
         {
-          "name": "isOpen",
-          "type": "boolean",
-          "default": "false"
+          "name": "chips",
+          "type": "(HTMLElement | SchmancyFilterChip)[]"
         }
       ]
     },
     {
-      "name": "schmancy-expand",
-      "path": "./src/expand/expand.component.ts",
+      "name": "schmancy-filter-chip",
+      "path": "./src/form/fields/chips/filter-chip.ts",
+      "description": "Filter chip component for content filtering.\n\nFilter chips are the ONLY chip type that maintains persistent selected state.\nThey are used for filtering content by toggling on/off different filter criteria.",
       "attributes": [
         {
-          "name": "summary",
-          "type": "string",
-          "default": "\"\""
-        },
-        {
-          "name": "open",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "summary-padding",
+          "name": "value",
+          "description": "Unique identifier for this filter chip",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "content-padding",
-          "type": "string",
-          "default": "\"\""
+          "name": "selected",
+          "type": "boolean"
         },
         {
-          "name": "hide-indicator",
+          "name": "removable",
+          "description": "Whether to show a remove button",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "indicator-rotate",
-          "type": "number",
-          "default": "90"
-        },
-        {
-          "name": "backdrop",
+          "name": "disabled",
+          "description": "Whether the chip is disabled",
           "type": "boolean",
-          "default": "true"
+          "default": "false"
         },
         {
-          "name": "inline",
+          "name": "elevated",
+          "description": "Whether to use elevated style with shadow",
           "type": "boolean",
           "default": "false"
         }
@@ -2526,119 +2602,92 @@
           "default": "[null]"
         },
         {
-          "name": "summary",
-          "attribute": "summary",
+          "name": "value",
+          "attribute": "value",
+          "description": "Unique identifier for this filter chip",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "open",
-          "attribute": "open",
+          "name": "selected",
+          "attribute": "selected",
+          "type": "boolean"
+        },
+        {
+          "name": "removable",
+          "attribute": "removable",
+          "description": "Whether to show a remove button",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "summaryPadding",
-          "attribute": "summary-padding",
-          "type": "string",
-          "default": "\"\""
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Whether the chip is disabled",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "contentPadding",
-          "attribute": "content-padding",
-          "type": "string",
-          "default": "\"\""
+          "name": "elevated",
+          "attribute": "elevated",
+          "description": "Whether to use elevated style with shadow",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "hideIndicator",
-          "attribute": "hide-indicator",
+          "name": "formAssociated",
           "type": "boolean",
-          "default": "false"
+          "default": "true"
         },
         {
-          "name": "indicatorRotate",
-          "attribute": "indicator-rotate",
-          "type": "number",
-          "default": "90"
+          "name": "internals",
+          "type": "ElementInternals | undefined"
         },
         {
-          "name": "backdrop",
-          "attribute": "backdrop",
-          "type": "boolean",
-          "default": "true"
+          "name": "form",
+          "type": "HTMLFormElement | null | undefined"
+        }
+      ],
+      "events": [
+        {
+          "name": "change",
+          "description": "Dispatched when selection state changes with {value, selected}"
         },
         {
-          "name": "inline",
-          "attribute": "inline",
-          "type": "boolean",
-          "default": "false"
+          "name": "remove",
+          "description": "Dispatched when remove button is clicked (if removable)"
         }
       ]
     },
     {
-      "name": "schmancy-float",
-      "path": "./src/float/float.ts",
+      "name": "schmancy-chip",
+      "path": "./src/form/fields/chips/filter-chip.ts",
       "attributes": [
         {
-          "name": "id",
+          "name": "value",
+          "description": "Unique identifier for this filter chip",
           "type": "string",
-          "default": "\"default\""
-        },
-        {
-          "name": "expandedWidth",
-          "description": "Override the expanded panel width (e.g. '320px', '24rem'). Defaults to responsive sizing.",
-          "type": "string | undefined"
-        },
-        {
-          "name": "expandedHeight",
-          "description": "Override the expanded panel height (e.g. '400px', '50vh').",
-          "type": "string | undefined"
-        },
-        {
-          "name": "lowered",
-          "description": "When true, uses a lower elevation shadow in the collapsed state.",
-          "type": "boolean",
-          "default": "false"
+          "default": "\"\""
         },
         {
-          "name": "corner",
-          "description": "Corner the window is anchored to.",
-          "type": "SnapCorner",
-          "default": "\"bottom-right\""
+          "name": "selected",
+          "type": "boolean"
         },
         {
-          "name": "resizable",
-          "description": "When true, window can be resized by the user.",
+          "name": "removable",
+          "description": "Whether to show a remove button",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "freePosition",
-          "description": "When true, window stays at its dragged position instead of snapping to a corner.",
+          "name": "disabled",
+          "description": "Whether the chip is disabled",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "visualState",
-          "description": "Visual state of the window (minimized, normal, maximized).",
-          "type": "WindowVisualState",
-          "default": "\"normal\""
-        },
-        {
-          "name": "minWidth",
-          "description": "Minimum width in pixels.",
-          "type": "number",
-          "default": "280"
-        },
-        {
-          "name": "minHeight",
-          "description": "Minimum height in pixels.",
-          "type": "number",
-          "default": "200"
-        },
-        {
-          "name": "open",
-          "description": "Whether the body is expanded.",
+          "name": "elevated",
+          "description": "Whether to use elevated style with shadow",
           "type": "boolean",
           "default": "false"
         }
@@ -2650,286 +2699,280 @@
           "default": "[null]"
         },
         {
-          "name": "id",
-          "attribute": "id",
+          "name": "value",
+          "attribute": "value",
+          "description": "Unique identifier for this filter chip",
           "type": "string",
-          "default": "\"default\""
-        },
-        {
-          "name": "expandedWidth",
-          "attribute": "expandedWidth",
-          "description": "Override the expanded panel width (e.g. '320px', '24rem'). Defaults to responsive sizing.",
-          "type": "string | undefined"
+          "default": "\"\""
         },
         {
-          "name": "expandedHeight",
-          "attribute": "expandedHeight",
-          "description": "Override the expanded panel height (e.g. '400px', '50vh').",
-          "type": "string | undefined"
+          "name": "selected",
+          "attribute": "selected",
+          "type": "boolean"
         },
         {
-          "name": "lowered",
-          "attribute": "lowered",
-          "description": "When true, uses a lower elevation shadow in the collapsed state.",
+          "name": "removable",
+          "attribute": "removable",
+          "description": "Whether to show a remove button",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "corner",
-          "attribute": "corner",
-          "description": "Corner the window is anchored to.",
-          "type": "SnapCorner",
-          "default": "\"bottom-right\""
-        },
-        {
-          "name": "resizable",
-          "attribute": "resizable",
-          "description": "When true, window can be resized by the user.",
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Whether the chip is disabled",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "freePosition",
-          "attribute": "freePosition",
-          "description": "When true, window stays at its dragged position instead of snapping to a corner.",
+          "name": "elevated",
+          "attribute": "elevated",
+          "description": "Whether to use elevated style with shadow",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "visualState",
-          "attribute": "visualState",
-          "description": "Visual state of the window (minimized, normal, maximized).",
-          "type": "WindowVisualState",
-          "default": "\"normal\""
+          "name": "formAssociated",
+          "type": "boolean",
+          "default": "true"
         },
         {
-          "name": "minWidth",
-          "attribute": "minWidth",
-          "description": "Minimum width in pixels.",
-          "type": "number",
-          "default": "280"
+          "name": "internals",
+          "type": "ElementInternals | undefined"
         },
         {
-          "name": "minHeight",
-          "attribute": "minHeight",
-          "description": "Minimum height in pixels.",
-          "type": "number",
-          "default": "200"
+          "name": "form",
+          "type": "HTMLFormElement | null | undefined"
+        }
+      ],
+      "events": [
+        {
+          "name": "change",
+          "description": "Dispatched when selection state changes with {value, selected}"
         },
         {
-          "name": "open",
-          "attribute": "open",
-          "description": "Whether the body is expanded.",
-          "type": "boolean",
-          "default": "false"
+          "name": "remove",
+          "description": "Dispatched when remove button is clicked (if removable)"
         }
       ]
     },
     {
-      "name": "schmancy-autocomplete",
-      "path": "./src/form/fields/autocomplete/autocomplete.ts",
-      "description": "Autocomplete input component with filtering and multi-select support.",
-      "attributes": [
-        {
-          "name": "maxHeight",
-          "type": "string",
-          "default": "\"300px\""
-        },
+      "name": "schmancy-input-chip",
+      "path": "./src/form/fields/chips/input-chip.ts",
+      "description": "Input chip component - represents user-provided information that can be removed.\n\nIMPORTANT: Per Material Design 3 specification, input chips do NOT have selected state.\nThey represent discrete pieces of user input (like entered tags, selections from lists, etc.)\nthat can only be removed, not toggled on/off.\n\nUse cases:\n- Displaying selected recipients in an email\n- Showing applied filters that can be removed\n- Tags or keywords entered by the user\n- Selected items from a multi-select dropdown",
+      "attributes": [
         {
-          "name": "description",
+          "name": "value",
+          "description": "Value identifier for the chip",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "size",
-          "type": "InputSize",
-          "default": "\"md\""
-        },
-        {
-          "name": "autocomplete",
+          "name": "icon",
+          "description": "Optional icon name (Material Symbols)",
           "type": "string",
-          "default": "\"off\""
-        },
-        {
-          "name": "debounceMs",
-          "type": "number",
-          "default": "200"
-        },
-        {
-          "name": "similarityThreshold",
-          "type": "number",
-          "default": "0.3"
+          "default": "\"\""
         },
         {
-          "name": "placeholder",
-          "description": "Placeholder text for the input",
+          "name": "avatar",
+          "description": "Optional avatar image URL",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "multi",
-          "description": "Enable multi-select mode",
+          "name": "removable",
+          "description": "Whether to show remove button (default true for input chips)",
           "type": "boolean",
-          "default": "false"
+          "default": "true"
         },
         {
-          "name": "value",
-          "description": "Selected value (single select mode)",
-          "type": "string"
+          "name": "disabled",
+          "description": "Disable the chip",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "values",
-          "description": "Selected values (multi-select mode)",
-          "type": "string[]"
+          "name": "elevated",
+          "description": "Elevated style variant",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "properties": [
         {
-          "name": "maxHeight",
-          "attribute": "maxHeight",
-          "type": "string",
-          "default": "\"300px\""
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[null]"
         },
         {
-          "name": "description",
-          "attribute": "description",
+          "name": "value",
+          "attribute": "value",
+          "description": "Value identifier for the chip",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "size",
-          "attribute": "size",
-          "type": "InputSize",
-          "default": "\"md\""
-        },
-        {
-          "name": "autocomplete",
-          "attribute": "autocomplete",
+          "name": "icon",
+          "attribute": "icon",
+          "description": "Optional icon name (Material Symbols)",
           "type": "string",
-          "default": "\"off\""
-        },
-        {
-          "name": "debounceMs",
-          "attribute": "debounceMs",
-          "type": "number",
-          "default": "200"
-        },
-        {
-          "name": "similarityThreshold",
-          "attribute": "similarityThreshold",
-          "type": "number",
-          "default": "0.3"
-        },
-        {
-          "name": "name",
-          "description": "Name attribute for form submission",
-          "type": "string"
-        },
-        {
-          "name": "label",
-          "description": "Label text displayed above the input",
-          "type": "string"
+          "default": "\"\""
         },
         {
-          "name": "placeholder",
-          "attribute": "placeholder",
-          "description": "Placeholder text for the input",
+          "name": "avatar",
+          "attribute": "avatar",
+          "description": "Optional avatar image URL",
           "type": "string",
           "default": "\"\""
         },
         {
-          "name": "required",
-          "description": "Whether the field is required",
-          "type": "boolean"
+          "name": "removable",
+          "attribute": "removable",
+          "description": "Whether to show remove button (default true for input chips)",
+          "type": "boolean",
+          "default": "true"
         },
         {
-          "name": "multi",
-          "attribute": "multi",
-          "description": "Enable multi-select mode",
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Disable the chip",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "value",
-          "attribute": "value",
-          "description": "Selected value (single select mode)",
-          "type": "string"
+          "name": "elevated",
+          "attribute": "elevated",
+          "description": "Elevated style variant",
+          "type": "boolean",
+          "default": "false"
         },
         {
-          "name": "values",
-          "attribute": "values",
-          "description": "Selected values (multi-select mode)",
-          "type": "string[]"
+          "name": "uiState",
+          "type": "{ chipHover: boolean; removeHover: boolean; focused: boolean; pressed: boolean; }",
+          "default": "{\"chipHover\":false,\"removeHover\":false,\"focused\":false,\"pressed\":false}"
         },
         {
-          "name": "cssText",
-          "type": "string"
+          "name": "formAssociated",
+          "type": "boolean",
+          "default": "true"
         },
         {
-          "name": "styleSheet",
-          "type": "CSSStyleSheet | undefined"
+          "name": "internals",
+          "type": "ElementInternals | undefined"
+        },
+        {
+          "name": "form",
+          "type": "HTMLFormElement | null | undefined"
         }
       ],
       "events": [
         {
-          "name": "change"
+          "name": "click",
+          "description": "Optional click event on chip body (value)"
+        },
+        {
+          "name": "remove",
+          "description": "Dispatched when remove button is clicked (value)"
         }
       ]
     },
     {
-      "name": "schmancy-checkbox",
-      "path": "./src/form/fields/checkbox/checkbox.ts",
+      "name": "schmancy-suggestion-chip",
+      "path": "./src/form/fields/chips/suggestion-chip.ts",
+      "description": "Suggestion chip component - provides contextual recommendations to users\n\nIMPORTANT: Suggestion chips do NOT have a selected state. They are designed to\nprovide suggestions and recommendations that trigger actions when clicked.\nUnlike filter chips, they cannot be toggled on/off.\n\nPure Schmancy implementation with Tailwind CSS and RxJS state management",
       "attributes": [
         {
           "name": "value",
-          "description": "Boolean checked state. Test contract: `cb.value = true` flips the state.\nThe FormData *string* is read from `true-value` attribute (or `'on'`\ndefault) — kept separate from `value` to keep the boolean-state ergonomic.",
-          "type": "boolean",
-          "default": "false"
+          "description": "Value identifier for the chip",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "checked",
-          "description": "Alias for `value` for read-side ergonomics.",
-          "type": "boolean"
+          "name": "icon",
+          "description": "Optional icon name (Material Symbols)",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "size",
-          "description": "M3-aligned sizes: 24dp (xxs) → 32dp (xs) → 40dp (sm) → 48dp (md) → 56dp (lg).",
-          "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xxs\"",
-          "default": "\"md\""
+          "name": "href",
+          "description": "Optional href for navigation",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "target",
+          "description": "Target for navigation (e.g., '_blank')",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "disabled",
+          "description": "Disable the chip",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "elevated",
+          "description": "Elevated style variant - flat by default per M3 spec",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "properties": [
+        {
+          "name": "styles",
+          "type": "CSSResult[]",
+          "default": "[null]"
+        },
         {
           "name": "value",
           "attribute": "value",
-          "description": "Boolean checked state. Test contract: `cb.value = true` flips the state.\nThe FormData *string* is read from `true-value` attribute (or `'on'`\ndefault) — kept separate from `value` to keep the boolean-state ergonomic.",
-          "type": "boolean",
-          "default": "false"
+          "description": "Value identifier for the chip",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "checked",
-          "attribute": "checked",
-          "description": "Alias for `value` for read-side ergonomics.",
-          "type": "boolean"
+          "name": "icon",
+          "attribute": "icon",
+          "description": "Optional icon name (Material Symbols)",
+          "type": "string",
+          "default": "\"\""
         },
         {
-          "name": "size",
-          "attribute": "size",
-          "description": "M3-aligned sizes: 24dp (xxs) → 32dp (xs) → 40dp (sm) → 48dp (md) → 56dp (lg).",
-          "type": "\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xxs\"",
-          "default": "\"md\""
+          "name": "href",
+          "attribute": "href",
+          "description": "Optional href for navigation",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "target",
+          "attribute": "target",
+          "description": "Target for navigation (e.g., '_blank')",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Disable the chip",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "elevated",
+          "attribute": "elevated",
+          "description": "Elevated style variant - flat by default per M3 spec",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "events": [
         {
-          "name": "change",
-          "description": "Event fired when the checkbox value changes."
-        }
-      ],
-      "slots": [
+          "name": "action"
+        },
         {
-          "name": "",
-          "description": "The label for the checkbox."
+          "name": "click"
         }
       ]
     },
@@ -3211,7 +3254,7 @@
         {
           "name": "align",
           "description": "Text alignment within the input.\n- 'left' | 'center' | 'right'",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -3315,7 +3358,7 @@
           "name": "align",
           "attribute": "align",
           "description": "Text alignment within the input.\n- 'left' | 'center' | 'right'",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -3511,7 +3554,7 @@
         {
           "name": "align",
           "description": "Text alignment within the input.\n- 'left' | 'center' | 'right'",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -3615,7 +3658,7 @@
           "name": "align",
           "attribute": "align",
           "description": "Text alignment within the input.\n- 'left' | 'center' | 'right'",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -4154,7 +4197,7 @@
         },
         {
           "name": "align",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -4254,7 +4297,7 @@
         {
           "name": "align",
           "attribute": "align",
-          "type": "\"center\" | \"right\" | \"left\"",
+          "type": "\"right\" | \"left\" | \"center\"",
           "default": "\"left\""
         },
         {
@@ -5478,7 +5521,7 @@
         {
           "name": "alignment",
           "description": "Alignment of navigation items",
-          "type": "\"center\" | \"top\" | \"bottom\"",
+          "type": "\"top\" | \"bottom\" | \"center\"",
           "default": "\"'top'\""
         },
         {
@@ -5525,7 +5568,7 @@
           "name": "alignment",
           "attribute": "alignment",
           "description": "Alignment of navigation items",
-          "type": "\"center\" | \"top\" | \"bottom\"",
+          "type": "\"top\" | \"bottom\" | \"center\"",
           "default": "\"'top'\""
         },
         {