mftsccs-browser 2.1.237-beta → 2.1.239-dev

package/dist/types/Widgets/BuilderStatefulWidget.d.ts

@@ -1,392 +0,0 @@
-import { StatefulWidget } from "./StatefulWidget";
-import { Concept } from "../app";
-import { TCustomFunction } from "../DataStructures/TypeLibrary";
-/**
- * BuilderStatefulWidget - A dynamic, stateful widget component for building interactive UI elements.
- *
- * This class extends StatefulWidget to provide a powerful widget system that supports:
- * - Dynamic HTML rendering with lifecycle hooks
- * - Child widget composition and mounting
- * - Custom function execution and event handling
- * - Type-based data binding and queries
- * - Development mode with visual editing capabilities
- * - Widget dependencies and custom functions
- *
- * **Key Features:**
- * - **Lifecycle Management**: before_render, render, after_render hooks
- * - **Dynamic Code Execution**: Safely executes user-defined JavaScript functions
- * - **Child Widgets**: Supports hierarchical widget composition
- * - **Type Integration**: Connects to TSCCS type system for data binding
- * - **Development Mode**: Visual editing and type editor integration
- * - **Custom Functions**: Execute user-defined functions within widget context
- * - **Local Connections**: Create relationships between entities at the widget level
- *
- * **Lifecycle Flow:**
- * 1. Constructor creates widget instance
- * 2. mount() attaches to parent DOM element
- * 3. render_custom_functions() executes custom code
- * 4. render_widgetDependencies() loads dependencies
- * 5. before_render() (componentDidMount equivalent) executes
- * 6. mount_child() mounts child widgets
- * 7. render() updates the DOM
- * 8. after_render() (addEvent) attaches event listeners
- *
- * **Use Cases:**
- * - Building dynamic forms with type-based data
- * - Creating reusable UI components
- * - Widget-based page builders
- * - Interactive dashboards
- * - Data-driven UI components
- *
- * @extends StatefulWidget
- *
- * @example
- * // Create and mount a widget
- * const widget = new BuilderStatefulWidget();
- * widget.html = '<div>Hello Widget</div>';
- * widget.widgetType = 'the_person_name';
- * widget.componentDidMountFunction = 'console.log("Widget mounted")';
- * await widget.mount(parentElement);
- *
- * @example
- * // Widget with custom functions
- * const widget = new BuilderStatefulWidget();
- * widget.customFunctions = [
- *   { code: 'this.handleClick = () => { console.log("Clicked!"); }' }
- * ];
- * await widget.mount(parentElement);
- *
- * @example
- * // Development mode with type editor
- * const widget = new BuilderStatefulWidget();
- * widget.inDevelopment = true; // Enables visual editing
- * widget.widgetType = 'the_element_name';
- * await widget.mount(parentElement);
- */
-export declare class BuilderStatefulWidget extends StatefulWidget {
-    /** Array of child component instances mounted within this widget */
-    childComponents: any;
-    /** Flag indicating whether the component has been mounted to the DOM */
-    componentMounted: boolean;
-    /** Reference to the previous HTML element (used for comparison during updates) */
-    oldHtml: HTMLElement | null;
-    /** Value returned from onmount lifecycle hook */
-    onmountVal: any;
-    /** Value returned from addEvent lifecycle hook */
-    addEventVal: any;
-    /** Array of phonebook data (legacy or specific use case) */
-    phonebooks: any;
-    /** Object containing data for child components */
-    childrenData: any;
-    /** JavaScript code (as string) to execute after rendering for event binding */
-    addEventFunction: any;
-    /** JavaScript code (as string) to execute after component mounts (like componentDidMount) */
-    componentDidMountFunction: any;
-    /** JavaScript code (as string) to execute for mounting child widgets */
-    mountChildWidgetsFunction: any;
-    /** Array of child widget instances */
-    childWidgets: any;
-    /** Array of type value options fetched from backend based on widgetType */
-    typeValueList: any;
-    /** The type identifier for this widget (e.g., "the_person_name", "the_element_name") */
-    widgetType: string;
-    /** Array of parent concept IDs for hierarchical relationships */
-    parentConceptList: any;
-    /** Array of custom function objects with code to execute in widget context */
-    customFunctions: TCustomFunction[];
-    /** JavaScript code (as string) for widget dependencies initialization */
-    widgetDependenciesData: string;
-    /**
-     * Retrieves the current user's ID from local storage.
-     *
-     * This method fetches the user profile from localStorage and extracts the userId.
-     * Used for user-specific operations and data access within widgets.
-     *
-     * @returns Promise resolving to the user ID (number) or undefined if not found
-     *
-     * @example
-     * const userId = await widget.getUserId();
-     * console.log('Current user:', userId);
-     */
-    getUserId(): any;
-    /**
-     * Fetches a list of type values from the backend based on the widget's type.
-     *
-     * This method performs a filtered search using FreeschemaQuery to retrieve all entities
-     * of a specific type. The results are formatted as options for dropdowns or selection lists.
-     *
-     * **Process:**
-     * 1. Parses widgetType to extract main composition and type-value key
-     * 2. Creates filter for entities (e.g., filter by ID > 1)
-     * 3. Executes FreeschemaQuery with filters
-     * 4. Formats results into { id, name, text } objects
-     * 5. Stores in this.typeValueList
-     *
-     * **Type Name Format:**
-     * - widgetType: "the_element_name"
-     * - mainComposition: "the_element"
-     * - typevalueKey: "the_name"
-     *
-     * @param typeName - Optional type name (defaults to this.widgetType)
-     *
-     * @returns Promise resolving to array of formatted type values:
-     *         [{ id: number, name: string, text: string }, ...]
-     *
-     * @example
-     * widget.widgetType = 'the_person_name';
-     * const options = await widget.getTypeValueList();
-     * // Returns: [{ id: 123, name: "John Doe", text: "John Doe" }, ...]
-     */
-    getTypeValueList(typeName?: string): Promise<unknown>;
-    /**
-     * Sets the browser document title.
-     *
-     * @param title - The title string to set as the document title
-     */
-    setTitle(title: string): void;
-    /**
-     * Returns the HTML content of this widget.
-     *
-     * @returns The HTML string for this widget
-     */
-    getHtml(): string;
-    /**
-     * Generates a random identifier for this widget element.
-     *
-     * @returns A random number used as the element identifier
-     */
-    createRandomNumber(): number;
-    /**
-     * Mounts child widgets by executing the mountChildWidgetsFunction.
-     *
-     * This method dynamically executes user-defined JavaScript code for mounting
-     * child widgets. The code is executed within the widget's context with access
-     * to the tsccs package.
-     *
-     * **Execution Context:**
-     * - Code is bound to `this` (the widget instance)
-     * - Has access to `tsccs` module for TSCCS operations
-     * - Runs asynchronously
-     *
-     * @throws Will log and re-throw errors if mount_child code fails
-     *
-     * @example
-     * widget.mountChildWidgetsFunction = `
-     *   const childWidget = new tsccs.BuilderStatefulWidget();
-     *   childWidget.html = '<div>Child</div>';
-     *   await childWidget.mount(this.childWidgetElement);
-     * `;
-     * await widget.mount_child();
-     */
-    mount_child(): Promise<void>;
-    /**
-     * Sets the widget type and fetches associated type values.
-     *
-     * This method updates the widget's type, fetches the corresponding type values
-     * from the backend, updates DOM attributes, and triggers a re-render.
-     *
-     * @param widgetTypeName - The new widget type name (e.g., "the_person_name")
-     *
-     * @returns Promise resolving to this widget instance (for method chaining)
-     *
-     * @example
-     * await widget.setProperty('the_person_email');
-     * // Widget now displays person email options
-     */
-    setProperty(widgetTypeName: any): Promise<this>;
-    /**
-     * Opens the type editor interface for this widget.
-     *
-     * This method is called in development mode when the widget is clicked.
-     * It opens a visual editor for modifying the widget's type and properties.
-     *
-     * @param event - The click event that triggered the editor
-     */
-    createTypeEditor(event: any): void;
-    /**
-     * Mounts the widget to a parent DOM element and initializes the lifecycle.
-     *
-     * This is the primary method for rendering a widget to the DOM. It:
-     * 1. Creates a wrapper div element
-     * 2. Attaches click handlers (if in development mode)
-     * 3. Inserts HTML content
-     * 4. Executes lifecycle hooks in order
-     * 5. Mounts child widgets
-     *
-     * **Lifecycle Execution Order:**
-     * 1. render_custom_functions() - Execute custom functions
-     * 2. render_widgetDependencies() - Load dependencies
-     * 3. before_render() - componentDidMount equivalent
-     * 4. mount_child() - Mount child widgets
-     * 5. render() - Update DOM
-     *
-     * **Development Mode:**
-     * When `inDevelopment` is true, the widget becomes clickable and opens
-     * the type editor for visual configuration.
-     *
-     * @param parent - The parent HTMLElement to mount this widget to
-     *
-     * @example
-     * // Basic mounting
-     * const widget = new BuilderStatefulWidget();
-     * widget.html = '<h1>Hello World</h1>';
-     * await widget.mount(document.getElementById('app'));
-     *
-     * @example
-     * // Development mode
-     * const widget = new BuilderStatefulWidget();
-     * widget.inDevelopment = true;
-     * widget.widgetType = 'the_person_name';
-     * await widget.mount(parentElement);
-     * // Widget is now clickable for editing
-     */
-    mount(parent: HTMLElement): Promise<void>;
-    /**
-     * Executes widget dependencies initialization code.
-     *
-     * This lifecycle method runs during the mount phase to load and initialize
-     * any dependencies required by the widget. Dependencies code is executed
-     * with access to the tsccs module.
-     *
-     * **Execution:**
-     * - Runs before before_render()
-     * - Code in widgetDependenciesData is executed
-     * - Bound to widget context (this)
-     * - Has access to tsccs package
-     *
-     * @throws Will log and re-throw errors if dependency code fails
-     *
-     * @example
-     * widget.widgetDependenciesData = `
-     *   this.apiClient = await tsccs.createApiClient();
-     *   this.config = await tsccs.loadConfig();
-     * `;
-     */
-    render_widgetDependencies(): void;
-    /**
-     * Executes all custom functions defined for this widget.
-     *
-     * This method runs during the mount phase to execute user-defined custom
-     * functions. All functions in the customFunctions array are concatenated
-     * and executed together in the widget's context.
-     *
-     * **Custom Functions:**
-     * - Defined in widget.customFunctions array
-     * - Each function is a TCustomFunction object with a code property
-     * - All functions execute with access to `this` (widget) and `tsccs` module
-     * - Functions can define methods, initialize state, or set up utilities
-     *
-     * @throws Will log and re-throw errors if custom function code fails
-     *
-     * @example
-     * widget.customFunctions = [
-     *   { code: 'this.handleClick = (e) => { console.log("Clicked", e); }' },
-     *   { code: 'this.formatDate = (date) => date.toLocaleDateString();' }
-     * ];
-     * widget.render_custom_functions();
-     * // Both functions are now available on widget instance
-     */
-    render_custom_functions(): void;
-    /**
-     * Executes the componentDidMount lifecycle hook.
-     *
-     * This function is called after the component mounts to the DOM, similar to
-     * React's componentDidMount. It executes user-defined initialization code
-     * stored in componentDidMountFunction.
-     *
-     * **Lifecycle Position:**
-     * Runs after render_custom_functions() and render_widgetDependencies(),
-     * but before mount_child().
-     *
-     * **Common Uses:**
-     * - Fetch initial data from API
-     * - Set up subscriptions or listeners
-     * - Initialize third-party libraries
-     * - Perform DOM manipulations
-     * - Set initial state based on props
-     *
-     * @throws Will log and re-throw errors if componentDidMount code fails
-     *
-     * @example
-     * widget.componentDidMountFunction = `
-     *   const data = await tsccs.GetTheConcept(123);
-     *   this.setState({ userData: data });
-     *   console.log("Widget mounted with data:", data);
-     * `;
-     * widget.before_render(); // Executes the above code
-     */
-    before_render(): void;
-    /**
-     * Executes event binding code after the widget renders.
-     *
-     * This lifecycle method runs after the DOM is updated to attach event listeners
-     * and perform post-render operations. It executes user-defined code stored in
-     * addEventFunction.
-     *
-     * **Lifecycle Position:**
-     * Runs after render() completes and DOM is updated.
-     *
-     * **Common Uses:**
-     * - Attach click, input, or other event listeners
-     * - Set up keyboard shortcuts
-     * - Initialize interactive features
-     * - Bind form validation
-     * - Set up drag-and-drop handlers
-     *
-     * @throws Will log and re-throw errors if event binding code fails
-     *
-     * @example
-     * widget.addEventFunction = `
-     *   const button = this.element.querySelector('.submit-btn');
-     *   button.addEventListener('click', async (e) => {
-     *     const data = await tsccs.CreateTheConcept('New Item', 1, 1);
-     *     console.log('Created:', data);
-     *   });
-     * `;
-     * widget.after_render(); // Attaches the event listener
-     */
-    after_render(): void;
-    /**
-     * Creates a local connection between two concepts with a specified linker type.
-     *
-     * This helper method creates a connection relationship between two entity concepts
-     * using local storage (not immediately synced to backend). The linker name is
-     * automatically prefixed with the first concept's type to create a typed connection.
-     *
-     * **Process:**
-     * 1. Extracts userId from first concept
-     * 2. Creates linker name: "{concept1Type}_{linkerName}"
-     * 3. Creates or gets the connection type concept locally
-     * 4. Creates the connection between the two concepts
-     *
-     * **Use Cases:**
-     * - Creating relationships in offline mode
-     * - Building entity associations within widgets
-     * - Temporary connections before sync
-     * - Development/testing without backend
-     *
-     * @param concept1Data - The source concept (FROM)
-     * @param concept2Data - The target concept (TO)
-     * @param linker - The relationship name (e.g., "email", "phone", "address")
-     *                This will be prefixed with concept1's type
-     *
-     * @returns Promise resolving to "connection created" string
-     *
-     * @example
-     * const person = await tsccs.GetTheConcept(123); // type: "the_person"
-     * const email = await tsccs.GetTheConcept(456);  // type: "the_email"
-     *
-     * await widget.CreateConnectionBetweenEntityLocal(person, email, "email");
-     * // Creates connection with type: "the_person_email"
-     * // Result: Person → email → Email
-     *
-     * @example
-     * // Create organization-department connection
-     * const org = await tsccs.GetTheConcept(789);  // type: "the_organization"
-     * const dept = await tsccs.GetTheConcept(101); // type: "the_department"
-     *
-     * await widget.CreateConnectionBetweenEntityLocal(org, dept, "department");
-     * // Creates: "the_organization_department" connection
-     */
-    CreateConnectionBetweenEntityLocal(concept1Data: Concept, concept2Data: Concept, linker: string): Promise<string>;
-}

