@kubex/zinc 1.1.119 → 1.1.120

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,17 +13,6 @@
13
13
  }
14
14
  ]
15
15
  },
16
- {
17
- "name": "zn-action-bar",
18
- "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
19
- "attributes": [],
20
- "references": [
21
- {
22
- "name": "Documentation",
23
- "url": "https://zinc.style/components/action-bar"
24
- }
25
- ]
26
- },
27
16
  {
28
17
  "name": "zn-alert",
29
18
  "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -64,6 +53,17 @@
64
53
  }
65
54
  ]
66
55
  },
56
+ {
57
+ "name": "zn-action-bar",
58
+ "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
59
+ "attributes": [],
60
+ "references": [
61
+ {
62
+ "name": "Documentation",
63
+ "url": "https://zinc.style/components/action-bar"
64
+ }
65
+ ]
66
+ },
67
67
  {
68
68
  "name": "zn-animated-button",
69
69
  "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -138,21 +138,6 @@
138
138
  }
139
139
  ]
140
140
  },
141
- {
142
- "name": "zn-bulk-actions",
143
- "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
144
- "attributes": [
145
- { "name": "name", "values": [] },
146
- { "name": "value", "values": [{ "name": "PropertyKey" }] },
147
- { "name": "actions", "values": [{ "name": "BulkActionData" }] }
148
- ],
149
- "references": [
150
- {
151
- "name": "Documentation",
152
- "url": "https://zinc.style/components/bulk-actions"
153
- }
154
- ]
155
- },
156
141
  {
157
142
  "name": "zn-background",
158
143
  "description": "Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.\n---\n\n\n### **Slots:**\n - _default_ - Content displayed above the background layers.\n\n### **CSS Properties:**\n - **--zn-background-color** - Fallback colour when the `color` attribute is not set. _(default: undefined)_\n- **--zn-background-image-position** - Position of the background image. Defaults to `center`. _(default: undefined)_\n- **--zn-background-overlay-angle** - Direction of the overlay gradient. Defaults to `110deg`. _(default: undefined)_\n- **--zn-background-floating-icon-color** - Colour of the floating icons. Defaults to `currentColor`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's full-size background canvas.\n- **image** - The decorative background image.\n- **overlay** - The contrast overlay between the image and content.\n- **floating-icons** - The non-interactive layer containing the floating icons.\n- **floating-icon** - Each floating `zn-icon`.\n- **content** - The wrapper around the default slot.",
@@ -206,22 +191,17 @@
206
191
  ]
207
192
  },
208
193
  {
209
- "name": "zn-button-group",
210
- "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Properties:**\n - **--grow** - Use flex-grow to fill available space. _(default: undefined)_\n- **--start** - Justify content at the start of the flex space. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
194
+ "name": "zn-bulk-actions",
195
+ "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
211
196
  "attributes": [
212
- {
213
- "name": "direction",
214
- "values": [{ "name": "horizontal" }, { "name": "vertical" }]
215
- },
216
- { "name": "grow", "values": [] },
217
- { "name": "wrap", "values": [] },
218
- { "name": "start", "values": [] },
219
- { "name": "gap", "values": [] }
197
+ { "name": "name", "values": [] },
198
+ { "name": "value", "values": [{ "name": "PropertyKey" }] },
199
+ { "name": "actions", "values": [{ "name": "BulkActionData" }] }
220
200
  ],
221
201
  "references": [
222
202
  {
223
203
  "name": "Documentation",
224
- "url": "https://zinc.style/components/button-group"
204
+ "url": "https://zinc.style/components/bulk-actions"
225
205
  }
226
206
  ]
227
207
  },
@@ -363,6 +343,26 @@
363
343
  }
364
344
  ]
365
345
  },
