@raylang/elements 0.6.0 → 0.8.0

package/custom-elements.json

@@ -1504,11 +1504,11 @@
             {
               "name": "label-position",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the label.",
+              "description": "Side of the label: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "labelPosition",
-              "default": "right"
+              "default": "end"
             },
             {
               "name": "radius",
@@ -1654,12 +1654,12 @@
               "kind": "field",
               "name": "labelPosition",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the label.",
+              "description": "Side of the label: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "label-position",
               "reflects": true,
-              "default": "right"
+              "default": "end"
             },
             {
               "kind": "field",
@@ -8238,11 +8238,11 @@
             {
               "name": "label-position",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the label.",
+              "description": "Side of the label: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "labelPosition",
-              "default": "right"
+              "default": "end"
             },
             {
               "name": "color",
@@ -8376,12 +8376,12 @@
               "kind": "field",
               "name": "labelPosition",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the label.",
+              "description": "Side of the label: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "label-position",
               "reflects": true,
-              "default": "right"
+              "default": "end"
             },
             {
               "kind": "field",
@@ -9141,9 +9141,9 @@
             {
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
-              "description": "An icon of the registry (or put one in the icon slot).",
+              "description": "An icon of the registry, drawn filled on the current item when it has a filled version (or put one in the icon slot: yours, as it is).",
               "fieldName": "icon"
             },
             {
@@ -9220,9 +9220,9 @@
               "kind": "field",
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
-              "description": "An icon of the registry (or put one in the icon slot).",
+              "description": "An icon of the registry, drawn filled on the current item when it has a filled version (or put one in the icon slot: yours, as it is).",
               "attribute": "icon",
               "reflects": false
             },
@@ -10183,11 +10183,11 @@
             {
               "name": "side",
               "type": {
-                "text": "\"left\" | \"right\""
+                "text": "\"start\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "The edge it sits on.",
+              "description": "The edge it sits on (its border faces the content, its narrow-screen drawer slides from there): start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "side",
-              "default": "left"
+              "default": "start"
             },
             {
               "name": "variant",
@@ -10258,12 +10258,12 @@
               "kind": "field",
               "name": "side",
               "type": {
-                "text": "\"left\" | \"right\""
+                "text": "\"start\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "The edge it sits on.",
+              "description": "The edge it sits on (its border faces the content, its narrow-screen drawer slides from there): start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "side",
               "reflects": true,
-              "default": "left"
+              "default": "start"
             },
             {
               "kind": "field",
@@ -10509,11 +10509,11 @@
             {
               "name": "icon-position",
               "type": {
-                "text": "\"left\" | \"top\""
+                "text": "\"start\" | \"top\" | \"left\""
               },
-              "description": "Label beside the number, or under it (narrow screens, many steps).",
+              "description": "Label beside the number (after it in the reading direction), or under it (narrow screens, many steps). \"left\", its former name, still works.",
               "fieldName": "iconPosition",
-              "default": "left"
+              "default": "start"
             },
             {
               "name": "allow-step-select",
@@ -10586,12 +10586,12 @@
               "kind": "field",
               "name": "iconPosition",
               "type": {
-                "text": "\"left\" | \"top\""
+                "text": "\"start\" | \"top\" | \"left\""
               },
-              "description": "Label beside the number, or under it (narrow screens, many steps).",
+              "description": "Label beside the number (after it in the reading direction), or under it (narrow screens, many steps). \"left\", its former name, still works.",
               "attribute": "icon-position",
               "reflects": true,
-              "default": "left"
+              "default": "start"
             },
             {
               "kind": "field",
@@ -11877,11 +11877,11 @@
             {
               "name": "position",
               "type": {
-                "text": "\"right\" | \"left\" | \"top\" | \"bottom\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\" | \"top\" | \"bottom\""
               },
-              "description": "The edge it slides from.",
+              "description": "The edge it slides from: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "position",
-              "default": "right"
+              "default": "end"
             },
             {
               "name": "size",
@@ -11968,12 +11968,12 @@
               "kind": "field",
               "name": "position",
               "type": {
-                "text": "\"right\" | \"left\" | \"top\" | \"bottom\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\" | \"top\" | \"bottom\""
               },
-              "description": "The edge it slides from.",
+              "description": "The edge it slides from: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "position",
               "reflects": true,
-              "default": "right"
+              "default": "end"
             },
             {
               "kind": "field",
@@ -12147,7 +12147,7 @@
               "type": {
                 "text": "\"bottom-start\" | \"bottom\" | \"bottom-end\" | \"top-start\" | \"top\" | \"top-end\" | \"right-start\" | \"left-start\""
               },
-              "description": "Preferred side and alignment.",
+              "description": "Preferred side and alignment: top/bottom/left/right are sides of the screen; on top and bottom, -start/-end follow the writing direction (right to left, \"bottom-start\" lines up the right edges).",
               "fieldName": "placement",
               "default": "bottom-start"
             },
@@ -12202,7 +12202,7 @@
               "type": {
                 "text": "\"bottom-start\" | \"bottom\" | \"bottom-end\" | \"top-start\" | \"top\" | \"top-end\" | \"right-start\" | \"left-start\""
               },
-              "description": "Preferred side and alignment.",
+              "description": "Preferred side and alignment: top/bottom/left/right are sides of the screen; on top and bottom, -start/-end follow the writing direction (right to left, \"bottom-start\" lines up the right edges).",
               "attribute": "placement",
               "reflects": true,
               "default": "bottom-start"
@@ -12528,7 +12528,7 @@
               "type": {
                 "text": "\"bottom\" | \"bottom-start\" | \"bottom-end\" | \"top\" | \"top-start\" | \"top-end\" | \"left\" | \"left-start\" | \"left-end\" | \"right\" | \"right-start\" | \"right-end\""
               },
-              "description": "Preferred side and alignment.",
+              "description": "Preferred side and alignment: top/bottom/left/right are sides of the screen; on top and bottom, -start/-end follow the writing direction (right to left, \"bottom-start\" lines up the right edges).",
               "fieldName": "placement",
               "default": "bottom"
             },
@@ -12592,7 +12592,7 @@
               "type": {
                 "text": "\"bottom\" | \"bottom-start\" | \"bottom-end\" | \"top\" | \"top-start\" | \"top-end\" | \"left\" | \"left-start\" | \"left-end\" | \"right\" | \"right-start\" | \"right-end\""
               },
-              "description": "Preferred side and alignment.",
+              "description": "Preferred side and alignment: top/bottom/left/right are sides of the screen; on top and bottom, -start/-end follow the writing direction (right to left, \"bottom-start\" lines up the right edges).",
               "attribute": "placement",
               "reflects": true,
               "default": "bottom"
@@ -12750,7 +12750,7 @@
               "type": {
                 "text": "\"top\" | \"bottom\" | \"left\" | \"right\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\""
               },
-              "description": "Preferred side.",
+              "description": "Preferred side; -start/-end follow the writing direction.",
               "fieldName": "placement",
               "default": "top"
             },
@@ -12823,7 +12823,7 @@
               "type": {
                 "text": "\"top\" | \"bottom\" | \"left\" | \"right\" | \"top-start\" | \"top-end\" | \"bottom-start\" | \"bottom-end\""
               },
-              "description": "Preferred side.",
+              "description": "Preferred side; -start/-end follow the writing direction.",
               "attribute": "placement",
               "reflects": true,
               "default": "top"
@@ -12988,11 +12988,11 @@
             {
               "name": "chevron-position",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the chevron.",
+              "description": "Side of the chevron: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "chevronPosition",
-              "default": "right"
+              "default": "end"
             }
           ],
           "members": [
@@ -13031,12 +13031,12 @@
               "kind": "field",
               "name": "chevronPosition",
               "type": {
-                "text": "\"right\" | \"left\""
+                "text": "\"end\" | \"start\" | \"right\" | \"left\""
               },
-              "description": "Side of the chevron.",
+              "description": "Side of the chevron: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "chevron-position",
               "reflects": true,
-              "default": "right"
+              "default": "end"
             },
             {
               "kind": "field",
@@ -13997,7 +13997,7 @@
             {
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Registry icon of the mark, or none. The icon slot replaces it.",
               "fieldName": "icon",
@@ -14083,7 +14083,7 @@
               "kind": "field",
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Registry icon of the mark, or none. The icon slot replaces it.",
               "attribute": "icon",
@@ -14844,7 +14844,7 @@
           "name": "RayIcon",
           "tagName": "ray-icon",
           "customElement": true,
-          "description": "setIcons({ name: '<svg…>' }) replaces or adds icons (SVG markup or an SVGElement, drawn with currentColor); iconNames() lists them. Sizes follow the font unless size; --ray-icon-size and --ray-icon-stroke tune the whole system.",
+          "description": "setIcons({ name: '<svg…>' }) replaces or adds icons (SVG markup or an SVGElement, drawn with currentColor); iconNames() lists them. An icon may have a filled version for a state (filled; \"<name>:filled\" in setIcons; iconNames({ filled: true }) lists them). The components draw roles (\"ui.close\", \"ui.remove\", \"ui.expand\"…; iconAliases()), each its glyph until the app registers the role: setIcons({ \"ui.remove\": … }) changes only the chips' ×. Sizes follow the font unless size; --ray-icon-size and --ray-icon-stroke tune the whole system.",
           "superclass": {
             "name": "RayElement"
           },
@@ -14852,11 +14852,27 @@
             {
               "name": "name",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Registered icon name (iconNames()); \"none\" draws nothing, a blank that keeps the alignment (a menu item without its check).",
               "fieldName": "name"
             },
+            {
+              "name": "filled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "The filled version, for a state (active, selected, favorite, unread); the outline icon when there is none. Built in: user, info, circle-check, alert-triangle, circle-x, folder, bell, star, settings, home, message-circle.",
+              "fieldName": "filled"
+            },
+            {
+              "name": "mirror",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Mirrored in a right-to-left context (dir=\"rtl\"), for an icon that points along the text: back, forward, send, undo. The roles that do (ui.next, ui.previous, ui.first, ui.last, ui.disclosure, ui.separator) mirror by themselves.",
+              "fieldName": "mirror"
+            },
             {
               "name": "size",
               "type": {
@@ -14895,12 +14911,32 @@
               "kind": "field",
               "name": "name",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Registered icon name (iconNames()); \"none\" draws nothing, a blank that keeps the alignment (a menu item without its check).",
               "attribute": "name",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "filled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "The filled version, for a state (active, selected, favorite, unread); the outline icon when there is none. Built in: user, info, circle-check, alert-triangle, circle-x, folder, bell, star, settings, home, message-circle.",
+              "attribute": "filled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "mirror",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Mirrored in a right-to-left context (dir=\"rtl\"), for an icon that points along the text: back, forward, send, undo. The roles that do (ui.next, ui.previous, ui.first, ui.last, ui.disclosure, ui.separator) mirror by themselves.",
+              "attribute": "mirror",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "size",
@@ -15853,11 +15889,11 @@
             {
               "name": "align",
               "type": {
-                "text": "\"left\" | \"right\""
+                "text": "\"start\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "Side of the line.",
+              "description": "Side of the line: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "align",
-              "default": "left"
+              "default": "start"
             },
             {
               "name": "bullet-size",
@@ -15908,12 +15944,12 @@
               "kind": "field",
               "name": "align",
               "type": {
-                "text": "\"left\" | \"right\""
+                "text": "\"start\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "Side of the line.",
+              "description": "Side of the line: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "align",
               "reflects": true,
-              "default": "left"
+              "default": "start"
             },
             {
               "kind": "field",
@@ -15999,7 +16035,7 @@
             {
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "An icon of the registry in the bullet.",
               "fieldName": "icon"
@@ -16047,7 +16083,7 @@
               "kind": "field",
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "An icon of the registry in the bullet.",
               "attribute": "icon",
@@ -16195,7 +16231,7 @@
             {
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "A registered icon name, or none.",
               "fieldName": "icon"
@@ -16264,7 +16300,7 @@
               "kind": "field",
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "A registered icon name, or none.",
               "attribute": "icon",
@@ -16483,7 +16519,7 @@
             {
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Status icon from the registry (default: from the color); \"none\" for no icon.",
               "fieldName": "icon"
@@ -16546,7 +16582,7 @@
               "kind": "field",
               "name": "icon",
               "type": {
-                "text": "string"
+                "text": "IconName"
               },
               "description": "Status icon from the registry (default: from the color); \"none\" for no icon.",
               "attribute": "icon",
@@ -16639,11 +16675,11 @@
             {
               "name": "position",
               "type": {
-                "text": "\"bottom-right\" | \"bottom-left\" | \"bottom-center\" | \"top-right\" | \"top-left\" | \"top-center\""
+                "text": "\"bottom-end\" | \"bottom-start\" | \"bottom-center\" | \"top-end\" | \"top-start\" | \"top-center\" | \"bottom-right\" | \"bottom-left\" | \"top-right\" | \"top-left\""
               },
-              "description": "Corner of the stack.",
+              "description": "Corner of the stack: -start/-end follow the writing direction; -left/-right are sides of the screen.",
               "fieldName": "position",
-              "default": "bottom-right"
+              "default": "bottom-end"
             },
             {
               "name": "limit",
@@ -16686,12 +16722,12 @@
               "kind": "field",
               "name": "position",
               "type": {
-                "text": "\"bottom-right\" | \"bottom-left\" | \"bottom-center\" | \"top-right\" | \"top-left\" | \"top-center\""
+                "text": "\"bottom-end\" | \"bottom-start\" | \"bottom-center\" | \"top-end\" | \"top-start\" | \"top-center\" | \"bottom-right\" | \"bottom-left\" | \"top-right\" | \"top-left\""
               },
-              "description": "Corner of the stack.",
+              "description": "Corner of the stack: -start/-end follow the writing direction; -left/-right are sides of the screen.",
               "attribute": "position",
               "reflects": true,
-              "default": "bottom-right"
+              "default": "bottom-end"
             },
             {
               "kind": "field",
@@ -17634,8 +17670,24 @@
               "type": {
                 "text": "string"
               },
-              "description": "What a step is called: \"Round\" is announced \"Round 4 of 12\" and names the element. Default: Step (named Steps).",
+              "description": "What a step is called: \"Round\" is announced \"Round 4 of 12\" and names the element. Default: Step (named Steps). In another language, use value-text.",
               "fieldName": "label"
+            },
+            {
+              "name": "value-text",
+              "type": {
+                "text": "string"
+              },
+              "description": "The announced text, {step} (the current one, from 1) and {count} replaced, numbers in the page's language: value-text=\"Asalto {step} de {count}\". Default: \"<label> {step} of {count}\".",
+              "fieldName": "valueText"
+            },
+            {
+              "name": "done-text",
+              "type": {
+                "text": "string"
+              },
+              "description": "The announced text once every step is done (value = count), with {count}. Default: value-text, else \"{count} of {count}, done\".",
+              "fieldName": "doneText"
             }
           ],
           "members": [
@@ -17699,9 +17751,29 @@
               "type": {
                 "text": "string"
               },
-              "description": "What a step is called: \"Round\" is announced \"Round 4 of 12\" and names the element. Default: Step (named Steps).",
+              "description": "What a step is called: \"Round\" is announced \"Round 4 of 12\" and names the element. Default: Step (named Steps). In another language, use value-text.",
               "attribute": "label",
               "reflects": false
+            },
+            {
+              "kind": "field",
+              "name": "valueText",
+              "type": {
+                "text": "string"
+              },
+              "description": "The announced text, {step} (the current one, from 1) and {count} replaced, numbers in the page's language: value-text=\"Asalto {step} de {count}\". Default: \"<label> {step} of {count}\".",
+              "attribute": "value-text",
+              "reflects": false
+            },
+            {
+              "kind": "field",
+              "name": "doneText",
+              "type": {
+                "text": "string"
+              },
+              "description": "The announced text once every step is done (value = count), with {count}. Default: value-text, else \"{count} of {count}, done\".",
+              "attribute": "done-text",
+              "reflects": false
             }
           ],
           "events": [],
@@ -19080,21 +19152,21 @@
             {
               "kind": "method",
               "name": "scrollToStart",
-              "description": "Scrolls to the top (left)."
+              "description": "Scrolls to the start: the top, or the left when horizontal (the right right to left)."
             },
             {
               "kind": "method",
               "name": "scrollToEnd",
-              "description": "Scrolls to the bottom (right when horizontal)."
+              "description": "Scrolls to the end: the bottom, or the right when horizontal (the left right to left)."
             }
           ],
           "events": [
             {
               "name": "ray-reach-end",
               "type": {
-                "text": "CustomEvent<{ edge: \"bottom\" | \"right\" }>"
+                "text": "CustomEvent<{ edge: \"bottom\" | \"right\" | \"left\" }>"
               },
-              "description": "The end came within threshold (once per arrival)."
+              "description": "The end came within threshold (once per arrival): the bottom, or the right when horizontal (the left right to left)."
             }
           ],
           "slots": [
@@ -19168,9 +19240,9 @@
             {
               "name": "label-position",
               "type": {
-                "text": "\"left\" | \"center\" | \"right\""
+                "text": "\"start\" | \"center\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "Where the label sits.",
+              "description": "Where the label sits: start/end follow the writing direction; left/right are sides of the screen.",
               "fieldName": "labelPosition",
               "default": "center"
             },
@@ -19219,9 +19291,9 @@
               "kind": "field",
               "name": "labelPosition",
               "type": {
-                "text": "\"left\" | \"center\" | \"right\""
+                "text": "\"start\" | \"center\" | \"end\" | \"left\" | \"right\""
               },
-              "description": "Where the label sits.",
+              "description": "Where the label sits: start/end follow the writing direction; left/right are sides of the screen.",
               "attribute": "label-position",
               "reflects": true,
               "default": "center"