arrmatura 6.2.1 → 6.3.2

package/src/core/routing.ts

@@ -1,37 +0,0 @@
-import { CtxNode } from "../ctx/CtxNode";
-import { Ctx } from "../ctx/Ctx";
-import type { XmlNode } from "ultimus/types";
-
-class DynamicTag extends Ctx<CDynamicTagNode> {
-  get displayName(): string {
-    return "dynamics";
-  }
-
-  get content() {
-    const tag = this.component.tag;
-    const uid = `${this.uid}:${String(tag ?? "")}`;
-    return new Map([
-      [
-        uid,
-        Object.assign(
-          this.platform.getCompiledNodes({ ...this.node.xml, tag } as XmlNode),
-          { uid }
-        ),
-      ],
-    ]);
-  }
-}
-
-export class CDynamicTagNode extends CtxNode {
-  xml: XmlNode & { tag: string };
-
-  constructor(xml: XmlNode, expr: string) {
-    super();
-    this.compileAttribute("tag", expr);
-    this.xml = xml;
-  }
-
-  get EntityConstructor() {
-    return DynamicTag;
-  }
-}

package/src/core/selection.ts

@@ -1,57 +0,0 @@
-import { CtxNode } from "../ctx/CtxNode";
-import { Ctx } from "../ctx/Ctx";
-import type { Hash, XmlNode } from "ultimus/types";
-import type { EContent, IPlatform } from "arrmatura-api/types";
-
-export class Selector extends Ctx<CSelectorNode> {
-  get displayName(): string {
-    return `💠Selector`;
-  }
-
-  /**
-   * Gets the content of the function.
-   *
-   * @return {any} The content of the function.
-   */
-  get content() {
-    const cases = this.node.getCases(this.platform);
-    const matchedCase = cases?.[this.component.on as string];
-    if (!matchedCase) {
-      this.log('unmatched case', this.component.on, cases);
-    }
-    return matchedCase ?? cases?.['default'] ?? Object.values(cases)[0];
-  }
-}
-
-export class CSelectorNode extends CtxNode {
-  cases: Hash<EContent> | null = null;
-  key = '';
-  nodes?: XmlNode["nodes"];
-
-  constructor({ tag, attrs, nodes }: XmlNode) {
-    super();
-    this.tag = tag;
-    this.nodes = nodes;
-    this.compileAttributes(attrs);
-  }
-
-  /**
-   * Retrieves the cases nodes for a component.
-   *
-   * @param {IPlatform} platform - The platform to get cases for.
-   * @return {Hash<EContent>} - The cases for the platform.
-   */
-  getCases(platform: IPlatform): Hash<EContent> {
-    return this.cases ?? (this.cases = (this.nodes ?? []).reduce<Hash<EContent>>(
-      (groups, node) => {
-        groups[node.attrs?.when as string] = platform.getCompiledNodes(node.nodes ?? []);
-        return groups;
-      },
-      {}
-    ));
-  }
-
-  get EntityConstructor() {
-    return Selector;
-  }
-}

package/src/core/slot.ts

@@ -1,36 +0,0 @@
-import { CtxNode } from "../ctx/CtxNode";
-import { Ctx } from "../ctx/Ctx";
-import type { XmlNode } from "ultimus/types";
-import type { ICtx } from "arrmatura-api/types";
-import { Composite } from "./composition";
-
-class Slot extends Ctx {
-  get displayName(): string {
-    return "🔸";
-  }
-
-  get compositeScope(): Composite {
-    return this.scope as Composite;
-  }
-
-  get content() {
-    return this.compositeScope.slotContent((this.node as CSlotNode).key);
-  }
-
-  get recontentScope(): ICtx {
-    return this.compositeScope.scope;
-  }
-}
-
-export class CSlotNode extends CtxNode {
-  key?: string;
-
-  constructor(x: XmlNode) {
-    super();
-    this.key = x.attrs?.key as string;
-  }
-
-  get EntityConstructor() {
-    return Slot;
-  }
-}

package/src/ctx/Ctx.ts

