@thi.ng/hiccup-css 2.7.9 → 2.7.10

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-05-08T18:24:32Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [2.7.10](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup-css@2.7.10) (2024-06-21)
+
+#### ♻️ Refactoring
+
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+
 ## [2.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup-css@2.7.0) (2024-03-21)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -122,7 +122,7 @@ Browser ESM import:
 
 [JSDelivr documentation](https://www.jsdelivr.com/)
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.23 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.24 KB
 
 ## Dependencies
 

package/animation.d.ts

@@ -14,19 +14,23 @@ export interface AnimationOpts {
  * option is given a default value (250ms), all others are optional.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/animation.ts
  * import { animation, css } from "@thi.ng/hiccup-css";
  *
- * css(
- *   animation(
- *     "fadein",
- *     { delay: "0.5s" },
- *     { opacity: 0 },
- *     { opacity: 1 }
+ * console.log(
+ *   css(
+ *     animation(
+ *       "fadein",
+ *       { delay: "0.5s" },
+ *       { opacity: 0 },
+ *       { opacity: 1 }
+ *     )
  *   )
  * );
  * ```
  *
+ * Result:
+ *
  * ```css
  * @keyframes fadein {
  *     0% {

package/conditional.js

@@ -2,14 +2,16 @@ import { isString } from "@thi.ng/checks/is-string";
 import { expand, indent } from "./impl.js";
 const conditional = (type, cond, rules) => (acc, opts) => {
   const space = indent(opts);
-  acc.push(`${space}${type} ${formatCond(cond)}${opts.format.declStart}`);
+  acc.push(
+    `${space}${type} ${__formatCond(cond)}${opts.format.declStart}`
+  );
   opts.depth++;
   expand(acc, [], rules, opts);
   opts.depth--;
   acc.push(space + opts.format.declEnd);
   return acc;
 };
-const formatCond = (cond) => {
+const __formatCond = (cond) => {
   if (isString(cond)) {
     return cond;
   }

package/impl.js

@@ -13,13 +13,13 @@ import { str } from "@thi.ng/transducers/str";
 import { transduce } from "@thi.ng/transducers/transduce";
 const EMPTY = /* @__PURE__ */ new Set();
 const NO_SPACES = ":[";
-const xfSel = comp(
+const __xfSel = comp(
   flatten(),
   map(
     (x) => x[0] === "&" ? x.substring(1) : NO_SPACES.includes(x[0]) ? x : " " + x
   )
 );
-const withScope = (xf, scope) => comp(
+const __withScope = (xf, scope) => comp(
   xf,
   map((x) => isString(x) && x.startsWith(" .") ? x + scope : x)
 );
@@ -30,9 +30,9 @@ const expand = (acc, parent, rules, opts) => {
   const process = (i, r) => {
     let rfn = null;
     if (isArray(r)) {
-      expand(acc, makeSelector(parent, sel), r, opts);
+      expand(acc, __makeSelector(parent, sel), r, opts);
     } else if (isIterable(r) && !isString(r)) {
-      expand(acc, makeSelector(parent, sel), [...r], opts);
+      expand(acc, __makeSelector(parent, sel), [...r], opts);
     } else if ((isFn = isFunction(r)) || (rfn = opts.fns[r])) {
       if (!parent.length) {
         if (rfn) {
@@ -56,14 +56,14 @@ const expand = (acc, parent, rules, opts) => {
       return acc;
     }
   }
-  curr && acc.push(formatRule(parent, sel, curr, opts));
+  curr && acc.push(__formatRule(parent, sel, curr, opts));
   return acc;
 };
-const makeSelector = (parent, curr) => parent.length ? [...permutations(parent, curr)] : curr;
-const formatRule = (parent, sel, curr, opts) => {
+const __makeSelector = (parent, curr) => parent.length ? [...permutations(parent, curr)] : curr;
+const __formatRule = (parent, sel, curr, opts) => {
   const f = opts.format;
   const space = indent(opts);
-  const xf = opts.scope ? withScope(xfSel, opts.scope) : xfSel;
+  const xf = opts.scope ? __withScope(__xfSel, opts.scope) : __xfSel;
   return [
     space,
     transduce(
@@ -71,7 +71,7 @@ const formatRule = (parent, sel, curr, opts) => {
         (sel2) => transduce(xf, str(), isArray(sel2) ? sel2 : [sel2]).trim()
       ),
       str(f.ruleSep),
-      makeSelector(parent, sel)
+      __makeSelector(parent, sel)
     ),
     f.declStart,
     formatDecls(curr, opts),

package/keyframes.d.ts

@@ -6,20 +6,19 @@ export type Keyframe = Record<string, any>;
  * objects. This way any number of stops can be specified.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/at-keyframes.ts
  * import { at_keyframes, css } from "@thi.ng/hiccup-css";
  *
- * css(at_keyframes("fadein", {0: {opacity: 0}, 100: {opacity: 1}}))
+ * console.log(
+ *   css(at_keyframes("fadein", {0: {opacity: 0}, 100: {opacity: 1}}))
+ * );
  * // @keyframes fadein {
- * //
  * //     0% {
  * //         opacity: 0;
  * //     }
- * //
  * //     100% {
  * //         opacity: 1;
  * //     }
- * //
  * // }
  * ```
  *
@@ -28,20 +27,22 @@ export type Keyframe = Record<string, any>;
  * will be at 0%, 50%, 100%.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/at-keyframes-2.ts
  * import { at_keyframes, css } from "@thi.ng/hiccup-css";
  *
- * css(at_keyframes("fadein", {opacity: 0}, {opacity: 1}));
+ * console.log(
+ *   css(at_keyframes("fadein", { opacity: 0 }, { opacity: 0.33 }, { opacity: 1 }))
+ * );
  * // @keyframes fadein {
- * //
  * //     0% {
  * //         opacity: 0;
  * //     }
- * //
+ * //     50% {
+ * //         opacity: 0.33;
+ * //     }
  * //     100% {
  * //         opacity: 1;
  * //     }
- * //
  * // }
  * ```
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/hiccup-css",
-  "version": "2.7.9",
+  "version": "2.7.10",
   "description": "CSS from nested JS data structures",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/hiccup-css#readme",
+  "homepage": "https://thi.ng/hiccup-css",
   "funding": [
     {
       "type": "github",
@@ -36,16 +36,16 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.2",
-    "@thi.ng/checks": "^3.6.4",
-    "@thi.ng/errors": "^2.5.7",
-    "@thi.ng/transducers": "^9.0.5"
+    "@thi.ng/api": "^8.11.3",
+    "@thi.ng/checks": "^3.6.5",
+    "@thi.ng/errors": "^2.5.8",
+    "@thi.ng/transducers": "^9.0.6"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.2",
-    "esbuild": "^0.21.1",
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
     "typedoc": "^0.25.13",
-    "typescript": "^5.4.5"
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "array",
@@ -127,5 +127,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "df34b4a9e650cc7323575356de207d78933bdcf3\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/units.d.ts

@@ -7,6 +7,8 @@ export declare let PRECISION: number;
  * @param n
  */
 export declare const setPrecision: (n: number) => number;
+/** @internal */
+export declare const ff: (x: number) => string;
 export declare const cap: (x: number) => string;
 export declare const ch: (x: number) => string;
 export declare const cm: (x: number) => string;

package/units.js

@@ -31,6 +31,7 @@ export {
   deg,
   em,
   ex,
+  ff,
   inch,
   lh,
   mm,