@mhmo91/schmancy 0.9.27 → 0.10.1

package/types/src/mailbox/email-template-picker.d.ts

@@ -1,5 +1,5 @@
+import { SchmancyElement } from '@mixins/index';
 import type { EmailTemplate } from './types';
-declare const SchmancyEmailTemplatePicker_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * Email template picker content component (for use inside sheets)
  *
@@ -19,7 +19,8 @@ declare const SchmancyEmailTemplatePicker_base: CustomElementConstructor & impor
  * sheet.open({ component: picker, title: 'Choose Template' })
  * ```
  */
-export declare class SchmancyEmailTemplatePicker extends SchmancyEmailTemplatePicker_base {
+export declare class SchmancyEmailTemplatePicker extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /** Available templates */
     templates: EmailTemplate[];
     /** Search query */
@@ -29,7 +30,7 @@ export declare class SchmancyEmailTemplatePicker extends SchmancyEmailTemplatePi
     /** Selected category filter */
     private selectedCategory;
     connectedCallback(): void;
-    updated(changed: Map<string, any>): void;
+    updated(changed: Map<string, unknown>): void;
     /** Get unique categories from templates */
     get categories(): string[];
     /** Update filtered templates */
@@ -51,4 +52,3 @@ declare global {
         'schmancy-email-template-picker': SchmancyEmailTemplatePicker;
     }
 }
-export {};

package/types/src/mailbox/email-viewer.d.ts

@@ -1,5 +1,5 @@
+import { SchmancyElement } from '@mixins/index';
 import type { EmailAttachment } from './types';
-declare const SchmancyEmailViewer_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * Email viewer component showing formatted HTML and plain text versions
  *
@@ -22,7 +22,8 @@ declare const SchmancyEmailViewer_base: CustomElementConstructor & import("@mixi
  * ></schmancy-email-viewer>
  * ```
  */
-export declare class SchmancyEmailViewer extends SchmancyEmailViewer_base {
+export declare class SchmancyEmailViewer extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /** Email subject */
     subject: string;
     /** Email body content (markdown) */
@@ -83,4 +84,3 @@ declare global {
         'schmancy-email-viewer': SchmancyEmailViewer;
     }
 }
-export {};

package/types/src/mailbox/mailbox.d.ts

@@ -1,5 +1,5 @@
+import { SchmancyElement } from '@mixins/index';
 import type { EmailTemplate, EmailComposeConfig, ImportSource } from './types';
-declare const SchmancyMailbox_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * Main mailbox component that orchestrates the entire email composition flow
  *
