@marianmeres/stuic 3.181.0 → 3.183.0

package/dist/components/Input/index.d.ts

@@ -1,5 +1,8 @@
 export * from "./types.js";
 export { default as FieldAssets, type Props as FieldAssetsProps, type FieldAsset, type FieldAssetUrlObj, type FieldAssetWithBlobUrl, } from "./FieldAssets.svelte";
+export { default as FieldSingleAsset, type Props as FieldSingleAssetProps, type FieldSingleAssetUploadContext, type FieldSingleAssetShape, type FieldSingleAssetFit, type FieldSingleAssetSize, type FieldSingleAssetFileCheck, } from "./FieldSingleAsset.svelte";
+export { createFieldSingleAssetT, FIELD_SINGLE_ASSET_MESSAGES_EN, type FieldSingleAssetMessageKey, type FieldSingleAssetMessages, } from "./field-single-asset-i18n.js";
+export { FIELD_SINGLE_ASSET_MESSAGES_SK } from "./field-single-asset-i18n-sk.js";
 export { default as FieldCheckbox, type Props as FieldCheckboxProps, } from "./FieldCheckbox.svelte";
 export { default as Honeypot, type Props as HoneypotProps } from "./Honeypot.svelte";
 export { default as TimeTrap, type Props as TimeTrapProps, type TimeTrapSnapshot, } from "./TimeTrap.svelte";
@@ -18,6 +21,10 @@ export { default as FieldTextarea, type Props as FieldTextareaProps, } from "./F
 export { default as FieldInputLocalized, type Props as FieldInputLocalizedProps, } from "./FieldInputLocalized.svelte";
 export { default as FieldKeyValues, type Props as FieldKeyValuesProps, type KeyValueEntry, } from "./FieldKeyValues.svelte";
 export { default as FieldObject, type Props as FieldObjectProps, } from "./FieldObject.svelte";
+export { default as FieldTable, type Props as FieldTableProps, type FieldTableColumn, type FieldTableCellType, type FieldTableCellContext, type FieldTableRow, } from "./FieldTable.svelte";
+export { createFieldTableT, FIELD_TABLE_MESSAGES_EN, type FieldTableMessageKey, type FieldTableMessages, } from "./field-table-i18n.js";
+export { FIELD_TABLE_MESSAGES_SK } from "./field-table-i18n-sk.js";
+export { parseCellNumber, formatCellNumber, type ParsedCellNumber, } from "./field-table-number.js";
 export { default as FieldPhoneNumber, type Props as FieldPhoneNumberProps, } from "./FieldPhoneNumber.svelte";
 export { default as FieldCountry, type Props as FieldCountryProps, } from "./FieldCountry.svelte";
 export { validatePhoneNumber } from "./phone-validation.js";

package/dist/components/Input/index.js

@@ -1,5 +1,8 @@
 export * from "./types.js";
 export { default as FieldAssets, } from "./FieldAssets.svelte";
+export { default as FieldSingleAsset, } from "./FieldSingleAsset.svelte";
+export { createFieldSingleAssetT, FIELD_SINGLE_ASSET_MESSAGES_EN, } from "./field-single-asset-i18n.js";
+export { FIELD_SINGLE_ASSET_MESSAGES_SK } from "./field-single-asset-i18n-sk.js";
 export { default as FieldCheckbox, } from "./FieldCheckbox.svelte";
 export { default as Honeypot } from "./Honeypot.svelte";
 export { default as TimeTrap, } from "./TimeTrap.svelte";
@@ -18,6 +21,10 @@ export { default as FieldTextarea, } from "./FieldTextarea.svelte";
 export { default as FieldInputLocalized, } from "./FieldInputLocalized.svelte";
 export { default as FieldKeyValues, } from "./FieldKeyValues.svelte";
 export { default as FieldObject, } from "./FieldObject.svelte";
+export { default as FieldTable, } from "./FieldTable.svelte";
+export { createFieldTableT, FIELD_TABLE_MESSAGES_EN, } from "./field-table-i18n.js";
+export { FIELD_TABLE_MESSAGES_SK } from "./field-table-i18n-sk.js";
+export { parseCellNumber, formatCellNumber, } from "./field-table-number.js";
 export { default as FieldPhoneNumber, } from "./FieldPhoneNumber.svelte";
 export { default as FieldCountry, } from "./FieldCountry.svelte";
 export { validatePhoneNumber } from "./phone-validation.js";

