@terrazzo/parser 0.1.3 → 0.2.1

package/dist/parse/normalize.js

@@ -0,0 +1,163 @@
+import { isAlias, parseColor, } from '@terrazzo/token-tools';
+export const FONT_WEIGHT_MAP = {
+    thin: 100,
+    hairline: 100,
+    'extra-light': 200,
+    'ultra-light': 200,
+    light: 300,
+    normal: 400,
+    regular: 400,
+    book: 400,
+    medium: 500,
+    'semi-bold': 600,
+    'demi-bold': 600,
+    bold: 700,
+    'extra-bold': 800,
+    'ultra-bold': 800,
+    black: 900,
+    heavy: 900,
+    'extra-black': 950,
+    'ultra-black': 950,
+};
+// Note: because we’re handling a lot of input values, the type inference gets lost.
+// This file is expected to have a lot of `@ts-ignore` comments.
+const NUMBER_WITH_UNIT_RE = /(-?\d*\.?\d+)(.*)/;
+/** Fill in defaults, and return predictable shapes for tokens */
+export default function normalizeValue(token) {
+    if (isAlias(token.$value)) {
+        return token.$value;
+    }
+    switch (token.$type) {
+        case 'boolean': {
+            return !!token.$value;
+        }
+        case 'border': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            return {
+                color: normalizeValue({ $type: 'color', $value: token.$value.color ?? '#000000' }),
+                style: normalizeValue({ $type: 'strokeStyle', $value: token.$value.style ?? 'solid' }),
+                width: normalizeValue({ $type: 'dimension', $value: token.$value.width }),
+            };
+        }
+        case 'color': {
+            if (typeof token.$value === 'string') {
+                return parseColor(token.$value);
+            }
+            return 'alpha' in token.$value ? token.$value : { ...token.$value, alpha: 1 };
+        }
+        case 'cubicBezier': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            return token.$value.map((value) => typeof value === 'number' ? normalizeValue({ $type: 'number', $value: value }) : value);
+        }
+        case 'dimension': {
+            if (token.$value === 0) {
+                return { value: 0, unit: 'px' };
+            }
+            // Backwards compat: handle string
+            if (typeof token.$value === 'string') {
+                const match = token.$value.match(NUMBER_WITH_UNIT_RE);
+                return { value: Number.parseFloat(match?.[1] || token.$value), unit: match?.[2] || 'px' };
+            }
+            return token.$value;
+        }
+        case 'duration': {
+            if (token.$value === 0) {
+                return { value: 0, unit: 'ms' };
+            }
+            // Backwards compat: handle string
+            if (typeof token.$value === 'string') {
+                const match = token.$value.match(NUMBER_WITH_UNIT_RE);
+                return { value: Number.parseFloat(match?.[1] || token.$value), unit: match?.[2] || 'ms' };
+            }
+            return token.$value;
+        }
+        case 'fontFamily': {
+            return Array.isArray(token.$value) ? token.$value : [token.$value];
+        }
+        case 'fontWeight': {
+            if (typeof token.$value === 'string' && FONT_WEIGHT_MAP[token.$value]) {
+                return FONT_WEIGHT_MAP[token.$value];
+            }
+            return Math.min(999, Math.max(1, typeof token.$value === 'string' ? Number.parseInt(token.$value) : token.$value));
+        }
+        case 'gradient': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            const output = [];
+            for (let i = 0; i < token.$value.length; i++) {
+                const stop = { ...token.$value[i] };
+                stop.color = normalizeValue({ $type: 'color', $value: stop.color });
+                if (stop.position === undefined) {
+                    stop.position = i / (token.$value.length - 1);
+                }
+                output.push(stop);
+            }
+            return output;
+        }
+        case 'number': {
+            return typeof token.$value === 'number' ? token.$value : Number.parseFloat(token.$value);
+        }
+        case 'shadow': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            return (Array.isArray(token.$value) ? token.$value : [token.$value]).map((layer) => ({
+                color: normalizeValue({ $type: 'color', $value: layer.color }),
+                // @ts-ignore
+                offsetX: normalizeValue({ $type: 'dimension', $value: layer.offsetX ?? 0 }),
+                // @ts-ignore
+                offsetY: normalizeValue({ $type: 'dimension', $value: layer.offsetY ?? 0 }),
+                // @ts-ignore
+                blur: normalizeValue({ $type: 'dimension', $value: layer.blur ?? 0 }),
+                // @ts-ignore
+                spread: normalizeValue({ $type: 'dimension', $value: layer.spread ?? 0 }),
+                inset: layer.inset === true,
+            }));
+        }
+        case 'strokeStyle': {
+            return token.$value;
+        }
+        case 'string': {
+            return String(token.$value);
+        }
+        case 'transition': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            return {
+                // @ts-ignore
+                duration: normalizeValue({ $type: 'duration', $value: token.$value.duration ?? 0 }),
+                // @ts-ignore
+                delay: normalizeValue({ $type: 'duration', $value: token.$value.delay ?? 0 }),
+                // @ts-ignore
+                timingFunction: normalizeValue({ $type: 'cubicBezier', $value: token.$value.timingFunction }),
+            };
+        }
+        case 'typography': {
+            if (typeof token.$value === 'string') {
+                return token.$value;
+            }
+            const output = {};
+            for (const k in token.$value) {
+                switch (k) {
+                    case 'letterSpacing':
+                    case 'fontSize':
+                        output[k] = normalizeValue({ $type: 'dimension', $value: token.$value[k] });
+                        break;
+                    default:
+                        output[k] = token.$value[k];
+                }
+            }
+            return output;
+        }
+        default: {
+            return token.$value;
+        }
+    }
+}
+//# sourceMappingURL=normalize.js.map

