@interactivethings/scripts 2.0.2 → 2.1.0

package/dist/config.d.ts

@@ -1,78 +0,0 @@
-import { z } from "zod";
-/**
- * Figma configuration schema
- */
-export declare const FigmaAssetConfigSchema: z.ZodObject<{
-    url: z.ZodString;
-    output: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strip>;
-export declare const FigmaConfigSchema: z.ZodObject<{
-    token: z.ZodOptional<z.ZodString>;
-    assets: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        url: z.ZodString;
-        output: z.ZodString;
-        name: z.ZodString;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-/**
- * Tokens Studio configuration schema
- */
-export declare const TokensStudioConfigSchema: z.ZodObject<{
-    input: z.ZodDefault<z.ZodString>;
-    output: z.ZodOptional<z.ZodString>;
-    handler: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Vercel configuration schema
- */
-export declare const VercelConfigSchema: z.ZodObject<{
-    team: z.ZodOptional<z.ZodString>;
-    project: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Main IXT Scripts configuration schema
- */
-export declare const IxtConfigSchema: z.ZodObject<{
-    figma: z.ZodOptional<z.ZodObject<{
-        token: z.ZodOptional<z.ZodString>;
-        assets: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
-            output: z.ZodString;
-            name: z.ZodString;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    tokensStudio: z.ZodOptional<z.ZodObject<{
-        input: z.ZodDefault<z.ZodString>;
-        output: z.ZodOptional<z.ZodString>;
-        handler: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    vercel: z.ZodOptional<z.ZodObject<{
-        team: z.ZodOptional<z.ZodString>;
-        project: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type IxtConfig = z.infer<typeof IxtConfigSchema>;
-export type FigmaConfig = z.infer<typeof FigmaConfigSchema>;
-export type FigmaAssetConfig = z.infer<typeof FigmaAssetConfigSchema>;
-export type TokensStudioConfig = z.infer<typeof TokensStudioConfigSchema>;
-export type VercelConfig = z.infer<typeof VercelConfigSchema>;
-/**
- * Helper function for type-safe configuration definition
- * Provides IntelliSense and validation for the configuration object
- */
-export declare function defineConfig(config: IxtConfig): IxtConfig;
-/**
- * Load configuration from a TypeScript file
- * Only supports .ts configuration files for better type safety
- */
-export declare function loadConfig(configPath?: string): Promise<IxtConfig>;
-/**
- * Merge CLI arguments with configuration
- * CLI arguments take precedence over config file values
- */
-export declare function mergeConfigWithArgs<T extends Record<string, any>>(config: IxtConfig, args: T, section: keyof IxtConfig): T & Partial<IxtConfig[keyof IxtConfig]>;
-/**
- * Validate that required values are present after merging config and args
- */
-export declare function validateRequiredConfig<T extends Record<string, any>>(mergedConfig: T, requiredFields: (keyof T)[]): void;

package/dist/figma/api.d.ts

@@ -1,71 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-type Color = {
-    r: number;
-    g: number;
-    b: number;
-    a: number;
-};
-type FileId = string;
-type NodeId = string;
-export type FigmaNode = ({
-    type: "RECTANGLE";
-    fills: {
-        type: "SOLID";
-        color: Color;
-    }[];
-    effects: {
-        type: "DROP_SHADOW";
-        offset: {
-            x: number;
-            y: number;
-        };
-        color: Color;
-        radius: number;
-    }[];
-} | {
-    type: "TEXT";
-    style: {
-        fontFamily: string;
-        fontWeight: number;
-        fontSize: number;
-        letterSpacing: number;
-        lineHeightPx: number;
-    };
-}) & {
-    name: string;
-    id: string;
-};
-export declare const createAPI: (figmaToken: string) => {
-    file: {
-        fetch: (fileId: FileId) => Promise<any>;
-    };
-    nodes: {
-        fetch: (fileId: FileId, ids: NodeId[]) => Promise<any>;
-    };
-    styles: {
-        fetch: (fileId: FileId) => Promise<{
-            nodes: {
-                document: FigmaNode;
-            }[];
-        }>;
-    };
-    /**
-     * Given a root node, fetches all exports of the nodes in the tree.
-     * This is especially useful to fetch all icons or assets from a design system.
-     */
-    images: {
-        fetch: (fileId: FileId, nodeIds: string[], { onFetchSources, onFetchImage, }?: {
-            onFetchSources?: ((sources: {
-                name: string;
-                format: string;
-            }[]) => void) | undefined;
-            onFetchImage?: ((url: string) => void) | undefined;
-        }) => Promise<{
-            data: string | Buffer;
-            name: string;
-            format: string;
-        }[]>;
-    };
-};
-export {};

package/dist/figma/cli.d.ts

@@ -1,20 +0,0 @@
-/**
- * This script downloads the assets from Figma and saves them into the repository.
- * It is configured via the unified ixt configuration system.
- *
- * @example ixt.config.js
- * import { defineConfig } from '@interactivethings/scripts';
- *
- * export default defineConfig({
- *   figma: {
- *     assets: [{
- *       name: "illustrations",
- *       url: "https://www.figma.com/design/ElWWZIcOGFhiT06rzfIwRO/Design-System?node-id=11861-10071",
- *       output: "src/assets/illustrations"
- *     }]
- *   }
- * });
- */
-import { ArgumentParser } from "argparse";
-export declare const configParser: (parser: ArgumentParser) => void;
-export declare const run: (parser: ArgumentParser) => Promise<void>;

package/dist/figma/optimizeImage.js

@@ -1,53 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.optimizeImage = void 0;
-const child_process_1 = require("child_process");
-const path = __importStar(require("path"));
-const optimizeImage = async (filepath) => {
-    try {
-        const extension = path.extname(filepath).toLowerCase();
-        const binaryForExtensions = new Map([
-            [".png", "optipng"],
-            [".jpg", "jpegoptim"],
-        ]);
-        const binaryName = binaryForExtensions.get(extension);
-        if (!binaryName) {
-            // console.log(`No optimizer found for ${extension}, skipping optimization`);
-            return;
-        }
-        const binaryPath = (0, child_process_1.execSync)(`which ${binaryName}`).toString().trim();
-        if (!binaryPath) {
-            throw new Error(`Cannot find ${binaryName} in PATH. Please install it.`);
-        }
-        console.log(`Optimizing with ${filepath} with ${binaryName}`);
-        await (0, child_process_1.execSync)(`${binaryPath} "${filepath}"`);
-        console.log(`Image optimized successfully: ${filepath}`);
-    }
-    catch (error) {
-        console.error(`Error optimizing image ${filepath}: ${error instanceof Error ? error.message : error}`);
-    }
-};
-exports.optimizeImage = optimizeImage;

package/dist/figma/utils.d.ts

@@ -1,10 +0,0 @@
-/**
- * Should parse a URL in the form https://www.figma.com/design/ElWWZIcOGFhiT06rzfIwRO/Design-System-%5BTPW-Mobile-App%5D?node-id=10404-19140&p=f&t=K5K37NzOSt1uwjsX-0
- * and extracts the pageId and nodeId
- * The page id is the part just after /design
- */
-export declare const parseFigmaURL: (urlString: string) => {
-    figmaFileId: string;
-    figmaPageId: string;
-};
-export declare const formatFigmaURL: (figmaFileId: string, figmaPageId: string) => string;

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @interactivethings/scripts
- *
- * A collection of useful development tools by Interactive Things
- */
-export * from "./types";
-export { defineConfig, type IxtConfig, type FigmaConfig, type TokensStudioConfig, } from "./config";
-export * as tokensStudio from "./tokens-studio";

package/dist/init/cli.d.ts

@@ -1,3 +0,0 @@
-import { ArgumentParser } from "argparse";
-export declare function configParser(parser: ArgumentParser): void;
-export declare function run(mainParser: ArgumentParser): Promise<void>;

package/dist/mui-tokens-studio.js

@@ -1,177 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * This script transforms tokens exported with tokens-studio in Figma into
- * a format that is easier to work with when using MUI.
- * You can run it via `pnpm run design:tokens`
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs = require("fs");
-const argparse_1 = require("argparse");
-const remeda_1 = require("remeda");
-const simplifyValues = (x) => {
-    if (typeof x === "string") {
-        return x;
-    }
-    else if (typeof x === "object" && !!x) {
-        if ("value" in x) {
-            return x.value;
-        }
-        else {
-            return (0, remeda_1.mapValues)(x, simplifyValues);
-        }
-    }
-};
-const kebabCase = (x) => {
-    return x
-        .split(" ")
-        .map((t, i) => {
-        if (i === 0) {
-            return t.toLowerCase();
-        }
-        else {
-            return `${t[0].toUpperCase()}${t.substring(1).toLowerCase()}`;
-        }
-    })
-        .join("");
-};
-const renameColorKeys = (k) => {
-    return kebabCase(k
-        .replace(/-[a-zA-Z0-9]+/, "")
-        .replace(" - ", " ")
-        .replace(",", "")
-        .replace(/^\d+\s+/, ""));
-};
-const renameColorKeysEntries = (obj) => {
-    const visitor = (k, v) => {
-        if (typeof v === "object") {
-            return [renameColorKeys(k), mapEntries(v, visitor)];
-        }
-        else {
-            return [renameColorKeys(k), v];
-        }
-    };
-    return mapEntries(obj, visitor);
-};
-const mapEntries = (x, mapper) => {
-    return Object.fromEntries(Object.entries(x).map(([k, v]) => mapper(k, v)));
-};
-const getPalette = (tokensData) => {
-    const data = tokensData.global;
-    const colorKeys = ["Base", "Functional"];
-    let palette = (0, remeda_1.pick)(data, colorKeys);
-    palette = (0, remeda_1.mapValues)(palette, simplifyValues);
-    palette = renameColorKeysEntries(palette);
-    palette = {
-        ...palette.base,
-        ...(0, remeda_1.pick)(palette, ["functional"]),
-    };
-    return palette;
-};
-const getTypography = (tokensData) => {
-    const sizes = ["Desktop", "Mobile"];
-    const res = {};
-    const index = {};
-    for (const k of [
-        "fontFamilies",
-        "lineHeights",
-        "fontWeights",
-        "fontSize",
-        "letterSpacing",
-        "textDecoration",
-    ]) {
-        for (const [vName, value] of Object.entries(tokensData.global[k])) {
-            index[`${k}.${vName}`] = value;
-        }
-    }
-    const maybeParseToNumber = (x) => {
-        const parsed = Number(x);
-        if (Number.isNaN(x)) {
-            return x;
-        }
-        else {
-            return parsed;
-        }
-    };
-    const maybeParseToPx = (x) => {
-        if (typeof x === "number") {
-            return `${x}px`;
-        }
-        else {
-            return x;
-        }
-    };
-    const cleanupFns = {
-        fontWeight: (x) => {
-            const lowered = x.toLowerCase();
-            if (lowered == "regular") {
-                return 400;
-            }
-            return lowered;
-        },
-        fontSize: maybeParseToNumber,
-        lineHeight: (x) => maybeParseToPx(maybeParseToNumber(x)),
-        paragraphSpacing: maybeParseToNumber,
-        letterSpacing: maybeParseToNumber,
-    };
-    const cleanup = (k, v) => {
-        if (k in cleanupFns) {
-            return [k, cleanupFns[k](v)];
-        }
-        else {
-            return [k, v];
-        }
-    };
-    const resolve = (str) => {
-        if (str[0] === "{" && str[str.length - 1] === "}") {
-            const path = str.substring(1, str.length - 1);
-            return index[path]?.value;
-        }
-        else {
-            return str;
-        }
-    };
-    for (const size of sizes) {
-        const typographies = tokensData.global[size];
-        for (const [typo, typoDataRaw] of Object.entries(typographies)) {
-            const typoData = typoDataRaw;
-            const typoKey = kebabCase(typo.toLowerCase());
-            res[typoKey] = res[typoKey] || {};
-            res[typoKey][size.toLowerCase()] = mapEntries((0, remeda_1.mapValues)(typoData.value, resolve), cleanup);
-        }
-    }
-    return res;
-};
-const getShadows = (tokenData) => {
-    const transformShadow = (shadowData) => {
-        const { color, x, y, blur, spread } = shadowData;
-        return `${x}px ${y}px ${blur}px ${spread}px ${color}`;
-    };
-    const shadows = mapEntries(tokenData.global.Elevation, (k, v) => [
-        `${Number(k.replace("dp", "").replace("pd", ""))}`,
-        Array.isArray(v.value)
-            ? v.value.map(transformShadow).join(", ")
-            : transformShadow(v.value),
-    ]);
-    return shadows;
-};
-const transform = (tokenData) => {
-    const palette = getPalette(tokenData);
-    const typography = getTypography(tokenData);
-    const shadows = getShadows(tokenData);
-    return {
-        palette,
-        typography,
-        shadows,
-    };
-};
-const main = () => {
-    const parser = new argparse_1.ArgumentParser();
-    parser.add_argument("input");
-    parser.add_argument("output");
-    const args = parser.parse_args();
-    const content = JSON.parse(fs.readFileSync(args.input).toString());
-    const transformed = transform(content);
-    fs.writeFileSync(args.output === "-" ? process.stdout.fd : args.output, JSON.stringify(transformed, null, 2));
-};
-main();