ctrl-fx 0.0.1 → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { type NodeGroup } from './dom/views';
+import type { Node } from './dom';
+import { type Effect } from './effects';
+import type { Component } from './dom/components';
+/** Type guard that returns true when `effectOrState` is a plain state value rather than an `Effect`. */
+export declare function isState<State>(effectOrState: Effect<State, never, State> | State): effectOrState is State;
+/** Converts a plain view function and initial state into a `Component`. Used internally by `manageApplication`; prefer `component()` from `ctrl-fx/dom` in application code. */
+export declare function toComponent<State>(app: (state: State) => Node<State, never> | NodeGroup<State, never>, initialState: State | Effect<State, never, State>): Component<State, void, never>;
+/**
+ * Mounts a ctrl-fx application into the DOM element with id `mountId` and starts the runtime.
+ * Returns a `dispatchEffect` handle for triggering effects from outside the framework
+ * (e.g. from a service worker message).
+ * @param mountId The id of the mount element. Defaults to `'app'`.
+ */
+export declare function manageApplication<State>(app: (state: State) => Node<State, never> | NodeGroup<State, never>, initialState: State | Effect<State, never, State>, mountId?: string): {
+    dispatchEffect: (effect: Effect<State, never, void>) => void;
+};
+/** Width and height in pixels, as reported by a resize observer. */
+export type Dimensions = {
+    width: number;
+    height: number;
+};
+/** The browser permission state for a feature such as notifications. */
+export interface Permission {
+    value: 'default' | 'granted' | 'denied';
+    /** Returns true when the permission has been explicitly granted. */
+    isGranted(): boolean;
+    /** Returns true when the user has not yet been prompted. */
+    isDefault(): boolean;
+    /** Returns true when the permission has been explicitly denied. */
+    isDenied(): boolean;
+}
+/** Constructs a `Permission` value from a raw browser permission string. */
+export declare function permission(value: 'default' | 'granted' | 'denied'): Permission;
+/** A branded string containing a UUID v4. */
+export type Uuid = string & {
+    __brand: 'Uuid';
+};
+/** Deterministically derives a UUID-shaped string from `input` by hashing it. Useful for generating stable node identifiers from content. */
+export declare function uuidFromString(input: string): Uuid;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAOjD,wGAAwG;AACxG,wBAAgB,OAAO,CAAC,KAAK,EAC3B,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,KAAK,GACjD,aAAa,IAAI,KAAK,CAExB;AAED,gLAAgL;AAChL,wBAAgB,WAAW,CAAC,KAAK,EAC/B,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EACnE,YAAY,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAChD,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAwB/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EACrC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EACnE,YAAY,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EACjD,OAAO,GAAE,MAAc,GACtB;IAAE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,CAUlE;AAeD,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;IACvC,oEAAoE;IACpE,SAAS,IAAI,OAAO,CAAA;IACpB,4DAA4D;IAC5D,SAAS,IAAI,OAAO,CAAA;IACpB,mEAAmE;IACnE,QAAQ,IAAI,OAAO,CAAA;CACpB;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GACtC,UAAU,CAaZ;AAED,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/C,6IAA6I;AAC7I,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAkBlD"}

package/dist/index.js

@@ -0,0 +1,78 @@
+//import type { Component } from "./components";
+//import { type NodeGroup } from "./dom/views";
+import { isNodeGroup, nodeGroup } from './dom/views';
+import { 
+/*isEffect, makeEffects,*/ isEffect, makeEffects, } from './effects';
+import { domInterpreter } from './internal/dominterpreter';
+import { manageComponent } from './internal/cmpmgr';
+import { realStyleRegistry } from './internal/styleregistry';
+//import { ComponentManager } from "./internal/cmpmgr";
+/** Type guard that returns true when `effectOrState` is a plain state value rather than an `Effect`. */
+export function isState(effectOrState) {
+    return !isEffect(effectOrState);
+}
+/** Converts a plain view function and initial state into a `Component`. Used internally by `manageApplication`; prefer `component()` from `ctrl-fx/dom` in application code. */
+export function toComponent(app, initialState) {
+    const { pure } = makeEffects();
+    const initialStateEffect = isState(initialState)
+        ? pure(initialState)
+        : initialState;
+    const adjustedApp = (state) => {
+        const nodeOrNodeGroup = app(state);
+        if (isNodeGroup(nodeOrNodeGroup)) {
+            return nodeOrNodeGroup;
+        }
+        else {
+            return nodeGroup(nodeOrNodeGroup);
+        }
+    };
+    return {
+        _type: 'Component',
+        params: undefined,
+        view: adjustedApp,
+        initialState() {
+            return initialStateEffect;
+        },
+    };
+}
+/**
+ * Mounts a ctrl-fx application into the DOM element with id `mountId` and starts the runtime.
+ * Returns a `dispatchEffect` handle for triggering effects from outside the framework
+ * (e.g. from a service worker message).
+ * @param mountId The id of the mount element. Defaults to `'app'`.
+ */
+export function manageApplication(app, initialState, mountId = 'app') {
+    const component = toComponent(app, initialState);
+    return manageComponent(component, mountId, globalThis.window, domInterpreter, realStyleRegistry());
+}
+/** Constructs a `Permission` value from a raw browser permission string. */
+export function permission(value) {
+    return {
+        value,
+        isGranted() {
+            return value === 'granted';
+        },
+        isDefault() {
+            return value === 'default';
+        },
+        isDenied() {
+            return value === 'denied';
+        },
+    };
+}
+/** Deterministically derives a UUID-shaped string from `input` by hashing it. Useful for generating stable node identifiers from content. */
+export function uuidFromString(input) {
+    let hash = 0;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) - hash + input.charCodeAt(i)) | 0;
+    }
+    const hex = (hash >>> 0).toString(16).padStart(8, '0');
+    const repeated = hex.repeat(4);
+    return [
+        repeated.slice(0, 8),
+        repeated.slice(8, 12),
+        repeated.slice(12, 16),
+        repeated.slice(16, 20),
+        repeated.slice(20, 32),
+    ].join('-');
+}

