@latty-ds/web 0.10.4 → 1.0.0

package/dist/manifest.json

@@ -229,11 +229,16 @@
         "default": "filled"
       },
       {
-        "name": "title",
+        "name": "heading",
         "description": "Optional bold heading above the body content.",
         "type": "text",
         "default": ""
       },
+      {
+        "name": "title",
+        "type": "text",
+        "default": ""
+      },
       {
         "name": "icon",
         "description": "Icon to show before the body. Leave empty for auto (shows variant icon for status variants),\nset to `\"none\"` to suppress, or pass any icon name to override.",
@@ -242,10 +247,16 @@
       },
       {
         "name": "closable",
-        "description": "Show a dismiss button. Clicking it fires lt-close and removes the element.",
+        "description": "Show a dismiss button. Clicking it fires `close` and hides the element (sets `open` to false).",
         "type": "boolean",
         "default": false
       },
+      {
+        "name": "open",
+        "description": "Whether the alert is visible. Defaults to true, so existing markup with no attribute keeps showing.\nDismissing (or setting this to false directly) hides the alert but does not remove it from the DOM —\nthat choice is left to the consumer, since a framework that owns this node would otherwise fight the\nalert over removing it out from under its own reconciliation.",
+        "type": "boolean",
+        "default": true
+      },
       {
         "name": "background",
         "description": "Background color override. Accepts a hex value (#1a1a2e) or a CSS token name (--lt-color-primary-600).",
@@ -254,9 +265,15 @@
       },
       {
         "name": "uppercase",
-        "description": "Renders the title in small caps with wider letter spacing.",
+        "description": "Renders the heading in small caps with wider letter spacing.",
         "type": "boolean",
         "default": false
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the dismiss button's accessible name), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -379,6 +396,12 @@
         "description": "The character or element to use as a separator between breadcrumb items.\nThis is passed down to all children items via CSS variables.",
         "type": "text",
         "default": "/"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the breadcrumb nav's landmark label), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -513,6 +536,24 @@
           "reset"
         ],
         "default": "button"
+      },
+      {
+        "name": "name",
+        "description": "Name submitted alongside `value` when this button triggers a form submission (`type=\"submit\"`), matching a\nnative `<button name value>` — only included in the submitted data for the button that actually triggered\nthe submission, not every submit button in the form.",
+        "type": "text",
+        "default": ""
+      },
+      {
+        "name": "value",
+        "description": "Value submitted alongside `name`. See `name`.",
+        "type": "text",
+        "default": ""
+      },
+      {
+        "name": "form-action",
+        "description": "Overrides the form's own `action` for a submission triggered by this button, matching a native\n`<button formaction>`. Only applies when `type=\"submit\"`.",
+        "type": "text",
+        "default": ""
       }
     ]
   },
@@ -566,11 +607,16 @@
       },
       {
         "name": "week-start",
-        "description": "First day of the week. 0 = Sunday, 1 = Monday.",
+        "description": "First day of the week (0 = Sunday … 6 = Saturday). Defaults to whatever `locale` implies (via\n`Intl.Locale#getWeekInfo`, falling back to Sunday) — set this explicitly only to override that.",
         "type": "select",
         "options": [
           "0",
-          "1"
+          "1",
+          "2",
+          "3",
+          "4",
+          "5",
+          "6"
         ],
         "default": "0"
       },
@@ -591,6 +637,12 @@
         "description": "Number of month panels to display side-by-side.",
         "type": "number",
         "default": 1
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (nav button labels, the \"Today\" footer button, the month/year picker toggle), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -622,7 +674,7 @@
       },
       {
         "name": "checked",
-        "description": "Whether the checkbox is checked.",
+        "description": "Whether the checkbox is checked. Not reflected as an attribute — a native checkbox's `checked` _content_\nattribute stays fixed at the markup default and never tracks interaction (that's what `defaultChecked` is\nfor); reflecting it live meant `formResetCallback` could no longer tell what the original default was. Read\nthe property, or the `change` event's `detail.checked`, instead of `[checked]`/`hasAttribute('checked')`.",
         "type": "boolean",
         "default": false
       },
