domma-js 0.53.3 → 0.55.0

package/assets/types/config.d.ts

@@ -28,8 +28,8 @@ export interface EventAction {
     log?: string;
 }
 
-export type EventHandler = (event: Event, $el: DommaCollection) => void;
-export type EventActions = EventHandler | EventAction | (EventHandler | EventAction)[];
+export type ConfigEventHandler = (event: Event, $el: DommaCollection) => void;
+export type EventActions = ConfigEventHandler | EventAction | (ConfigEventHandler | EventAction)[];
 
 export interface SelectorConfig {
     /** Component type to initialise */

package/assets/types/elements.d.ts

@@ -30,6 +30,18 @@ export interface ComponentInstance {
     /** Update component options at runtime */
     setOptions(newOptions: Record<string, any>): this;
 
+    /**
+     * Listen for a component event - the name of an `onX` option without `on`, lower-cased
+     * ('change', 'open', 'beforeclose'). The handler gets the same arguments as the option;
+     * returning false from a `before...` handler cancels. The same event is dispatched on
+     * `element` as `dm:<component>:<event>` with `detail = {instance, args}`.
+     */
+    on(event: string, handler: (...args: any[]) => any): this;
+    /** Listen once */
+    once(event: string, handler: (...args: any[]) => any): this;
+    /** Stop listening (every handler for the event when none is given) */
+    off(event: string, handler?: (...args: any[]) => any): this;
+
     /** Destroy the component and cleanup event listeners */
     destroy(): void;
 }
@@ -79,6 +91,14 @@ export interface ModalOptions {
     animationDuration?: number;
     /** Show close button */
     closeButton?: boolean;
+    /** Return false to keep the modal closed (also `.on('beforeopen')`, `dm:modal:beforeopen`) */
+    onBeforeOpen?: (modal: ModalInstance) => boolean | void;
+    /** Return false to keep the modal open (also `.on('beforeclose')`, `dm:modal:beforeclose`) */
+    onBeforeClose?: (modal: ModalInstance) => boolean | void;
+    /** Modal content (HTML, sanitised like $().html() unless `safe: false`) */
+    content?: string;
+    /** false: insert `content` as trusted markup */
+    safe?: boolean;
     /** Callback before opening */
     onOpen?: (modal: ModalInstance) => void;
     /** Callback after open animation completes */
@@ -622,7 +642,8 @@ export interface Elements {
     accordion(selector: string | HTMLElement, options?: AccordionOptions): AccordionInstance;
 
     /** Create Tooltip(s) - returns array if multiple elements match */
-    tooltip(selector: string | HTMLElement, options?: TooltipOptions): TooltipInstance | TooltipInstance[];
+    /** Sets up every match; returns the first, with `all()` for every instance */
+    tooltip(selector: string | HTMLElement, options?: TooltipOptions): TooltipInstance & {all(): TooltipInstance[]};
 
     /** Create Badge(s) - returns array if multiple elements match */
     badge(selector: string | HTMLElement, options?: BadgeOptions): BadgeInstance | BadgeInstance[];
@@ -642,8 +663,8 @@ export interface Elements {
     /** Toast notification system */
     toast: ToastStatic;
 
-    /** Get component instance for an element */
-    get(selector: string | HTMLElement): ComponentInstance | undefined;
+    /** Get the component on an element - factory-made ones too. `name` picks one when an element hosts several. */
+    get(selector: string | HTMLElement, name?: string): ComponentInstance | undefined;
 
     /** Destroy a component */
     destroy(selector: string | HTMLElement): void;

package/assets/types/index.d.ts

@@ -22,11 +22,11 @@ export * from './flags';
 export * from './smooth-caret';
 
 // Import types for the main Domma object
-import {dom, DommaCollection} from './dom';
+import {DommaCollection} from './dom';
 import {Utils, utils} from './utils';
 import {Dates, dates, DommaDate} from './dates';
 import {Model, models, Models} from './models';
-import {configEngine, SelectorConfig, SetupConfig} from './config';
+import {SelectorConfig, SetupConfig} from './config';
 import {Elements, elements} from './elements';
 import {Tables, tables} from './tables';
 import {Storage, storage} from './storage';
@@ -55,9 +55,6 @@ export interface DommaStatic {
      */
     (callback: () => void): void;
 
-    /** DOM manipulation module */
-    dom: typeof dom;
-
     /** Utility functions (Lodash-compatible) */
     utils: Utils;
 
@@ -137,8 +134,12 @@ export interface DommaStatic {
     /** Domma version string */
     version: string;
 
-    /** No-conflict mode - restore previous $ */
-    noConflict(): DommaStatic;
+    /**
+     * Give `$` and `_` back to whatever owned them before Domma loaded (jQuery, Lodash).
+     * With `deep`, give back every short alias (`window.Domma` stays).
+     * @returns Domma, so `const dm = Domma.noConflict()` keeps a handle
+     */
+    noConflict(deep?: boolean): DommaStatic;
 }
 
 // ============================================
@@ -190,21 +191,43 @@ declare global {
 declare const Domma: DommaStatic;
 export default Domma;
 
-// Named exports for ES modules
-export {
-    Domma,
-    dom,
-    utils,
-    dates,
-    models,
-    elements,
-    tables,
-    storage,
-    http,
-    theme,
-    icons,
-    configEngine,
-    DommaCollection,
-    DommaDate,
-    Model
-};
+// Named exports for ES modules - exactly what src/index.js exports
+declare const $: DommaStatic;
+declare const _: Utils;
+declare const M: Models;
+declare const D: Dates;
+declare const S: Storage;
+declare const H: Http;
+declare const E: Elements;
+declare const I: Icons;
+declare const T: Tables;
+declare const smoothCaret: SmoothCaret;
+// Not typed yet: auth, forms, router, blueprint helpers, web-component registry
+declare const A: any;
+declare const F: any;
+declare const R: any;
+declare const B: any;
+declare const components: any;
+
+export {Domma, $, _, M, D, S, A, F, H, E, I, T, R, B, components, smoothCaret};
+export type {DommaCollection, DommaDate, Model};
+
+/** Options read from `window.DommaOptions` when Domma loads - set it before the script tag. */
+export interface DommaLoadOptions {
+    /** true (default): every alias; 'safe': only aliases nobody else owns; false: window.Domma only */
+    globals?: boolean | 'safe';
+    /** false: never add the `dm-cloaked` class */
+    cloak?: boolean;
+    /** false: don't initialise the theme engine automatically */
+    theme?: boolean;
+    /** false: no console warning when DOMPurify is missing */
+    purifyWarning?: boolean;
+    /** false: no deprecation warnings */
+    deprecationWarnings?: boolean;
+}
+
+declare global {
+    interface Window {
+        DommaOptions?: DommaLoadOptions;
+    }
+}

package/assets/types/theme.d.ts

@@ -23,7 +23,8 @@ export interface ThemeChangeEvent {
 }
 
 export type ThemeChangeCallback = (event: ThemeChangeEvent) => void;
-export type UnsubscribeFn = () => void;
+import type {UnsubscribeFn} from './models';
+export type {UnsubscribeFn};
 
 export interface ThemeOptions {
     /** Initial theme mode */

package/package.json

@@ -1,10 +1,34 @@
 {
     "name": "domma-js",
-    "version": "0.53.3",
+    "version": "0.55.0",
     "description": "Dynamic Object Manipulation & Modeling API - A complete front-end toolkit.",
     "main": "public/dist/domma.min.js",
     "module": "public/dist/domma.esm.js",
     "types": "assets/types/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./assets/types/index.d.ts",
+            "import": "./public/dist/domma.esm.js",
+            "default": "./public/dist/domma.esm.js"
+        },
+        "./css": "./public/dist/domma.css",
+        "./elements.css": "./public/dist/elements.css",
+        "./grid.css": "./public/dist/grid.css",
+        "./syntax.css": "./public/dist/syntax.css",
+        "./syntax": "./public/dist/domma-syntax.min.js",
+        "./flags": {
+            "import": "./public/dist/domma-flags.esm.js",
+            "default": "./public/dist/domma-flags.min.js"
+        },
+        "./themes/*": "./public/dist/themes/*",
+        "./bundles/*": "./public/dist/bundles/*",
+        "./types": "./assets/types/index.d.ts",
+        "./package.json": "./package.json",
+        "./public/*": "./public/*",
+        "./assets/*": "./assets/*",
+        "./templates/*": "./templates/*",
+        "./bin/*": "./bin/*"
+    },
     "bin": {
         "domma": "./bin/domma-cli.js"
     },
@@ -15,15 +39,20 @@
         "templates/page-template/",
         "templates/view-template/",
         "public/dist/domma.min.js",
+        "public/dist/domma.min.js.map",
         "public/dist/domma.esm.js",
+        "public/dist/domma.esm.js.map",
         "public/dist/domma.css",
         "public/dist/bundles/",
         "public/dist/elements.css",
         "public/dist/grid.css",
         "public/dist/syntax.css",
         "public/dist/domma-syntax.min.js",
+        "public/dist/domma-syntax.min.js.map",
         "public/dist/domma-flags.min.js",
+        "public/dist/domma-flags.min.js.map",
         "public/dist/domma-flags.esm.js",
+        "public/dist/domma-flags.esm.js.map",
         "public/dist/themes/",
         "assets/types/",
         "LICENSE",
@@ -35,7 +64,6 @@
     },
     "type": "module",
     "scripts": {
-        "postinstall": "node bin/postinstall.js",
         "start": "node bin/domma-cli.js serve",
         "serve": "node bin/domma-cli.js serve",
         "serve:3096": "node bin/domma-cli.js serve --port 3096",
@@ -95,10 +123,7 @@
         "live-server": "^1.2.0",
         "puppeteer": "^24.34.0",
         "rollup": "^4.28.0",
-        "rollup-plugin-obfuscator": "^1.1.0",
         "vitest": "^4.0.16"
     },
-    "dependencies": {
-        "@fastify/cors": "^11.2.0"
-    }
+    "dependencies": {}
 }