@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/model/CjsModelState.js

@@ -1,72 +1,72 @@
-/**
- * Per-model runtime state. One instance per model at `__state`.
- *
- * Ownership and clearing rules (kb section 8):
- * - `dirty` is the only generically managed member: mutations mark it, and
- *   `UpdateValues` (the settle) is the only thing that clears it. The
- *   pipeline is cooperative - anything mutating outside `SetValues`
- *   (direct writes, Object.assign, reader adapters) owes a `MarkDirty()`
- *   or an explicit `UpdateValues()` ("I made changes, apply please").
- * - `flags` holds lazy invalidations ("bounds is stale"). Written at
- *   mutation time from `@io.flag` field metadata or by class code; cleared
- *   ONLY by the getter that recomputes the derived value. Never
- *   auto-cleared - deferring until needed is their whole point.
- * - `rebuild` holds scheduled work requirements ("vertices need
- *   rebuilding"). Written at mutation time from `@io.rebuild` field
- *   metadata or by class code; cleared ONLY by the specific work method
- *   that succeeds (e.g. RebuildVertices), typically driven from Update /
- *   per-frame passes. Never auto-cleared.
- * - Future transient runtime state (lifecycle links, revision counters)
- *   lands here rather than growing new underscore properties.
- */
-export class CjsModelState
-{
-
-    /** Something changed; the next settle applies it. @type {boolean} */
-    dirty = false;
-
-    /** Lazy invalidations - consumers clear when they recompute. @type {Set<string>} */
-    flags = new Set();
-
-    /** Scheduled work requirements - work methods clear on success. @type {Set<string>} */
-    rebuild = new Set();
-
-    /** Settle re-entrancy guard. @type {boolean} */
-    updating = false;
-
-    /** Construction/teardown event gate (counted). @type {number} */
-    suppressEvents = 0;
-
-    /**
-     * Checks whether a settle is owed.
-     *
-     * @returns {boolean}
-     */
-    IsDirty()
-    {
-        return this.dirty;
-    }
-
-    /**
-     * Marks the model as changed ("apply at the next settle").
-     *
-     * @returns {CjsModelState} This state.
-     */
-    MarkDirty()
-    {
-        this.dirty = true;
-        return this;
-    }
-
-    /**
-     * Clears the dirty mark. The settle calls this; class code rarely should.
-     *
-     * @returns {CjsModelState} This state.
-     */
-    ClearDirty()
-    {
-        this.dirty = false;
-        return this;
-    }
-
-}
+/**
+ * Per-model runtime state. One instance per model at `__state`.
+ *
+ * Ownership and clearing rules (kb section 8):
+ * - `dirty` is the only generically managed member: mutations mark it, and
+ *   `UpdateValues` (the settle) is the only thing that clears it. The
+ *   pipeline is cooperative - anything mutating outside `SetValues`
+ *   (direct writes, Object.assign, reader adapters) owes a `MarkDirty()`
+ *   or an explicit `UpdateValues()` ("I made changes, apply please").
+ * - `flags` holds lazy invalidations ("bounds is stale"). Written at
+ *   mutation time from `@io.flag` field metadata or by class code; cleared
+ *   ONLY by the getter that recomputes the derived value. Never
+ *   auto-cleared - deferring until needed is their whole point.
+ * - `rebuild` holds scheduled work requirements ("vertices need
+ *   rebuilding"). Written at mutation time from `@io.rebuild` field
+ *   metadata or by class code; cleared ONLY by the specific work method
+ *   that succeeds (e.g. RebuildVertices), typically driven from Update /
+ *   per-frame passes. Never auto-cleared.
+ * - Future transient runtime state (lifecycle links, revision counters)
+ *   lands here rather than growing new underscore properties.
+ */
+export class CjsModelState
+{
+
+    /** Something changed; the next settle applies it. @type {boolean} */
+    dirty = false;
+
+    /** Lazy invalidations - consumers clear when they recompute. @type {Set<string>} */
+    flags = new Set();
+
+    /** Scheduled work requirements - work methods clear on success. @type {Set<string>} */
+    rebuild = new Set();
+
+    /** Settle re-entrancy guard. @type {boolean} */
+    updating = false;
+
+    /** Construction/teardown event gate (counted). @type {number} */
+    suppressEvents = 0;
+
+    /**
+     * Checks whether a settle is owed.
+     *
+     * @returns {boolean}
+     */
+    IsDirty()
+    {
+        return this.dirty;
+    }
+
+    /**
+     * Marks the model as changed ("apply at the next settle").
+     *
+     * @returns {CjsModelState} This state.
+     */
+    MarkDirty()
+    {
+        this.dirty = true;
+        return this;
+    }
+
+    /**
+     * Clears the dirty mark. The settle calls this; class code rarely should.
+     *
+     * @returns {CjsModelState} This state.
+     */
+    ClearDirty()
+    {
+        this.dirty = false;
+        return this;
+    }
+
+}