@@ -1,424 +0,0 @@
-import { areEqual, capitalize, identity } from "ultimus";
-import { stringify } from "../utils/stringify";
-import type { Delta, Fn, Hash, Proc, Uid } from "ultimus/types";
-import type {
-  EProcedure,
-  ICtx,
-  ICtxNode,
-  IComponent,
-  IPlatform,
-} from "arrmatura-api/types";
-
-/**
- * The Component Context class.
- * It creates, refers and manages a component instance.
- *
- * A component instance gets reference to its context in 2nd constructor parameter.
- */
-export class Ctx<T extends ICtxNode = ICtxNode> implements ICtx {
-  readonly component: IComponent;
-  $children?: Map<Uid, ICtx>;
-  readonly root: ICtx;
-  readonly scope: ICtx;
-  isDone = false;
-
-  #isInited = false;
-  #state: Hash = {};
-  #initialState: Hash = {};
-  #listeners?: Set<(c: Ctx) => void>;
-  #defered?: EProcedure[] = [];
-  #weak?: Map<string, number>;
-  #refs?: Hash<ICtx>;
-  #propFnMap?: Map<string, Proc>;
-
-  constructor(
-    readonly platform: IPlatform,
-    protected readonly node: T,
-    private _parent?: ICtx,
-    scope?: ICtx
-  ) {
-    this.scope = scope ?? this;
-    this.root = scope?.root ?? this;
-    this.#initialState = this.node.resolveInitialProps(this);
-    this.component = this.createComponent(this.#initialState);
-
-    if (this.refId) {
-      this.scope.addEntityReference(this.refId, this);
-    }
-  }
-
-  get parent(): ICtx | undefined {
-    return this._parent;
-  }
-
-  get uid(): string {
-    return this.node.uid;
-  }
-
-  get displayName(): string {
-    return "🔹";
-  }
-
-  createComponent(initials: Hash): IComponent {
-    return { ...initials };
-  }
-
-  // --- State
-
-  // updates component state
-  up(Δ?: Delta | Promise<any> | null | void | unknown, force = false): void {
-    if (!Δ || this.isDone) {
-      return;
-    }
-
-    if (Δ instanceof Promise) {
-      this.upAsync(Δ, "*");
-      return;
-    }
-
-    const changes = new Map<string, unknown>();
-    Object.entries(Δ).forEach(([k, v]) => {
-      if (v instanceof Promise) {
-        this.upAsync(v, k);
-      } else if (
-        k &&
-        typeof v !== "undefined" &&
-        !areEqual(v, this.#state[k])
-      ) {
-        this.#state[k] = v;
-        changes.set(k, v);
-      }
-    });
-
-    if (changes.size || force) {
-      this.stateChanged(changes);
-    }
-  }
-
-  private upAsync(promise: Promise<any>, key: string): void {
-    const racer = this.raceCondition(`set:${key}`);
-    if (key[0] !== "*") {
-      const akey = key.replace("Promise", "");
-      void promise.then((val) => racer(() => this.up({ [akey]: val })));
-    } else {
-      void promise.then((r: Delta) => racer(() => this.up(r)));
-    }
-  }
-
-  private stateChanged(changes: Map<string, unknown>) {
-    if (this.component.stateChanged) {
-      this.component.stateChanged(changes);
-    } else {
-      changes.forEach((v, k) => {
-        const setter = this.component[`set${capitalize(k)}`];
-        if (typeof setter === "function") {
-          setter.call(this.component, v);
-        } else {
-          this.component[k] = v;
-        }
-      });
-    }
-    this.touch();
-  }
-
-  // do recontent and notify all
-  touch() {
-    this.recontent();
-    this.notify();
-  }
-
-  // gets component property by key
-  get(propId: string): unknown {
-    const map = this.#propFnMap ?? (this.#propFnMap = new Map());
-    if (map.has(propId)) {
-      return map.get(propId)();
-    }
-
-    let fn: Fn | null = null;
-    const impl = this.component;
-    const instant = impl[propId];
-    if (instant && typeof instant === "function") {
-      const bound = instant.bind(impl);
-      fn = () => bound;
-    } else {
-      const [pk, ...path] = propId.split(".");
-      if (pk[0] === "@") {
-        path.unshift(pk.slice(1));
-        const val = this.platform.getResource(path) ?? null;
-        fn = () => val;
-      } else {
-        const gettr = impl[`get${capitalize(pk)}`];
-        const fn0 =
-          typeof gettr === "function"
-            ? () => gettr.call(impl) ?? null
-            : () => impl[pk] ?? null;
-
-        fn = !path.length
-          ? fn0
-          : () => path.reduce((r, p) => r?.[p] ?? null, fn0());
-      }
-    }
-
-    map.set(propId, fn);
-
-    return fn();
-  }
-
-  getFromScope(propId: string): unknown {
-    return this.scope.get(propId);
-  }
-
-  // --- Left Arrow.
-
-  notify() {
-    this.#listeners?.forEach((fn) => fn(this));
-  }
-
-  // add listener to componet state changes
-  subscribe(handler: (src: Ctx) => any): Proc {
-    const listeners = this.#listeners ?? (this.#listeners = new Set());
-    listeners.add(handler);
-    return () => {
-      listeners.delete(handler);
-    };
-  }
-
-  // --- Right Arrow.
-
-  // emits action event to this component
-  emit(key: string, data: Delta): void {
-    if (!key || !key.includes(".")) {
-      this.up(key ? { [key]: data } : data);
-      return;
-    }
-
-    const [refId, target] = key.split(".");
-    try {
-      const ref = this.getByRef(refId);
-      if (!ref) {
-        throw new Error(`No such reference: ${refId}`);
-      }
-      if (!target) {
-        ref.up(data);
-        return;
-      }
-
-      const propId = `on${capitalize(target)}`;
-      const impl = ref.component;
-      const method = impl[propId];
-
-      if (!method) {
-        ref.up({ [target]: data });
-        return;
-      }
-
-      if (!method || !(typeof method === "function")) {
-        throw new Error(`No such method ${refId}.${propId}`);
-      }
-
-      const result = method.call(impl, data, impl, ref);
-
-      this.log(`-> ${refId}.${propId}`, result, data, impl);
-
-      ref.up(result);
-    } catch (ex) {
-      this.logError(`emit ${key}:`, ex);
-    }
-    return;
-  }
-
-  // Done life-cycle hook.
-  done() {
-    if (this.isDone) {
-      return;
-    }
-    this.isDone = true;
-
-    this.component.done?.(this);
-
-    this.children?.forEach((c) => c.done());
-
-    this.#defered?.forEach((f) => f(this));
-    this.#defered = undefined;
-
-    this._parent?.children?.delete(this.uid);
-    this._parent = undefined;
-  }
-
-  // map of children contexts
-  get children(): Map<Uid, ICtx> | undefined {
-    return this.$children;
-  }
-
-  // map of chidren of its node
-  get content() {
-    return this.node.getContent(this.platform);
-  }
-
-  // actual scope for re-content
-  get recontentScope() {
-    return this.scope;
-  }
-
-  settleAsChild() {
-    if (!this.#isInited) {
-      this.#isInited = true;
-
-      this.initConnectors();
-
-      this.up(this.#initialState, true);
-
-      this.up(this.component.init?.(this));
-    } else {
-      void this.up(this.node.resolveProps(this), true);
-    }
-  }
-
-  // perform children instantiation and updates
-  private recontent() {
-    const nodes = this.content;
-
-    this.platform.redraw(this, this.root);
-
-    this.children?.forEach((e, uid) => {
-      if (!nodes?.get(uid)) {
-        e.done();
-      }
-    });
-
-    const children = new Map<Uid, ICtx>();
-
-    nodes?.forEach((node: ICtxNode, uid: Uid) => {
-      const e =
-        this.children?.get(uid) ??
-        node.createContext(this.platform, this, this.recontentScope);
-      children.set(e.uid, e);
-    });
-
-    this.$children = children;
-
-    for (const ch of children.values()) {
-      ch.settleAsChild();
-    }
-  }
-
-  // --- Referencing.
-
-  get refId() {
-    return this.node.refId;
-  }
-
-  // gets any context instance in current or upper scope by key
-  getByRef(refId: string): ICtx | undefined {
-    if (!refId) return undefined;
-
-    if (refId === "this") {
-      return this;
-    }
-    const local = this.#refs?.[refId];
-    if (local) {
-      return local;
-    }
-    const ref = this === this.scope ? null : this.scope.getByRef(refId);
-    return ref as Ctx;
-  }
-
-  addEntityReference(refId: string, c: ICtx) {
-    (this.#refs ?? (this.#refs = {}))[refId] = c;
-  }
-
-  // --- Routines -------------------------
-
-  private initConnectors() {
-    if (this.node.connectors) {
-      for (const [key, pipes] of this.node.connectors.entries()) {
-        const [srcIds, targetPropName] = key.split("|");
-        const [refId, ...propIds] = srcIds.split(".");
-
-        const ref = this.scope.getByRef(refId) as Ctx;
-        if (!ref) {
-          this.logError(`Connect: No such ref: ${refId}`);
-          continue;
-        }
-
-        if (!propIds.length) {
-          this.logError(`Connect: No prop specified: ${key}`);
-          continue;
-        }
-
-        const propId = propIds.join(".");
-        const applicator = targetPropName
-          ? (rr: any) => ({ [targetPropName]: rr })
-          : identity;
-
-        this.defer(
-          ref.subscribe((source: Ctx) => {
-            try {
-              const r = applicator(pipes(this, source.get(propId)));
-              this.up(r as Delta);
-            } catch (ex) {
-              source.logError("Notify ", ex);
-            }
-          })
-        );
-
-        // hot subscription
-        Object.assign(
-          this.#initialState,
-          applicator(pipes(ref, ref.get(propId)))
-        );
-      }
-    }
-  }
-
-  raceCondition(key: string) {
-    const COUNTERS = this.#weak ?? (this.#weak = new Map<string, number>());
-    let counter = 1 + (COUNTERS.get(key) ?? 0);
-    COUNTERS.set(key, counter);
-    return (fn: () => unknown) => {
-      if (counter === COUNTERS.get(key)) {
-        counter = 0;
-        return fn();
-      }
-    };
-  }
-
-  // register callback to be called on done
-  defer(fn: EProcedure) {
-    if (fn && typeof fn === "function") {
-      (this.#defered ?? (this.#defered = [])).push(fn);
-    }
-  }
-
-  log(val: any, ...args: unknown[]) {
-    this.platform.log({
-      level: "log",
-      source: `${this.displayName}:${this.uid}`,
-      message: val,
-      params: args,
-    });
-    return val;
-  }
-
-  logError(error: any, ...args: unknown[]) {
-    this.platform.log({
-      level: "error",
-      source: `${this.displayName}:${this.uid}`,
-      error,
-      message: `${String(error.message || error)}\n${this.toString().slice(
-        0,
-        120
-      )}`,
-      params: args,
-    });
-  }
-
-  // access to resource by key
-  res(key: string | string[]) {
-    return this.platform.getResource(key);
-  }
-
-  toString(): string {
-    return stringify(this);
-  }
-}

package/src/ctx/CtxNode.ts

@@ -1,159 +0,0 @@
-import { nextId } from "ultimus";
-import {
-  compileExpression,
-  compilePipeExpression,
-} from "../utils/compileExpression";
-import type { Delta, Expression, Hash, Uid } from "ultimus/types";
-import type {
-  IPlatform,
-  ICtx,
-  ICtxNode,
-  PropertyGetter,
-  PropertyResolver,
-} from "arrmatura-api/types";
-
-/**
- * ContextNode is a factory for all ICtx instances.
- */
-export abstract class CtxNode implements ICtxNode {
-  protected $content?: Map<Uid, ICtxNode> | undefined;
-  uid: Uid = nextId("N");
-  refId?: string;
-  private readonly propertyResolvers: PropertyResolver[] = [];
-  private initialState: Hash<(c: ICtx) => any> = {};
-  connectors?: Map<string, (c: ICtx, x: unknown) => unknown>;
-  tag: any;
-
-  abstract get EntityConstructor(): new (
-    platform: IPlatform,
-    node: typeof this,
-    parent?: ICtx,
-    scope?: ICtx
-  ) => ICtx;
-
-  /**
-   * Create a context object.
-   *
-   * @param {IPlatform} platform - The platform object.
-   * @param {ICtx} parent - The parent context object (optional).
-   * @param {ICtx} scope - The scope context object (optional).
-   * @return {ICtx} The created context object.
-   */
-  createContext(platform: IPlatform, parent?: ICtx, scope?: ICtx): ICtx {
-    return new this.EntityConstructor(platform, this, parent, scope);
-  }
-
-  getContent(_platform: IPlatform): Map<Uid, ICtxNode> | undefined {
-    return this.$content;
-  }
-
-  addPropertyResolver(getter: PropertyGetter, propKey: string) {
-    this.propertyResolvers.push((c: ICtx, delta: Delta) => {
-      delta[propKey] = getter(c);
-      return delta;
-    });
-    return this;
-  }
-
-  private addDataPropertyResolver(getter: PropertyGetter, propKey: string) {
-    this.propertyResolvers.push((c: ICtx, delta: Delta) => {
-      const val = getter(c);
-      delta.data = Object.assign((delta.data as object) || {}, {
-        [propKey]: val,
-      });
-      return delta;
-    });
-    return this;
-  }
-
-  private addPropertiesResolver(getter: PropertyGetter) {
-    this.propertyResolvers.push((c: ICtx, delta: Delta) => {
-      const value = getter(c);
-      if (value && typeof value === "object") {
-        Object.entries(value).forEach(([key, val]) => {
-          delta[key] = val;
-        });
-      }
-      return delta;
-    });
-    return this;
-  }
-
-  addConnector(expr: Expression, propName: string) {
-    const { key, pipec } = compilePipeExpression(expr);
-    (this.connectors ?? (this.connectors = new Map())).set(
-      `${key}|${propName}`,
-      pipec
-    );
-  }
-
-  private addEmitter(expr: Expression, k: string) {
-    const { key, pipec } = compilePipeExpression(expr);
-    this.initialState[k] = (c) => (data: unknown) =>
-      c.scope?.emit(key, pipec(c, data) as Delta);
-  }
-
-  resolveInitialProps(c: ICtx) {
-    return this.propertyResolvers.reduce(
-      (delta, resolver) => resolver(c, delta),
-      Object.entries(this.initialState).reduce((acc, [key, fn]) => {
-        acc[key] = fn(c);
-        return acc;
-      }, {} as Hash)
-    );
-  }
-
-  resolveProps(c: ICtx) {
-    return this.propertyResolvers.reduce(
-      (delta, resolver) => resolver(c, delta),
-      {}
-    );
-  }
-
-  compileAttribute(k: string, v: unknown) {
-    if (k.startsWith("data-")) {
-      this.addDataPropertyResolver(compileExpression(v), k.slice(5));
-    } else if (k === "ref") {
-      this.refId = String(v);
-    } else if (k === "props") {
-      const sv = String(v);
-      if (sv[0] === "<" && sv[1] === "-") {
-        this.addConnector(sv.slice(2), "");
-      } else {
-        this.addPropertiesResolver(compileExpression(v));
-      }
-    } else {
-      if (typeof v !== "string") {
-        this.initialState[k] = () => v;
-      } else {
-        if (v[0] === "<" && v[1] === "-") {
-          this.addConnector(v.slice(2), k);
-        } else if (v[0] === "-" && v[1] === ">") {
-          this.addEmitter(v.slice(2), k);
-        } else {
-          if (!v.includes("{") && v[0] !== "@") {
-            this.initialState[k] = () => v;
-          } else {
-            if (
-              v[0] === "@" &&
-              v[1] === "@" &&
-              v.match(/^@@[a-z0-9\-_.]+$/i) != null
-            ) {
-              this.initialState[k] = (c) => c.platform.getResource(v.slice(2));
-            } else {
-              this.addPropertyResolver(compileExpression(v), k);
-            }
-          }
-        }
-      }
-    }
-  }
-
-  compileAttributes(attrs?: Hash) {
-    if (attrs) {
-      Object.entries(attrs).forEach((keyValue) =>
-        this.compileAttribute(...keyValue)
-      );
-    }
-  }
-}