package/dist/types/Widgets/CacheWidget.service.d.ts

@@ -1,77 +0,0 @@
-/**
- * Statistics about the current cache state.
- */
-export interface CacheStats {
-    /** Number of cached entries */
-    cacheSize: number;
-    /** Number of pending fetch requests */
-    pendingRequests: number;
-    /** Array of all cache keys */
-    keys: string[];
-}
-/**
- * Generic data cache with promise deduplication.
- *
- * Provides in-memory caching with automatic request deduplication to prevent
- * multiple simultaneous fetches for the same key.
- */
-export declare class DataCache<T = any> {
-    /** Map storing cached data by key */
-    static cache: Map<string, any>;
-    /** Map storing pending fetch promises by key */
-    static promises: Map<string, Promise<any>>;
-    /**
-     * Gets data from cache or fetches if not cached.
-     *
-     * Automatically deduplicates concurrent requests for the same key.
-     *
-     * @param key - Cache key
-     * @param fetcher - Function to fetch data if not cached
-     * @returns Promise resolving to the cached or fetched data
-     */
-    static get<K>(key: string, fetcher: () => Promise<K>): Promise<K>;
-    /**
-     * Checks if a key exists in cache without fetching.
-     *
-     * @param key - Cache key to check
-     * @returns True if key exists in cache
-     */
-    static has(key: string): boolean;
-    /**
-     * Gets cached data synchronously without fetching.
-     *
-     * @param key - Cache key
-     * @returns Cached data or undefined if not cached
-     */
-    static peek<K>(key: string): K | undefined;
-    /**
-     * Removes a specific cache entry.
-     *
-     * @param key - Cache key to remove
-     */
-    static invalidate(key: string): void;
-    /**
-     * Clears all cached data and pending promises.
-     */
-    static clear(): void;
-    /**
-     * Sets data directly in cache without fetching.
-     *
-     * @param key - Cache key
-     * @param data - Data to cache
-     * @returns Promise resolving to the cached data
-     */
-    static set<K>(key: string, data: K): Promise<K>;
-    /**
-     * Gets cache statistics including size and pending requests.
-     *
-     * @returns Object with cache statistics
-     */
-    static stats(): CacheStats;
-}
-/**
- * Initializes and returns a new widget cache instance.
- *
- * @returns A new DataCache instance
- */
-export declare function initWidgetCache(): DataCache<any>;

