@jackens/nnn 2024.3.3 → 2024.3.5

package/nnn.d.ts

@@ -107,6 +107,11 @@ export declare const s: {
     (tagOrNode: string | Node, ...args1: HArgs1[]): Node;
 };
 
+/**
+ * A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
+ */
+export declare const svgUse: (id: string, ...args: HArgs1[]) => SVGSVGElement;
+
 /**
  * A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
  */
@@ -139,7 +144,7 @@ export type JcNode = {
 export type JcRoot = Partial<Record<PropertyKey, JcNode>>;
 
 /**
- * A simple CSS-in-JS helper.
+ * A simple JS-to-CSS (aka CSS-in-JS) helper.
  *
  * The `root` parameter provides a hierarchical description of CSS rules.
  *

package/nnn.js

@@ -64,6 +64,7 @@ var _h = (namespaceURI) => {
 };
 var h = _h();
 var s = _h("http://www.w3.org/2000/svg");
+var svgUse = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
 
 // src/nnn/chartable.ts
 var COLORS = ["#e22", "#e73", "#fc3", "#ad4", "#4d9", "#3be", "#45d", "#c3e"];
@@ -398,6 +399,7 @@ var uuid1 = ({
 };
 export {
   uuid1,
+  svgUse,
   s,
   refsInfo,
   pro,

package/package.json

@@ -43,5 +43,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2024.3.3"
+  "version": "2024.3.5"
 }

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.3.3</code></sub>
+<sub>Version: <code class="version">2024.3.5</code></sub>
 
 ## Examples
 
@@ -53,7 +53,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
 - `has`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
 - `is`: A helper that checks if the given argument is of a certain type.
-- `jc`: A simple CSS-in-JS helper.
+- `jc`: A simple JS-to-CSS (aka CSS-in-JS) helper.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
 - `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
@@ -64,6 +64,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `pro`: A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
 - `refsInfo`: A helper that provides information about the given `refs`.
 - `s`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
+- `svgUse`: A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
 - `uuid1`: A helper that generates a UUID v1 identifier (with a creation timestamp).
 
 ### EscapeMap
@@ -459,7 +460,7 @@ expect(is(Number, num)).toBeTrue()
 const jc: (root: JcRoot, splitter?: string) => string;
 ```
 
-A simple CSS-in-JS helper.
+A simple JS-to-CSS (aka CSS-in-JS) helper.
 
 The `root` parameter provides a hierarchical description of CSS rules.
 
@@ -957,6 +958,14 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
 - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
 
+### svgUse
+
+```ts
+const svgUse: (id: string, ...args: HArgs1[]) => SVGSVGElement;
+```
+
+A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
+
 ### uuid1
 
 ```ts