346
+ {
347
+ "name": "zn-button-group",
348
+ "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Properties:**\n - **--grow** - Use flex-grow to fill available space. _(default: undefined)_\n- **--start** - Justify content at the start of the flex space. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
349
+ "attributes": [
350
+ {
351
+ "name": "direction",
352
+ "values": [{ "name": "horizontal" }, { "name": "vertical" }]
353
+ },
354
+ { "name": "grow", "values": [] },
355
+ { "name": "wrap", "values": [] },
356
+ { "name": "start", "values": [] },
357
+ { "name": "gap", "values": [] }
358
+ ],
359
+ "references": [
360
+ {
361
+ "name": "Documentation",
362
+ "url": "https://zinc.style/components/button-group"
363
+ }
364
+ ]
365
+ },
366
366
  {
367
367
  "name": "zn-button-menu",
368
368
  "description": "Automatically hides buttons in a menu when the screen is too small.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
@@ -2967,30 +2967,6 @@
2967
2967
  }
2968
2968
  ]
2969
2969
  },
2970
- {
2971
- "name": "zn-pagination",
2972
- "description": "Pagination component for navigating through pages of content.\n---\n",
2973
- "attributes": [
2974
- { "name": "limit", "values": [] },
2975
- { "name": "total", "values": [] },
2976
- { "name": "page", "values": [] },
2977
- { "name": "uri", "values": [] }
2978
- ],
2979
- "references": [
2980
- {
2981
- "name": "Documentation",
2982
- "url": "https://zinc.style/components/pagination"
2983
- }
2984
- ]
2985
- },
2986
- {
2987
- "name": "zn-pane",
2988
- "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
2989
- "attributes": [{ "name": "flush", "values": [] }],
2990
- "references": [
2991
- { "name": "Documentation", "url": "https://zinc.style/components/pane" }
2992
- ]
2993
- },
2994
2970
  {
2995
2971
  "name": "zn-page-nav",
2996
2972
  "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -3025,6 +3001,30 @@
3025
3001
  }
3026
3002
  ]
3027
3003
  },
3004
+ {
3005
+ "name": "zn-pagination",
3006
+ "description": "Pagination component for navigating through pages of content.\n---\n",
3007
+ "attributes": [
3008
+ { "name": "limit", "values": [] },
3009
+ { "name": "total", "values": [] },
3010
+ { "name": "page", "values": [] },
3011
+ { "name": "uri", "values": [] }
3012
+ ],
3013
+ "references": [
3014
+ {
3015
+ "name": "Documentation",
3016
+ "url": "https://zinc.style/components/pagination"
3017
+ }
3018
+ ]
3019
+ },
3020
+ {
3021
+ "name": "zn-pane",
3022
+ "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
3023
+ "attributes": [{ "name": "flush", "values": [] }],
3024
+ "references": [
3025
+ { "name": "Documentation", "url": "https://zinc.style/components/pane" }
3026
+ ]
3027
+ },
3028
3028
  {
3029
3029
  "name": "zn-panel",
3030
3030
  "description": "Panels are versatile containers that provide structure for organizing content with optional headers and footers.\n---\n\n\n### **Slots:**\n - _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -3198,6 +3198,78 @@
3198
3198
  }
3199
3199
  ]
3200
3200
  },
