@marianmeres/stuic 3.166.0 → 3.168.0

package/dist/components/EmptyState/EmptyState.svelte

@@ -0,0 +1,121 @@
+<script lang="ts" module>
+	import type { HTMLAttributes } from "svelte/elements";
+	import type { Snippet } from "svelte";
+	import type { THC } from "../Thc/Thc.svelte";
+
+	export type EmptyStateVariant = "plain" | "outline" | "dashed";
+	export type EmptyStateSize = "sm" | "md" | "lg";
+
+	export interface Props extends Omit<
+		HTMLAttributes<HTMLDivElement>,
+		"children" | "title"
+	> {
+		/** Icon area content (typically `{ html: iconSearch({ size: 48 }) }`) */
+		icon?: THC;
+		/** Title (the "Nothing here yet" headline) */
+		title?: THC;
+		/** Short supporting description below the title */
+		description?: THC;
+		/** Container treatment */
+		variant?: EmptyStateVariant;
+		/** Size preset (padding, icon and typography scale) */
+		size?: EmptyStateSize;
+		/** CTA area below the description (buttons, links) */
+		actions?: Snippet;
+		/** Override the entire default layout */
+		children?: Snippet;
+		/** Override the icon area */
+		renderIcon?: Snippet;
+		/** Skip all default styling */
+		unstyled?: boolean;
+		/** Additional CSS classes */
+		class?: string;
+		/** Class for the icon area */
+		classIcon?: string;
+		/** Class for the title */
+		classTitle?: string;
+		/** Class for the description */
+		classDescription?: string;
+		/** Class for the actions area */
+		classActions?: string;
+		/** Bindable element reference */
+		el?: HTMLElement;
+	}
+</script>
+
+<script lang="ts">
+	import { twMerge } from "../../utils/tw-merge.js";
+	import Thc from "../Thc/Thc.svelte";
+
+	let {
+		icon,
+		title,
+		description,
+		variant = "plain",
+		size = "md",
+		actions,
+		children,
+		renderIcon,
+		unstyled = false,
+		class: classProp,
+		classIcon: classIconProp,
+		classTitle: classTitleProp,
+		classDescription: classDescriptionProp,
+		classActions: classActionsProp,
+		el = $bindable(),
+		...rest
+	}: Props = $props();
+
+	let _class = $derived(unstyled ? classProp : twMerge("stuic-empty-state", classProp));
+	let _classIcon = $derived(
+		unstyled ? classIconProp : twMerge("stuic-empty-state-icon", classIconProp)
+	);
+	let _classTitle = $derived(
+		unstyled ? classTitleProp : twMerge("stuic-empty-state-title", classTitleProp)
+	);
+	let _classDescription = $derived(
+		unstyled
+			? classDescriptionProp
+			: twMerge("stuic-empty-state-description", classDescriptionProp)
+	);
+	let _classActions = $derived(
+		unstyled ? classActionsProp : twMerge("stuic-empty-state-actions", classActionsProp)
+	);
+</script>
+
+<div
+	bind:this={el}
+	class={_class}
+	data-variant={!unstyled ? variant : undefined}
+	data-size={!unstyled ? size : undefined}
+	{...rest}
+>
+	{#if children}
+		{@render children()}
+	{:else}
+		{#if renderIcon || icon}
+			<div class={_classIcon}>
+				{#if renderIcon}
+					{@render renderIcon()}
+				{:else if icon}
+					<Thc thc={icon} />
+				{/if}
+			</div>
+		{/if}
+		{#if title}
+			<div class={_classTitle}>
+				<Thc thc={title} />
+			</div>
+		{/if}
+		{#if description}
+			<div class={_classDescription}>
+				<Thc thc={description} />
+			</div>
+		{/if}
+		{#if actions}
+			<div class={_classActions}>
+				{@render actions()}
+			</div>
+		{/if}
+	{/if}
+</div>

package/dist/components/EmptyState/EmptyState.svelte.d.ts

@@ -0,0 +1,40 @@
+import type { HTMLAttributes } from "svelte/elements";
+import type { Snippet } from "svelte";
+import type { THC } from "../Thc/Thc.svelte";
+export type EmptyStateVariant = "plain" | "outline" | "dashed";
+export type EmptyStateSize = "sm" | "md" | "lg";
+export interface Props extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> {
+    /** Icon area content (typically `{ html: iconSearch({ size: 48 }) }`) */
+    icon?: THC;
+    /** Title (the "Nothing here yet" headline) */
+    title?: THC;
+    /** Short supporting description below the title */
+    description?: THC;
+    /** Container treatment */
+    variant?: EmptyStateVariant;
+    /** Size preset (padding, icon and typography scale) */
+    size?: EmptyStateSize;
+    /** CTA area below the description (buttons, links) */
+    actions?: Snippet;
+    /** Override the entire default layout */
+    children?: Snippet;
+    /** Override the icon area */
+    renderIcon?: Snippet;
+    /** Skip all default styling */
+    unstyled?: boolean;
+    /** Additional CSS classes */
+    class?: string;
+    /** Class for the icon area */
+    classIcon?: string;
+    /** Class for the title */
+    classTitle?: string;
+    /** Class for the description */
+    classDescription?: string;
+    /** Class for the actions area */
+    classActions?: string;
+    /** Bindable element reference */
+    el?: HTMLElement;
+}
+declare const EmptyState: import("svelte").Component<Props, {}, "el">;
+type EmptyState = ReturnType<typeof EmptyState>;
+export default EmptyState;

package/dist/components/EmptyState/README.md

@@ -0,0 +1,188 @@
+# EmptyState
+
+Icon + title + description + CTA placeholder for empty lists, tables, and search
+results. Centered, theme-aware, and non-interactive by itself — the CTA area is a
+snippet you fill with your own `Button`s or links. Pairs naturally with `DataTable`
+("no rows"), search UIs ("no results"), and first-run dashboard tiles.
+
+## Props
+
+| Prop               | Type                               | Default   | Description                                       |
+| ------------------ | ---------------------------------- | --------- | ------------------------------------------------- |
+| `icon`             | `THC`                              | -         | Icon area content (e.g. `{ html: iconSearch() }`) |
+| `title`            | `THC`                              | -         | Title headline                                    |
+| `description`      | `THC`                              | -         | Short supporting text below the title             |
+| `variant`          | `"plain" \| "outline" \| "dashed"` | `"plain"` | Container treatment (bordered box or none)        |
+| `size`             | `"sm" \| "md" \| "lg"`             | `"md"`    | Padding, icon and typography scale                |
+| `unstyled`         | `boolean`                          | `false`   | Skip all default styling                          |
+| `class`            | `string`                           | -         | Additional CSS classes (merged via twMerge)       |
+| `classIcon`        | `string`                           | -         | Class for the icon area                           |
+| `classTitle`       | `string`                           | -         | Class for the title                               |
+| `classDescription` | `string`                           | -         | Class for the description                         |
+| `classActions`     | `string`                           | -         | Class for the actions area                        |
+| `el`               | `HTMLElement`                      | -         | Element reference (bindable)                      |
+
+## Snippet Props
+
+| Snippet      | Description                                        |
+| ------------ | -------------------------------------------------- |
+| `actions`    | CTA area below the description (buttons, links)    |
+| `renderIcon` | Override the icon area (instead of the `icon` THC) |
+| `children`   | Override the entire default layout                 |
+
+## Usage
+
+### Basic
+
+```svelte
+<script lang="ts">
+	import { EmptyState, Button, iconSearch } from "@marianmeres/stuic";
+</script>
+
+<EmptyState
+	icon={{ html: iconSearch() }}
+	title="No results found"
+	description="Try adjusting your search or filters."
+/>
+```
+
+### With CTA
+
+```svelte
+<EmptyState
+	icon={{ html: iconPlus() }}
+	title="No projects yet"
+	description="Create your first project to get started."
+>
+	{#snippet actions()}
+		<Button intent="primary">New project</Button>
+		<Button variant="ghost">Learn more</Button>
+	{/snippet}
+</EmptyState>
+```
+
+### Variants
+
+```svelte
+<!-- No box (default) — for use inside an already-framed area (table body, panel) -->
+<EmptyState variant="plain" title="Nothing here" />
+
+<!-- Bordered container -->
+<EmptyState variant="outline" title="Nothing here" />
+
+<!-- Dashed container — the "drop zone / placeholder" look -->
+<EmptyState variant="dashed" title="Nothing here" />
+```
+
+### Sizes
+
+```svelte
+<EmptyState size="sm" title="No comments" />
+<EmptyState size="md" title="No comments" />
+<EmptyState size="lg" title="No comments" />
+```
+
+### With DataTable
+
+`DataTable` already renders an `EmptyState` (titled with its `no_data` message) when it
+has no rows. Its `empty` snippet replaces that one, which is where an icon, a
+description and a CTA go:
+
+```svelte
+<DataTable {columns} {data}>
+	{#snippet empty()}
+		<EmptyState
+			icon={{ html: iconFile() }}
+			title="No documents"
+			description="Documents you upload will show up here."
+		>
+			{#snippet actions()}
+				<Button intent="primary">Upload</Button>
+			{/snippet}
+		</EmptyState>
+	{/snippet}
+</DataTable>
+```
+
+Swapping the whole table out is the other option — when the empty case should not look
+like a table at all (no header row, no pager):
+
+```svelte
+{#if !rows.length}
+	<EmptyState
+		icon={{ html: iconFile() }}
+		title="No documents"
+		description="Documents you upload will show up here."
+	>
+		{#snippet actions()}
+			<Button intent="primary">Upload</Button>
+		{/snippet}
+	</EmptyState>
+{:else}
+	<DataTable {rows} ... />
+{/if}
+```
+
+### Custom Styling
+
+```svelte
+<!-- Override the entire layout -->
+<EmptyState variant="dashed">
+	<img src="/illustrations/empty.svg" alt="" class="w-40" />
+	<p>Absolutely nothing.</p>
+</EmptyState>
+
+<!-- Override component tokens inline -->
+<EmptyState
+	title="Big icon"
+	icon={{ html: iconSearch() }}
+	style="--stuic-empty-state-icon-size-md: 5rem;"
+/>
+```
+
+## Accessibility
+
+The component renders a plain `<div>` with no implicit role. When an empty state
+replaces content dynamically (e.g. search results updating), pass `role="status"`
+so screen readers announce it:
+
+```svelte
+<EmptyState role="status" title="No results found" />
+```
+
+## CSS Variables
+
+### Component Tokens
+
+| Variable                                    | Default                          | Description                            |
+| ------------------------------------------- | -------------------------------- | -------------------------------------- |
+| `--stuic-empty-state-gap`                   | `0.5rem`                         | Gap between icon/title/description     |
+| `--stuic-empty-state-icon-text`             | `--stuic-color-muted-foreground` | Icon color                             |
+| `--stuic-empty-state-icon-opacity`          | `0.8`                            | Icon opacity                           |
+| `--stuic-empty-state-icon-margin-bottom`    | `0.25rem`                        | Extra space below the icon             |
+| `--stuic-empty-state-title-font-weight`     | `--font-weight-semibold`         | Title font weight                      |
+| `--stuic-empty-state-title-text`            | `--stuic-color-foreground`       | Title color                            |
+| `--stuic-empty-state-description-text`      | `--stuic-color-muted-foreground` | Description color                      |
+| `--stuic-empty-state-description-max-width` | `45ch`                           | Description line-length cap            |
+| `--stuic-empty-state-actions-gap`           | `0.5rem`                         | Gap between CTA buttons                |
+| `--stuic-empty-state-actions-margin-top`    | `1rem`                           | Space above the CTA row                |
+| `--stuic-empty-state-bg`                    | `transparent`                    | Background                             |
+| `--stuic-empty-state-border`                | `--stuic-color-border`           | Border color (outline/dashed variants) |
+| `--stuic-empty-state-border-width`          | `--stuic-border-width`           | Border width (outline/dashed variants) |
+| `--stuic-empty-state-radius`                | `--stuic-radius-container`       | Border radius (outline/dashed)         |
+
+### Size Tokens
+
+Each size (sm, md, lg) has corresponding tokens:
+
+- `--stuic-empty-state-padding-{size}`
+- `--stuic-empty-state-icon-size-{size}` (applied to any `svg` inside the icon area)
+- `--stuic-empty-state-title-font-size-{size}`
+- `--stuic-empty-state-description-font-size-{size}`
+
+## Data Attributes
+
+The component uses data attributes for styling:
+
+- `data-variant` - `"plain" | "outline" | "dashed"`
+- `data-size` - `"sm" | "md" | "lg"`

package/dist/components/EmptyState/index.css

@@ -0,0 +1,154 @@
+/* ============================================================================
+   EMPTY STATE COMPONENT TOKENS
+   Override globally: :root { --stuic-empty-state-icon-size-md: 4rem; }
+   Override locally:  <EmptyState style="--stuic-empty-state-gap: 1rem;">
+   ============================================================================ */
+
+/* prettier-ignore */
+:root {
+	--stuic-empty-state-gap: 0.5rem;
+
+	/* Size: sm */
+	--stuic-empty-state-padding-sm: 1.5rem;
+	--stuic-empty-state-icon-size-sm: 2rem;
+	--stuic-empty-state-title-font-size-sm: var(--text-base);
+	--stuic-empty-state-description-font-size-sm: var(--text-xs);
+
+	/* Size: md */
+	--stuic-empty-state-padding-md: 3rem;
+	--stuic-empty-state-icon-size-md: 2.5rem;
+	--stuic-empty-state-title-font-size-md: var(--text-lg);
+	--stuic-empty-state-description-font-size-md: var(--text-sm);
+
+	/* Size: lg */
+	--stuic-empty-state-padding-lg: 4rem;
+	--stuic-empty-state-icon-size-lg: 3rem;
+	--stuic-empty-state-title-font-size-lg: var(--text-xl);
+	--stuic-empty-state-description-font-size-lg: var(--text-base);
+
+	/* Icon */
+	--stuic-empty-state-icon-text: var(--stuic-color-muted-foreground);
+	--stuic-empty-state-icon-opacity: 0.8;
+	--stuic-empty-state-icon-margin-bottom: 0.25rem;
+
+	/* Typography */
+	--stuic-empty-state-title-font-weight: var(--font-weight-semibold);
+	--stuic-empty-state-title-text: var(--stuic-color-foreground);
+	--stuic-empty-state-description-text: var(--stuic-color-muted-foreground);
+	--stuic-empty-state-description-max-width: 45ch;
+
+	/* Actions */
+	--stuic-empty-state-actions-gap: 0.5rem;
+	--stuic-empty-state-actions-margin-top: 1rem;
+
+	/* Outline/dashed variants */
+	--stuic-empty-state-bg: transparent;
+	--stuic-empty-state-border: var(--stuic-color-border);
+}
+
+@layer components {
+	/* ============================================================================
+	   BASE STYLES
+	   ============================================================================ */
+
+	.stuic-empty-state {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		text-align: center;
+		width: 100%;
+		gap: var(--stuic-empty-state-gap);
+		background: var(--stuic-empty-state-bg);
+	}
+
+	/* ============================================================================
+	   SIZE VARIANTS
+	   Each size sets the scale via internal CSS vars consumed by the child areas.
+	   ============================================================================ */
+
+	.stuic-empty-state[data-size="sm"] {
+		padding: var(--stuic-empty-state-padding-sm);
+		--_icon-size: var(--stuic-empty-state-icon-size-sm);
+		--_title-font-size: var(--stuic-empty-state-title-font-size-sm);
+		--_description-font-size: var(--stuic-empty-state-description-font-size-sm);
+	}
+
+	.stuic-empty-state[data-size="md"] {
+		padding: var(--stuic-empty-state-padding-md);
+		--_icon-size: var(--stuic-empty-state-icon-size-md);
+		--_title-font-size: var(--stuic-empty-state-title-font-size-md);
+		--_description-font-size: var(--stuic-empty-state-description-font-size-md);
+	}
+
+	.stuic-empty-state[data-size="lg"] {
+		padding: var(--stuic-empty-state-padding-lg);
+		--_icon-size: var(--stuic-empty-state-icon-size-lg);
+		--_title-font-size: var(--stuic-empty-state-title-font-size-lg);
+		--_description-font-size: var(--stuic-empty-state-description-font-size-lg);
+	}
+
+	/* ============================================================================
+	   CONTAINER VARIANTS
+	   plain (default): no box. outline/dashed: bordered container.
+	   ============================================================================ */
+
+	.stuic-empty-state[data-variant="outline"],
+	.stuic-empty-state[data-variant="dashed"] {
+		border: var(--stuic-empty-state-border-width, var(--stuic-border-width)) solid
+			var(--stuic-empty-state-border);
+		border-radius: var(--stuic-empty-state-radius, var(--stuic-radius-container));
+	}
+
+	.stuic-empty-state[data-variant="dashed"] {
+		border-style: dashed;
+	}
+
+	/* ============================================================================
+	   ICON AREA
+	   ============================================================================ */
+
+	.stuic-empty-state-icon {
+		display: flex;
+		align-items: center;
+		justify-content: center;
+		color: var(--stuic-empty-state-icon-text);
+		opacity: var(--stuic-empty-state-icon-opacity);
+		margin-bottom: var(--stuic-empty-state-icon-margin-bottom);
+	}
+
+	/* Normalize any passed svg icon to the size preset (like DismissibleMessage) */
+	.stuic-empty-state-icon svg {
+		width: var(--_icon-size);
+		height: var(--_icon-size);
+	}
+
+	/* ============================================================================
+	   TITLE + DESCRIPTION
+	   ============================================================================ */
+
+	.stuic-empty-state-title {
+		font-size: var(--_title-font-size);
+		font-weight: var(--stuic-empty-state-title-font-weight);
+		color: var(--stuic-empty-state-title-text);
+	}
+
+	.stuic-empty-state-description {
+		font-size: var(--_description-font-size);
+		color: var(--stuic-empty-state-description-text);
+		max-width: var(--stuic-empty-state-description-max-width);
+	}
+
+	/* ============================================================================
+	   ACTIONS (CTA)
+	   ============================================================================ */
+
+	.stuic-empty-state-actions {
+		display: flex;
+		flex-wrap: wrap;
+		align-items: center;
+		justify-content: center;
+		gap: var(--stuic-empty-state-actions-gap);
+		margin-top: var(--stuic-empty-state-actions-margin-top);
+	}
+}

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

@@ -0,0 +1 @@
+export { default as EmptyState, type Props as EmptyStateProps, type EmptyStateVariant, type EmptyStateSize, } from "./EmptyState.svelte";

package/dist/components/EmptyState/index.js

@@ -0,0 +1 @@
+export { default as EmptyState, } from "./EmptyState.svelte";