@navita/css 0.0.0-main-20230917201540

package/index.d.ts

@@ -0,0 +1,39 @@
+import { StyleRule, GlobalStyleRule, CSSKeyframes, FontFaceRule, NullableTokens, ThemeVars, Tokens, Contract, MapLeafNodes, CSSVarFunction } from '@navita/types';
+
+declare function style(rule: StyleRule): string;
+
+declare function globalStyle(selector: string, rule: GlobalStyleRule): void;
+
+declare function merge(...classNames: (string | false | void | null | 0 | '')[]): string;
+
+declare function keyframes(rule: CSSKeyframes): string;
+
+declare function fontFace(rule: FontFaceRule | FontFaceRule[]): string;
+
+declare function createThemeContract<ThemeTokens extends NullableTokens>(tokens: ThemeTokens): ThemeVars<ThemeTokens>;
+declare function createGlobalThemeContract<ThemeTokens extends Tokens>(tokens: ThemeTokens): ThemeVars<ThemeTokens>;
+declare function createGlobalThemeContract<ThemeTokens extends NullableTokens>(tokens: ThemeTokens, mapFn: (value: string | null, path: Array<string>) => string): ThemeVars<ThemeTokens>;
+declare function createGlobalTheme<ThemeTokens extends Tokens>(selector: string, tokens: ThemeTokens): ThemeVars<ThemeTokens>;
+declare function createGlobalTheme<ThemeContract extends Contract>(selector: string, themeContract: ThemeContract, tokens: MapLeafNodes<ThemeContract, string>): void;
+declare function createTheme<ThemeTokens extends Tokens>(tokens: ThemeTokens, debugId?: string): [className: string, vars: ThemeVars<ThemeTokens>];
+declare function createTheme<ThemeContract extends Contract>(themeContract: ThemeContract, tokens: MapLeafNodes<ThemeContract, string>): string;
+
+declare function createVar(name: string): string;
+declare function fallbackVar(...values: [string, ...Array<string>]): CSSVarFunction;
+declare function assignVars<VarContract extends Contract>(varContract: VarContract, tokens: MapLeafNodes<VarContract, string>): Record<CSSVarFunction, string>;
+
+declare class ClassList extends String {
+    classList: {
+        [key: string]: string[];
+    };
+    constructor(str: string, classList: {
+        [key: string]: string[];
+    });
+}
+
+declare const importMap: {
+    callee: string;
+    source: string;
+}[];
+
+export { ClassList, assignVars, createGlobalTheme, createGlobalThemeContract, createTheme, createThemeContract, createVar, fallbackVar, fontFace, globalStyle, importMap, keyframes, merge, style };

package/index.js