@@ -671,6 +723,12 @@
         "description": "Value attribute for form submission.",
         "type": "text",
         "default": "on"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the required-field validation message), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -729,6 +787,12 @@
         "description": "Background color override. Accepts a hex value (#1a1a2e) or a CSS token name (--lt-color-primary-600).",
         "type": "color",
         "default": ""
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the delete button's accessible name), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -736,7 +800,7 @@
     "members": [
       {
         "name": "value",
-        "description": "The current color value. Accepts hex (`#7c3aed`), rgb (`rgb(124, 58, 237)`),\nor hsl (`hsl(263, 70%, 58%)`). Emitted values match the `format` prop.",
+        "description": "The current color value. Accepts hex (`#7c3aed`), rgb (`rgb(124, 58, 237)`),\nor hsl (`hsl(263, 70%, 58%)`). Emitted values match the `format` prop. Not reflected as an attribute —\nread the property, or the `change` event's `detail.value`, instead of `getAttribute('value')`/`[value]`.",
         "type": "text",
         "default": ""
       },
@@ -791,6 +855,12 @@
           "lg"
         ],
         "default": "md"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the required-field validation message), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -798,7 +868,7 @@
     "members": [
       {
         "name": "value",
-        "description": "Currently selected value.",
+        "description": "Currently selected value. Not reflected as an attribute — read the property, or the `change` event's\n`detail.value`, instead of `getAttribute('value')`/`[value]` (consistent with the rest of the form\ncontrols; see `lt-textfield`'s equivalent doc comment for why).",
         "type": "text",
         "default": ""
       },
@@ -860,6 +930,12 @@
         "description": "Name used in form submission.",
         "type": "text",
         "default": ""
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (validation message, \"no results\" text), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -867,7 +943,7 @@
     "members": [
       {
         "name": "value",
-        "description": "Selected date in ISO format (YYYY-MM-DD).",
+        "description": "Selected date in ISO format (YYYY-MM-DD). Not reflected as an attribute — read the property, or the\n`change` event's `detail.value`, instead of `getAttribute('value')`/`[value]`.",
         "type": "text",
         "default": ""
       },
@@ -903,9 +979,9 @@
       },
       {
         "name": "week-start",
-        "description": "First day of the week in the calendar. 0 = Sunday, 1 = Monday.",
+        "description": "First day of the week in the calendar (0 = Sunday … 6 = Saturday). Defaults to whatever `locale` implies —\nset this explicitly only to override that. Forwarded as-is to the internal `lt-calendar`, which does the\nactual derivation when this is left unset.",
         "type": "text",
-        "default": "0"
+        "default": ""
       },
       {
         "name": "label",
@@ -962,15 +1038,21 @@
       },
       {
         "name": "name",
-        "description": "Name used in form submission via a hidden input.",
+        "description": "Name used in form submission (through `ElementInternals`, so no hidden input is rendered).",
         "type": "text",
         "default": ""
       },
       {
         "name": "disabled-dates",
-        "description": "Individual dates to disable in the calendar, as Date objects.",
+        "description": "Individual dates to disable in the calendar, as Date objects. Set as a JS property (`.disabledDates`).",
         "type": "text",
         "default": "[]"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (validation message, calendar popover's accessible label), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -989,7 +1071,7 @@
       },
       {
         "name": "value",
-        "description": "Current value in the format required by the native input (`YYYY-MM-DD`, `HH:MM`, or `YYYY-MM-DDTHH:MM`).",
+        "description": "Current value in the format required by the native input (`YYYY-MM-DD`, `HH:MM`, or `YYYY-MM-DDTHH:MM`).\nNot reflected as an attribute — read the property, or the `change` event's `detail.value`, instead of\n`getAttribute('value')`/`[value]`.",
         "type": "text",
         "default": ""
       },
@@ -1087,9 +1169,14 @@
         "type": "boolean",
         "default": false
       },
+      {
+        "name": "heading",
+        "description": "Dialog heading displayed in the header.",
+        "type": "text",
+        "default": ""
+      },
       {
         "name": "title",
-        "description": "Dialog title displayed in the header.",
         "type": "text",
         "default": ""
       },
@@ -1113,7 +1200,7 @@
       },
       {
         "name": "uppercase",
-        "description": "Renders the dialog title in small caps with wider letter spacing.",
+        "description": "Renders the dialog heading in small caps with wider letter spacing.",
         "type": "boolean",
         "default": false
       },
@@ -1134,6 +1221,12 @@
         "description": "Visual appearance of the internal surface, matching `lt-surface`'s vocabulary.",
         "type": "text",
         "default": "filled"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the close button's accessible name), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -1552,6 +1645,12 @@
         "description": "Disable all controls.",
         "type": "boolean",
         "default": false
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (nav landmark label, control button labels), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -1593,6 +1692,18 @@
         "type": "text",
         "default": ""
       },
