@ctrliq/quantic-components 1.67.1 → 1.67.3

package/dist/types/shared/auto-hide-empty-slots.mixin.d.ts

@@ -1,27 +1,26 @@
-import { SlotContentInterface } from './slot-content.mixin';
 import { LitConstructor } from './shared.types';
 import { QuanticElement } from './quantic-element';
-export interface AutoHideEmptySlotsInterface extends SlotContentInterface {
-    handleAutoHide(e: Event): void;
-}
 /**
- * Mixin that automatically hides empty slots using the `hidden` attribute.
- * Extends SlotContentMixin to inherit slot checking functionality.
+ * Mixin that automatically hides empty named slots using CSS only.
  *
- * This is useful for components with optional sections that should not
- * take up space or affect layout when empty.
+ * Each named slot is hidden by default and revealed when the host has a light
+ * DOM child with a matching `slot` attribute. Two rules cover all browsers:
+ *
+ * - `:host(:has([slot="name"]))` — Safari and Firefox
+ * - `@scope { :scope:has([slot="name"]) }` — Chrome (@scope changes the
+ *   evaluation context so :has() can see light DOM children)
+ *
+ * The reveal value is `display: revert-layer` rather than `display: block` so
+ * that the component's own display value is restored instead of overridden.
+ * Component styles are placed in `@layer quantic-component` and the
+ * hide/reveal rules in `@layer quantic-slot-visibility` (declared after, so
+ * higher priority). `revert-layer` then falls back to whatever the component
+ * set in `quantic-component`.
+ *
+ * CSS is injected via `finalizeStyles` so it lands in Lit SSR's Declarative
+ * Shadow DOM output — no JS, no layout shift.
  *
  * @example
- * ```typescript
- * class MyComponent extends AutoHideEmptySlotsMixin(QuanticElement) {
- *   render() {
- *     return html`
- *       <slot name="header" @slotchange=${this.handleAutoHide}></slot>
- *       <slot></slot>
- *       <slot name="footer" @slotchange=${this.handleAutoHide}></slot>
- *     `;
- *   }
- * }
- * ```
+ * class MyElement extends AutoHideEmptySlotsMixin(QuanticElement, ['header', 'footer']) {}
  */
-export declare const AutoHideEmptySlotsMixin: <T extends LitConstructor<QuanticElement>>(superClass: T) => T & LitConstructor<AutoHideEmptySlotsInterface>;
+export declare const AutoHideEmptySlotsMixin: <T extends LitConstructor<QuanticElement>>(superClass: T, namedSlots?: string[]) => T;

package/dist/types/shared/quantic-element.d.ts

@@ -1,4 +1,5 @@
 import { LitElement } from 'lit';
+import type { LitConstructor } from './shared.types';
 import type { ComponentMeta } from './meta.types';
 /**
  * Base class for Quantic components.
@@ -8,10 +9,19 @@ export declare class QuanticElement extends LitElement {
     static meta?: ComponentMeta;
     static ensureDefined(): void;
 }
+/**
+ * Any QuanticElement subclass, including the anonymous ones mixins and HOCs
+ * return — those are plain constructors, so their statics are declared here
+ * rather than inferred from `typeof QuanticElement`.
+ */
+export type QuanticElementConstructor = LitConstructor<QuanticElement> & {
+    tagName?: string;
+    meta?: ComponentMeta;
+};
 /**
  * Decorator that registers a QuanticElement subclass as a custom element and sets its tagName.
  * The class must extend QuanticElement to inherit the ensureDefined() static method.
  *
  * @param tagName - The custom element tag name (e.g., 'quantic-badge')
  */
-export declare function quanticElement(tagName: string): <T extends typeof QuanticElement>(target: T) => T;
+export declare function quanticElement(tagName: string): <T extends QuanticElementConstructor>(target: T) => T;

package/dist/types/shared/slot-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Returns true if a slot has at least one non-whitespace node assigned.
+ */
+export declare function slotHasContent(slot: HTMLSlotElement): boolean;
+/**
+ * Returns the concatenated trimmed text content of all assigned nodes.
+ */
+export declare function slotTextContent(slot: HTMLSlotElement): string;
+/**
+ * Returns a slotchange event handler that calls `setter` with whether the slot
+ * has non-empty content.
+ *
+ * @example
+ * html`<slot @slotchange=${onSlotChange((has) => (this._hasLabel = has))}></slot>`
+ */
+export declare function onSlotChange(setter: (has: boolean) => void): (e: Event) => void;
+/**
+ * Returns a slotchange event handler that calls `setter` with the slot's text
+ * content, falling back to `''` when empty.
+ *
+ * @example
+ * html`<slot @slotchange=${onSlotTextChange((t) => (this._labelText = t))}></slot>`
+ */
+export declare function onSlotTextChange(setter: (text: string) => void): (e: Event) => void;

package/dist/types/table/index.stories.d.ts

@@ -20,4 +20,5 @@ export declare const WithToolbar: import("../shared/story").StoryObject<Args>;
 export declare const WithControls: import("../shared/story").StoryObject<Args>;
 export declare const WithToolbarAndControls: import("../shared/story").StoryObject<Args>;
 export declare const SortChange: import("../shared/story").StoryObject<Args>;
+export declare const EmptyOptionalSlots: any;
 export declare const CustomColumnWidths: import("../shared/story").StoryObject<Args>;

package/dist/types/table/table.component.d.ts

@@ -1,7 +1,7 @@
 import { QuanticElement } from '../shared/quantic-element';
 import { TableSize, TableVariant } from './index.constants';
 import type { ComponentMeta } from '../shared/meta.types';
-declare const Table_base: typeof QuanticElement & import("../shared/shared.types").LitConstructor<import("../shared/auto-hide-empty-slots.mixin").AutoHideEmptySlotsInterface>;
+declare const Table_base: typeof QuanticElement;
 export declare class Table extends Table_base {
     static meta: ComponentMeta;
     size: TableSize;

package/dist/types/toast/toast.d.ts

@@ -3,7 +3,7 @@ import { QuanticElement } from '../shared/quantic-element';
 import { ToastType } from './index.constants';
 import type { ComponentMeta } from '../shared/meta.types';
 export { ToastType } from './index.constants';
-declare const Toast_base: typeof QuanticElement & import("../shared/shared.types").LitConstructor<import("../shared/auto-hide-empty-slots.mixin").AutoHideEmptySlotsInterface>;
+declare const Toast_base: typeof QuanticElement;
 export declare class Toast extends Toast_base {
     static meta: ComponentMeta;
     open: boolean;

package/dist/types/toggle/index.d.ts

@@ -14,7 +14,7 @@ declare const Toggle_base: {
             invalid?: boolean;
         } | undefined): import("../shared/a11y-attributes.mixin").A11yAttributeValues;
     };
-} & typeof QuanticElement & import("../shared/shared.types").LitConstructor<import("../shared/slot-content.mixin").SlotContentInterface>;
+} & typeof QuanticElement;
 export declare class Toggle extends Toggle_base {
     static meta: ComponentMeta;
     static formAssociated: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctrliq/quantic-components",
-  "version": "1.67.1",
+  "version": "1.67.3",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "exports": {