@adobe/ecs 0.0.0-stage → 0.1.0

package/dist/interface/registry/layout.js

@@ -0,0 +1,312 @@
+import { isString } from './schemas.js';
+/** The layout of every string. */
+const stringLayout = { kind: "string", stride: 4 };
+/** The layout of values stored as they are. */
+export const objectLayout = { kind: "object" };
+export const bytesOf = (view) => view === "f64" ? 8 : view === "u8" ? 1 : 4;
+export const viewsOf = (buffer, byteOffset, byteLength) => ({
+    f32: new Float32Array(buffer, byteOffset, byteLength >> 2),
+    f64: new Float64Array(buffer, byteOffset, Math.floor(byteLength / 8)),
+    i32: new Int32Array(buffer, byteOffset, byteLength >> 2),
+    u32: new Uint32Array(buffer, byteOffset, byteLength >> 2),
+    u8: new Uint8Array(buffer, byteOffset, byteLength),
+});
+const integerScalar = ({ minimum, maximum }) => {
+    if (minimum === undefined || maximum === undefined)
+        return "f64";
+    if (minimum >= 0 && maximum <= 0xFFFFFFFF)
+        return "u32";
+    if (minimum >= -0x80000000 && maximum <= 0x7FFFFFFF)
+        return "i32";
+    return "f64";
+};
+/** `null` if the schema isn't linear: numbers, booleans, fixed-length tuples and structs of those. */
+const shapeOf = (schema) => {
+    if (!("type" in schema))
+        return null;
+    switch (schema.type) {
+        case "number": return { kind: "scalar", scalar: schema.precision === 1 ? "f32" : "f64" };
+        case "integer": return { kind: "scalar", scalar: "format" in schema ? "f64" : integerScalar(schema) };
+        case "boolean": return { kind: "scalar", scalar: "boolean" };
+        case "array": {
+            const length = schema.minItems;
+            if (length === undefined || length !== schema.maxItems)
+                return null;
+            const item = shapeOf(schema.items);
+            return item === null ? null : { kind: "tuple", items: new Array(length).fill(item) };
+        }
+        case "object": {
+            const names = Object.keys(schema.properties);
+            const { required } = schema;
+            if (required !== undefined && names.some(name => !required.includes(name)))
+                return null;
+            const items = [];
+            for (const name of names) {
+                const item = shapeOf(schema.properties[name]);
+                if (item === null)
+                    return null;
+                items.push(item);
+            }
+            return { kind: "struct", names, items };
+        }
+        default: return null;
+    }
+};
+const roundUp = (value, alignment) => Math.ceil(value / alignment) * alignment;
+const describe = (path) => path.length === 0 ? "the value" : `[${path.map(key => JSON.stringify(key)).join("][")}]`;
+const gpuScalar = (scalar, path) => {
+    if (scalar === "f64")
+        throw new Error(`${describe(path)} is f64, which isn't GPU compatible: use a number with precision: 1, or an integer with minimum and maximum within i32 or u32.`);
+    return scalar === "boolean" ? "u32" : scalar;
+};
+const sameScalar = (items) => {
+    const first = items[0];
+    if (first?.kind !== "scalar")
+        return null;
+    return items.every(item => item.kind === "scalar" && item.scalar === first.scalar) ? first.scalar : null;
+};
+const place = (shape, path, rules) => {
+    if (shape.kind === "scalar") {
+        const view = rules === "cpu" ? (shape.scalar === "boolean" ? "u8" : shape.scalar) : gpuScalar(shape.scalar, path);
+        const size = bytesOf(view);
+        return { size, align: size, leaves: [{ path, scalar: shape.scalar, view, offset: 0 }] };
+    }
+    const keys = shape.kind === "struct" ? shape.names : shape.items.map((_, i) => i);
+    const items = shape.items.map((item, i) => place(item, [...path, keys[i]], rules));
+    if (rules === "storage" && shape.kind === "tuple") {
+        const scalar = sameScalar(shape.items);
+        const length = shape.items.length;
+        // WGSL vec2/vec3/vec4: 4-byte components, aligned to 8, 16, 16; a vec3 is 12 bytes, so a scalar can follow it.
+        if (scalar !== null && length >= 2 && length <= 4) {
+            return { size: 4 * length, align: length === 2 ? 8 : 16, leaves: items.map((item, i) => ({ ...item.leaves[0], offset: 4 * i })) };
+        }
+        if (!shape.items.every(item => JSON.stringify(item) === JSON.stringify(shape.items[0]))) {
+            throw new Error(`${describe(path)} mixes element types, which a WGSL array can't: use a struct.`);
+        }
+        // WGSL array<T, N>: elements at a stride of T's size rounded up to its alignment.
+        const element = items[0];
+        const stride = roundUp(element.size, element.align);
+        return {
+            size: stride * length,
+            align: element.align,
+            leaves: items.flatMap((item, i) => item.leaves.map(leaf => ({ ...leaf, offset: leaf.offset + i * stride }))),
+        };
+    }
+    const align = rules === "vertex" ? 4 : Math.max(...items.map(item => item.align));
+    return pack(items, align, rules === "vertex" ? 4 : 0);
+};
+/** Members in order, each at its alignment (or `memberAlign` when set), padded to the aggregate's alignment. */
+const pack = (items, align, memberAlign) => {
+    let offset = 0;
+    const leaves = [];
+    for (const item of items) {
+        offset = roundUp(offset, memberAlign === 0 ? item.align : Math.min(memberAlign, item.align));
+        for (const leaf of item.leaves)
+            leaves.push({ ...leaf, offset: offset + leaf.offset });
+        offset += item.size;
+    }
+    return { size: roundUp(offset, align), align, leaves };
+};
+const element = (value, key) => typeof value === "object" && value !== null ? Reflect.get(value, key) : undefined;
+/** A tuple of 2 to 4 same-typed scalars in consecutive elements of one view. */
+const lanesNode = (view, unitStride, unitOffset, length) => {
+    const write = (views, row, value) => {
+        const target = views[view];
+        const index = row * unitStride + unitOffset;
+        if (Array.isArray(value))
+            for (let i = 0; i < length; i++)
+                target[index + i] = Number(value[i]);
+        else
+            for (let i = 0; i < length; i++)
+                target[index + i] = Number(element(value, i));
+    };
+    if (length === 2)
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const index = row * unitStride + unitOffset;
+                return [target[index], target[index + 1]];
+            },
+            write,
+        };
+    if (length === 3)
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const index = row * unitStride + unitOffset;
+                return [target[index], target[index + 1], target[index + 2]];
+            },
+            write,
+        };
+    return {
+        read: (views, row) => {
+            const target = views[view];
+            const index = row * unitStride + unitOffset;
+            return [target[index], target[index + 1], target[index + 2], target[index + 3]];
+        },
+        write,
+    };
+};
+/** Builds read/write closures over placed leaves, consuming them in shape order. */
+const nodeOf = (shape, leaves, next) => {
+    if (shape.kind === "scalar") {
+        const { view, unitStride, unitOffset } = leaves[next.index++];
+        return shape.scalar === "boolean"
+            ? { read: (views, row) => views[view][row * unitStride + unitOffset] !== 0, write: (views, row, value) => { views[view][row * unitStride + unitOffset] = Number(value); } }
+            : { read: (views, row) => views[view][row * unitStride + unitOffset], write: (views, row, value) => { views[view][row * unitStride + unitOffset] = Number(value); } };
+    }
+    const first = next.index;
+    const items = shape.items.map(item => nodeOf(item, leaves, next));
+    const tupleLeaves = leaves.slice(first, next.index);
+    // A tuple of same-typed non-boolean scalars, like a vec3: one loop over its leaves.
+    if (shape.kind === "tuple" && shape.items.every(item => item.kind === "scalar" && item.scalar !== "boolean") && tupleLeaves.every(leaf => leaf.view === tupleLeaves[0].view)) {
+        const view = tupleLeaves[0].view;
+        const strides = tupleLeaves.map(leaf => leaf.unitStride);
+        const offsets = tupleLeaves.map(leaf => leaf.unitOffset);
+        const length = tupleLeaves.length;
+        const [{ unitStride, unitOffset }] = tupleLeaves;
+        // Lanes next to each other, as in a vec2, vec3 or vec4: array literals and straight-line stores.
+        if (length >= 2 && length <= 4 && tupleLeaves.every((leaf, i) => leaf.unitStride === unitStride && leaf.unitOffset === unitOffset + i))
+            return lanesNode(view, unitStride, unitOffset, length);
+        return {
+            read: (views, row) => {
+                const target = views[view];
+                const value = new Array(length);
+                for (let i = 0; i < length; i++)
+                    value[i] = target[row * strides[i] + offsets[i]];
+                return value;
+            },
+            write: (views, row, value) => {
+                const target = views[view];
+                if (Array.isArray(value))
+                    for (let i = 0; i < length; i++)
+                        target[row * strides[i] + offsets[i]] = Number(value[i]);
+                else
+                    for (let i = 0; i < length; i++)
+                        target[row * strides[i] + offsets[i]] = Number(element(value, i));
+            },
+        };
+    }
+    if (shape.kind === "tuple") {
+        return {
+            read: (views, row) => {
+                const value = new Array(items.length);
+                for (let i = 0; i < items.length; i++)
+                    value[i] = items[i].read(views, row);
+                return value;
+            },
+            write: (views, row, value) => {
+                if (Array.isArray(value))
+                    for (let i = 0; i < items.length; i++)
+                        items[i].write(views, row, value[i]);
+                else
+                    for (let i = 0; i < items.length; i++)
+                        items[i].write(views, row, element(value, i));
+            },
+        };
+    }
+    const { names } = shape;
+    return {
+        read: (views, row) => {
+            const value = {};
+            for (let i = 0; i < names.length; i++)
+                value[names[i]] = items[i].read(views, row);
+            return value;
+        },
+        write: (views, row, value) => {
+            for (let i = 0; i < names.length; i++)
+                items[i].write(views, row, element(value, names[i]));
+        },
+    };
+};
+/** Whether code can be generated here; a content security policy without `'unsafe-eval'` forbids it. */
+let generating = true;
+/** A struct member's name as an object literal's key: quoted, and computed for `__proto__`, which a plain key would make the prototype. */
+const propertyOf = (name) => name === "__proto__" ? `[${JSON.stringify(name)}]` : JSON.stringify(name);
+/**
+ * A struct's or nested tuple's read and write as straight-line code: one literal of its leaves' loads, and one store per
+ * leaf, rather than a call per leaf and properties added one at a time. Only numbers, view names and quoted member
+ * names are written into the code. A value that isn't an object is written through `fallback`. Null where code can't
+ * be generated.
+ */
+const generatedNode = (shape, leaves, fallback) => {
+    if (!generating)
+        return null;
+    const at = (leaf) => `views.${leaf.view}[row * ${leaf.unitStride} + ${leaf.unitOffset}]`;
+    let next = 0;
+    const literal = (node) => {
+        if (node.kind === "scalar") {
+            const leaf = leaves[next++];
+            return leaf.scalar === "boolean" ? `${at(leaf)} !== 0` : at(leaf);
+        }
+        if (node.kind === "tuple")
+            return `[${node.items.map(literal).join(", ")}]`;
+        return `{ ${node.items.map((item, i) => `${propertyOf(node.names[i])}: ${literal(item)}`).join(", ")} }`;
+    };
+    const read = literal(shape);
+    next = 0;
+    let temporaries = 0;
+    // A member of `value` is read directly when `value` is known to be an object, and through `element` otherwise.
+    const stores = (node, value, object) => {
+        if (node.kind === "scalar")
+            return [`${at(leaves[next++])} = Number(${value});`];
+        const keys = node.kind === "struct" ? node.names.map(name => JSON.stringify(name)) : node.items.map((_, i) => String(i));
+        return node.items.flatMap((item, i) => {
+            const member = object ? `${value}[${keys[i]}]` : `element(${value}, ${keys[i]})`;
+            if (item.kind === "scalar")
+                return stores(item, member, false);
+            const temporary = `t${temporaries++}`;
+            return [`const ${temporary} = ${member};`, ...stores(item, temporary, false)];
+        });
+    };
+    const body = [
+        `return { read: (views, row) => (${read}), write: (views, row, value) => {`,
+        `if (typeof value !== "object" || value === null) { fallback.write(views, row, value); return; }`,
+        ...stores(shape, "value", true),
+        "} };",
+    ].join("\n");
+    try {
+        // The factory returns the node its body above makes.
+        const node = new Function("element", "fallback", body)(element, fallback);
+        return node;
+    }
+    catch {
+        generating = false;
+        return null;
+    }
+};
+const gpuLayoutOf = (schema) => "type" in schema && (schema.type === "object" || schema.type === "array") ? schema.layout : undefined;
+/**
+ * How a schema's values are stored. Throws when a schema declares a GPU `layout` it can't meet,
+ * naming the leaf and the fix, so registration fails rather than the GPU upload.
+ */
+/** A value without a schema isn't data, so it's stored as it is. */
+export const layoutOf = (schema) => {
+    if (schema === undefined)
+        return objectLayout;
+    if ("const" in schema)
+        return { kind: "constant", value: schema.const };
+    if (isString(schema))
+        return stringLayout;
+    const rules = gpuLayoutOf(schema) ?? "cpu";
+    const shape = shapeOf(schema);
+    if (shape === null) {
+        if (rules !== "cpu")
+            throw new Error(`A ${rules} layout needs numbers, integers, booleans, fixed-length tuples and structs with every property required.`);
+        return objectLayout;
+    }
+    const placed = place(shape, [], rules);
+    // An array of elements: each is padded to its alignment.
+    const stride = roundUp(placed.size, placed.align);
+    const leaves = placed.leaves.map(leaf => ({
+        ...leaf,
+        unitStride: stride / bytesOf(leaf.view),
+        unitOffset: leaf.offset / bytesOf(leaf.view),
+    }));
+    const built = nodeOf(shape, leaves, { index: 0 });
+    // Scalars and tuples of scalars are already straight-line.
+    const node = shape.kind === "struct" || (shape.kind === "tuple" && shape.items.some(item => item.kind !== "scalar")) ? generatedNode(shape, leaves, built) ?? built : built;
+    return { kind: "linear", leaves, stride, read: node.read, write: node.write };
+};
+export const samePath = (a, b) => a.length === b.length && a.every((key, i) => key === b[i]);
+//# sourceMappingURL=layout.js.map