+      {
+        "name": "max",
+        "description": "The value `value` is measured against (0–100 becomes 0–max). Ignored when `indeterminate` is true.",
+        "type": "number",
+        "default": 100
+      },
+      {
+        "name": "value-text",
+        "description": "Overrides the spoken value with a custom string (e.g. \"3 of 5 steps\") for scales a bare percentage\ndoesn't describe well. Leave unset to let `aria-valuenow`/`aria-valuemax` speak for themselves.",
+        "type": "text",
+        "default": ""
+      },
       {
         "name": "indeterminate",
         "description": "When true the bar animates continuously without a set value.",
@@ -1633,7 +1744,6 @@
       },
       {
         "name": "helper-text",
-        "description": "Helper text displayed below the radio group.",
         "type": "text",
         "default": ""
       },
@@ -1679,7 +1789,7 @@
       },
       {
         "name": "checked",
-        "description": "Whether the radio is checked.",
+        "description": "Whether the radio is checked. Not reflected as an attribute — a native radio's `checked` _content_\nattribute stays fixed at the markup default and never tracks interaction; reflecting it live meant\n`formResetCallback` could no longer tell what the original default was. Read the property, or the `change`\nevent's `detail.checked`, instead of `[checked]`/`hasAttribute('checked')`.",
         "type": "boolean",
         "default": false
       },
@@ -1722,6 +1832,18 @@
         "description": "Value attribute for form submission.",
         "type": "text",
         "default": ""
+      },
+      {
+        "name": "tabbable",
+        "description": "Whether this radio is reachable with Tab. Defaults to true for a standalone radio; `lt-radio-group` drives\nthis itself for its managed radios — a roving tabindex (only the checked radio, or the first enabled one,\nis a Tab stop), matching the native radiogroup pattern.",
+        "type": "boolean",
+        "default": true
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the required-field validation message), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -1751,10 +1873,10 @@
         "default": "md"
       },
       {
-        "name": "value",
-        "description": "Current selected value.",
-        "type": "text",
-        "default": ""
+        "name": "multiple",
+        "description": "Allow more than one option to be selected. The option list stays open while picking, and `value` becomes an\narray of the selected values.",
+        "type": "boolean",
+        "default": false
       },
       {
         "name": "placeholder",
@@ -1791,6 +1913,12 @@
         "description": "Whether the select is required. Shows asterisk in label when true.",
         "type": "boolean",
         "default": false
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the required-field validation message), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -1804,19 +1932,19 @@
       },
       {
         "name": "anchor",
-        "description": "Edge from which the panel slides in.",
+        "description": "Edge from which the panel slides in. `'start'`/`'end'` flip with reading direction.",
         "type": "select",
         "options": [
-          "left",
-          "right",
+          "start",
+          "end",
           "top",
           "bottom"
         ],
-        "default": "left"
+        "default": "start"
       },
       {
         "name": "size",
-        "description": "Panel width (left/right anchors) or height (top/bottom anchors).",
+        "description": "Panel width (start/end anchors) or height (top/bottom anchors).",
         "type": "text",
         "default": "320px"
       },
@@ -1843,6 +1971,12 @@
         "description": "Backdrop darkness as an alpha value from 0 (transparent) to 1 (opaque).",
         "type": "number",
         "default": 0.45
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the close button's accessible name), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -1919,6 +2053,7 @@
       },
       {
         "name": "value",
+        "description": "Not reflected as an attribute — read the property, or the `change` event's `detail.value`, instead of\n`getAttribute('value')`/`[value]`.",
         "type": "number",
         "default": 0
       },
@@ -1992,6 +2127,12 @@
         "description": "Visual appearance of the internal surface, matching `lt-surface`'s vocabulary.",
         "type": "text",
         "default": "filled"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the close button's accessible name), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -2084,7 +2225,7 @@
       },
       {
         "name": "checked",
-        "description": "Whether the switch is checked (on).",
+        "description": "Whether the switch is checked (on). Not reflected as an attribute — a native checkbox's `checked` _content_\nattribute stays fixed at the markup default and never tracks interaction; reflecting it live meant\n`formResetCallback` could no longer tell what the original default was. Read the property, or the `change`\nevent's `detail.checked`, instead of `[checked]`/`hasAttribute('checked')`.",
         "type": "boolean",
         "default": false
       },
