@thi.ng/wasm-api 0.18.1 → 1.0.0

package/codegen.js

@@ -1,198 +0,0 @@
-import { SIZEOF } from "@thi.ng/api/typedarray";
-import { compareByKey } from "@thi.ng/compare/keys";
-import { compareNumDesc } from "@thi.ng/compare/numeric";
-import { DEFAULT, defmulti } from "@thi.ng/defmulti/defmulti";
-import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
-import { PKG_NAME, WASM32, } from "./api.js";
-import { selectAlignment } from "./codegen/align.js";
-import { isBigNumeric, isNumeric, isPointer, isPointerLike, isSlice, isStringSlice, isWasmString, } from "./codegen/utils.js";
-export const DEFAULT_CODEGEN_OPTS = {
-    debug: false,
-    header: true,
-    lineWidth: 80,
-    stringType: "slice",
-    target: WASM32,
-    uppercaseEnums: true,
-};
-const sizeOf = defmulti((x) => x.type, {}, {
-    [DEFAULT]: (field, types, align, opts) => {
-        if (field.__size)
-            return field.__size;
-        if (field.pad != null) {
-            field.pad < 1 && illegalArgs(`pad size must be > 0`);
-            return (field.__size = field.pad);
-        }
-        let size = 0;
-        if (isPointer(field)) {
-            size = opts.target.usizeBytes;
-        }
-        else if (isSlice(field)) {
-            size = opts.target.usizeBytes * 2;
-        }
-        else {
-            size =
-                isNumeric(field.type) || isBigNumeric(field.type)
-                    ? SIZEOF[field.type]
-                    : isWasmString(field.type)
-                        ? opts.target.usizeBytes *
-                            (isStringSlice(opts.stringType) ? 2 : 1)
-                        : sizeOf(types[field.type], types, align, opts);
-            if (field.tag == "array" || field.tag === "vec") {
-                size *= field.len;
-                if (field.sentinel !== undefined && field.tag === "array") {
-                    size += SIZEOF[field.type];
-                }
-            }
-        }
-        return (field.__size = align.size(size, field.__align));
-    },
-    enum: (type) => {
-        if (type.__size)
-            return type.__size;
-        return (type.__size = SIZEOF[type.tag]);
-    },
-    struct: (type, types, align, opts) => {
-        if (type.__size)
-            return type.__size;
-        let offset = 0;
-        for (let f of type.fields) {
-            offset = align.offset(offset, f.__align);
-            f.__offset = offset;
-            offset += sizeOf(f, types, align, opts);
-        }
-        return (type.__size = align.size(offset, type.__align));
-    },
-    union: (type, types, align, opts) => {
-        if (type.__size)
-            return type.__size;
-        let maxSize = 0;
-        for (let f of type.fields) {
-            f.__offset = 0;
-            maxSize = Math.max(maxSize, sizeOf(f, types, align, opts));
-        }
-        return (type.__size = align.size(maxSize, type.__align));
-    },
-});
-const alignOf = defmulti((x) => x.type, {}, {
-    [DEFAULT]: (field, types, align, opts) => {
-        if (field.__align)
-            return field.__align;
-        if (field.type === "usize") {
-            field.type = opts.target.usize;
-        }
-        if (field.pad)
-            return (field.__align = 1);
-        return (field.__align = isPointerLike(field)
-            ? align.align({ type: opts.target.usize })
-            : isNumeric(field.type) || isBigNumeric(field.type)
-                ? align.align(field)
-                : alignOf(types[field.type], types, selectAlignment(types[field.type]), opts));
-    },
-    enum: (type, _, align) => {
-        const e = type;
-        if (!e.tag)
-            e.tag = "i32";
-        return (e.__align = align.align({
-            type: e.tag,
-        }));
-    },
-    struct: (type, types, align, opts) => {
-        let maxAlign = 1;
-        for (let f of type.fields) {
-            maxAlign = Math.max(maxAlign, alignOf(f, types, align, opts));
-        }
-        return (type.__align = maxAlign);
-    },
-    union: (type, types, align, opts) => {
-        let maxAlign = 1;
-        for (let f of type.fields) {
-            maxAlign = Math.max(maxAlign, alignOf(f, types, align, opts));
-        }
-        return (type.__align = maxAlign);
-    },
-});
-const prepareType = defmulti((x) => x.type, {}, {
-    [DEFAULT]: (x, types, alignImpl, opts) => {
-        if (x.__align)
-            return;
-        alignOf(x, types, alignImpl, opts);
-        sizeOf(x, types, alignImpl, opts);
-    },
-    struct: (x, types, align, opts) => {
-        if (x.__align)
-            return;
-        const struct = x;
-        alignOf(struct, types, align, opts);
-        if (struct.auto) {
-            struct.fields.sort(compareByKey("__align", compareNumDesc));
-        }
-        for (let f of struct.fields) {
-            const type = types[f.type];
-            if (type) {
-                prepareType(type, types, selectAlignment(type), opts);
-            }
-        }
-        sizeOf(struct, types, align, opts);
-    },
-});
-/**
- * Takes a type collection and analyzes each analyzed to compute individual
- * alignments and sizes.
- *
- * @remarks
- * This function is idempotent and called automatically by
- * {@link generateTypes}. Only exported for dev/debug purposes.
- *
- * @param types
- *
- * @internal
- */
-export const prepareTypes = (types, opts) => {
-    for (let id in types) {
-        prepareType(types[id], types, selectAlignment(types[id]), opts);
-    }
-    return types;
-};
-/**
- * Code generator main entry point. Takes an object of {@link TopLevelType}
- * definitions, an actual code generator implementation for a single target
- * language and (optional) global codegen options. Returns generated source code
- * for all given types as a single string.
- *
- * @remarks
- * Before actual code generation the types are first analyzed to compute their
- * alignments and sizes. This is only ever done once (idempotent), even if
- * `generateTypes()` is called multiple times for different target langs.
- *
- * @param types
- * @param codegen
- * @param opts
- */
-export const generateTypes = (types, codegen, opts = {}) => {
-    const $opts = {
-        ...DEFAULT_CODEGEN_OPTS,
-        ...opts,
-    };
-    prepareTypes(types, $opts);
-    const res = [];
-    if ($opts.header) {
-        codegen.doc(`Generated by ${PKG_NAME} at ${new Date().toISOString()} - DO NOT EDIT!`, res, $opts, true);
-        res.push("");
-    }
-    if (codegen.pre) {
-        const pre = codegen.pre($opts);
-        pre && res.push(pre, "");
-    }
-    $opts.pre && res.push($opts.pre, "");
-    for (let id in types) {
-        const type = types[id];
-        type.doc && codegen.doc(type.doc, res, $opts);
-        codegen[type.type](type, types, res, $opts);
-    }
-    $opts.post && res.push("", $opts.post);
-    if (codegen.post) {
-        const post = codegen.post($opts);
-        post && res.push("", post);
-    }
-    return res.join("\n");
-};