domma-js 0.56.0 → 0.58.0

package/public/dist/elements.css

@@ -1,9 +1,9 @@
 /*!
- * Domma Elements CSS v0.56.0
+ * Domma Elements CSS v0.58.0
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-10-24T16:12:49.159Z
- * Commit: f768320
+ * Built: 2026-10-24T22:17:45.003Z
+ * Commit: 6edd082
  */
 
 /**
@@ -3986,6 +3986,12 @@ code {
     z-index: 10000;
 }
 
+/* A slideover takes focus itself on open (its focus trap), so the first Tab reaches its
+   first control; the panel is not a tab stop and needs no ring of its own. */
+.dm-slideover[tabindex="-1"]:focus {
+    outline: none;
+}
+
 .dm-dialog-overlay {
     position: fixed;
     top: 0;

package/public/dist/grid.css

@@ -1,9 +1,9 @@
 /*!
- * Domma Grid CSS v0.56.0
+ * Domma Grid CSS v0.58.0
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-10-24T16:12:49.154Z
- * Commit: f768320
+ * Built: 2026-10-24T22:17:44.999Z
+ * Commit: 6edd082
  */
 
 /**

package/public/dist/syntax.css

@@ -1,9 +1,9 @@
 /*!
- * Domma Syntax Highlighting CSS v0.56.0
+ * Domma Syntax Highlighting CSS v0.58.0
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-10-24T16:12:49.162Z
- * Commit: f768320
+ * Built: 2026-10-24T22:17:45.006Z
+ * Commit: 6edd082
  */
 
 /**

package/public/dist/themes/domma-themes.css

@@ -1,9 +1,9 @@
 /*!
- * Domma Themes v0.56.0
+ * Domma Themes v0.58.0
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-10-24T16:12:49.139Z
- * Commit: f768320
+ * Built: 2026-10-24T22:17:44.986Z
+ * Commit: 6edd082
  */
 
 /**

package/templates/kickstart/.claude/snippets.md

@@ -61,7 +61,7 @@ $.ready(() => {
         // Event bindings
         '#theme-toggle': {
             events: {
-                click: () => Domma.theme.toggle()
+                click: () => Domma.theme.set(`${Domma.theme.getBase()}-${Domma.theme.isDark() ? 'light' : 'dark'}`)
             }
         }
     });

package/templates/kickstart/CLAUDE.md

@@ -537,7 +537,7 @@ if (Domma.theme.isDark()) {
 }
 
 // Toggle between light/dark variants
-Domma.theme.toggle();  // ocean-dark → ocean-light
+Domma.theme.set(`${Domma.theme.getBase()}-${Domma.theme.isDark() ? 'light' : 'dark'}`);  // ocean-dark → ocean-light
 
 // Listen to theme changes
 $(document.body).on('themechange', (e) => {

package/templates/kickstart/frontend/types/domma.d.ts

@@ -6,7 +6,8 @@
  * jQuery-style DOM manipulation, Lodash utilities, and modern UI components.
  *
  * NOTE: This is a consolidated type definition file for the Domma framework.
- * For complete type definitions, see: https://dommajs.org/assets/ide/phpstorm/
+ * For complete type definitions (generated from the source), see the domma-js npm package:
+ * assets/types/index.d.ts - https://unpkg.com/domma-js/assets/types/index.d.ts
  */
 
 // ============================================
@@ -473,10 +474,12 @@ export const http: Http;
 export interface Theme {
     init(options?: { theme?: string; autoDetect?: boolean; persist?: boolean }): void;
     set(themeName: string): void;
-    setVariant(variant: 'light' | 'dark'): void;
-    toggle(): void;
     get(): string;
-    getVariant(): string;
+    getBase(): string;
+    getMode(): string;
+    isDark(): boolean;
+    listThemes(): string[];
+    listBases(): string[];
 }
 
 export const theme: Theme;

package/templates/kickstart-spa/.claude/snippets.md

@@ -160,7 +160,7 @@ $.ready(() => {
         // Event bindings
         '#theme-toggle': {
             events: {
-                click: () => Domma.theme.toggle()
+                click: () => Domma.theme.set(`${Domma.theme.getBase()}-${Domma.theme.isDark() ? 'light' : 'dark'}`)
             }
         }
     });

package/assets/types/config.d.ts

@@ -1,136 +0,0 @@
-/**
- * Domma Config Module - TypeScript Declarations
- * Declarative configuration engine for component initialisation
- */
-
-import {DommaCollection} from './dom';
-
-export type ComponentType = 'card' | 'modal' | 'tabs' | 'accordion' | 'tooltip' | 'carousel' | 'dropdown';
-
-export interface InitialProperties {
-    css?: Record<string, string | number>;
-    text?: string;
-    html?: string;
-    addClass?: string;
-    removeClass?: string;
-    toggleClass?: string;
-    attr?: Record<string, string>;
-}
-
-export interface EventAction {
-    target?: string;
-    css?: Record<string, string | number>;
-    text?: string;
-    html?: string;
-    addClass?: string;
-    removeClass?: string;
-    toggleClass?: string;
-    log?: string;
-}
-
-export type ConfigEventHandler = (event: Event, $el: DommaCollection) => void;
-export type EventActions = ConfigEventHandler | EventAction | (ConfigEventHandler | EventAction)[];
-
-export interface SelectorConfig {
-    /** Component type to initialise */
-    component?: ComponentType;
-
-    /** Component options */
-    options?: Record<string, any>;
-
-    /** Initial state properties to apply */
-    initial?: InitialProperties;
-
-    /** Event handlers */
-    events?: Record<string, EventActions>;
-}
-
-export interface SetupConfig {
-    [selector: string]: SelectorConfig;
-}
-
-export interface ConfigEngine {
-    /**
-     * Process initial configuration
-     * @param config - Configuration object keyed by selector
-     */
-    process(config: SetupConfig): void;
-
-    /**
-     * Update configuration for a selector
-     * @param selector - CSS selector
-     * @param changes - Changes to merge into existing config
-     * @returns The merged configuration
-     */
-    update(selector: string, changes: Partial<SelectorConfig>): SelectorConfig;
-
-    /**
-     * Retrieve configuration for a selector or all selectors
-     * @param selector - Optional selector to get config for
-     * @returns Configuration object or null if not found
-     */
-    config(): Record<string, SelectorConfig>;
-
-    config(selector: string): SelectorConfig | null;
-
-    /**
-     * Reset/destroy configuration for a selector or all selectors
-     * @param selector - Optional selector to reset
-     */
-    /**
-     * Retrieve the live component instance created by setup() for a selector.
-     * Instances are NOT stored on the element - $(sel).data('component') is
-     * always undefined.
-     * @param selector - Selector the component was configured under
-     */
-    getComponent(selector: string): any | null;
-    getComponent(): Map<string, any>;
-
-    reset(selector?: string): void;
-
-    /**
-     * Initialise a component
-     * @param selector - CSS selector
-     * @param componentType - Component type name
-     * @param options - Component options
-     * @returns Component instance
-     */
-    initComponent(selector: string, componentType: ComponentType, options?: Record<string, any>): any;
-
-    /**
-     * Apply properties to DOM elements
-     * @param domElements - Domma collection
-     * @param properties - Properties to apply
-     */
-    applyProperties(domElements: DommaCollection, properties: InitialProperties): void;
-
-    /**
-     * Bind events to elements
-     * @param selector - CSS selector
-     * @param events - Event handlers object
-     * @param track - Whether to track handlers for later removal
-     */
-    bindEvents(selector: string, events: Record<string, EventActions>, track?: boolean): void;
-
-    /**
-     * Unbind all tracked events for a selector
-     * @param selector - CSS selector
-     */
-    unbindEvents(selector: string): void;
-
-    /**
-     * Update events for a selector (replaces existing handlers for same events)
-     * @param selector - CSS selector
-     * @param newEvents - New event handlers
-     */
-    updateEvents(selector: string, newEvents: Record<string, EventActions>): void;
-
-    /**
-     * Execute actions for an event
-     * @param event - DOM event
-     * @param actions - Actions to execute
-     */
-    executeActions(event: Event, actions: EventActions): void;
-}
-
-export declare const configEngine: ConfigEngine;

package/assets/types/dates.d.ts

@@ -1,209 +0,0 @@
-/**
- * Domma Dates Module - TypeScript Declarations
- * Moment.js-style chainable date manipulation
- */
-
-export type DateInput = Date | string | number | DommaDate | null | undefined;
-export type DateUnit =
-    'year'
-    | 'years'
-    | 'month'
-    | 'months'
-    | 'week'
-    | 'weeks'
-    | 'day'
-    | 'days'
-    | 'date'
-    | 'hour'
-    | 'hours'
-    | 'minute'
-    | 'minutes'
-    | 'second'
-    | 'seconds'
-    | 'millisecond'
-    | 'milliseconds';
-export type DiffUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
-export type Inclusivity = '()' | '[]' | '[)' | '(]';
-
-/**
- * Chainable date wrapper class
- */
-export declare class DommaDate {
-    constructor(value?: DateInput);
-
-    // ============================================
-    // Manipulation Methods (chainable)
-    // ============================================
-
-    /** Add time to the date */
-    add(amount: number, unit: DateUnit): DommaDate;
-
-    /** Subtract time from the date */
-    subtract(amount: number, unit: DateUnit): DommaDate;
-
-    /** Set to start of unit of time */
-    startOf(unit: DateUnit): DommaDate;
-
-    /** Set to end of unit of time */
-    endOf(unit: DateUnit): DommaDate;
-
-    /** Set a unit of time */
-    set(unit: DateUnit, value: number): DommaDate;
-
-    // ============================================
-    // Getter Methods
-    // ============================================
-
-    /** Get unit value or underlying Date */
-    get(): Date;
-    get(unit: DateUnit): number;
-
-    /** Get the year */
-    year(): number;
-
-    /** Get the month (0-11) */
-    month(): number;
-
-    /** Get the date of month (1-31) */
-    date(): number;
-
-    /** Get the day of week (0-6, Sunday=0) */
-    day(): number;
-
-    /** Get the hour (0-23) */
-    hour(): number;
-
-    /** Get the minute (0-59) */
-    minute(): number;
-
-    /** Get the second (0-59) */
-    second(): number;
-
-    /** Get the millisecond (0-999) */
-    millisecond(): number;
-
-    /** Get the day of year (1-366) */
-    dayOfYear(): number;
-
-    /** Get the week of year */
-    week(): number;
-
-    /** Get the quarter (1-4) */
-    quarter(): number;
-
-    /** Get Unix timestamp (seconds) */
-    unix(): number;
-
-    /** Get milliseconds since epoch */
-    valueOf(): number;
-
-    // ============================================
-    // Formatting
-    // ============================================
-
-    /** Format the date using tokens */
-    format(formatStr?: string): string;
-
-    /** Get ISO 8601 string */
-    toISOString(): string;
-
-    /** Get native Date object */
-    toDate(): Date;
-
-    /** Get string representation */
-    toString(): string;
-
-    /** Get relative time from now */
-    fromNow(relativeTo?: DateInput): string;
-
-    /** Get relative time to another date */
-    to(date: DateInput): string;
-
-    // ============================================
-    // Comparison Methods
-    // ============================================
-
-    /** Check if date is before another */
-    isBefore(other: DateInput, unit?: DateUnit): boolean;
-
-    /** Check if date is after another */
-    isAfter(other: DateInput, unit?: DateUnit): boolean;
-
-    /** Check if date is same as another */
-    isSame(other: DateInput, unit?: DateUnit): boolean;
-
-    /** Check if date is between two dates */
-    isBetween(start: DateInput, end: DateInput, unit?: DateUnit, inclusivity?: Inclusivity): boolean;
-
-    /** Get difference between dates */
-    diff(other: DateInput, unit?: DiffUnit, precise?: boolean): number;
-
-    // ============================================
-    // Query Methods
-    // ============================================
-
-    /** Check if date is valid */
-    isValid(): boolean;
-
-    /** Check if year is a leap year */
-    isLeapYear(): boolean;
-
-    /** Get number of days in month */
-    daysInMonth(): number;
-
-    // ============================================
-    // Clone
-    // ============================================
-
-    /** Create a copy of this date */
-    clone(): DommaDate;
-}
-
-export interface FormatTokens {
-    YYYY: string;
-    YY: string;
-    MM: string;
-    M: string;
-    DD: string;
-    D: string;
-    HH: string;
-    H: string;
-    hh: string;
-    h: string;
-    mm: string;
-    m: string;
-    ss: string;
-    s: string;
-    SSS: string;
-    A: string;
-    a: string;
-    ddd: string;
-    dddd: string;
-    MMM: string;
-    MMMM: string;
-}
-
-export interface Dates {
-    /** Create a DommaDate from a value */
-    (value?: DateInput): DommaDate;
-
-    /** Get current timestamp in milliseconds */
-    now(): number;
-
-    /** Parse a date string with optional format */
-    parse(dateString: string, format?: string): DommaDate;
-
-    /** Check if a value is a valid date */
-    isValid(value: DateInput): boolean;
-
-    /** Get the minimum date from a list */
-    min(...dates: DateInput[]): DommaDate;
-
-    /** Get the maximum date from a list */
-    max(...dates: DateInput[]): DommaDate;
-
-    /** Format tokens reference */
-    tokens: FormatTokens;
-}
-
-export declare const dates: Dates;