includio-cms 0.25.0 → 0.27.0

package/dist/components/ui/spinner/spinner.stories.svelte.d.ts

@@ -0,0 +1,27 @@
+export default Spinner;
+type Spinner = SvelteComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}> & {
+    $$bindings?: string | undefined;
+};
+declare const Spinner: $$__sveltets_2_IsomorphicComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+import { Spinner } from './index.js';
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}

package/dist/components/ui/switch/switch.stories.svelte

@@ -0,0 +1,56 @@
+<script module>
+	import { defineMeta } from '@storybook/addon-svelte-csf';
+	import { Switch } from './index.js';
+	import { Label } from '../label/index.js';
+
+	const { Story } = defineMeta({
+		title: 'UI/Forms/Switch',
+		component: Switch,
+		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Przełącznik on/off (preferencja, ustawienie). Zmiana stanu = natychmiastowy efekt. Dla wieloetapowej walidacji — `Checkbox` w formularzu.',
+				},
+			},
+		},
+		argTypes: {
+			checked: {
+				control: 'boolean',
+				description: 'Stan przełącznika.',
+			},
+			disabled: {
+				control: 'boolean',
+				description: 'Wyłącza interakcję.',
+			},
+		},
+	});
+</script>
+
+<Story name="Default (off)">
+	<div style="display:flex;align-items:center;gap:8px;">
+		<Switch id="sw-default" />
+		<Label for="sw-default">Powiadomienia email</Label>
+	</div>
+</Story>
+
+<Story name="Checked (on)">
+	<div style="display:flex;align-items:center;gap:8px;">
+		<Switch id="sw-checked" checked />
+		<Label for="sw-checked">Tryb publiczny</Label>
+	</div>
+</Story>
+
+<Story name="Disabled">
+	<div style="display:flex;align-items:center;gap:8px;">
+		<Switch id="sw-disabled" disabled />
+		<Label for="sw-disabled">Opcja zablokowana</Label>
+	</div>
+</Story>
+
+<Story name="Disabled checked">
+	<div style="display:flex;align-items:center;gap:8px;">
+		<Switch id="sw-disabled-on" disabled checked />
+		<Label for="sw-disabled-on">Opcja włączona przez admina</Label>
+	</div>
+</Story>

package/dist/components/ui/switch/switch.stories.svelte.d.ts

@@ -0,0 +1,27 @@
+export default Switch;
+type Switch = SvelteComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}> & {
+    $$bindings?: string | undefined;
+};
+declare const Switch: $$__sveltets_2_IsomorphicComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+import { Switch } from './index.js';
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}

package/dist/components/ui/table/table-cell.svelte

@@ -13,7 +13,7 @@
 <td
 	bind:this={ref}
 	data-slot="table-cell"
-	class={cn("whitespace-nowrap p-2 align-middle [&:has([role=checkbox])]:pr-0", className)}
+	class={cn("whitespace-nowrap p-2 align-middle [&:has([role=checkbox])]:pr-4", className)}
 	{...restProps}
 >
 	{@render children?.()}

package/dist/components/ui/table/table-head.svelte

@@ -14,7 +14,7 @@
 	bind:this={ref}
 	data-slot="table-head"
 	class={cn(
-		"text-foreground h-10 whitespace-nowrap px-2 text-left align-middle font-medium [&:has([role=checkbox])]:pr-0",
+		"text-foreground h-10 whitespace-nowrap px-2 text-left align-middle font-medium [&:has([role=checkbox])]:pr-4",
 		className
 	)}
 	{...restProps}

package/dist/components/ui/table/table.stories.svelte