package/src/model/index.js

@@ -1,4 +1,4 @@
-export * from "./CjsModel.js";
-export { CjsModelState } from "./CjsModelState.js";
-export { CjsEventEmitter } from "./CjsEventEmitter.js";
-export * from "./sourceRecordUtils.js";
+export * from "./CjsModel.js";
+export { CjsModelState } from "./CjsModelState.js";
+export { CjsEventEmitter } from "./CjsEventEmitter.js";
+export * from "./sourceRecordUtils.js";

package/src/model/sourceRecordUtils.js

@@ -1,54 +1,54 @@
-import { CjsModel } from "./CjsModel.js";
-
-export function asArray(value)
-{
-    if (!value) return [];
-    if (value instanceof Map) return Array.from(value.values());
-    return Array.isArray(value) ? value : [value];
-}
-
-export function firstDefined(...values)
-{
-    for (const value of values)
-    {
-        if (value !== undefined && value !== null) return value;
-    }
-    return null;
-}
-
-export function getField(object, ...names)
-{
-    if (!object) return null;
-    for (const name of names)
-    {
-        if (Object.prototype.hasOwnProperty.call(object, name)) return object[name];
-    }
-    return null;
-}
-
-export function objectFromMap(map)
-{
-    return Object.fromEntries(map.entries());
-}
-
-export function collectionValues(value)
-{
-    if (!value) return [];
-    if (value instanceof Map) return Array.from(value.values());
-    if (Array.isArray(value)) return value;
-    if (typeof value === "object") return Object.values(value);
-    return [value];
-}
-
-export function clonePlain(value)
-{
-    if (value instanceof CjsModel) return value.GetValues();
-    if (ArrayBuffer.isView(value)) return Array.from(value);
-    if (value instanceof Map) return new Map(Array.from(value.entries()).map(([key, item]) => [key, clonePlain(item)]));
-    if (Array.isArray(value)) return value.map(clonePlain);
-    if (value && typeof value === "object")
-    {
-        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, clonePlain(item)]));
-    }
-    return value;
-}
+import { CjsModel } from "./CjsModel.js";
+
+export function asArray(value)
+{
+    if (!value) return [];
+    if (value instanceof Map) return Array.from(value.values());
+    return Array.isArray(value) ? value : [value];
+}
+
+export function firstDefined(...values)
+{
+    for (const value of values)
+    {
+        if (value !== undefined && value !== null) return value;
+    }
+    return null;
+}
+
+export function getField(object, ...names)
+{
+    if (!object) return null;
+    for (const name of names)
+    {
+        if (Object.prototype.hasOwnProperty.call(object, name)) return object[name];
+    }
+    return null;
+}
+
+export function objectFromMap(map)
+{
+    return Object.fromEntries(map.entries());
+}
+
+export function collectionValues(value)
+{
+    if (!value) return [];
+    if (value instanceof Map) return Array.from(value.values());
+    if (Array.isArray(value)) return value;
+    if (typeof value === "object") return Object.values(value);
+    return [value];
+}
+
+export function clonePlain(value)
+{
+    if (value instanceof CjsModel) return value.GetValues();
+    if (ArrayBuffer.isView(value)) return Array.from(value);
+    if (value instanceof Map) return new Map(Array.from(value.entries()).map(([key, item]) => [key, clonePlain(item)]));
+    if (Array.isArray(value)) return value.map(clonePlain);
+    if (value && typeof value === "object")
+    {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, clonePlain(item)]));
+    }
+    return value;
+}