3201
+ {
3202
+ "name": "zn-preview-frame",
3203
+ "description": "Embeds a live preview iframe and drives the hp-preview postMessage\nprotocol: answers the frame's ready handshake with a config payload fetched\nfrom data-uri, auto-saves watched forms on change, refreshes the preview\nafter each save (its own, or a shell-driven save of a `refresh-on` form),\naccepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake, and grows the frame to a content height the\nembed reports so the panel scrolls an overflowing page.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - Pushes a theme payload into the preview. The payload is retained and\nre-posted after every ready handshake, so a frame reload doesn't drop an\nin-progress theme.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
3204
+ "attributes": [
3205
+ {
3206
+ "name": "src",
3207
+ "description": "URL of the preview shell page (tokened embed URL).",
3208
+ "values": []
3209
+ },
3210
+ {
3211
+ "name": "frame-origin",
3212
+ "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
3213
+ "values": []
3214
+ },
3215
+ {
3216
+ "name": "data-uri",
3217
+ "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
3218
+ "values": []
3219
+ },
3220
+ {
3221
+ "name": "watch",
3222
+ "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
3223
+ "values": []
3224
+ },
3225
+ {
3226
+ "name": "refresh-on",
3227
+ "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
3228
+ "values": []
3229
+ },
3230
+ {
3231
+ "name": "debounce",
3232
+ "description": "Debounce in ms between a form change and its auto-save.",
3233
+ "values": []
3234
+ },
3235
+ {
3236
+ "name": "zoom",
3237
+ "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
3238
+ "values": []
3239
+ },
3240
+ {
3241
+ "name": "min-height",
3242
+ "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
3243
+ "values": []
3244
+ },
3245
+ {
3246
+ "name": "fill",
3247
+ "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
3248
+ "values": []
3249
+ },
3250
+ {
3251
+ "name": "device",
3252
+ "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
3253
+ "values": [{ "name": "PreviewFrameDevice" }]
3254
+ },
3255
+ {
3256
+ "name": "backdrop",
3257
+ "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
3258
+ "values": [{ "name": "dots" }, { "name": "panel" }]
3259
+ },
3260
+ {
3261
+ "name": "interactive",
3262
+ "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
3263
+ "values": []
3264
+ }
3265
+ ],
3266
+ "references": [
3267
+ {
3268
+ "name": "Documentation",
3269
+ "url": "https://zinc.style/components/preview-frame"
3270
+ }
3271
+ ]
3272
+ },
3201
3273
  {
3202
3274
  "name": "zn-priority-list",
3203
3275
  "description": "A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\nand keyboard reordering. Priority values are submitted as form data via hidden inputs.\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the order of items changes.\n- **zn-reorder** - Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.\n\n### **Methods:**\n - **getPriorityMap(): _PriorityItem[]_** - Returns the priority map: an array of { key, priority } objects.\n- **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n- **label** - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n- **label-tooltip** - Used to add text displayed in a tooltip next to the label.\n- **help-text** - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-priority-list-item-gap** - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`. _(default: undefined)_\n- **--zn-priority-list-item-padding** - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`. _(default: undefined)_\n- **--zn-priority-list-actions-gap** - The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`. _(default: undefined)_\n- **--zn-priority-list-handle-color** - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`. _(default: undefined)_\n- **--zn-priority-list-priority-color** - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input area wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **list** - The list container.\n- **item** - An individual list item row.\n- **drag-handle** - The drag handle icon.\n- **priority** - The priority number badge.\n- **content** - The content area of an item.",
@@ -3291,78 +3363,6 @@
3291
3363
  }
3292
3364
  ]
3293
3365
  },
3294
- {
3295
- "name": "zn-preview-frame",
3296
- "description": "Embeds a live preview iframe and drives the hp-preview postMessage\nprotocol: answers the frame's ready handshake with a config payload fetched\nfrom data-uri, auto-saves watched forms on change, refreshes the preview\nafter each save (its own, or a shell-driven save of a `refresh-on` form),\naccepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake, and grows the frame to a content height the\nembed reports so the panel scrolls an overflowing page.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - Pushes a theme payload into the preview. The payload is retained and\nre-posted after every ready handshake, so a frame reload doesn't drop an\nin-progress theme.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
3297
- "attributes": [
3298
- {
3299
- "name": "src",
3300
- "description": "URL of the preview shell page (tokened embed URL).",
3301
- "values": []
3302
- },
3303
- {
3304
- "name": "frame-origin",
3305
- "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
3306
- "values": []
3307
- },
3308
- {
3309
- "name": "data-uri",
3310
- "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
3311
- "values": []
3312
- },
3313
- {
3314
- "name": "watch",
3315
- "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
3316
- "values": []
3317
- },
3318
- {
3319
- "name": "refresh-on",
3320
- "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
3321
- "values": []
3322
- },
3323
- {
3324
- "name": "debounce",
3325
- "description": "Debounce in ms between a form change and its auto-save.",
3326
- "values": []
3327
- },
3328
- {
3329
- "name": "zoom",
3330
- "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
3331
- "values": []
3332
- },
3333
- {
3334
- "name": "min-height",
3335
- "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
3336
- "values": []
3337
- },
3338
- {
3339
- "name": "fill",
3340
- "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
3341
- "values": []
3342
- },
3343
- {
3344
- "name": "device",
3345
- "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
3346
- "values": [{ "name": "PreviewFrameDevice" }]
3347
- },
3348
- {
3349
- "name": "backdrop",
3350
- "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
3351
- "values": [{ "name": "dots" }, { "name": "panel" }]
3352
- },
3353
- {
3354
- "name": "interactive",
3355
- "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
3356
- "values": []
3357
- }
3358
- ],
3359
- "references": [
3360
- {
3361
- "name": "Documentation",
3362
- "url": "https://zinc.style/components/preview-frame"
3363
- }
3364
- ]
3365
- },
3366
3366
  {
3367
3367
  "name": "zn-progress-tile",
3368
3368
  "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -5184,55 +5184,6 @@
5184
5184
  }