@@ -0,0 +1,68 @@
+<script module>
+	import { defineMeta } from '@storybook/addon-svelte-csf';
+	import * as Table from './index.js';
+	import { Root as TableRoot } from './index.js';
+
+	const { Story } = defineMeta({
+		title: 'UI/Data/Table',
+		component: TableRoot,
+		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Niskopoziomowa kompozycja `<table>`. Dla list adminowych używaj `DataTable` z TanStack Table — automatycznie obsługuje sortowanie, paginację, ARIA.',
+				},
+			},
+		},
+	});
+
+	const orders = [
+		{ number: 'ZAM-2026-0001', email: 'kowalski@example.com', total: '123,00 PLN', status: 'Nowe' },
+		{ number: 'ZAM-2026-0002', email: 'nowak@example.com', total: '450,00 PLN', status: 'Opłacone' },
+		{ number: 'ZAM-2026-0003', email: 'a@example.com', total: '78,00 PLN', status: 'Wysłane' }
+	];
+</script>
+
+<Story name="Basic">
+	<Table.Root>
+		<Table.Caption>Lista zamówień (3 ostatnie)</Table.Caption>
+		<Table.Header>
+			<Table.Row>
+				<Table.Head>Numer</Table.Head>
+				<Table.Head>Email klienta</Table.Head>
+				<Table.Head>Kwota</Table.Head>
+				<Table.Head>Status</Table.Head>
+			</Table.Row>
+		</Table.Header>
+		<Table.Body>
+			{#each orders as order (order.number)}
+				<Table.Row>
+					<Table.Cell>{order.number}</Table.Cell>
+					<Table.Cell>{order.email}</Table.Cell>
+					<Table.Cell>{order.total}</Table.Cell>
+					<Table.Cell>{order.status}</Table.Cell>
+				</Table.Row>
+			{/each}
+		</Table.Body>
+	</Table.Root>
+</Story>
+
+<Story name="Empty">
+	<Table.Root>
+		<Table.Caption>Brak danych do wyświetlenia.</Table.Caption>
+		<Table.Header>
+			<Table.Row>
+				<Table.Head>Numer</Table.Head>
+				<Table.Head>Email</Table.Head>
+				<Table.Head>Kwota</Table.Head>
+			</Table.Row>
+		</Table.Header>
+		<Table.Body>
+			<Table.Row>
+				<Table.Cell colspan={3} style="text-align:center;color:var(--muted-foreground);">
+					Brak zamówień. Pojawią się tutaj gdy klient złoży zakup.
+				</Table.Cell>
+			</Table.Row>
+		</Table.Body>
+	</Table.Root>
+</Story>

package/dist/components/ui/table/table.stories.svelte.d.ts

@@ -0,0 +1,27 @@
+export default Table;
+type Table = SvelteComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}> & {
+    $$bindings?: string | undefined;
+};
+declare const Table: $$__sveltets_2_IsomorphicComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+import * as Table from './index.js';
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}

package/dist/components/ui/table/table.svelte

@@ -14,7 +14,7 @@
 	<table
 		bind:this={ref}
 		data-slot="table"
-		class={cn("w-full caption-bottom text-sm", className)}
+		class={cn("min-w-full caption-bottom text-sm", className)}
 		{...restProps}
 	>
 		{@render children?.()}

package/dist/components/ui/tabs/tabs.stories.svelte

@@ -0,0 +1,48 @@
+<script module>
+	import { defineMeta } from '@storybook/addon-svelte-csf';
+	import * as Tabs from './index.js';
+	import { Root as TabsRoot } from './index.js';
+
+	const { Story } = defineMeta({
+		title: 'UI/Navigation/Tabs',
+		component: TabsRoot,
+		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Zakładki (np. Treść/SEO w edytorze). `value` = identyfikator aktywnej zakładki. Klawiatura: strzałki, Home/End między tabami.',
+				},
+			},
+		},
+		argTypes: {
+			value: {
+				control: 'text',
+				description: 'Identyfikator aktywnej zakładki.',
+			},
+			orientation: {
+				control: 'select',
+				options: ['horizontal', 'vertical'],
+				description: 'Układ tablisty.',
+			},
+		},
+	});
+</script>
+
+<Story name="Three tabs">
+	<Tabs.Root value="general" style="width:480px;">
+		<Tabs.List>
+			<Tabs.Trigger value="general">Ogólne</Tabs.Trigger>
+			<Tabs.Trigger value="seo">SEO</Tabs.Trigger>
+			<Tabs.Trigger value="media">Media</Tabs.Trigger>
+		</Tabs.List>
+		<Tabs.Content value="general">
+			<p>Podstawowe pola wpisu — tytuł, slug, status.</p>
+		</Tabs.Content>
+		<Tabs.Content value="seo">
+			<p>Meta description, OG image, słowa kluczowe.</p>
+		</Tabs.Content>
+		<Tabs.Content value="media">
+			<p>Zdjęcia, galeria, cover.</p>
+		</Tabs.Content>
+	</Tabs.Root>
+</Story>