@@ -2127,6 +2268,12 @@
         "description": "Value attribute for form submission.",
         "type": "text",
         "default": "on"
+      },
+      {
+        "name": "labels",
+        "description": "Overridable UI text (the required-field validation message), for i18n. English defaults — override only the keys you need.",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -2275,6 +2422,12 @@
         "type": "text",
         "default": "No data available"
       },
+      {
+        "name": "label",
+        "description": "Accessible name for the table. Required when a page has more than one table, since column labels alone\ndon't tell assistive tech which table it's in.",
+        "type": "text",
+        "default": ""
+      },
       {
         "name": "row-key",
         "description": "Field name to use as a stable row identity key for efficient DOM reuse during sorts/updates.\nWhen omitted, falls back to the row's JSON representation.",
@@ -2316,7 +2469,7 @@
       },
       {
         "name": "as",
-        "description": "HTML tag to render. Defaults to the semantic tag for the chosen variant.",
+        "description": "HTML tag to render. Defaults to the semantic tag for the chosen variant; anything outside `TextTag` is ignored.",
         "type": "select",
         "options": [
           "",
@@ -2379,7 +2532,7 @@
       },
       {
         "name": "value",
-        "description": "Current value of the input.",
+        "description": "Current value of the input. Not reflected as an attribute: for `type=\"password\"` that would put whatever\nthe user types in plain text in the DOM (`outerHTML`, DevTools, session-replay/DOM-mutation recorders) —\nvisible via `getAttribute('value')`/`[value]` regardless of input type. Read the property, or the\n`input`/`change` event's `detail.value`, instead of an attribute selector.",
         "type": "text",
         "default": ""
       },
@@ -2454,6 +2607,23 @@
         "description": "Renders the label in small caps with wider letter spacing.",
         "type": "boolean",
         "default": false
+      },
+      {
+        "name": "clearable",
+        "description": "Shows a clear button while the field has a value. Not shown for password fields, which have their own toggle.",
+        "type": "boolean",
+        "default": false
+      },
+      {
+        "name": "counter",
+        "description": "Shows the character count as `length / max` below the field. Uses `max` as the limit, which is also enforced natively.",
+        "type": "boolean",
+        "default": false
+      },
+      {
+        "name": "labels",
+        "type": "text",
+        "default": "{}"
       }
     ]
   },
@@ -2472,8 +2642,8 @@
         "options": [
           "top",
           "bottom",
-          "left",
-          "right"
+          "start",
+          "end"
         ],
         "default": "top"
       },

package/dist/utils/dev-warn.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logs a developer-facing warning, stripped in production. The `typeof process` guard keeps an unbundled browser
+ * (no `process` global) silent instead of throwing; bundlers replace `process.env.NODE_ENV` and drop the branch.
+ */
+export declare const devWarn: (tag: string, message: string) => void;

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
 export { dispatch } from './dispatch';
 export { resolveColorValue } from './color';
 export { createClickOutsideHandler } from './click-outside';
+export { devWarn } from './dev-warn';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latty-ds/web",
-  "version": "0.10.4",
+  "version": "1.0.0",
   "description": "Web Components for the Latty design system — framework-agnostic UI components built with Lit",
   "license": "MIT",
   "repository": {
@@ -148,10 +148,6 @@
       "import": "./dist/components/select/index.js",
       "default": "./dist/components/select/index.js"
     },
-    "./shared": {
-      "import": "./dist/components/shared/index.js",
-      "default": "./dist/components/shared/index.js"
-    },
     "./sidepanel": {
       "import": "./dist/components/sidepanel/index.js",
       "default": "./dist/components/sidepanel/index.js"
@@ -224,8 +220,8 @@
   },
   "dependencies": {
     "@floating-ui/dom": "^1.7.6",
-    "@latty-ds/icons": "0.10.4"
+    "@latty-ds/icons": "1.0.0"
   },
   "customElements": "custom-elements.json",
-  "gitHead": "ce56485456ff6ef71d5c4606bdf484928ae30401"
+  "gitHead": "fa5fe02064dea0ecfbb11423a5e51093b2bf7095"
 }