@@ -0,0 +1,237 @@
+'use strict';
+
+var adapter = require('@navita/adapter');
+var cssesc = require('cssesc');
+var chalk = require('chalk');
+var deepObjectDiff = require('deep-object-diff');
+
+function style(rule) {
+    return adapter.addCss(rule);
+}
+
+function globalStyle(selector, rule) {
+    adapter.addStaticCss(selector, rule);
+}
+
+function merge(...classNames) {
+    const input = classNames.filter(Boolean).join(' ').split(' ');
+    const output = {};
+    for (const className of input){
+        const [property] = className.split(/\d+$/);
+        output[property] = className;
+    }
+    return Object.values(output).join(' ');
+}
+
+function keyframes(rule) {
+    return adapter.addKeyframe(rule);
+}
+
+function fontFace(rule) {
+    return adapter.addFontFace(rule);
+}
+
+function walkObject(objectToWalk, transformFn, currentPath = []) {
+    const clonedObject = objectToWalk.constructor();
+    for(const key in objectToWalk){
+        const value = objectToWalk[key];
+        const newPath = [
+            ...currentPath,
+            key
+        ];
+        if (typeof value === 'string' || typeof value === 'number' || value == null) {
+            clonedObject[key] = transformFn(value, newPath);
+        } else if (typeof value === 'object' && !Array.isArray(value)) {
+            clonedObject[key] = walkObject(value, transformFn, newPath);
+        }
+    }
+    return clonedObject;
+}
+
+const normaliseObject = (obj)=>walkObject(obj, ()=>'');
+function validateContract(contract, tokens) {
+    const theDiff = deepObjectDiff.diff(normaliseObject(contract), normaliseObject(tokens));
+    const valid = Object.keys(theDiff).length === 0;
+    return {
+        valid,
+        diffString: valid ? '' : renderDiff(contract, theDiff)
+    };
+}
+function diffLine(value, nesting, type) {
+    const whitespace = [
+        ...Array(nesting).keys()
+    ].map(()=>'  ').join('');
+    const line = `${type ? type : ' '}${whitespace}${value}`;
+    {
+        if (type === '-') {
+            return chalk.red(line);
+        }
+        if (type === '+') {
+            return chalk.green(line);
+        }
+    }
+    return line;
+}
+function renderDiff(orig, diff, nesting = 0) {
+    const lines = [];
+    if (nesting === 0) {
+        lines.push(diffLine('{', 0));
+    }
+    const innerNesting = nesting + 1;
+    const keys = Object.keys(diff).sort();
+    for (const key of keys){
+        const value = diff[key];
+        if (!(key in orig)) {
+            lines.push(diffLine(`${key}: ...,`, innerNesting, '+'));
+        } else if (typeof value === 'object') {
+            lines.push(diffLine(`${key}: {`, innerNesting));
+            lines.push(renderDiff(orig[key], diff[key], innerNesting));
+            lines.push(diffLine('}', innerNesting));
+        } else {
+            lines.push(diffLine(`${key}: ...,`, innerNesting, '-'));
+        }
+    }
+    if (nesting === 0) {
+        lines.push(diffLine('}', 0));
+    }
+    return lines.join('\n');
+}
+
+function createVar(name) {
+    if (!name) {
+        return `var(--${adapter.generateIdentifier(undefined)})`;
+    }
+    return `var(--${cssesc(name, {
+        isIdentifier: true
+    })})`;
+}
+function fallbackVar(...values) {
+    let finalValue = '';
+    values.reverse().forEach((value)=>{
+        if (finalValue === '') {
+            finalValue = String(value);
+        } else {
+            if (typeof value !== 'string' || !/^var\(--.*\)$/.test(value)) {
+                throw new Error(`Invalid variable name: ${value}`);
+            }
+            finalValue = value.replace(/\)$/, `, ${finalValue})`);
+        }
+    });
+    return finalValue;
+}
+function assignVars(varContract, tokens) {
+    const varSetters = {};
+    const { valid , diffString  } = validateContract(varContract, tokens);
+    if (!valid) {
+        throw new Error(`Tokens don't match contract.\n${diffString}`);
+    }
+    walkObject(tokens, (value, path)=>{
+        const cssVarWithoutVar = `--${cssesc(path.join('-').toLowerCase(), {
+            isIdentifier: true
+        })}`;
+        varSetters[cssVarWithoutVar] = String(value);
+    });
+    return varSetters;
+}
+
+function createThemeContract(tokens) {
+    return walkObject(tokens, (_value, path)=>{
+        return createVar(path.join('-').toLowerCase());
+    });
+}
+function createGlobalThemeContract(tokens, mapFn) {
+    return walkObject(tokens, (value, path)=>{
+        const rawVarName = typeof mapFn === 'function' ? mapFn(value, path) : value;
+        const varName = typeof rawVarName === 'string' ? rawVarName.replace(/^\-\-/, '') : null;
+        if (typeof varName !== 'string' || varName !== cssesc(varName, {
+            isIdentifier: true
+        })) {
+            throw new Error(`Invalid variable name for "${path.join('.')}": ${varName}`);
+        }
+        return `var(--${varName})`;
+    });
+}
+function createGlobalTheme(selector, arg2, arg3) {
+    const shouldCreateVars = Boolean(!arg3);
+    const themeVars = shouldCreateVars ? createThemeContract(arg2) : arg2;
+    const tokens = shouldCreateVars ? arg2 : arg3;
+    const temp = assignVars(themeVars, tokens);
+    adapter.addStaticCss(selector, temp);
+    if (shouldCreateVars) {
+        return themeVars;
+    }
+}
+function createTheme(arg1, arg2) {
+    const themeClassName = `.${adapter.generateIdentifier(typeof arg2 === 'object' ? arg2 : arg1)}`;
+    const vars = typeof arg2 === 'object' ? createGlobalTheme(themeClassName, arg1, arg2) : createGlobalTheme(themeClassName, arg1);
+    return vars ? [
+        themeClassName,
+        vars
+    ] : themeClassName;
+}
+
+class ClassList extends String {
+    constructor(str, classList){
+        super(str);
+        this.classList = classList;
+    }
+}
+
+const source = '@navita/css';
+const importMap = [
+    {
+        callee: "style",
+        source
+    },
+    {
+        callee: "globalStyle",
+        source
+    },
+    {
+        callee: "keyframes",
+        source
+    },
+    {
+        callee: "fontFace",
+        source
+    },
+    {
+        callee: "createThemeContract",
+        source
+    },
+    {
+        callee: "createGlobalThemeContract",
+        source
+    },
+    {
+        callee: "createGlobalTheme",
+        source
+    },
+    {
+        callee: "createTheme",
+        source
+    },
+    {
+        callee: "createVar",
+        source
+    },
+    {
+        callee: "fallbackVar",
+        source
+    }
+];
+
+exports.ClassList = ClassList;
+exports.assignVars = assignVars;
+exports.createGlobalTheme = createGlobalTheme;
+exports.createGlobalThemeContract = createGlobalThemeContract;
+exports.createTheme = createTheme;
+exports.createThemeContract = createThemeContract;
+exports.createVar = createVar;
+exports.fallbackVar = fallbackVar;
+exports.fontFace = fontFace;
+exports.globalStyle = globalStyle;
+exports.importMap = importMap;
+exports.keyframes = keyframes;
+exports.merge = merge;
+exports.style = style;

