js-draw 0.18.0 → 0.18.1

package/dist/mjs/build_tools/buildTranslationTemplate.mjs

@@ -1,94 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import  { defaultEditorLocalization }  from '../src/localization.mjs';
-// Adds markdown formatting to format text like code.
-const codeFormat = (text) => {
-    let maxConsecutiveBackticks = 0;
-    // Find the longest number of consecutive backticks — we need to have more
-    // than that for the delimiters.
-    const backtickRuns = text.matchAll(/[`]+/g);
-    for (const backticks of backtickRuns) {
-        if (backticks.length > maxConsecutiveBackticks) {
-            maxConsecutiveBackticks = backticks.length;
-        }
-    }
-    let codeStartEnd = '';
-    for (let i = 0; i < maxConsecutiveBackticks + 1; i++) {
-        codeStartEnd += '`';
-    }
-    // If the text already starts with a `, add a space to prevent the
-    // markdown parser from treating it as part of the delimiter.
-    if (text.startsWith('`')) {
-        text = ' ' + text;
-    }
-    if (text.endsWith('`')) {
-        text = text + ' ';
-    }
-    return `${codeStartEnd}${text}${codeStartEnd}`;
-};
-const collapseSpaces = (text) => text.replace(/\s+/g, ' ');
-const generateTranslationTemplate = () => {
-    const bodyContentLines = [];
-    const addInput = (type, id, attrs, required = false) => {
-        const lines = [];
-        lines.push(`  - type: ${type}`);
-        lines.push(`    id: ${id}`);
-        lines.push('    attributes:');
-        for (const key in attrs) {
-            const value = `${attrs[key]}`;
-            const escapedValue = value.replace(/[\\]/g, '\\\\').replace(/"/g, '\\"');
-            lines.push(`      ${key}: "${escapedValue}"`);
-        }
-        lines.push('    validations:');
-        lines.push(`      required: ${required}`);
-        bodyContentLines.push(...lines);
-    };
-    const addLabel = (text) => {
-        bodyContentLines.push('  - type: markdown');
-        bodyContentLines.push('    attributes:');
-        bodyContentLines.push('      value: |');
-        bodyContentLines.push('        ' + text);
-    };
-    addLabel(collapseSpaces(`
-		Thank you for taking the time to translate \`js-draw\`! If you don't have time to translate
-		all of the strings below, feel free to submit an incomplete translation and edit it later.
-		Use this template to update an existing translation or to create a new translation.
-	`));
-    addLabel(collapseSpaces(`
-		(Optional) If you would like to submit a pull request that applies this translation, 
-		note that existing translations are present in
-		[src/localizations/](https://github.com/personalizedrefrigerator/js-draw/tree/main/src/localizations).
-	`));
-    addInput('input', 'language-name', {
-        label: 'Language',
-        description: 'The name of the language to translate to in English (e.g. Spanish)',
-    }, true);
-    for (const key in defaultEditorLocalization) {
-        const englishTranslation = `${defaultEditorLocalization[key]}`;
-        addInput('input', `translation-${key}`, {
-            label: `${key}`,
-            description: `Translate ${codeFormat(englishTranslation)}.`,
-            placeholder: englishTranslation,
-        });
-    }
-    addInput('textarea', 'additional-comments', {
-        label: 'Additional information',
-        placeholder: 'Any additional information/comments on the translation can go here.',
-    });
-    return `name: Translation
-# This template is auto-generated by build_tools/buildTranslationTemplate.ts
-# Do not modify it directly.
-description: Translate the editor to a new language!
-title: "[Translation]: <language>"
-labels: [localization]
-assignees: []
-body:
-${bodyContentLines.join('\n')}`;
-};
-const template = generateTranslationTemplate();
-// According to https://stackoverflow.com/a/13650454, fs should
-// be able to handle forward and back slashes (both) on Windows (so extra
-// path logic shouldn't be needed here.)
-const rootDir = path.dirname(__dirname);
-const translationTempaltePath = path.join(rootDir, '.github/ISSUE_TEMPLATE/translation.yml');
-fs.writeFileSync(translationTempaltePath, template);

package/dist/mjs/build_tools/bundle.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/mjs/build_tools/bundle.mjs

@@ -1,5 +0,0 @@
-import { dirname } from 'path';
-import  BundledFile  from './BundledFile.mjs';
-const rootDir = dirname(__dirname);
-const mainBundle = new BundledFile('jsdraw', `${rootDir}/src/bundle/bundled.ts`, `${rootDir}/dist/bundle.js`);
-void mainBundle.build();

package/dist/mjs/build_tools/postDist.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/mjs/build_tools/postDist.mjs

@@ -1,67 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { readdir, stat, rename, readFile, writeFile, unlink } from 'fs/promises';
-import path from 'path';
-// Script to be run after building JavaScript files from TypeScript.
-// TODO: This is very hacky.
-// TODO: [Use the TypeScript Compiler API instead.](https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API)
-// Iterates over every JavaScript file in [directory].
-const forEachFile = (directory, processFile) => __awaiter(void 0, void 0, void 0, function* () {
-    const files = yield readdir(directory);
-    yield Promise.all(files.map((file) => __awaiter(void 0, void 0, void 0, function* () {
-        const filePath = path.join(directory, file);
-        const stats = yield stat(filePath);
-        if (stats.isDirectory()) {
-            yield forEachFile(filePath, processFile);
-        }
-        else if (stats.isFile()) {
-            yield processFile(filePath);
-        }
-        else {
-            throw new Error('Unknown file type!');
-        }
-    })));
-});
-const removeFiles = (directory, filePattern) => __awaiter(void 0, void 0, void 0, function* () {
-    yield forEachFile(directory, (filePath) => __awaiter(void 0, void 0, void 0, function* () {
-        if (!filePath.match(filePattern)) {
-            return;
-        }
-        yield unlink(filePath);
-    }));
-});
-const main = () => __awaiter(void 0, void 0, void 0, function* () {
-    const rootDir = path.dirname(__dirname);
-    const cjsPath = `${rootDir}/dist/cjs`;
-    const mjsPath = `${rootDir}/dist/mjs`;
-    const testPattern = /\.test\.js$/;
-    yield removeFiles(cjsPath, testPattern);
-    yield removeFiles(mjsPath, testPattern);
-    // We need to replace imports in ESM files.
-    yield forEachFile(mjsPath, (filePath) => __awaiter(void 0, void 0, void 0, function* () {
-        if (!filePath.endsWith('.js')) {
-            return;
-        }
-        // Rename
-        const newPath = filePath.replace(/\.js$/, '.mjs');
-        yield rename(filePath, newPath);
-        // Change imports from
-        //   import foo from './bar'
-        // to
-        //   import foo from './bar.mjs'
-        // and exports similarly.
-        let contents = yield readFile(newPath, { encoding: 'utf-8' });
-        // TODO: Switch to using the TypeScript compiler API. This has the danger of changing imports
-        // in multi-line strings.
-        contents = contents.replace(/([\n]|^)(import|export)(.*)from\s+(['"])(\.*\/[^\n]+)(['"])/g, '$1$2 $3 from $4$5.mjs$6');
-        yield writeFile(newPath, contents);
-    }));
-});
-main();

package/dist/mjs/src/Color4.d.ts

@@ -1,61 +0,0 @@
-export default class Color4 {
-    /** Red component. Should be in the range [0, 1]. */
-    readonly r: number;
-    /** Green component. `g` ∈ [0, 1] */
-    readonly g: number;
-    /** Blue component. `b` ∈ [0, 1] */
-    readonly b: number;
-    /** Alpha/transparent component. `a` ∈ [0, 1]. 0 = transparent */
-    readonly a: number;
-    private constructor();
-    /**
-     * Create a color from red, green, blue components. The color is fully opaque (`a = 1.0`).
-     *
-     * Each component should be in the range [0, 1].
-     */
-    static ofRGB(red: number, green: number, blue: number): Color4;
-    static ofRGBA(red: number, green: number, blue: number, alpha: number): Color4;
-    static fromHex(hexString: string): Color4;
-    /** Like fromHex, but can handle additional colors if an `HTMLCanvasElement` is available. */
-    static fromString(text: string): Color4;
-    /** @returns true if `this` and `other` are approximately equal. */
-    eq(other: Color4 | null | undefined): boolean;
-    /**
-     * If `fractionTo` is not in the range [0, 1], it will be clamped to the nearest number
-     * in that range. For example, `a.mix(b, -1)` is equivalent to `a.mix(b, 0)`.
-     *
-     * @returns a color `fractionTo` of the way from this color to `other`.
-     *
-     * @example
-     * ```ts
-     * Color4.ofRGB(1, 0, 0).mix(Color4.ofRGB(0, 1, 0), 0.1) // -> Color4(0.9, 0.1, 0)
-     * ```
-     */
-    mix(other: Color4, fractionTo: number): Color4;
-    /**
-     * @returns the component-wise average of `colors`, or `Color4.transparent` if `colors` is empty.
-     */
-    static average(colors: Color4[]): Color4;
-    private hexString;
-    /**
-     * @returns a hexadecimal color string representation of `this`, in the form `#rrggbbaa`.
-     *
-     * @example
-     * ```
-     * Color4.red.toHexString(); // -> #ff0000ff
-     * ```
-     */
-    toHexString(): string;
-    toString(): string;
-    static transparent: Color4;
-    static red: Color4;
-    static green: Color4;
-    static blue: Color4;
-    static purple: Color4;
-    static yellow: Color4;
-    static clay: Color4;
-    static black: Color4;
-    static gray: Color4;
-    static white: Color4;
-}
-export { Color4 };

package/dist/mjs/src/Color4.mjs

@@ -1,193 +0,0 @@
-export default class Color4 {
-    constructor(
-    /** Red component. Should be in the range [0, 1]. */
-    r, 
-    /** Green component. `g` ∈ [0, 1] */
-    g, 
-    /** Blue component. `b` ∈ [0, 1] */
-    b, 
-    /** Alpha/transparent component. `a` ∈ [0, 1]. 0 = transparent */
-    a) {
-        this.r = r;
-        this.g = g;
-        this.b = b;
-        this.a = a;
-        this.hexString = null;
-    }
-    /**
-     * Create a color from red, green, blue components. The color is fully opaque (`a = 1.0`).
-     *
-     * Each component should be in the range [0, 1].
-     */
-    static ofRGB(red, green, blue) {
-        return Color4.ofRGBA(red, green, blue, 1.0);
-    }
-    static ofRGBA(red, green, blue, alpha) {
-        red = Math.max(0, Math.min(red, 1));
-        green = Math.max(0, Math.min(green, 1));
-        blue = Math.max(0, Math.min(blue, 1));
-        alpha = Math.max(0, Math.min(alpha, 1));
-        return new Color4(red, green, blue, alpha);
-    }
-    static fromHex(hexString) {
-        var _a;
-        // Remove starting '#' (if present)
-        hexString = ((_a = hexString.match(/^[#]?(.*)$/)) !== null && _a !== void 0 ? _a : [])[1];
-        hexString = hexString.toUpperCase();
-        if (!hexString.match(/^[0-9A-F]+$/)) {
-            throw new Error(`${hexString} is not in a valid format.`);
-        }
-        // RGBA or RGB
-        if (hexString.length === 3 || hexString.length === 4) {
-            // Each character is a component
-            const components = hexString.split('');
-            // Convert to RRGGBBAA or RRGGBB format
-            hexString = components.map(component => `${component}0`).join('');
-        }
-        if (hexString.length === 6) {
-            // Alpha component
-            hexString += 'FF';
-        }
-        const components = [];
-        for (let i = 2; i <= hexString.length; i += 2) {
-            const chunk = hexString.substring(i - 2, i);
-            components.push(parseInt(chunk, 16) / 255);
-        }
-        if (components.length !== 4) {
-            throw new Error(`Unable to parse ${hexString}: Wrong number of components.`);
-        }
-        return Color4.ofRGBA(components[0], components[1], components[2], components[3]);
-    }
-    /** Like fromHex, but can handle additional colors if an `HTMLCanvasElement` is available. */
-    static fromString(text) {
-        if (text.startsWith('#')) {
-            return Color4.fromHex(text);
-        }
-        if (text === 'none' || text === 'transparent') {
-            return Color4.transparent;
-        }
-        // rgba?: Match both rgb and rgba strings.
-        // ([,0-9.]+): Match any string of only numeric, '.' and ',' characters.
-        const rgbRegex = /^rgba?\(([,0-9.]+)\)$/i;
-        const rgbMatch = text.replace(/\s*/g, '').match(rgbRegex);
-        if (rgbMatch) {
-            const componentsListStr = rgbMatch[1];
-            const componentsList = JSON.parse(`[ ${componentsListStr} ]`);
-            if (componentsList.length === 3) {
-                return Color4.ofRGB(componentsList[0] / 255, componentsList[1] / 255, componentsList[2] / 255);
-            }
-            else if (componentsList.length === 4) {
-                return Color4.ofRGBA(componentsList[0] / 255, componentsList[1] / 255, componentsList[2] / 255, componentsList[3]);
-            }
-            else {
-                throw new Error(`RGB string, ${text}, has wrong number of components: ${componentsList.length}`);
-            }
-        }
-        // Otherwise, try to use an HTMLCanvasElement to determine the color.
-        // Note: We may be unable to create an HTMLCanvasElement if running as a unit test.
-        const canvas = document.createElement('canvas');
-        canvas.width = 1;
-        canvas.height = 1;
-        const ctx = canvas.getContext('2d');
-        ctx.fillStyle = text;
-        ctx.fillRect(0, 0, 1, 1);
-        const data = ctx.getImageData(0, 0, 1, 1);
-        const red = data.data[0] / 255;
-        const green = data.data[1] / 255;
-        const blue = data.data[2] / 255;
-        const alpha = data.data[3] / 255;
-        return Color4.ofRGBA(red, green, blue, alpha);
-    }
-    /** @returns true if `this` and `other` are approximately equal. */
-    eq(other) {
-        if (other == null) {
-            return false;
-        }
-        // If both completely transparent,
-        if (this.a === 0 && other.a === 0) {
-            return true;
-        }
-        return this.toHexString() === other.toHexString();
-    }
-    /**
-     * If `fractionTo` is not in the range [0, 1], it will be clamped to the nearest number
-     * in that range. For example, `a.mix(b, -1)` is equivalent to `a.mix(b, 0)`.
-     *
-     * @returns a color `fractionTo` of the way from this color to `other`.
-     *
-     * @example
-     * ```ts
-     * Color4.ofRGB(1, 0, 0).mix(Color4.ofRGB(0, 1, 0), 0.1) // -> Color4(0.9, 0.1, 0)
-     * ```
-     */
-    mix(other, fractionTo) {
-        fractionTo = Math.min(Math.max(fractionTo, 0), 1);
-        const fractionOfThis = 1 - fractionTo;
-        return new Color4(this.r * fractionOfThis + other.r * fractionTo, this.g * fractionOfThis + other.g * fractionTo, this.b * fractionOfThis + other.b * fractionTo, this.a * fractionOfThis + other.a * fractionTo);
-    }
-    /**
-     * @returns the component-wise average of `colors`, or `Color4.transparent` if `colors` is empty.
-     */
-    static average(colors) {
-        let averageA = 0;
-        let averageR = 0;
-        let averageG = 0;
-        let averageB = 0;
-        for (const color of colors) {
-            averageA += color.a;
-            averageR += color.r;
-            averageG += color.g;
-            averageB += color.b;
-        }
-        if (colors.length > 0) {
-            averageA /= colors.length;
-            averageR /= colors.length;
-            averageG /= colors.length;
-            averageB /= colors.length;
-        }
-        return new Color4(averageR, averageG, averageB, averageA);
-    }
-    /**
-     * @returns a hexadecimal color string representation of `this`, in the form `#rrggbbaa`.
-     *
-     * @example
-     * ```
-     * Color4.red.toHexString(); // -> #ff0000ff
-     * ```
-     */
-    toHexString() {
-        if (this.hexString) {
-            return this.hexString;
-        }
-        const componentToHex = (component) => {
-            const res = Math.round(255 * component).toString(16);
-            if (res.length === 1) {
-                return `0${res}`;
-            }
-            return res;
-        };
-        const alpha = componentToHex(this.a);
-        const red = componentToHex(this.r);
-        const green = componentToHex(this.g);
-        const blue = componentToHex(this.b);
-        if (alpha === 'ff') {
-            return `#${red}${green}${blue}`;
-        }
-        this.hexString = `#${red}${green}${blue}${alpha}`;
-        return this.hexString;
-    }
-    toString() {
-        return this.toHexString();
-    }
-}
-Color4.transparent = Color4.ofRGBA(0, 0, 0, 0);
-Color4.red = Color4.ofRGB(1.0, 0.0, 0.0);
-Color4.green = Color4.ofRGB(0.0, 1.0, 0.0);
-Color4.blue = Color4.ofRGB(0.0, 0.0, 1.0);
-Color4.purple = Color4.ofRGB(0.5, 0.2, 0.5);
-Color4.yellow = Color4.ofRGB(1, 1, 0.1);
-Color4.clay = Color4.ofRGB(0.8, 0.4, 0.2);
-Color4.black = Color4.ofRGB(0, 0, 0);
-Color4.gray = Color4.ofRGB(0.5, 0.5, 0.5);
-Color4.white = Color4.ofRGB(1, 1, 1);
-export { Color4 };