package/dist/types/Widgets/NormalizeStyles.service.d.ts

@@ -1,10 +0,0 @@
-/**
- * Normalizes CSS by processing nested selectors into flat CSS.
- *
- * Uses PostCSS with postcss-nested to convert nested CSS syntax
- * into standard flat CSS rules.
- *
- * @param cssString - CSS string with nested selectors
- * @returns Promise resolving to normalized CSS string or null on error
- */
-export declare function normalizeCSS(cssString: string): Promise<string | null>;

package/dist/types/Widgets/RenderPage.service.d.ts

@@ -1,17 +0,0 @@
-/**
- * Applies page-level properties from page data to the document.
- *
- * Processes meta tags, width, font size, font family, and page type settings.
- *
- * @param pageData - Page data object containing property configurations
- */
-export declare function applyPageProperties(pageData: any): Promise<void>;
-/**
- * Applies a single page property to the document.
- *
- * Handles width, font size, font family, page type (fixed/fluid), and meta tags.
- *
- * @param property - Property name (e.g., "width", "meta_title", "font_size")
- * @param value - Property value to apply
- */
-export declare function applyPageProperty(property: string, value: any): Promise<void>;

package/dist/types/Widgets/RenderWidgetLibrary.service.d.ts

@@ -1,22 +0,0 @@
-import { WidgetTree } from "./WidgetTree";
-/**
- * Initializes and loads external CSS and JS libraries for a widget.
- *
- * Processes widget library dependencies and injects them into the document
- * in the correct order.
- *
- * @param widgetTree - The widget tree containing library definitions
- */
-export declare function initializeLibraries(widgetTree: WidgetTree): Promise<void>;
-/**
- * Removes CSS library elements from document head by class name.
- *
- * @param cssClassName - The class name of CSS library elements to remove
- */
-export declare function removeCSSLibrariesFromHead(cssClassName: string): void;
-/**
- * Removes JavaScript library elements from document head by class name.
- *
- * @param jsClassName - The class name of JS library elements to remove
- */
-export declare function removeJSLibrariesFromHead(jsClassName: string): void;