package/docs/domains/actions.md

@@ -121,7 +121,7 @@ Per the HTML spec, `<input type="hidden">` is _barred from constraint
 validation_ — `validity.valueMissing` stays `false` regardless of the
 `required` attribute, and native browser submit blocking is skipped. Several
 STUIC field components (`FieldPhoneNumber`, `FieldCountry`, `FieldObject`,
-`FieldAssets`, `FieldInputLocalized`, `FieldKeyValues`, `FieldLikeButton`,
+`FieldAssets`, `FieldSingleAsset`, `FieldInputLocalized`, `FieldKeyValues`, `FieldLikeButton`,
 `FieldDate`, `FieldDateRange`) use a hidden input to participate in `FormData`, so they each enforce
 `required` themselves inside their `customValidator`:
 
@@ -153,12 +153,12 @@ Two element types are deliberately exempt from the synthetic dispatch:
   group, which is wrong.
 - **`type="file"`** — a file input's value is read-only to script, so a
   synthetic `change` can't re-validate it; worse, it re-triggers any dropzone /
-  upload listener bound to the input. `FieldAssets` wires its hidden
+  upload listener bound to the input. `FieldAssets` (and `FieldSingleAsset`) wire their hidden
   `<input type="file">` through `fileDropzone`, so a re-fired `change` would
   re-run `processFiles` with the previously-picked file still in `inputEl.files`
   — duplicating the asset and firing a real re-upload on every save. File inputs
   are still read for native constraint validation (`required`); only the event
-  dispatch is skipped. (`FieldAssets` additionally clears its file input after
+  dispatch is skipped. (Both additionally clear their file input after
   consuming a selection, both as defense-in-depth and to allow re-selecting the
   same file twice in a row.)
 

package/docs/domains/components.md

@@ -62,24 +62,26 @@
 
 ### Form
 
-| Component                                     | Purpose                                                                                    |
-| --------------------------------------------- | ------------------------------------------------------------------------------------------ |
-| Input (FieldInput, FieldSelect, etc.)         | Form fields                                                                                |
-| FieldMoney                                    | Money input storing integer minor units (e.g. cents)                                       |
-| Calendar                                      | Month grid for single-date / range picking: keyboard grid, min/max, dropdown caption, i18n |
-| FieldDate, FieldDateRange                     | Date / date-range fields around Calendar: trigger + dialog or embedded; ISO hidden inputs  |
-| FieldPhoneNumber                              | International phone input with country picker                                              |
-| FieldObject                                   | Dual-mode JSON object editor (pretty-print/raw)                                            |
-| CronInput                                     | Cron expression editor with presets and validation                                         |
-| Fieldset                                      | Field grouping with legend                                                                 |
-| FieldKeyValues                                | Key-value pair editor                                                                      |
-| FieldsBuilder                                 | Field-definition list editor ("what properties does a thing have?")                        |
-| FieldAssets                                   | File/asset management                                                                      |
-| LoginForm, LoginFormModal                     | Standalone login form with optional modal variant                                          |
-| RegisterForm                                  | Standalone registration form with declarative extra fields                                 |
-| LoginOrRegisterForm, LoginOrRegisterFormModal | Composite login/register/verify form (3 modes, shared social-logins)                       |
-| EmailVerifyForm                               | Post-registration email-verify form (OtpInput + resend cooldown)                           |
-| OtpInput                                      | Generic N-slot one-time-code input (numeric/alphanumeric, paste-distribute)                |
+| Component                                     | Purpose                                                                                           |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| Input (FieldInput, FieldSelect, etc.)         | Form fields                                                                                       |
+| FieldMoney                                    | Money input storing integer minor units (e.g. cents)                                              |
+| Calendar                                      | Month grid for single-date / range picking: keyboard grid, min/max, dropdown caption, i18n        |
+| FieldDate, FieldDateRange                     | Date / date-range fields around Calendar: trigger + dialog or embedded; ISO hidden inputs         |
+| FieldPhoneNumber                              | International phone input with country picker                                                     |
+| FieldObject                                   | Dual-mode JSON object editor (pretty-print/raw)                                                   |
+| CronInput                                     | Cron expression editor with presets and validation                                                |
+| Fieldset                                      | Field grouping with legend                                                                        |
+| FieldKeyValues                                | Key-value pair editor                                                                             |
+| FieldTable                                    | Rows × typed columns editor (text/number/select/checkbox/date/url cells, container layout)        |
+| FieldsBuilder                                 | Field-definition list editor ("what properties does a thing have?")                               |
+| FieldAssets                                   | File/asset management                                                                             |
+| FieldSingleAsset                              | One asset (avatar, logo, cover): replace-in-place tile, inline remove + undo, rollback on failure |
+| LoginForm, LoginFormModal                     | Standalone login form with optional modal variant                                                 |
+| RegisterForm                                  | Standalone registration form with declarative extra fields                                        |
+| LoginOrRegisterForm, LoginOrRegisterFormModal | Composite login/register/verify form (3 modes, shared social-logins)                              |
+| EmailVerifyForm                               | Post-registration email-verify form (OtpInput + resend cooldown)                                  |
+| OtpInput                                      | Generic N-slot one-time-code input (numeric/alphanumeric, paste-distribute)                       |
 
 ### Display
 
@@ -156,8 +158,8 @@ failed `validate()` (imperative or event-driven) renders the inline error.
 Use `validate={false}` to bypass stuic's validation entirely.
 
 > **Why default-on?** Hidden-input field components (`FieldPhoneNumber`,
-> `FieldCountry`, `FieldObject`, `FieldAssets`, `FieldInputLocalized`,
-> `FieldKeyValues`, `FieldLikeButton`, `FieldDate`, `FieldDateRange`, `Rating`) _must_ be default-on because hidden
+> `FieldCountry`, `FieldObject`, `FieldAssets`, `FieldSingleAsset`, `FieldInputLocalized`,
+> `FieldKeyValues`, `FieldTable`, `FieldLikeButton`, `FieldDate`, `FieldDateRange`, `Rating`) _must_ be default-on because hidden
 > inputs are excluded from native browser constraint validation — without the
 > stuic action enforcing `required` in a `customValidator`, the attribute is a
 > silent no-op. Plain-input field components were harmonized to the same