package/dist/interface/registry/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/interface/registry/layout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAoDxC,kCAAkC;AAClC,MAAM,YAAY,GAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAEvD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAU,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAuB,EAAE,UAAkB,EAAE,UAAkB,EAAS,EAAE,CAAC,CAAC;IAChG,GAAG,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC;IAC1D,GAAG,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACrE,GAAG,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC;IACxD,GAAG,EAAE,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC;IACzD,EAAE,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;CACrD,CAAC,CAAC;AAQH,MAAM,aAAa,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAA4D,EAAU,EAAE;IAC7G,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IAClE,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,sGAAsG;AACtG,MAAM,OAAO,GAAG,CAAC,MAAc,EAAgB,EAAE;IAC7C,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACzF,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACtG,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7D,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACpE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAQ,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChG,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YAC5B,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxF,MAAM,KAAK,GAAY,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9C,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACzB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAOvG,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAElI,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,IAAU,EAAQ,EAAE;IACnD,IAAI,MAAM,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,gIAAgI,CAAC,CAAC;IACzL,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAuB,EAAiB,EAAE;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7G,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,IAAU,EAAE,KAAY,EAAU,EAAE;IAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAS,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5F,CAAC;IACD,MAAM,IAAI,GAAiC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAChH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACnF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QAClC,+GAA+G;QAC/G,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACtI,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QACtG,CAAC;QACD,kFAAkF;QAClF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO;YACH,IAAI,EAAE,MAAM,GAAG,MAAM;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;SAC/G,CAAC;IACN,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,gHAAgH;AAChH,MAAM,IAAI,GAAG,CAAC,KAAwB,EAAE,KAAa,EAAE,WAAmB,EAAU,EAAE;IAClF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC,CAAC;AAOF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,GAAoB,EAAW,EAAE,CAC9D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAEtF,gFAAgF;AAChF,MAAM,SAAS,GAAG,CAAC,IAAU,EAAE,UAAkB,EAAE,UAAkB,EAAE,MAAc,EAAQ,EAAE;IAC3F,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,GAAW,EAAE,KAAc,EAAQ,EAAE;QAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;;YAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC;IACF,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO;YACrB,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC;gBAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,KAAK;SACR,CAAC;IACF,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO;YACrB,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC;gBAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;YACD,KAAK;SACR,CAAC;IACF,OAAO;QACH,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,KAAK;KACR,CAAC;AACN,CAAC,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,GAAG,CAAC,KAAY,EAAE,MAAuB,EAAE,IAAuB,EAAQ,EAAE;IACpF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;YAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YAC3K,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9K,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,oFAAoF;IACpF,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3K,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,WAAW,CAAC;QACjD,iGAAiG;QACjG,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,GAAG,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/L,OAAO;YACH,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,MAAM,CAAC,CAAC;gBACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;oBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClF,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;gBACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;wBAAE,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;;oBAC/G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;wBAAE,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5G,CAAC;SACJ,CAAC;IACN,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACH,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACjB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAU,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;oBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC5E,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;gBACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;wBAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;;oBACjG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;wBAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9F,CAAC;SACJ,CAAC;IACN,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,OAAO;QACH,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjB,MAAM,KAAK,GAAgC,EAAE,CAAC;YAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnF,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,wGAAwG;AACxG,IAAI,UAAU,GAAG,IAAI,CAAC;AAEtB,2IAA2I;AAC3I,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAEvH;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CAAC,KAAY,EAAE,MAAuB,EAAE,QAAc,EAAe,EAAE;IACzF,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,IAAU,EAAU,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,UAAU,GAAG,CAAC;IACvG,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,CAAC,IAAW,EAAU,EAAE;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5E,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7G,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,GAAG,CAAC,CAAC;IACT,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,+GAA+G;IAC/G,MAAM,MAAM,GAAG,CAAC,IAAW,EAAE,KAAa,EAAE,MAAe,EAAY,EAAE;QACrE,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACjF,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,SAAS,SAAS,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,MAAM,IAAI,GAAG;QACT,mCAAmC,IAAI,oCAAoC;QAC3E,iGAAiG;QACjG,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;QAC/B,MAAM;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,IAAI,CAAC;QACD,qDAAqD;QACrD,MAAM,IAAI,GAAS,IAAI,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,CAAC;QACH,UAAU,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAc,EAAoC,EAAE,CACrE,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAE1G;;;GAGG;AACH,oEAAoE;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAA0B,EAAU,EAAE;IAC3D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAC9C,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACxE,IAAI,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IAC1C,MAAM,KAAK,GAAU,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,IAAI,KAAK,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,0GAA0G,CAAC,CAAC;QAC3J,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACvC,yDAAyD;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAW,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,GAAG,IAAI;QACP,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QACvC,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;KAC/C,CAAC,CAAC,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAClD,2DAA2D;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5K,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAO,EAAE,CAAO,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/interface/registry/names.d.ts