5185
5185
  ]
5186
5186
  },
5187
- {
5188
- "name": "zn-translation-group",
5189
- "description": "Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\ntranslated a language at a time.\n---\n\n\n### **Events:**\n - **zn-language-change** - Emitted when the active language changes. Detail: `{ language: string }`.\n\n### **Slots:**\n - _default_ - The `zn-translations` fields the select drives.\n- **actions** - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n- **footer** - Content displayed in the grey panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-group** - The form group holding the caption, the language select and the fields.\n- **actions** - The row of buttons at the bottom of the body.\n- **language-field** - The select that chooses the language every child is editing, in the group's chip slot.\n- **language-select** - The select itself.",
5190
- "attributes": [
5191
- {
5192
- "name": "label",
5193
- "description": "The form group's label. An alias for the inherited `caption`, which wins where both are set.",
5194
- "values": []
5195
- },
5196
- {
5197
- "name": "help-text",
5198
- "description": "Sits under the label, above the language select, as help text does in any other form group.",
5199
- "values": []
5200
- },
5201
- {
5202
- "name": "inline",
5203
- "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the surrounding form\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
5204
- "values": []
5205
- },
5206
- {
5207
- "name": "language-label",
5208
- "description": "The select's accessible name. Not shown — the caption is what names the section on screen — but read out by a\nscreen reader, which has nothing else to go on once the visible label is gone.",
5209
- "values": []
5210
- },
5211
- {
5212
- "name": "languages",
5213
- "description": "The languages on offer, as language code to display name — `{\"en\": \"English\", \"fr\": \"French\"}`. Writing the code\nas the name (`{\"en\": \"EN\"}`) is also accepted. `en` is the language every other one falls back to. Set on every\nchild, so they do not need their own copy.",
5214
- "values": [{ "name": "Record<string" }, { "name": "string>" }]
5215
- },
5216
- { "name": "basis-px", "values": [] },
5217
- { "name": "caption", "values": [] },
5218
- { "name": "icon", "values": [] },
5219
- { "name": "tabbed", "values": [] },
5220
- { "name": "header-borderless", "values": [] },
5221
- { "name": "cosmic", "values": [] },
5222
- { "name": "flush", "values": [] },
5223
- { "name": "flush-x", "values": [] },
5224
- { "name": "flush-y", "values": [] },
5225
- { "name": "flush-footer", "values": [] },
5226
- { "name": "transparent", "values": [] },
5227
- { "name": "shadow", "values": [] }
5228
- ],
5229
- "references": [
5230
- {
5231
- "name": "Documentation",
5232
- "url": "https://zinc.style/components/translation-group"
5233
- }
5234
- ]
5235
- },
5236
5187
  {
5237
5188
  "name": "zn-translations",
5238
5189
  "description": "Collects one piece of text in several languages, one language at a time.\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when a translation's value changes.\n- **zn-input** - Emitted when a translation receives input.\n\n### **Methods:**\n - **setActiveLanguage(language: _string_)** - Sets the active language externally. Used by zn-translation-group. Browsing to a language does not create a key\nfor it — an untouched language stays absent from `values` so it is not submitted as an empty translation.\n- **getActiveLanguage(): _string_** - Returns the currently active language.\n- **addLanguageKey(languageCode: _string_)** - Adds a language key to this component's values if not already present. Used by zn-translation-group.\n- **getValueLanguages(): _string[]_** - Returns all language codes that have values.\n- **hasTranslation(language: _string_): _boolean_** - Whether the language carries a translation of its own, rather than falling back to English.\n\n### **Slots:**\n - **label** - The field's label. Alternatively, use the `label` attribute.\n- **help-text** - Text describing how to fill the field in, shown below it and shared by every language. Alternatively, use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, the language select, the field and the help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The wrapper around the field being edited.\n- **form-control-help-text** - The help text's wrapper.\n- **language-select** - The select that chooses the language being edited.",
@@ -5344,6 +5295,55 @@
5344
5295
  }