@@ -19,7 +19,8 @@ declare const SchmancyMailbox_base: CustomElementConstructor & import("@mixins/i
  * ></schmancy-mailbox>
  * ```
  */
-export declare class SchmancyMailbox extends SchmancyMailbox_base {
+export declare class SchmancyMailbox extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /** Configuration for endpoints and handlers */
     config: EmailComposeConfig;
     /** Available email templates */
@@ -47,7 +48,7 @@ export declare class SchmancyMailbox extends SchmancyMailbox_base {
     private attachments;
     private isSending;
     connectedCallback(): void;
-    updated(changedProperties: Map<string, any>): void;
+    updated(changedProperties: Map<string, unknown>): void;
     /** Handle emails imported from various sources */
     private handleEmailsImported;
     /** Handle individual recipient removal */
@@ -79,4 +80,3 @@ declare global {
         'schmancy-mailbox': SchmancyMailbox;
     }
 }
-export {};

package/types/src/map/map.d.ts

@@ -1,3 +1,4 @@
+import { SchmancyElement } from '@mixins/index';
 import { Observable } from 'rxjs';
 interface GoogleMapsAPI {
     maps: {
@@ -20,7 +21,6 @@ declare global {
         __schmancyGoogleMapsLoading?: Observable<boolean>;
     }
 }
-declare const SchmancyMap_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * `<schmancy-map>` component
  *
@@ -45,7 +45,8 @@ declare const SchmancyMap_base: import("@mixins/index").Constructor<CustomElemen
  * <!-- Static map -->
  * <schmancy-map address="Eiffel Tower, Paris" interactive="false" controls="false"></schmancy-map>
  */
-export default class SchmancyMap extends SchmancyMap_base {
+export default class SchmancyMap extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /**
      * Simple address string that automatically geocodes to display the location.
      * Takes precedence over latitude/longitude if both are provided.
@@ -118,7 +119,7 @@ export default class SchmancyMap extends SchmancyMap_base {
     private initializeMap;
     private getMapTypeId;
     private addMarker;
-    protected updated(changedProperties: Map<string, any>): void;
+    protected updated(changedProperties: Map<string, unknown>): void;
     protected render(): import("lit-html").TemplateResult<1>;
 }
 declare global {

package/types/src/menu/menu-item.d.ts

@@ -1,18 +1,6 @@
-declare const SchmancyMenuItem_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
-/**
- * Single item inside a schmancy-menu. Auto-dismisses the menu dialog on click — attach your action handler to `@click` and it just works.
- *
- * @element schmancy-menu-item
- * @summary Always nested inside schmancy-menu. The click handler runs before the dialog closes, so `@click=${() => doThing()}` is the full pattern.
- * @example
- * <schmancy-menu-item @click=${() => archive()}>
- *   <schmancy-icon slot="leading">archive</schmancy-icon>
- *   Archive
- * </schmancy-menu-item>
- * @platform menuitem click - Wraps schmancy-list-item with auto-dismiss. Degrades to a styled `<button role="menuitem">` if the tag never registers.
- * @slot - The item label and optional icons.
- */
-export default class SchmancyMenuItem extends SchmancyMenuItem_base {
+import { SchmancyElement } from '@mixins/index';
+export default class SchmancyMenuItem extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     protected render(): unknown;
 }
 declare global {
@@ -20,4 +8,3 @@ declare global {
         'schmancy-menu-item': SchmancyMenuItem;
     }
 }
-export {};

package/types/src/menu/menu.d.ts

@@ -1,23 +1,36 @@
-declare const SchmancyMenu_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+import { SchmancyElement } from '@mixins/index';
 /**
- * Floating menu — a trigger button + a list of schmancy-menu-item children that open as a positioned dialog on click.
+ * Menu Component
  *
- * @element schmancy-menu
- * @summary Use for dropdown menus attached to a button or icon — "More actions", "Account", row overflow menus in tables. Clicking a schmancy-menu-item inside auto-dismisses; custom components slotted inside must call `$dialog.dismiss()` themselves.
- * @example
+ * CRITICAL: The dialog ONLY renders the raw menu items passed via the default slot.
+ * NO <ul> wrapper, NO classes, NO additional markup in the dialog call.
+ * The dialog service handles positioning and display - we just pass the pure content.
+ *
+ * @example Basic menu with auto-dismiss
+ * ```typescript
  * <schmancy-menu>
- *   <schmancy-icon-button slot="trigger" aria-label="Actions">
- *     <schmancy-icon>more_vert</schmancy-icon>
- *   </schmancy-icon-button>
- *   <schmancy-menu-item @click=${() => edit()}>Edit</schmancy-menu-item>
- *   <schmancy-menu-item @click=${() => remove()}>Delete</schmancy-menu-item>
+ *   <schmancy-button slot="trigger">Actions</schmancy-button>
+ *   <schmancy-menu-item @click=${() => editItem()}>Edit</schmancy-menu-item>
+ *   <schmancy-menu-item @click=${() => deleteItem()}>Delete</schmancy-menu-item>
  * </schmancy-menu>
- * @platform menu close - Trigger + floating listbox dialog. Degrades to a native `<select>` or inline list if the tag never registers.
+ * ```
+ * Note: Dialog auto-dismisses when schmancy-menu-item is clicked
+ *
+ * @example Custom component (manual dismiss)
+ * ```typescript
+ * <schmancy-menu>
+ *   <schmancy-icon-button slot="trigger">settings</schmancy-icon-button>
+ *   <my-settings-form @submit=${() => $dialog.dismiss()}></my-settings-form>
+ * </schmancy-menu>
+ * ```
+ * Note: Custom components must call $dialog.dismiss() manually
+ *
  * @slot trigger - Button to open menu (new naming)
  * @slot button - Button to open menu (backward compatible)
  * @slot default - Menu items or any custom component to display in dialog
  */
-export default class SchmancyMenu extends SchmancyMenu_base {
+export default class SchmancyMenu extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     private menuSlot;
     private showMenu;
     render(): import("lit-html").TemplateResult<1>;
@@ -27,4 +40,3 @@ declare global {
         'schmancy-menu': SchmancyMenu;
     }
 }
-export {};

package/types/src/nav-drawer/appbar.d.ts

@@ -1,20 +1,10 @@
-declare const SchmancyDrawerAppbar_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+import { SchmancyElement } from '@mixins/index';
 /**
- * Top app bar region inside schmancy-nav-drawer — the horizontal strip above the content area that typically holds the page title, hamburger trigger, and contextual actions.
- *
  * @element schmancy-nav-drawer-appbar
- * @summary Always nested inside schmancy-nav-drawer. Holds the page-level title + top-right actions. On mobile, the drawer's hamburger button renders inside this region.
- * @example
- * <schmancy-nav-drawer-appbar>
- *   <schmancy-typography type="title" token="lg">Dashboard</schmancy-typography>
- *   <schmancy-icon-button slot="trailing" aria-label="Notifications">
- *     <schmancy-icon>notifications</schmancy-icon>
- *   </schmancy-icon-button>
- * </schmancy-nav-drawer-appbar>
- * @platform header - Styled horizontal bar. Degrades to a plain header element if the tag never registers.
  * @slot - The default slot
  */
-export declare class SchmancyDrawerAppbar extends SchmancyDrawerAppbar_base {
+export declare class SchmancyDrawerAppbar extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
@@ -22,4 +12,3 @@ declare global {
         'schmancy-nav-drawer-appbar': SchmancyDrawerAppbar;
     }
 }
-export {};

package/types/src/nav-drawer/content.d.ts

@@ -1,16 +1,6 @@
-declare const SchmancyNavigationDrawerContent_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
-/**
- * Main content region inside schmancy-nav-drawer — typically hosts the router outlet or the page's body content.
- *
- * @element schmancy-nav-drawer-content
- * @summary Always nested inside schmancy-nav-drawer. Scrollable by default; propagates scroll events up so the drawer can collapse app-bar on scroll.
- * @example
- * <schmancy-nav-drawer-content>
- *   <schmancy-area name="main"></schmancy-area>
- * </schmancy-nav-drawer-content>
- * @platform main scroll - Scrollable `<main>`. Degrades to a plain scrollable div if the tag never registers.
- */
-export declare class SchmancyNavigationDrawerContent extends SchmancyNavigationDrawerContent_base {
+import { SchmancyElement } from '@mixins/index';
+export declare class SchmancyNavigationDrawerContent extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     connectedCallback(): void;
     render(): import("lit-html").TemplateResult<1>;
 }
@@ -19,4 +9,3 @@ declare global {
         'schmancy-nav-drawer-content': SchmancyNavigationDrawerContent;
     }
 }
-export {};

package/types/src/nav-drawer/drawer.d.ts

@@ -1,25 +1,11 @@
+import { SchmancyElement } from '@mixins/index';
 import { TSchmancyDrawerNavbarMode, TSchmancyDrawerNavbarState } from './context';
-declare const SchmancyNavigationDrawer_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
- * Responsive navigation drawer — a left sidebar that becomes a hamburger-triggered modal overlay on narrow viewports. Composes schmancy-nav-drawer-navbar (the nav rail), schmancy-nav-drawer-appbar (the top bar), and schmancy-nav-drawer-content (the main region).
- *
  * @element schmancy-nav-drawer
- * @summary The app-shell layout primitive. Wrap your whole app in this when you want "persistent sidebar on desktop, drawer on mobile" behavior. Mode auto-switches at the breakpoint.
- * @example
- * <schmancy-nav-drawer>
- *   <schmancy-nav-drawer-navbar>
- *     <!-- nav items, typically schmancy-list-item links -->
- *   </schmancy-nav-drawer-navbar>
- *   <schmancy-nav-drawer-appbar>App title</schmancy-nav-drawer-appbar>
- *   <schmancy-nav-drawer-content>
- *     <!-- router outlet / page content -->
- *   </schmancy-nav-drawer-content>
- * </schmancy-nav-drawer>
- * @platform div - Flex layout with viewport-width mode switching. Degrades to a stack of plain divs if the tag never registers.
  * @slot - The content slot
- * @fires schmancy-drawer-state - When the drawer open/close state changes on mobile.
  */
-export declare class SchmancyNavigationDrawer extends SchmancyNavigationDrawer_base {
+export declare class SchmancyNavigationDrawer extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     fullscreen: boolean;
     /**
      * The breakpoint for the sidebar based on Tailwind CSS breakpoints.
@@ -38,4 +24,3 @@ declare global {
         'schmancy-nav-drawer': SchmancyNavigationDrawer;
     }
 }
-export {};

package/types/src/nav-drawer/navbar.d.ts

@@ -1,20 +1,6 @@
+import { SchmancyElement } from '@mixins/index';
 import { TSchmancyDrawerNavbarMode, TSchmancyDrawerNavbarState } from './context';
-declare const SchmancyNavigationDrawerSidebar_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
-/**
- * Sidebar region inside schmancy-nav-drawer — the persistent-on-desktop / modal-on-mobile nav rail.
- *
- * @element schmancy-nav-drawer-navbar
- * @summary Always nested inside schmancy-nav-drawer. On desktop: pinned left sidebar. On mobile: modal overlay triggered by the hamburger button in schmancy-nav-drawer-appbar.
- * @example
- * <schmancy-nav-drawer-navbar>
- *   <schmancy-list>
- *     <schmancy-list-item href="/dashboard">Dashboard</schmancy-list-item>
- *     <schmancy-list-item href="/settings">Settings</schmancy-list-item>
- *   </schmancy-list>
- * </schmancy-nav-drawer-navbar>
- * @platform nav - Sidebar `<nav>` with responsive open/close behavior. Degrades to a plain sidebar div if the tag never registers.
- */
-export declare class SchmancyNavigationDrawerSidebar extends SchmancyNavigationDrawerSidebar_base {
+export declare class SchmancyNavigationDrawerSidebar extends SchmancyElement {
     mode: TSchmancyDrawerNavbarMode;
     drawerState: TSchmancyDrawerNavbarState;
     overlay: HTMLElement;
@@ -30,7 +16,7 @@ export declare class SchmancyNavigationDrawerSidebar extends SchmancyNavigationD
      * updated()
      * Trigger animations when either the consumed mode or state changes.
      */
-    updated(changedProperties: Map<string, any>): void;
+    updated(changedProperties: Map<string, unknown>): void;
     /**
      * Animate the overlay to fade in.
      */
@@ -53,4 +39,3 @@ declare global {
         'schmancy-nav-drawer-navbar': SchmancyNavigationDrawerSidebar;
     }
 }
-export {};

package/types/src/navigation-bar/navigation-bar-item.d.ts

@@ -1,10 +1,11 @@
-declare const SchmancyNavigationBarItem_base: import("../../mixins").Constructor<CustomElementConstructor> & import("../../mixins").Constructor<import("@mixins/tailwind.mixin").ITailwindElementMixin> & import("../../mixins").Constructor<import("lit").LitElement> & import("../../mixins").Constructor<import("../../mixins").IBaseMixin>;
+import { SchmancyElement } from '@mixins/index';
 /**
- * Single destination inside schmancy-navigation-bar — an icon + optional label representing one primary app destination.
+ * `<schmancy-navigation-bar-item>` component
+ *
+ * Individual navigation item for use within a navigation bar.
+ * Represents a single destination with an icon and optional label following Material Design 3 specifications.
  *
  * @element schmancy-navigation-bar-item
- * @summary Always nested inside schmancy-navigation-bar. Use `icon` attr for a Material Symbols glyph or slot=icon for custom content.
- * @platform button click - Styled navigation target. Degrades to a plain `<button>` if the tag never registers.
  * @slot icon - Slot for custom icon content
  * @slot - Default slot for custom content
  *
@@ -20,7 +21,8 @@ declare const SchmancyNavigationBarItem_base: import("../../mixins").Constructor
  *   <span slot="icon">🏠</span>
  * </schmancy-navigation-bar-item>
  */
-export declare class SchmancyNavigationBarItem extends SchmancyNavigationBarItem_base {
+export declare class SchmancyNavigationBarItem extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /**
      * Icon name for the navigation item (Material Symbols Outlined)
      */
@@ -90,4 +92,3 @@ declare global {
         'schmancy-navigation-bar-item': SchmancyNavigationBarItem;
     }
 }
-export {};

package/types/src/navigation-bar/navigation-bar.d.ts

@@ -1,10 +1,16 @@
-declare const SchmancyNavigationBar_base: import("../../mixins").Constructor<CustomElementConstructor> & import("../../mixins").Constructor<import("@mixins/tailwind.mixin").ITailwindElementMixin> & import("../../mixins").Constructor<import("lit").LitElement> & import("../../mixins").Constructor<import("../../mixins").IBaseMixin>;
+import { SchmancyElement } from '@mixins/index';
 /**
- * Bottom navigation bar — Material Design 3 horizontal nav for mobile primary destinations (3–7 items). Auto-hides in fullscreen mode.
+ * `<schmancy-navigation-bar>` component
+ *
+ * A horizontal navigation component following Material Design 3 specifications.
+ * Navigation bars provide access to between 3-7 primary destinations.
+ * Automatically hides in fullscreen mode when triggered via schmancyTheme.next({ fullscreen: true }).
+ *
+ * **IMPORTANT**: This component includes `z-10` by default (consistent with navigation-rail).
+ * The consumer is responsible for positioning the navigation bar in their layout.
+ * For typical bottom-fixed positioning, add: `class="fixed bottom-0 left-0 right-0"`.
  *
  * @element schmancy-navigation-bar
- * @summary Use for mobile primary navigation (home, search, favorites, settings). For persistent desktop nav, prefer schmancy-navigation-rail or schmancy-nav-drawer. Consumer is responsible for fixed-bottom positioning via class.
- * @platform nav - Styled horizontal nav with schmancy-navigation-bar-item children. Degrades to a plain flex container if the tag never registers.
  * @slot - Default slot for navigation bar items
  *
  * @fires navigation-change - When an item is selected
@@ -27,7 +33,8 @@ declare const SchmancyNavigationBar_base: import("../../mixins").Constructor<Cus
  *   </schmancy-navigation-bar>
  * </div>
  */
-export declare class SchmancyNavigationBar extends SchmancyNavigationBar_base {
+export declare class SchmancyNavigationBar extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /**
      * Observable for active index state
      */
@@ -125,7 +132,7 @@ export declare class SchmancyNavigationBar extends SchmancyNavigationBar_base {
      * Update active states on all items
      */
     private updateActiveStates;
-    updated(changedProperties: Map<string, any>): void;
+    updated(changedProperties: Map<string, unknown>): void;
     protected render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
@@ -133,4 +140,3 @@ declare global {
         'schmancy-navigation-bar': SchmancyNavigationBar;
     }
 }
-export {};

package/types/src/navigation-rail/navigation-rail-item.d.ts

@@ -1,3 +1,4 @@
+import { SchmancyElement } from '@mixins/index';
 import { PropertyValues } from 'lit';
 export type NavigationRailItemClickEvent = CustomEvent<{
     icon: string;
@@ -5,13 +6,16 @@ export type NavigationRailItemClickEvent = CustomEvent<{
     value: string;
     active: boolean;
 }>;
-declare const SchmancyNavigationRailItem_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
- * Single destination inside schmancy-navigation-rail — vertically-stacked icon + optional label. @see https://m3.material.io/components/navigation-rail/overview
+ * Material Design 3 Navigation Rail Item Component
+ * @see https://m3.material.io/components/navigation-rail/overview
+ *
+ * `<schmancy-navigation-rail-item>` component
+ *
+ * Individual navigation item for use within a navigation rail.
+ * Represents a single destination or action with an icon and optional label.
  *
  * @element schmancy-navigation-rail-item
- * @summary Always nested inside schmancy-navigation-rail. Use `icon` attr for a Material Symbols glyph, or slot=icon for custom content. Supports a `badge` slot for notification dots / counts.
- * @platform button click - Styled vertical navigation target. Degrades to a plain `<button>` if the tag never registers.
  * @slot icon - Slot for the navigation item icon (e.g., schmancy-icon)
  * @slot - Default slot for custom content
  * @slot badge - Custom badge content
@@ -48,7 +52,7 @@ declare const SchmancyNavigationRailItem_base: CustomElementConstructor & import
  *   <schmancy-icon slot="icon">dashboard</schmancy-icon>
  * </schmancy-navigation-rail-item>
  */
-export declare class SchmancyNavigationRailItem extends SchmancyNavigationRailItem_base {
+export declare class SchmancyNavigationRailItem extends SchmancyElement {
     private hovering$;
     private pressing$;
     private active$;
@@ -122,4 +126,3 @@ declare global {
         'schmancy-navigation-rail-item': SchmancyNavigationRailItem;
     }
 }
-export {};

package/types/src/navigation-rail/navigation-rail.d.ts

@@ -1,24 +1,20 @@
+import { SchmancyElement } from '@mixins/index';
 import { PropertyValues } from 'lit';
 export type NavigateEvent = CustomEvent<string>;
 export type NavigationRailMenuClickEvent = CustomEvent<void>;
 export type NavigationRailFabClickEvent = CustomEvent<void>;
 export type LabelVisibility = 'all' | 'selected' | 'none';
-declare const SchmancyNavigationRail_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
- * Vertical navigation rail — Material Design 3 compact left-side nav for desktop / tablet layouts with 3–7 primary destinations. Auto-hides in fullscreen mode. @see https://m3.material.io/components/navigation-rail/overview
+ * Material Design 3 Navigation Rail Component
+ * @see https://m3.material.io/components/navigation-rail/overview
+ *
+ * `<schmancy-navigation-rail>` component
+ *
+ * A Material Design 3 vertical navigation component positioned on the left side of an application.
+ * Navigation rails provide access to between 3-7 primary destinations with a compact footprint.
+ * Automatically hides in fullscreen mode when triggered via schmancyTheme.next({ fullscreen: true }).
  *
  * @element schmancy-navigation-rail
- * @summary Use as the desktop counterpart of schmancy-navigation-bar: same destinations, different form factor. Prefer schmancy-nav-drawer when you also want a drawer + app-bar combo.
- * @example
- * <schmancy-navigation-rail activeIndex="0">
- *   <schmancy-icon-button slot="fab" variant="filled">
- *     <schmancy-icon>add</schmancy-icon>
- *   </schmancy-icon-button>
- *   <schmancy-navigation-rail-item icon="home" label="Home"></schmancy-navigation-rail-item>
- *   <schmancy-navigation-rail-item icon="search" label="Search"></schmancy-navigation-rail-item>
- *   <schmancy-navigation-rail-item icon="settings" label="Settings"></schmancy-navigation-rail-item>
- * </schmancy-navigation-rail>
- * @platform nav - Vertical styled nav. Degrades to a plain vertical flex container if the tag never registers.
  * @slot fab - Slot for a floating action button at the top
  * @slot menu - Slot for a menu icon or button below the FAB
  * @slot header - Custom header content slot
@@ -48,7 +44,7 @@ declare const SchmancyNavigationRail_base: CustomElementConstructor & import("@m
  *   <schmancy-navigation-rail-item icon="settings" label="Settings"></schmancy-navigation-rail-item>
  * </schmancy-navigation-rail>
  */
-export declare class SchmancyNavigationRail extends SchmancyNavigationRail_base {
+export declare class SchmancyNavigationRail extends SchmancyElement {
     private activeIndex$;
     /**
      * The currently active item index
@@ -135,4 +131,3 @@ declare global {
         'schmancy-navigation-rail': SchmancyNavigationRail;
     }
 }
-export {};

package/types/src/notification/notification.d.ts

@@ -1,10 +1,11 @@
+import { SchmancyElement } from '@mixins/index';
 import '../progress/progress';
 export type NotificationType = 'info' | 'success' | 'warning' | 'error';
-declare const SchmancyNotification_base: CustomElementConstructor & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
 /**
  * @fires close - When notification is closed
  */
-export default class SchmancyNotification extends SchmancyNotification_base {
+export default class SchmancyNotification extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     title: string;
     message: string;
     type: NotificationType;
@@ -41,4 +42,3 @@ declare global {
         'sch-notification': SchmancyNotification;
     }
 }
-export {};

package/types/src/option/option.d.ts

@@ -1,10 +1,11 @@
-declare const SchmancyOption_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+import { SchmancyElement } from '@mixins/index';
 /**
  * `schmancy-option` is an option element for schmancy-select and schmancy-autocomplete components.
  *
  * @fires click - When the option is clicked
  */
-export default class SchmancyOption extends SchmancyOption_base {
+export default class SchmancyOption extends SchmancyElement {
+    static styles: import("lit").CSSResult[];
     /**
      * The value of the option, will be used when selected.
      */
@@ -38,4 +39,3 @@ declare global {
         'schmancy-option': SchmancyOption;
     }
 }
-export {};

package/types/src/overlay/overlay.animations.d.ts

@@ -1,13 +1,21 @@
-import type { OverlayLayout } from './overlay.types';
+import type { Anchor, OverlayLayout } from './overlay.types';
 /**
  * WAAPI keyframes + options per layout + direction.
  *
  * One animation vocabulary — no per-element bespoke keyframes. Aligns
- * with the `animation` skill (spring physics presets). Honors
- * `prefers-reduced-motion` by collapsing transforms to opacity-only.
+ * with the `animation` skill (spring physics presets). Every easing runs
+ * through `getEasing()` so modern browsers (that support
+ * `animation-timing-function: linear(0, 1)`) get the true `linear()`
+ * spring expression while older browsers fall through to the cubic-bezier
+ * fallback. Honors `prefers-reduced-motion` by collapsing transforms to
+ * opacity-only.
  *
- * Returns `null` when reduced-motion is active and only opacity change
- * is needed — the caller sets style directly.
+ * Anchor-origin bloom: the caller computes
+ * `anchorOriginVars(anchor, surfaceRect)` and writes the resulting CSS
+ * custom properties onto the surface element BEFORE triggering the
+ * entrance animation. Keyframes reference those vars via
+ * `transform-origin: var(--schmancy-overlay-origin-x, 50%) var(...)`, so
+ * the surface scales OUT of the click point — not from its own centre.
  */
 /**
  * Shape matches both DOM `AnimationEffectTiming` and
@@ -22,5 +30,46 @@ export interface AnimationSpec {
         fill?: FillMode;
     };
 }
+/**
+ * Compute CSS-var values for the anchor-relative transform origin.
+ * Caller writes the returned record onto the surface element's style
+ * before triggering the entrance animation. When no anchor is present,
+ * returns sensible per-layout defaults (caller picks which to use):
+ *   - centered → 50% 50% (self-centre)
+ *   - sheet    → 50% 100% (rises from bottom edge)
+ *   - anchored → computed from the anchor's position relative to the
+ *                surface rect
+ */
+export declare function anchorOriginVars(anchor: Anchor | undefined, surfaceRect: DOMRect | {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}): Record<string, string>;
 export declare function backdropAnimation(direction: 'in' | 'out'): AnimationSpec;
 export declare function surfaceAnimation(layout: OverlayLayout, direction: 'in' | 'out'): AnimationSpec;
+/**
+ * FLIP (First / Last / Invert / Play) animation from `before` rect to
+ * `after` rect. Caller has already moved the element between the two
+ * states; this produces the WAAPI spec that animates the delta back.
+ *
+ * Used by the ResizeObserver-driven layout re-resolve in the overlay
+ * element — when content grows past threshold mid-session and the
+ * layout switches from centered → sheet, this animates the transition
+ * instead of a hard cut.
+ *
+ * Reduced-motion collapses to an instant 1ms no-op; caller should check
+ * `reducedMotion` (not exported) — or just run this and tolerate the
+ * 1ms animation.
+ */
+export declare function flipAnimation(before: DOMRect | {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, after: DOMRect | {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}): AnimationSpec;