noelc-css-blender 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Noel C
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# noelc-css-blender
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Tiny ESM utility for blending CSS custom-property token maps into `var()`
+declarations. Zero dependencies, no build step, works in Node 18+ and modern
+browsers.
+
+## Usage
+
+```js
+import { blendTokens, cssVars } from 'noelc-css-blender';
+
+const base = { bg: '#111827', fg: '#f9fafb', accent: 'var(--brand)' };
+const dark = blendTokens(base, { bg: '#000000' });
+
+// "--app-bg: #000000; --app-fg: #f9fafb; --app-accent: var(--brand);"
+const decl = cssVars(dark, 'app');
+```
+
+## API
+
+### `blendTokens(base, override)`
+
+Shallow-merges two token maps (`override` wins per key) and memoizes the
+result, so repeated calls with the same maps return the same object.
+
+### `cssVars(map, prefix)`
+
+Renders a token map as a CSS custom-property block body. The optional prefix
+is joined with `-` (e.g. `cssVars({bg: 'red'}, 'app')` → `--app-bg: red;`).
+
+### `memoSize()`
+
+Returns the number of memoized results — handy in tests.
+
+## License
+
+MIT

package/index.mjs

@@ -0,0 +1,46 @@
+// noelc-css-blender — blend CSS custom-property token maps into var() declarations.
+
+const MEMO = new Map();
+
+function stableKey(parts) {
+  let out = '';
+  for (const part of parts) out += JSON.stringify(part) + '\n';
+  return out;
+}
+
+/**
+ * Merge a base token map with an override map. Override wins per key.
+ * Values containing var() references are passed through untouched.
+ */
+export function blendTokens(base = {}, override = {}) {
+  const key = stableKey([base, override]);
+  if (MEMO.has(key)) return MEMO.get(key);
+  const out = { ...base };
+  for (const [name, value] of Object.entries(override)) {
+    out[name] = value;
+  }
+  MEMO.set(key, out);
+  return out;
+}
+
+/**
+ * Render a token map as a CSS custom-property block body, e.g.
+ * cssVars({ 'bg': '#111', 'fg': 'var(--base-fg)' }, 'app') ->
+ * "--app-bg: #111; --app-fg: var(--base-fg);"
+ */
+export function cssVars(map = {}, prefix = '') {
+  const key = stableKey([map, prefix]);
+  if (MEMO.has(key)) return MEMO.get(key);
+  const lines = [];
+  for (const [name, value] of Object.entries(map)) {
+    lines.push(`--${prefix ? prefix + '-' : ''}${name}: ${value};`);
+  }
+  const out = lines.join(' ');
+  MEMO.set(key, out);
+  return out;
+}
+
+/** Number of memoized results (handy in tests). */
+export function memoSize() {
+  return MEMO.size;
+}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "noelc-css-blender",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Tiny ESM utility for blending CSS custom-property token maps into var() declarations.",
+  "license": "MIT",
+  "author": "Noel C",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.mjs",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "css",
+    "custom-properties",
+    "tokens",
+    "theme",
+    "utility"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}