package/dist/parse/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/parse/normalize.ts"],"names":[],"mappings":"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"}

package/dist/parse/validate.d.ts

@@ -0,0 +1,45 @@
+import { type AnyNode, type MemberNode, type ValueNode } from '@humanwhocodes/momoa';
+import type Logger from '../logger.js';
+export interface ValidateOptions {
+    filename?: URL;
+    src: string;
+    logger: Logger;
+}
+export declare const VALID_COLORSPACES: Set<string>;
+export declare const FONT_WEIGHT_VALUES: Set<string>;
+export declare const STROKE_STYLE_VALUES: Set<string>;
+export declare const STROKE_STYLE_LINE_CAP_VALUES: Set<string>;
+/** Verify an Alias $value is formatted correctly */
+export declare function validateAliasSyntax($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Border token is valid */
+export declare function validateBorder($value: ValueNode, node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Color token is valid */
+export declare function validateColor($value: ValueNode, node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Cubic Bézier token is valid */
+export declare function validateCubicBezier($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Dimension token is valid */
+export declare function validateDimension($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Duration token is valid */
+export declare function validateDuration($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/**  Verify a Font Family token is valid */
+export declare function validateFontFamily($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Font Weight token is valid */
+export declare function validateFontWeight($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Gradient token is valid */
+export declare function validateGradient($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Number token is valid */
+export declare function validateNumber($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Boolean token is valid */
+export declare function validateBoolean($value: ValueNode, _node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Shadow token’s value is valid */
+export declare function validateShadowLayer($value: ValueNode, node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Stroke Style token is valid. */
+export declare function validateStrokeStyle($value: ValueNode, node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/** Verify a Transition token is valid */
+export declare function validateTransition($value: ValueNode, node: AnyNode, { filename, src, logger }: ValidateOptions): void;
+/**
+ * Validate a MemberNode (the entire token object, plus its key in the parent
+ * object) to see if it’s a valid DTCG token or not. Keeping the parent key
+ * really helps in debug messages.
+ */
+export default function validate(node: MemberNode, { filename, src, logger }: ValidateOptions): void;