@@ -0,0 +1,38 @@
+import type { AnyDeclaration } from './declarations.js';
+/** What a key names. */
+export type Kind = "component" | "resource" | "trait";
+/** Whether a key is a component, a resource or a trait. */
+export declare const kindOf: (key: unknown) => Kind | undefined;
+/** The declaration of a registered component or resource. */
+export declare const declarationOf: (key: unknown) => AnyDeclaration | undefined;
+/** Whether two values are one key: the same value, or symbols registered under one id. */
+export declare const sameKey: (a: unknown, b: unknown) => boolean;
+/** The symbol first registered as this key, which stands for it wherever keys are compared; any other value as it is. */
+export declare const firstKeyOf: <K>(key: K) => K | symbol;
+/** The symbol last registered as this key, by which a world gives values; any other value as it is. */
+export declare const newestKeyOf: <K>(key: K) => K | symbol;
+/**
+ * How errors and reports name a key: its description, `Symbol()` without one, while no other registered key has it;
+ * else its id when the plugin gave it one, and without one, for a registered key, its description numbered by
+ * registration order. Any other value is named as text.
+ */
+export declare const labelOf: (key: unknown) => string;
+/** Throws, naming the key, for a key registration can't take. */
+export declare const failRegistration: (kind: Kind, key: unknown, message: string) => never;
+/** The key, or a throw for one that isn't a plain `Symbol(...)`: a `Symbol.for` or well-known symbol is shared. */
+export declare const requireKey: (kind: Kind, key: unknown) => symbol;
+/**
+ * Whether two declarations are the same, as a module evaluated again declares them, such as on a hot reload. Keys
+ * compare as `sameKey` does, and systems and finalizers they list as `sameItem` does, since evaluating their modules
+ * again makes new values of them.
+ */
+export declare const sameDeclaration: (a: unknown, b: unknown) => boolean;
+/**
+ * Records a key as a component, resource or trait, with its declaration. A symbol whose id is already a registered
+ * key's, of its kind with the same declaration, as a module evaluated again makes it, is that key. Throws for a key
+ * that isn't a plain `Symbol(...)`, one already registered, or one whose id is another kind's or has another
+ * declaration.
+ */
+export declare const claimKey: (key: unknown, kind: Kind, declaration?: AnyDeclaration) => void;
+/** The symbol last registered under an id, by which a world gives values, or undefined where none was. */
+export declare const keyOfId: (id: string) => symbol | undefined;