package/dist/components/ui/tabs/tabs.stories.svelte.d.ts

@@ -0,0 +1,27 @@
+export default Tabs;
+type Tabs = SvelteComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}> & {
+    $$bindings?: string | undefined;
+};
+declare const Tabs: $$__sveltets_2_IsomorphicComponent<{
+    [x: string]: never;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+import * as Tabs from './index.js';
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import("svelte").ComponentConstructorOptions<Props>): import("svelte").SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}

package/dist/components/ui/textarea/textarea.stories.svelte

@@ -6,6 +6,27 @@
 		title: 'UI/Forms/Textarea',
 		component: Textarea,
 		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Pole wieloliniowe. Zawsze wewnątrz `Field.Root`. Dla treści z formatowaniem — `Content` (TipTap editor), nie textarea.',
+				},
+			},
+		},
+		argTypes: {
+			placeholder: {
+				control: 'text',
+				description: 'Tekst zachęty — NIE używaj zamiast labela.',
+			},
+			rows: {
+				control: 'number',
+				description: 'Domyślna liczba widocznych linii.',
+			},
+			disabled: {
+				control: 'boolean',
+				description: 'Blokada interakcji.',
+			},
+		},
 	});
 </script>
 

package/dist/components/ui/toggle/toggle.stories.svelte

@@ -6,6 +6,29 @@
 		title: 'UI/Actions/Toggle',
 		component: Toggle,
 		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Przycisk dwustanowy (np. format Bold w toolbarze). Stan komunikuje `aria-pressed`. Dla preferencji — `Switch`, dla wyboru z wielu — `ToggleGroup`.',
+				},
+			},
+		},
+		argTypes: {
+			pressed: {
+				control: 'boolean',
+				description: 'Stan wciśnięcia.',
+			},
+			variant: {
+				control: 'select',
+				options: ['default', 'outline'],
+				description: 'Wariant wizualny.',
+			},
+			size: {
+				control: 'select',
+				options: ['default', 'sm', 'lg'],
+				description: 'Rozmiar.',
+			},
+		},
 	});
 </script>
 

package/dist/components/ui/toggle-group/toggle-group.stories.svelte

@@ -6,6 +6,34 @@
 		title: 'UI/Actions/ToggleGroup',
 		component: ToggleGroup,
 		tags: ['autodocs'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Grupa toggle\'i (jednowybór `single` lub wielowybór `multiple`). Używaj dla format toolbarów lub wyboru opcji wizualnych (np. align left/center/right).',
+				},
+			},
+		},
+		argTypes: {
+			type: {
+				control: 'select',
+				options: ['single', 'multiple'],
+				description: 'Tryb — jeden naraz lub wiele.',
+			},
+			value: {
+				control: 'text',
+				description: 'Aktualna wartość lub tablica wartości.',
+			},
+			variant: {
+				control: 'select',
+				options: ['default', 'outline'],
+				description: 'Wariant wizualny.',
+			},
+			size: {
+				control: 'select',
+				options: ['default', 'sm', 'lg'],
+				description: 'Rozmiar.',
+			},
+		},
 	});
 </script>
 
@@ -15,3 +43,18 @@
 		<ToggleGroupItem value="en" style="font-weight:600;font-size:12px;">EN</ToggleGroupItem>
 	</ToggleGroup>
 </Story>
+
+<Story name="Multi (formatting)">
+	<ToggleGroup type="multiple" value={['bold']} aria-label="Formatowanie tekstu">
+		<ToggleGroupItem value="bold" aria-label="Pogrubienie">B</ToggleGroupItem>
+		<ToggleGroupItem value="italic" aria-label="Kursywa"><em>I</em></ToggleGroupItem>
+		<ToggleGroupItem value="underline" aria-label="Podkreślenie"><u>U</u></ToggleGroupItem>
+	</ToggleGroup>
+</Story>
+
+<Story name="Disabled">
+	<ToggleGroup type="single" value="pl" disabled>
+		<ToggleGroupItem value="pl">PL</ToggleGroupItem>
+		<ToggleGroupItem value="en">EN</ToggleGroupItem>
+	</ToggleGroup>
+</Story>

