diff options
| author | Ivan Gabaldon <igabaldon@inetol.net> | 2025-07-06 12:27:28 +0200 |
|---|---|---|
| committer | Markus Heiser <markus.heiser@darmarIT.de> | 2025-08-18 16:38:32 +0200 |
| commit | 0b913053a76e83a43846e19097963f98c8519a1d (patch) | |
| tree | d11f7d76db1053559ca91f8ad66b0afd6c6d4336 /client/simple/tools/jinja_svg_catalog.js | |
| parent | 4fb6105d699e19321f6799d7fff05313fd4cd4b9 (diff) | |
[mod] theme/simple: migrate codebase to TypeScript
TypeScript is a superset of JavaScript, converting the entire theme to
TypeScript allows us to receive much more feedback on possible issues made in
package updates or our own typos, furthermore, it allows to transpile properly
to lower specs. This PR couldn't be done in smaller commits, a lot of work
needed to make everything *work properly*:
- A browser baseline has been set that requires minimum **Chromium 93, Firefox
92 and Safari 15** (proper visuals/operation on older browser versions is not
guaranteed)
- LightningCSS now handles minification and prefix creation for CSS.
- All hardcoded polyfills and support for previous browser baseline versions
have been removed.
- Convert codebase to TypeScript.
- Convert IIFE to ESM, handling globals with IIFE is cumbersome, ESM is the
standard for virtually any use of JS nowadays.
- Vite now builds the theme without the need for `vite-plugin-static-copy`.
- `searxng.ready` now accepts an array of conditions for the callback to be
executed.
- Replace `leaflet` with `ol` as there were some issues with proper Vite
bundling.
- Merged `head` with `main` script, as head was too small now.
- Add `assertElement` to properly check the existence of critical DOM elements.
- `searxng.on` renamed to `searxng.listen` with some handling improvements.
Diffstat (limited to 'client/simple/tools/jinja_svg_catalog.js')
| -rw-r--r-- | client/simple/tools/jinja_svg_catalog.js | 119 |
1 files changed, 0 insertions, 119 deletions
diff --git a/client/simple/tools/jinja_svg_catalog.js b/client/simple/tools/jinja_svg_catalog.js deleted file mode 100644 index b7b0347b5..000000000 --- a/client/simple/tools/jinja_svg_catalog.js +++ /dev/null @@ -1,119 +0,0 @@ -import fs from "node:fs"; -import { dirname, resolve } from "node:path"; -import { fileURLToPath } from "node:url"; -import { Edge } from "edge.js"; -import { optimize as svgo } from "svgo"; - -const __dirname = dirname(fileURLToPath(import.meta.url)); -const __jinja_class_placeholder__ = "__jinja_class_placeholder__"; - -// -- types - -/** - * @typedef {object} IconSet - A set of icons - * @property {object} set - Object of SVG icons, where property name is the - * name of the icon and value is the src of the SVG (relative to base). - * @property {string} base - Folder in which the SVG src files are located. - * @property {import("svgo").Config} svgo_opts - svgo options for this set. - */ - -/** - * @typedef {object} IconSVG - Mapping of icon name to SVG source file. - * @property {string} name - Name of the icon isource file. - * @property {string} src - Name of the destination file. - * @property {import("svgo").Config} svgo_opts - Options passed to svgo. - */ - -/** - * @typedef {object} JinjaMacro - Arguments to create a jinja macro - * @property {string} name - Name of the jinja macro. - * @property {string} class - SVG's class name (value of XML class attribute) - */ - -// -- functions - -/** - * Generate a jinja template with a catalog of SVG icons that can be - * used in in other HTML jinja templates. - * - * @param {string} dest - filename of the generate jinja template. - * @param {JinjaMacro} macros - Jinja macros to create. - * @param {IconSVG[]} items - Array of SVG items. - */ - -function jinja_svg_catalog(dest, macros, items) { - const svg_catalog = {}; - const edge_template = resolve(__dirname, "jinja_svg_catalog.html.edge"); - - items.forEach((item) => { - /** @type {import("svgo").Config} */ - // JSON.stringify & JSON.parse are used to create a deep copy of the - // item.svgo_opts object - const svgo_opts = JSON.parse(JSON.stringify(item.svgo_opts)); - svgo_opts.plugins.push({ - name: "addClassesToSVGElement", - params: { - classNames: [__jinja_class_placeholder__] - } - }); - - try { - const raw = fs.readFileSync(item.src, "utf8"); - const opt = svgo(raw, svgo_opts); - svg_catalog[item.name] = opt.data; - } catch (err) { - console.error(`ERROR: jinja_svg_catalog processing ${item.name} src: ${item.src} -- ${err}`); - throw err; - } - }); - - fs.mkdir(dirname(dest), { recursive: true }, (err) => { - if (err) throw err; - }); - - const ctx = { - svg_catalog: svg_catalog, - macros: macros, - edge_template: edge_template, - __jinja_class_placeholder__: __jinja_class_placeholder__, - // see https://github.com/edge-js/edge/issues/162 - open_curly_brace: "{{", - close_curly_brace: "}}" - }; - - const jinjatmpl = Edge.create().renderRawSync(fs.readFileSync(edge_template, "utf-8"), ctx); - - fs.writeFileSync(dest, jinjatmpl); - console.log(`[jinja_svg_catalog] created: ${dest}`); -} - -/** - * Calls jinja_svg_catalog for a collection of icon sets where each set has its - * own parameters. - * - * @param {string} dest - filename of the generate jinja template. - * @param {JinjaMacro} macros - Jinja macros to create. - * @param {IconSet[]} sets - Array of SVG sets. - */ -function jinja_svg_sets(dest, macros, sets) { - /** @type IconSVG[] */ - const items = []; - const all = []; - for (const obj of sets) { - for (const [name, file] of Object.entries(obj.set)) { - if (all.includes(name)) { - throw new Error(`ERROR: ${name} has already been defined`); - } - items.push({ - name: name, - src: resolve(obj.base, file), - svgo_opts: obj.svgo_opts - }); - } - jinja_svg_catalog(dest, macros, items); - } -} - -// -- exports - -export { jinja_svg_sets, jinja_svg_catalog }; |