package/index.mjs

@@ -0,0 +1,222 @@
+import { addCss, addStaticCss, addKeyframe, addFontFace, generateIdentifier } from '@navita/adapter';
+import cssesc from 'cssesc';
+import chalk from 'chalk';
+import { diff } from 'deep-object-diff';
+
+function style(rule) {
+    return addCss(rule);
+}
+
+function globalStyle(selector, rule) {
+    addStaticCss(selector, rule);
+}
+
+function merge(...classNames) {
+    const input = classNames.filter(Boolean).join(' ').split(' ');
+    const output = {};
+    for (const className of input){
+        const [property] = className.split(/\d+$/);
+        output[property] = className;
+    }
+    return Object.values(output).join(' ');
+}
+
+function keyframes(rule) {
+    return addKeyframe(rule);
+}
+
+function fontFace(rule) {
+    return addFontFace(rule);
+}
+
+function walkObject(objectToWalk, transformFn, currentPath = []) {
+    const clonedObject = objectToWalk.constructor();
+    for(const key in objectToWalk){
+        const value = objectToWalk[key];
+        const newPath = [
+            ...currentPath,
+            key
+        ];
+        if (typeof value === 'string' || typeof value === 'number' || value == null) {
+            clonedObject[key] = transformFn(value, newPath);
+        } else if (typeof value === 'object' && !Array.isArray(value)) {
+            clonedObject[key] = walkObject(value, transformFn, newPath);
+        }
+    }
+    return clonedObject;
+}
+
+const normaliseObject = (obj)=>walkObject(obj, ()=>'');
+function validateContract(contract, tokens) {
+    const theDiff = diff(normaliseObject(contract), normaliseObject(tokens));
+    const valid = Object.keys(theDiff).length === 0;
+    return {
+        valid,
+        diffString: valid ? '' : renderDiff(contract, theDiff)
+    };
+}
+function diffLine(value, nesting, type) {
+    const whitespace = [
+        ...Array(nesting).keys()
+    ].map(()=>'  ').join('');
+    const line = `${type ? type : ' '}${whitespace}${value}`;
+    {
+        if (type === '-') {
+            return chalk.red(line);
+        }
+        if (type === '+') {
+            return chalk.green(line);
+        }
+    }
+    return line;
+}
+function renderDiff(orig, diff, nesting = 0) {
+    const lines = [];
+    if (nesting === 0) {
+        lines.push(diffLine('{', 0));
+    }
+    const innerNesting = nesting + 1;
+    const keys = Object.keys(diff).sort();
+    for (const key of keys){
+        const value = diff[key];
+        if (!(key in orig)) {
+            lines.push(diffLine(`${key}: ...,`, innerNesting, '+'));
+        } else if (typeof value === 'object') {
+            lines.push(diffLine(`${key}: {`, innerNesting));
+            lines.push(renderDiff(orig[key], diff[key], innerNesting));
+            lines.push(diffLine('}', innerNesting));
+        } else {
+            lines.push(diffLine(`${key}: ...,`, innerNesting, '-'));
+        }
+    }
+    if (nesting === 0) {
+        lines.push(diffLine('}', 0));
+    }
+    return lines.join('\n');
+}
+
+function createVar(name) {
+    if (!name) {
+        return `var(--${generateIdentifier(undefined)})`;
+    }
+    return `var(--${cssesc(name, {
+        isIdentifier: true
+    })})`;
+}
+function fallbackVar(...values) {
+    let finalValue = '';
+    values.reverse().forEach((value)=>{
+        if (finalValue === '') {
+            finalValue = String(value);
+        } else {
+            if (typeof value !== 'string' || !/^var\(--.*\)$/.test(value)) {
+                throw new Error(`Invalid variable name: ${value}`);
+            }
+            finalValue = value.replace(/\)$/, `, ${finalValue})`);
+        }
+    });
+    return finalValue;
+}
+function assignVars(varContract, tokens) {
+    const varSetters = {};
+    const { valid , diffString  } = validateContract(varContract, tokens);
+    if (!valid) {
+        throw new Error(`Tokens don't match contract.\n${diffString}`);
+    }
+    walkObject(tokens, (value, path)=>{
+        const cssVarWithoutVar = `--${cssesc(path.join('-').toLowerCase(), {
+            isIdentifier: true
+        })}`;
+        varSetters[cssVarWithoutVar] = String(value);
+    });
+    return varSetters;
+}
+
+function createThemeContract(tokens) {
+    return walkObject(tokens, (_value, path)=>{
+        return createVar(path.join('-').toLowerCase());
+    });
+}
+function createGlobalThemeContract(tokens, mapFn) {
+    return walkObject(tokens, (value, path)=>{
+        const rawVarName = typeof mapFn === 'function' ? mapFn(value, path) : value;
+        const varName = typeof rawVarName === 'string' ? rawVarName.replace(/^\-\-/, '') : null;
+        if (typeof varName !== 'string' || varName !== cssesc(varName, {
+            isIdentifier: true
+        })) {
+            throw new Error(`Invalid variable name for "${path.join('.')}": ${varName}`);
+        }
+        return `var(--${varName})`;
+    });
+}
+function createGlobalTheme(selector, arg2, arg3) {
+    const shouldCreateVars = Boolean(!arg3);
+    const themeVars = shouldCreateVars ? createThemeContract(arg2) : arg2;
+    const tokens = shouldCreateVars ? arg2 : arg3;
+    const temp = assignVars(themeVars, tokens);
+    addStaticCss(selector, temp);
+    if (shouldCreateVars) {
+        return themeVars;
+    }
+}
+function createTheme(arg1, arg2) {
+    const themeClassName = `.${generateIdentifier(typeof arg2 === 'object' ? arg2 : arg1)}`;
+    const vars = typeof arg2 === 'object' ? createGlobalTheme(themeClassName, arg1, arg2) : createGlobalTheme(themeClassName, arg1);
+    return vars ? [
+        themeClassName,
+        vars
+    ] : themeClassName;
+}
+
+class ClassList extends String {
+    constructor(str, classList){
+        super(str);
+        this.classList = classList;
+    }
+}
+
+const source = '@navita/css';
+const importMap = [
+    {
+        callee: "style",
+        source
+    },
+    {
+        callee: "globalStyle",
+        source
+    },
+    {
+        callee: "keyframes",
+        source
+    },
+    {
+        callee: "fontFace",
+        source
+    },
+    {
+        callee: "createThemeContract",
+        source
+    },
+    {
+        callee: "createGlobalThemeContract",
+        source
+    },
+    {
+        callee: "createGlobalTheme",
+        source
+    },
+    {
+        callee: "createTheme",
+        source
+    },
+    {
+        callee: "createVar",
+        source
+    },
+    {
+        callee: "fallbackVar",
+        source
+    }
+];
+
+export { ClassList, assignVars, createGlobalTheme, createGlobalThemeContract, createTheme, createThemeContract, createVar, fallbackVar, fontFace, globalStyle, importMap, keyframes, merge, style };

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@navita/css",
+  "version": "0.0.0-main-20230917201540",
+  "license": "MIT",
+  "private": false,
+  "sideEffects": false,
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@navita/adapter": "0.0.0-main-20230917201540",
+    "@navita/types": "0.0.0-main-20230917201540",
+    "deep-object-diff": "^1.1.9",
+    "cssesc": "^3.0.0",
+    "chalk": "^4.1.2"
+  }
+}