@@ -166,8 +168,8 @@ Use `validate={false}` to bypass stuic's validation entirely.
 ### Per-field methods
 
 Available on `FieldInput`, `FieldMoney`, `FieldTextarea`, `FieldCheckbox`,
-`FieldSelect`, `FieldFile`, `FieldObject`, `FieldAssets`, `FieldInputLocalized`,
-`FieldKeyValues`, `FieldPhoneNumber`, `FieldCountry`, `FieldLikeButton`,
+`FieldSelect`, `FieldFile`, `FieldObject`, `FieldAssets`, `FieldSingleAsset`, `FieldInputLocalized`,
+`FieldKeyValues`, `FieldTable`, `FieldPhoneNumber`, `FieldCountry`, `FieldLikeButton`,
 `FieldRadios`, `FieldSwitch`, `FieldOptions`, `FieldDate`, `FieldDateRange`, and
 `Switch`:
 
@@ -563,8 +565,10 @@ the list is the consumer's job, server-side. Own directory: `components/FieldsBu
 | `FieldDef`                                                         | type      | One field definition (the value unit)                       |
 | `FieldLock`                                                        | type      | Per-field edit locks                                        |
 | `FieldOptionDef`                                                   | type      | Choice-type option `{ value, label }`                       |
+| `FieldColumnDef`                                                   | type      | One column of a `supportsColumns` field                     |
 | `FieldTypeDef`                                                     | type      | Palette entry                                               |
-| `FieldTypeExtraDef`                                                | type      | Palette-declared boolean extra                              |
+| `FieldTypeExtraDef`                                                | type      | Palette-declared boolean / string / select extra            |
+| `FieldColumnErrors`, `FieldDefRowErrors`                           | types     | `validateFieldDefs` result shapes                           |
 | `LocalizedText`                                                    | type      | `string \| Record<language, string>`                        |
 | `FIELDS_BUILDER_DEFAULT_TYPES`                                     | constant  | Starter palette (text/longtext/number/checkbox/select/date) |
 | `FIELDS_BUILDER_DEFAULT_KEY_PATTERN`                               | constant  | `/^[a-z][a-z0-9_]{0,62}$/`                                  |