5345
5296
  ]
5346
5297
  },
5298
+ {
5299
+ "name": "zn-translation-group",
5300
+ "description": "Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\ntranslated a language at a time.\n---\n\n\n### **Events:**\n - **zn-language-change** - Emitted when the active language changes. Detail: `{ language: string }`.\n\n### **Slots:**\n - _default_ - The `zn-translations` fields the select drives.\n- **actions** - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n- **footer** - Content displayed in the grey panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-group** - The form group holding the caption, the language select and the fields.\n- **actions** - The row of buttons at the bottom of the body.\n- **language-field** - The select that chooses the language every child is editing, in the group's chip slot.\n- **language-select** - The select itself.",
5301
+ "attributes": [
5302
+ {
5303
+ "name": "label",
5304
+ "description": "The form group's label. An alias for the inherited `caption`, which wins where both are set.",
5305
+ "values": []
5306
+ },
5307
+ {
5308
+ "name": "help-text",
5309
+ "description": "Sits under the label, above the language select, as help text does in any other form group.",
5310
+ "values": []
5311
+ },
5312
+ {
5313
+ "name": "inline",
5314
+ "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the surrounding form\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
5315
+ "values": []
5316
+ },
5317
+ {
5318
+ "name": "language-label",
5319
+ "description": "The select's accessible name. Not shown — the caption is what names the section on screen — but read out by a\nscreen reader, which has nothing else to go on once the visible label is gone.",
5320
+ "values": []
5321
+ },
5322
+ {
5323
+ "name": "languages",
5324
+ "description": "The languages on offer, as language code to display name — `{\"en\": \"English\", \"fr\": \"French\"}`. Writing the code\nas the name (`{\"en\": \"EN\"}`) is also accepted. `en` is the language every other one falls back to. Set on every\nchild, so they do not need their own copy.",
5325
+ "values": [{ "name": "Record<string" }, { "name": "string>" }]
5326
+ },
5327
+ { "name": "basis-px", "values": [] },
5328
+ { "name": "caption", "values": [] },
5329
+ { "name": "icon", "values": [] },
5330
+ { "name": "tabbed", "values": [] },
5331
+ { "name": "header-borderless", "values": [] },
5332
+ { "name": "cosmic", "values": [] },
5333
+ { "name": "flush", "values": [] },
5334
+ { "name": "flush-x", "values": [] },
5335
+ { "name": "flush-y", "values": [] },
5336
+ { "name": "flush-footer", "values": [] },
5337
+ { "name": "transparent", "values": [] },
5338
+ { "name": "shadow", "values": [] }
5339
+ ],
5340
+ "references": [
5341
+ {
5342
+ "name": "Documentation",
5343
+ "url": "https://zinc.style/components/translation-group"
5344
+ }
5345
+ ]
5346
+ },
5347
5347
  {
5348
5348
  "name": "zn-vertical-stepper",
5349
5349
  "description": "Vertical steppers display a sequence of steps in a vertical layout with descriptions and optional icons.\n---\n\n\n### **Slots:**\n - **icon** - Optional slot for adding an icon or indicator before the step content.\n\n### **CSS Parts:**\n - **vs** - The main container for the vertical stepper.\n- **vs__left** - The left section containing the icon and connecting line.\n- **vs__icon** - The icon container.\n- **vs__line** - The vertical connecting line between steps.\n- **vs__right** - The right section containing caption and description text.\n- **vs__caption** - The caption/title text element.\n- **vs__description** - The description text element.",