package/dist/interface/registry/names.js

@@ -0,0 +1,136 @@
+import { idOfKey } from './ids.js';
+import { sameItem } from './items.js';
+/** Every component, resource and user trait, by symbol identity: symbols of one id share an entry. */
+const entries = new Map();
+/** Entries by the ids the plugin gave their keys. */
+const identified = new Map();
+/** Numbered labels given, so each key's is unique. */
+const labels = new Set();
+/** How many registered keys have each description. */
+const described = new Map();
+/** A symbol's description, `Symbol()` without one. */
+const descriptionOf = (key) => key.description === undefined || key.description === "" ? "Symbol()" : key.description;
+/** `Symbol.iterator` and the rest, which the platform shares, so they can't be keys. */
+const wellKnown = new Map(Reflect.ownKeys(Symbol).flatMap((name) => {
+    const value = Reflect.get(Symbol, name);
+    return typeof value === "symbol" ? [[value, `Symbol.${String(name)}`]] : [];
+}));
+/** Whether a key is a component, a resource or a trait. */
+export const kindOf = (key) => typeof key === "symbol" ? entries.get(key)?.kind : undefined;
+/** The declaration of a registered component or resource. */
+export const declarationOf = (key) => typeof key === "symbol" ? entries.get(key)?.declaration : undefined;
+/** Whether two values are one key: the same value, or symbols registered under one id. */
+export const sameKey = (a, b) => {
+    if (a === b)
+        return true;
+    if (typeof a !== "symbol" || typeof b !== "symbol")
+        return false;
+    const entry = entries.get(a);
+    return entry !== undefined && entry === entries.get(b);
+};
+/** The symbol first registered as this key, which stands for it wherever keys are compared; any other value as it is. */
+export const firstKeyOf = (key) => typeof key === "symbol" ? entries.get(key)?.first ?? key : key;
+/** The symbol last registered as this key, by which a world gives values; any other value as it is. */
+export const newestKeyOf = (key) => typeof key === "symbol" ? entries.get(key)?.newest ?? key : key;
+/**
+ * How errors and reports name a key: its description, `Symbol()` without one, while no other registered key has it;
+ * else its id when the plugin gave it one, and without one, for a registered key, its description numbered by
+ * registration order. Any other value is named as text.
+ */
+export const labelOf = (key) => {
+    if (typeof key !== "symbol")
+        return String(key);
+    const known = wellKnown.get(key);
+    if (known !== undefined)
+        return known;
+    const entry = entries.get(key);
+    const description = entry?.description ?? descriptionOf(key);
+    if ((described.get(description) ?? 0) <= (entry === undefined ? 0 : 1))
+        return description;
+    return entry === undefined ? idOfKey(key) ?? description : entry.id ?? entry.numbered;
+};
+/** A label for a key registered now without an id, its description numbered when another key's has it. */
+const numberedFor = (description) => {
+    let label = description;
+    for (let n = 2; labels.has(label); n++)
+        label = `${description}#${n}`;
+    labels.add(label);
+    return label;
+};
+/** Throws, naming the key, for a key registration can't take. */
+export const failRegistration = (kind, key, message) => {
+    throw new Error(`Cannot register ${kind} "${labelOf(key)}": ${message}`);
+};
+/** The key, or a throw for one that isn't a plain `Symbol(...)`: a `Symbol.for` or well-known symbol is shared. */
+export const requireKey = (kind, key) => {
+    if (typeof key !== "symbol")
+        return failRegistration(kind, key, `a key is a plain Symbol(...), not a ${typeof key}.`);
+    if (Symbol.keyFor(key) !== undefined)
+        return failRegistration(kind, key, "a Symbol.for key is shared across the program, so another could claim it; use Symbol(...).");
+    const known = wellKnown.get(key);
+    if (known !== undefined)
+        return failRegistration(kind, key, `${known} is a well-known symbol.`);
+    return key;
+};
+/**
+ * Whether two declarations are the same, as a module evaluated again declares them, such as on a hot reload. Keys
+ * compare as `sameKey` does, and systems and finalizers they list as `sameItem` does, since evaluating their modules
+ * again makes new values of them.
+ */
+export const sameDeclaration = (a, b) => {
+    if (a === b)
+        return true;
+    if (typeof a === "symbol" || typeof b === "symbol")
+        return sameKey(a, b);
+    if (typeof a !== "object" || typeof b !== "object" || a === null || b === null || Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if ("declaration" in a && "declaration" in b)
+        return sameItem(a, b);
+    // A set or map, such as a default, compares by its entries in order, as a module evaluated again makes them.
+    if (a instanceof Set)
+        return b instanceof Set && sameDeclaration(Array.from(a), Array.from(b));
+    if (a instanceof Map)
+        return b instanceof Map && sameDeclaration(Array.from(a), Array.from(b));
+    if (b instanceof Set || b instanceof Map)
+        return false;
+    const keys = Reflect.ownKeys(a);
+    const others = Reflect.ownKeys(b);
+    return keys.length === others.length && keys.every(key => {
+        const other = typeof key === "symbol" ? others.find(candidate => sameKey(key, candidate)) : key;
+        return other !== undefined && Reflect.has(b, other) && sameDeclaration(Reflect.get(a, key), Reflect.get(b, other));
+    });
+};
+/**
+ * Records a key as a component, resource or trait, with its declaration. A symbol whose id is already a registered
+ * key's, of its kind with the same declaration, as a module evaluated again makes it, is that key. Throws for a key
+ * that isn't a plain `Symbol(...)`, one already registered, or one whose id is another kind's or has another
+ * declaration.
+ */
+export const claimKey = (key, kind, declaration) => {
+    const symbol = requireKey(kind, key);
+    const existing = entries.get(symbol);
+    if (existing !== undefined) {
+        failRegistration(kind, symbol, existing.kind === kind ? `already registered as a ${kind}, with another declaration.` : `already registered as a ${existing.kind}.`);
+    }
+    const id = idOfKey(symbol);
+    const named = id === undefined ? undefined : identified.get(id);
+    if (named !== undefined) {
+        if (named.kind !== kind)
+            failRegistration(kind, symbol, `its id is a ${named.kind}'s.`);
+        if (!sameDeclaration(named.declaration, declaration)) {
+            failRegistration(kind, symbol, "its id is another key's, with another declaration; if a module was evaluated again with a changed declaration, reload the page.");
+        }
+        named.newest = symbol;
+        entries.set(symbol, named);
+        return;
+    }
+    const description = descriptionOf(symbol);
+    const entry = { kind, declaration, description, id, numbered: numberedFor(description), first: symbol, newest: symbol };
+    described.set(description, (described.get(description) ?? 0) + 1);
+    if (id !== undefined)
+        identified.set(id, entry);
+    entries.set(symbol, entry);
+};
+/** The symbol last registered under an id, by which a world gives values, or undefined where none was. */
+export const keyOfId = (id) => identified.get(id)?.newest;
+//# sourceMappingURL=names.js.map

package/dist/interface/registry/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/interface/registry/names.ts"],"names":[],"mappings":"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"}

package/dist/interface/registry/program.d.ts

@@ -0,0 +1,36 @@
+import type { Finalizer } from '../finalizer/created.js';
+import type { Rule } from '../rule/created.js';
+import type { Definition } from '../system/definition.js';
+/** What a system, rule or finalizer constructor recorded. */
+export type Item = Definition | Rule | Finalizer;
+/**
+ * Records a system under the id the plugin gave its declaration. Declared again under that id the same, as a module
+ * evaluated again declares it, it's a new value of the same system. Throws for that id with another kind or declaration.
+ */
+export declare const claimSystem: (system: Definition, id: string | undefined) => void;
+/**
+ * Records a rule under the id the plugin gave its declaration, which applies in every world, and returns it; declared
+ * again under that id the same, it's the rule already recorded. Throws for a cycle through a negation, and for that id
+ * with another kind or declaration.
+ */
+export declare const addRule: (rule: Rule, id: string | undefined) => Rule;
+/**
+ * Records a finalizer under the id the plugin gave its declaration, which applies in every world, and returns it;
+ * declared again under that id the same, it's the finalizer already recorded, which keeps its place with the new body.
+ * Throws for an order that cycles or leaves a resource conflict, and for that id with another kind or declaration.
+ */
+export declare const addFinalizer: (finalizer: Finalizer, id: string | undefined) => Finalizer;
+/** A system's definition: the value a System constructor returned, or undefined for any other value. */
+export declare const definitionOf: (system: {
+    readonly name: string;
+}) => Definition | undefined;
+/** A system's definition. Throws for a value no constructor returned. */
+export declare const requireDefinition: (system: {
+    readonly name: string;
+}) => Definition;
+/** Counts rules and finalizers recorded, so a world can tell when one was added since it last looked. */
+export declare const programVersion: () => number;
+/** The program's rules, in creation order. */
+export declare const programRules: () => readonly Rule[];
+/** The program's finalizers, in the order every world runs them. */
+export declare const programFinalizers: () => readonly Finalizer[];