@@ -572,26 +576,29 @@ the list is the consumer's job, server-side. Own directory: `components/FieldsBu
 
 ### Key Props
 
-| Prop                 | Type                                           | Default  | Description                                      |
-| -------------------- | ---------------------------------------------- | -------- | ------------------------------------------------ |
-| `value`              | `FieldDef[]`                                   | required | Bindable ordered field list                      |
-| `name`               | `string`                                       | required | Hidden-input name                                |
-| `types`              | `FieldTypeDef[]`                               | required | The type palette                                 |
-| `languages`          | `string[]`                                     | —        | Multi-language labels/descriptions/options       |
-| `keysImmutable`      | `boolean`                                      | `true`   | Freeze keys loaded from `value`                  |
-| `deriveKeyFromLabel` | `boolean \| (label) => string`                 | `true`   | Live slug derivation (diacritics transliterated) |
-| `reservedKeys`       | `string[] \| (key) => boolean`                 | —        | Forbidden keys (derivation auto-avoids them)     |
-| `deleteMode`         | `"mark" \| "immediate"`                        | `"mark"` | Mark+undo vs outright removal                    |
-| `onBeforeDelete`     | `(field) => void \| false \| Promise`          | —        | Delete veto (Tree `onMove`-style)                |
-| `onBeforeTypeChange` | `(field, newType) => void \| false \| Promise` | —        | Type-change veto for pre-existing fields         |
-| `preview`            | `Snippet<[{ fields }]>`                        | —        | Live preview pane (side-by-side when wide)       |
-| `maxFields`          | `number`                                       | —        | Add-limit                                        |
+| Prop                                               | Type                                           | Default  | Description                                      |
+| -------------------------------------------------- | ---------------------------------------------- | -------- | ------------------------------------------------ |
+| `value`                                            | `FieldDef[]`                                   | required | Bindable ordered field list                      |
+| `name`                                             | `string`                                       | required | Hidden-input name                                |
+| `types`                                            | `FieldTypeDef[]`                               | required | The type palette                                 |
+| `languages`                                        | `string[]`                                     | —        | Multi-language labels/descriptions/options       |
+| `keysImmutable`                                    | `boolean`                                      | `true`   | Freeze keys loaded from `value`                  |
+| `deriveKeyFromLabel`                               | `boolean \| (label) => string`                 | `true`   | Live slug derivation (diacritics transliterated) |
+| `reservedKeys`                                     | `string[] \| (key) => boolean`                 | —        | Forbidden keys (derivation auto-avoids them)     |
+| `deleteMode`                                       | `"mark" \| "immediate"`                        | `"mark"` | Mark+undo vs outright removal                    |
+| `onBeforeDelete`                                   | `(field) => void \| false \| Promise`          | —        | Delete veto (Tree `onMove`-style)                |
+| `onBeforeTypeChange`                               | `(field, newType) => void \| false \| Promise` | —        | Type-change veto for pre-existing fields         |
+| `onBeforeColumnDelete`, `onBeforeColumnTypeChange` | `(field, column[, newType]) => …`              | —        | Column veto hooks (stored columns only)          |
+| `preview`                                          | `Snippet<[{ fields }]>`                        | —        | Live preview pane (side-by-side when wide)       |
+| `maxFields`                                        | `number`                                       | —        | Add-limit                                        |
 
 Features: collapsed rows (label + key + type chip) expanding to the full editor;
 drag reorder + Move up/down buttons with aria-live announcements; `lock.*` per-field
 locks (label/description always editable); unknown-type rows render degraded
 read-only and round-trip untouched; per-row inline validation with
-focus-first-offender `validate()`.
+focus-first-offender `validate()`; `supportsOptions` types get an option editor,
+`supportsColumns` types a column editor (each column: label / type from `columnTypes` /
+key, plus that column type's options and extras), capped by `maxColumns`.
 
 ### CSS Tokens
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@marianmeres/stuic",
-	"version": "3.181.0",
+	"version": "3.183.0",
 	"packageManager": "pnpm@11.5.0",
 	"scripts": {
 		"dev": "vite dev",