package/dist/components/ui/tooltip/tooltip.stories.svelte

@@ -2,24 +2,64 @@
 	import { defineMeta } from '@storybook/addon-svelte-csf';
 	import { Tooltip, TooltipContent, TooltipTrigger, TooltipProvider } from './index.js';
 	import { Button } from '../button/index.js';
+	import HistoryIcon from '@lucide/svelte/icons/history';
 
+	// Tooltip Provider context nie propaguje przez Storybook MockProvider/DecoratorHandler
+	// w vitest-browser. Stories renderują się normalnie w dev (`pnpm storybook`),
+	// ale test runner crashuje. Odłożone do S10 (axe runtime) — wtedy testujemy
+	// tooltipy via real browser MCP zamiast vitest browser.
 	const { Story } = defineMeta({
 		title: 'UI/Feedback/Tooltip',
 		component: Tooltip,
-		tags: ['autodocs'],
+		tags: ['autodocs', 'no-test'],
+		parameters: {
+			docs: {
+				description: {
+					component: 'Krótki opis przy najechaniu/fokusie. Dla ikon-only przycisków zawsze podaj `aria-label` na triggerze (tooltip nie zastępuje accessible name).',
+				},
+			},
+		},
+		argTypes: {
+			delayDuration: {
+				control: 'number',
+				description: 'Opóźnienie pokazania w ms (default 700).',
+			},
+			side: {
+				control: 'select',
+				options: ['top', 'right', 'bottom', 'left'],
+				description: 'Strona względem triggera.',
+			},
+		},
 	});
 </script>
 
 <Story name="Plum Tooltip">
-	<TooltipProvider>
+	<TooltipProvider delayDuration={0}>
 		<Tooltip>
 			<TooltipTrigger>