package/dist/internal/clipboard.d.ts

@@ -0,0 +1,5 @@
+import { type ClipboardError } from '../clipboard';
+import { type Result } from '../utils/result';
+export declare function writeClipboard(text: string, callback: (result: Result<void, ClipboardError>) => void): void;
+export declare function readClipboard(callback: (result: Result<string, ClipboardError>) => void): void;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/internal/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/internal/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE/D,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,IAAI,GACvD,IAAI,CAWN;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,IAAI,GACzD,IAAI,CAWN"}

package/dist/internal/clipboard.js

@@ -0,0 +1,33 @@
+import { clipboardError } from '../clipboard';
+import { failure, success } from '../utils/result';
+export function writeClipboard(text, callback) {
+    if (!globalThis.navigator?.clipboard?.writeText) {
+        callback(failure(clipboardError('NotSupported', 'Clipboard API not available')));
+        return;
+    }
+    globalThis.navigator.clipboard
+        .writeText(text)
+        .then(() => callback(success(undefined)))
+        .catch((err) => callback(failure(toClipboardError(err))));
+}
+export function readClipboard(callback) {
+    if (!globalThis.navigator?.clipboard?.readText) {
+        callback(failure(clipboardError('NotSupported', 'Clipboard API not available')));
+        return;
+    }
+    globalThis.navigator.clipboard
+        .readText()
+        .then(text => callback(success(text)))
+        .catch((err) => callback(failure(toClipboardError(err))));
+}
+function toClipboardError(err) {
+    if (err instanceof DOMException && err.name === 'NotAllowedError') {
+        return clipboardError('NotAllowed', err.message);
+    }
+    else if (err instanceof Error) {
+        return clipboardError('UnexpectedError', err.message);
+    }
+    else {
+        return clipboardError('UnexpectedError', `Unexpected clipboard error: ${err}`);
+    }
+}

package/dist/internal/cmpmgr.d.ts

@@ -0,0 +1,46 @@
+import { type ComponentPath } from ".";
+import { type Component } from "../dom/components";
+import type { Effect } from "../effects";
+import type { Interpreter } from "./interpreter";
+import type { RealElement, RealWindow } from "./realdom";
+import type { StyleRegistry } from "./styleregistry";
+import { type ComponentState, type InternalNode } from "./vdom";
+export declare function manageComponent<State, Params, Event>(component: Component<State, Params, Event>, mountId: string, window: RealWindow, interpreter: Interpreter, styleRegistry: StyleRegistry): {
+    dispatchEffect: (effect: Effect<State, Event, void>) => void;
+};
+export declare class ComponentManager {
+    private rootCompPath;
+    private components;
+    private removedComponents;
+    private addedComponents;
+    private interpreter;
+    private window;
+    private document;
+    private eventManager;
+    private taskRegistry;
+    private styleRegistry;
+    private onRootEvent;
+    constructor(component: Component<unknown, unknown, unknown>, mountNode: RealElement, window: RealWindow, interpreter: Interpreter, styleRegistry: StyleRegistry, onRootEvent?: (event: unknown) => void);
+    private injectComponentCss;
+    getRootState(): ComponentState;
+    dispatchEffect(effect: Effect<unknown, unknown, void>): void;
+    destroy(): void;
+    private runEffect;
+    private renderComponent;
+    private compareNodeSequences;
+    private removeNode;
+    private compareNodes;
+    private convertNodeToInternalNode;
+    /**
+     * Return an old node that can be compared to `newNode`.
+     *
+     * If the old node represent the same node as `newNode`, return it.
+     *
+     * If the same node isn't found, return the first node if it is `comparable`,
+     * otherwise return undefined. (We don't move nodes if they are comparable but
+     * not the same).
+     */
+    private findCorrespondingOldNode;
+}
+export declare function foldTree<A>(root: InternalNode, ancestorComponentPath: ComponentPath, init: A, f: (node: InternalNode, ancestorComponentId: ComponentPath, acc: A) => A): A;
+//# sourceMappingURL=cmpmgr.d.ts.map

package/dist/internal/cmpmgr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmpmgr.d.ts","sourceRoot":"","sources":["../../src/internal/cmpmgr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,GAAG,CAAC;AAGtD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAYL,KAAK,cAAc,EACnB,KAAK,YAAY,EAGlB,MAAM,QAAQ,CAAC;AAIhB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAClD,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAC1C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,GAC3B;IAAE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,CAkBlE;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO,CAAC,UAAU,CAEX;IAEP,OAAO,CAAC,iBAAiB,CAElB;IAEP,OAAO,CAAC,eAAe,CAAuB;IAE9C,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAE/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,WAAW,CAAyC;gBAG1D,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAC/C,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAqCxC,OAAO,CAAC,kBAAkB;IAW1B,YAAY,IAAI,cAAc;IAQ9B,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;IAI5D,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,eAAe;IA2CvB,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,UAAU;IAiDlB,OAAO,CAAC,YAAY;IAqJpB,OAAO,CAAC,yBAAyB;IAwIjC;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;CAgCjC;AAoED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,YAAY,EAClB,qBAAqB,EAAE,aAAa,EACpC,IAAI,EAAE,CAAC,EACP,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GACvE,CAAC,CA+CH"}