arloui 0.1.3

package/dist/index.d.cts

@@ -0,0 +1,323 @@
+import { z } from 'zod';
+
+declare const CONFIG_FILE = "arlo.json";
+declare const arloConfigSchema: z.ZodObject<{
+    $schema: z.ZodString;
+    /** URL of the registry index — defaults to the public CDN. */
+    registry: z.ZodString;
+    /** Where to write component files (relative to project root). */
+    aliases: z.ZodObject<{
+        components: z.ZodString;
+        tokens: z.ZodString;
+        theme: z.ZodString;
+        lib: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        components: string;
+        tokens: string;
+        theme: string;
+        lib: string;
+    }, {
+        components: string;
+        tokens: string;
+        theme: string;
+        lib: string;
+    }>;
+    /** Style preference. Reserved for future variants (e.g. `compact`). */
+    style: z.ZodLiteral<"default">;
+}, "strict", z.ZodTypeAny, {
+    $schema: string;
+    registry: string;
+    aliases: {
+        components: string;
+        tokens: string;
+        theme: string;
+        lib: string;
+    };
+    style: "default";
+}, {
+    $schema: string;
+    registry: string;
+    aliases: {
+        components: string;
+        tokens: string;
+        theme: string;
+        lib: string;
+    };
+    style: "default";
+}>;
+type ArloConfig = z.infer<typeof arloConfigSchema>;
+declare const DEFAULT_CONFIG: ArloConfig;
+declare function loadConfig(cwd: string): Promise<ArloConfig | null>;
+declare function saveConfig(cwd: string, config: ArloConfig): Promise<void>;
+
+/**
+ * Runtime validation for everything the CLI fetches from a registry.
+ *
+ * The registry is a *remote*, user-configurable URL — `add.ts` turns whatever
+ * comes back into files written onto the user's disk. We therefore never trust
+ * the shape of that JSON: every payload is parsed through these zod schemas
+ * before it is used, so a malformed (or malicious) registry produces a clear
+ * error instead of a confusing crash or an unsafe write.
+ *
+ * The shapes mirror `@arloui/registry`'s `schema.ts` and the output of
+ * `tooling/build-registry`.
+ */
+
+/** A fully-resolved entry as served at `<base>/<name>.json`. */
+declare const resolvedRegistryEntrySchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        target: z.ZodString;
+        source: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["component", "utility", "theme", "tokens", "example"]>>;
+        content: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        target: string;
+        content: string;
+        type?: "tokens" | "theme" | "utility" | "component" | "example" | undefined;
+        source?: string | undefined;
+    }, {
+        target: string;
+        content: string;
+        type?: "tokens" | "theme" | "utility" | "component" | "example" | undefined;
+        source?: string | undefined;
+    }>, "many">;
+    hash: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<["primitive", "pattern", "foundation", "icon"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nativeDeps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        setup: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        setup: string;
+    }, {
+        name: string;
+        setup: string;
+    }>, "many">>;
+    meta: z.ZodOptional<z.ZodObject<{
+        figma: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        figma?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        figma?: string | undefined;
+        tags?: string[] | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    kind: "primitive" | "pattern" | "foundation" | "icon";
+    title: string;
+    description: string;
+    files: {
+        target: string;
+        content: string;
+        type?: "tokens" | "theme" | "utility" | "component" | "example" | undefined;
+        source?: string | undefined;
+    }[];
+    hash: string;
+    registryDependencies?: string[] | undefined;
+    dependencies?: string[] | undefined;
+    nativeDeps?: {
+        name: string;
+        setup: string;
+    }[] | undefined;
+    meta?: {
+        figma?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}, {
+    name: string;
+    kind: "primitive" | "pattern" | "foundation" | "icon";
+    title: string;
+    description: string;
+    files: {
+        target: string;
+        content: string;
+        type?: "tokens" | "theme" | "utility" | "component" | "example" | undefined;
+        source?: string | undefined;
+    }[];
+    hash: string;
+    registryDependencies?: string[] | undefined;
+    dependencies?: string[] | undefined;
+    nativeDeps?: {
+        name: string;
+        setup: string;
+    }[] | undefined;
+    meta?: {
+        figma?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}>;
+declare const registryIndexSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    generatedAt: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["primitive", "pattern", "foundation", "icon"]>;
+        title: z.ZodString;
+        description: z.ZodString;
+        registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        nativeDeps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            setup: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            setup: string;
+        }, {
+            name: string;
+            setup: string;
+        }>, "many">>;
+        meta: z.ZodOptional<z.ZodObject<{
+            figma: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        }, {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        kind: "primitive" | "pattern" | "foundation" | "icon";
+        title: string;
+        description: string;
+        registryDependencies?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        nativeDeps?: {
+            name: string;
+            setup: string;
+        }[] | undefined;
+        meta?: {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }, {
+        name: string;
+        kind: "primitive" | "pattern" | "foundation" | "icon";
+        title: string;
+        description: string;
+        registryDependencies?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        nativeDeps?: {
+            name: string;
+            setup: string;
+        }[] | undefined;
+        meta?: {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: string;
+    items: {
+        name: string;
+        kind: "primitive" | "pattern" | "foundation" | "icon";
+        title: string;
+        description: string;
+        registryDependencies?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        nativeDeps?: {
+            name: string;
+            setup: string;
+        }[] | undefined;
+        meta?: {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+    generatedAt?: string | undefined;
+}, {
+    version: string;
+    items: {
+        name: string;
+        kind: "primitive" | "pattern" | "foundation" | "icon";
+        title: string;
+        description: string;
+        registryDependencies?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        nativeDeps?: {
+            name: string;
+            setup: string;
+        }[] | undefined;
+        meta?: {
+            figma?: string | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+    generatedAt?: string | undefined;
+}>;
+type ResolvedRegistryEntry = z.infer<typeof resolvedRegistryEntrySchema>;
+type RegistryIndex = z.infer<typeof registryIndexSchema>;
+
+/** Subset of the global `fetch` we depend on — injectable so tests can stub it. */
+type FetchLike = (input: string, init?: {
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    json: () => Promise<unknown>;
+}>;
+type RegistryClientOptions = {
+    /** Abort a request that takes longer than this (ms). Default 15s. */
+    timeoutMs?: number;
+    /** Override the fetch implementation (tests / custom transports). */
+    fetch?: FetchLike;
+};
+declare class RegistryClient {
+    private readonly base;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(base: string, options?: RegistryClientOptions);
+    index(): Promise<RegistryIndex>;
+    get(name: string): Promise<ResolvedRegistryEntry>;
+    /**
+     * Returns the entry plus all transitive registry dependencies, deduped and
+     * ordered foundation → primitive → pattern → icon so dependencies are written
+     * before the components that rely on them. Safe against dependency cycles.
+     */
+    resolve(name: string): Promise<ResolvedRegistryEntry[]>;
+    private fetchJson;
+}
+
+type Options$3 = {
+    cwd: string;
+    names: string[];
+    yes?: boolean;
+    overwrite?: boolean;
+};
+declare function add({ cwd, names, yes, overwrite }: Options$3): Promise<void>;
+
+type Options$2 = {
+    cwd: string;
+    name?: string;
+};
+/**
+ * Compare locally-installed component files to the latest registry version.
+ * This is the equivalent of `shadcn diff` — it does NOT modify files. It just
+ * surfaces drift so the user can decide whether to re-run `add --overwrite`.
+ */
+declare function diff({ cwd, name }: Options$2): Promise<void>;
+
+type Options$1 = {
+    cwd: string;
+    yes?: boolean;
+};
+declare function init({ cwd, yes }: Options$1): Promise<void>;
+
+type Options = {
+    cwd: string;
+};
+declare function list({ cwd }: Options): Promise<void>;
+
+export { type ArloConfig, CONFIG_FILE, DEFAULT_CONFIG, RegistryClient, add, diff, init, list, loadConfig, saveConfig };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "arloui",
+  "version": "0.1.3",
+  "description": "Arlo UI CLI — copy-paste React Native components, tokens, and patterns into your Expo or bare RN app.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.cts",
+      "import": "./dist/index.cjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "arloui": "dist/cli.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://arloui.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Base16-Labs/arloui.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "ui",
+    "components",
+    "design-system",
+    "shadcn",
+    "tailwind-ui"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "clean": "rm -rf dist .turbo",
+    "start": "node dist/cli.cjs"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "commander": "^12.1.0",
+    "kleur": "^4.1.5",
+    "ora": "^8.1.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@arloui/eslint-config": "file:../eslint-config",
+    "@arloui/registry": "file:../registry",
+    "@arloui/tsconfig": "file:../tsconfig",
+    "@types/node": "^20.16.10",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.9"
+  }
+}