-				<Button variant="ghost" size="icon">
-					<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
-				</Button>
+				{#snippet child({ props })}
+					<Button {...props} variant="ghost" size="icon" aria-label="Historia zmian">
+						<HistoryIcon />
+					</Button>
+				{/snippet}
 			</TooltipTrigger>
 			<TooltipContent>
-				<p>Historia</p>
+				<p>Historia zmian</p>
+			</TooltipContent>
+		</Tooltip>
+	</TooltipProvider>
+</Story>
+
+<Story name="Text trigger">
+	<TooltipProvider delayDuration={0}>
+		<Tooltip>
+			<TooltipTrigger>
+				{#snippet child({ props })}
+					<button type="button" {...props}>Najedź żeby zobaczyć skrót</button>
+				{/snippet}
+			</TooltipTrigger>
+			<TooltipContent>
+				<p>Cmd / Ctrl + K — szybkie wyszukiwanie</p>
 			</TooltipContent>
 		</Tooltip>
 	</TooltipProvider>

package/dist/core/cms.d.ts

@@ -4,7 +4,7 @@ import type { ApiKeyConfig, AuthConfig, CMSConfig, ICMS, MediaConfig, Typography
 import type { CollectionConfigWithType } from '../types/collections.js';
 import type { Language } from '../types/languages.js';
 import type { SingleConfigWithType } from '../types/singles.js';
-import type { CustomFieldDefinition, PluginConfig } from '../types/plugins.js';
+import type { CustomFieldDefinition, IconSetPlugin, Plugin } from '../types/plugins.js';
 import type { FormConfig } from '../types/forms.js';
 import type { AIAdapter } from '../types/adapters/ai.js';
 import type { EmailAdapter } from '../types/adapters/email.js';
@@ -28,8 +28,17 @@ export declare class CMS implements ICMS {
     sidebarHelp: boolean;
     shopConfig: ResolvedShopConfig | null;
     cmpConfig: ResolvedCmpConfig | null;
-    plugins: PluginConfig[];
+    /**
+     * Resolves once the shop's variant-attribute GIN indexes have been applied
+     * by `initCMS()`. `null` when the CMS is configured without a shop. Tests
+     * can `await` this to gate on init completion; production callers don't
+     * need to — index application is idempotent and non-blocking.
+     * @internal
+     */
+    shopInitPromise: Promise<void> | null;
+    plugins: Plugin[];
     customFields: Map<string, CustomFieldDefinition>;
+    iconSets: Map<string, IconSetPlugin>;
     apiKeys: ApiKeyConfig[];
     constructor(config: CMSConfig);
     private validateFieldSlugs;

package/dist/core/cms.js

@@ -1,9 +1,11 @@
+import { isIconSetPlugin } from '../types/plugins.js';
 import { setSchemaGetCMS } from './fields/fieldSchemaToTs.js';
 import { betterAuth } from 'better-auth';
 import { drizzleAdapter } from 'better-auth/adapters/drizzle';
 import { admin } from 'better-auth/plugins';
 import { resetPasswordEmailTemplate } from '../admin/email/reset-password-template.js';
 import * as authSchema from '../server/db/schema/auth-schema.js';
+import { applyVariantAttributeIndexes } from '../shop/server/init.js';
 export class CMS {
     config;
     databaseAdapter;
@@ -21,8 +23,17 @@ export class CMS {
     sidebarHelp;
     shopConfig;
     cmpConfig;
+    /**
+     * Resolves once the shop's variant-attribute GIN indexes have been applied
+     * by `initCMS()`. `null` when the CMS is configured without a shop. Tests
+     * can `await` this to gate on init completion; production callers don't
+     * need to — index application is idempotent and non-blocking.
+     * @internal
+     */
+    shopInitPromise = null;
     plugins = [];
     customFields = new Map();
+    iconSets = new Map();
     apiKeys = [];
     constructor(config) {
         this.config = config;
@@ -64,6 +75,13 @@ export class CMS {
         if (config.plugins) {
             this.plugins = config.plugins;
             for (const plugin of this.plugins) {
+                if (isIconSetPlugin(plugin)) {
+                    if (this.iconSets.has(plugin.slug)) {
+                        throw new Error(`Duplicate icon-set plugin slug: "${plugin.slug}"`);
+                    }
+                    this.iconSets.set(plugin.slug, plugin);
+                    continue;
+                }
                 for (const def of plugin.fields ?? []) {
                     if (this.customFields.has(def.fieldType)) {
                         throw new Error(`Duplicate custom field type: "${def.fieldType}" (plugin: "${plugin.slug}")`);
@@ -157,6 +175,17 @@ export function initCMS(config) {
     import('./server/media/operations/backgroundMaintenance.js')
         .then((m) => m.startBackgroundMaintenance())
         .catch((e) => console.warn('[cms] Failed to start background maintenance:', e));
+    // Apply shop variantAttribute GIN indexes (idempotent CREATE INDEX IF NOT EXISTS).
+    // Pass shop + drizzle explicitly so the dynamic import doesn't depend on a
+    // shared CMS singleton (vitest can give the dynamic module a fresh instance).
+    if (cms.shopConfig) {
+        const drizzle = cms.databaseAdapter._drizzle;
+        if (drizzle) {
+            cms.shopInitPromise = applyVariantAttributeIndexes(cms.shopConfig, drizzle).catch((e) => {
+                console.warn('[shop] Failed to apply variant attribute indexes:', e);
+            });
+        }
+    }
     return cms;
 }
 /**

package/dist/core/fields/fieldSchemaToTs.d.ts

@@ -15,6 +15,13 @@ type AnyZodObject = z.ZodObject<any, any>;
 interface GenerateZodSchemaOptions {
     parentRequired?: boolean;
     localized?: boolean;
+    /**
+     * Preferred language for validation messages drawn from Localized field
+     * config (e.g. `TextField.patternError`). Falls back to the first value
+     * in the Localized object. Client-side schemas should pass the interface
+     * language; server-side leaves it `undefined`.
+     */
+    messageLanguage?: string;
 }
 export declare function generateZodSchemaFromField(field: Field, languages: string[], options?: GenerateZodSchemaOptions): z.ZodType;
 export declare function generateZodSchemaFromFields(fields: Field[], languages: string[], options?: GenerateZodSchemaOptions): AnyZodObject;