@tokens-studio/tokenscript-schemas 0.0.12 → 0.0.14

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Types for schema bundler
+ */
+interface SchemaFile {
+    path: string;
+    content: string;
+}
+interface SchemaBundle {
+    slug: string;
+    name: string;
+    type: "type" | "function";
+    version: string;
+    schema?: unknown;
+    scripts: Record<string, string>;
+    metadata: {
+        id: string;
+        description: string;
+        contentType: string | null;
+        originalVersion: string;
+    };
+}
+interface ScriptBlock {
+    type: string;
+    script: string;
+}
+interface Initializer {
+    title?: string;
+    keyword: string;
+    description?: string;
+    schema?: unknown;
+    script: ScriptBlock;
+}
+interface Conversion {
+    source: string;
+    target: string;
+    description?: string;
+    lossless: boolean;
+    script: ScriptBlock;
+}
+interface SpecProperty {
+    type: "number" | "string" | "color";
+}
+interface SpecSchema {
+    type: "object";
+    properties: Record<string, SpecProperty>;
+    required?: string[];
+    order?: string[];
+    additionalProperties?: boolean;
+}
+interface ColorSpecification {
+    name: string;
+    type: "color";
+    description?: string;
+    schema?: SpecSchema;
+    initializers: Initializer[];
+    conversions: Conversion[];
+    slug?: string;
+}
+interface FunctionSpecification {
+    name: string;
+    type: "function";
+    input?: {
+        type: "object";
+        properties?: Record<string, unknown>;
+    };
+    script: ScriptBlock;
+    keyword: string;
+    description?: string;
+    requirements?: string[];
+    slug?: string;
+}
+type SchemaSpecification = ColorSpecification | FunctionSpecification;
+interface BundledRegistry {
+    version: string;
+    types: ColorSpecification[];
+    functions: FunctionSpecification[];
+    metadata: {
+        generatedAt: string;
+        totalSchemas: number;
+    };
+}
+
+/**
+ * Schema bundler - bundles schemas for distribution
+ */
+
+/**
+ * Bundle all schemas from the schemas directory
+ */
+declare function bundleAllSchemas(schemasDir: string, outputDir: string): Promise<BundledRegistry>;
+
+/**
+ * Types for schema downloader
+ */
+interface LatestVersion {
+    id: string;
+    version: string;
+    created_at: string;
+}
+interface SchemaListItem {
+    id: string;
+    slug: string;
+    name: string;
+    description: string;
+    license_name: string | null;
+    type: "type" | "function";
+    latest: LatestVersion;
+}
+interface SchemaVersion {
+    id: string;
+    type: "type" | "function";
+    schema: string;
+    slug: string;
+    version: string;
+    content: unknown;
+    status?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface SchemaDetails {
+    id: string;
+    slug: string;
+    name: string;
+    description: string;
+    type: "type" | "function";
+    version: string;
+    content: unknown;
+    metadata?: Record<string, unknown>;
+}
+interface SchemaConfig {
+    apiBaseUrl: string;
+    outputDir: string;
+    targetVersion: string;
+}
+
+/**
+ * Schema downloader - fetches schemas from the TokenScript API
+ */
+
+declare const DEFAULT_CONFIG: SchemaConfig;
+/**
+ * Fetch all schemas from the API
+ */
+declare function fetchSchemaList(config?: SchemaConfig): Promise<SchemaListItem[]>;
+/**
+ * Fetch versions for a schema
+ */
+declare function fetchSchemaVersions(schemaSlug: string, config?: SchemaConfig): Promise<SchemaVersion[]>;
+/**
+ * Download and organize a single schema
+ */
+declare function downloadSchema(schema: SchemaListItem, config?: SchemaConfig): Promise<void>;
+/**
+ * Download all schemas from the API
+ */
+declare function downloadAllSchemas(config?: Partial<SchemaConfig>): Promise<void>;
+
+export { type BundledRegistry, type ColorSpecification, type Conversion, DEFAULT_CONFIG, type FunctionSpecification, type Initializer, type LatestVersion, type SchemaBundle, type SchemaConfig, type SchemaDetails, type SchemaFile, type SchemaListItem, type SchemaSpecification, type SchemaVersion, type ScriptBlock, type SpecProperty, type SpecSchema, bundleAllSchemas, downloadAllSchemas, downloadSchema, fetchSchemaList, fetchSchemaVersions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokens-studio/tokenscript-schemas",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Schema registry for TokenScript with bundled schemas and validation",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli/commands/bundle.ts

@@ -70,10 +70,7 @@ function formatDependencyTree(
         const isLastChild = idx === node.dependencies.length - 1;
         const childKey = dep;
 
-        if (visited.has(childKey)) {
-          const childPrefix = childIndent + (isLastChild ? "└── " : "├── ");
-          lines.push(`${childPrefix + childKey} (already visited)`);
-        } else {
+        if (!visited.has(childKey)) {
           formatNode(childKey, childIndent, isLastChild);
         }
       });

package/src/cli/commands/list.ts

@@ -5,7 +5,8 @@
 /// <reference types="../../../types/ulog" />
 
 import { readdir } from "node:fs/promises";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import anylogger from "ulog";
 
 const log = anylogger("list");
@@ -20,13 +21,44 @@ interface ListResult {
   functions: string[];
 }
 
+/**
+ * Find the schemas directory - works for both development/tests and installed package
+ */
+function findSchemasDir(): string {
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+
+  // From compiled dist/cli/index.js (bundled) to src/schemas
+  const fromDist = join(__dirname, "../../src/schemas");
+
+  // From source src/cli/commands/list.ts to src/schemas (for tests/dev)
+  const fromSource = join(__dirname, "../../schemas");
+
+  // Try to detect which one exists
+  try {
+    const fs = require("node:fs");
+    if (fs.existsSync(fromDist)) {
+      return fromDist;
+    }
+    if (fs.existsSync(fromSource)) {
+      return fromSource;
+    }
+  } catch {
+    // If fs checks fail, default to dist structure
+  }
+
+  // Default to dist structure (for installed package)
+  return fromDist;
+}
+
 /**
  * List all available schemas
  */
 export async function listSchemas(
-  schemasDir: string = join(process.cwd(), "src/schemas"),
+  schemasDir?: string,
   options: ListOptions = {},
 ): Promise<ListResult> {
+  const resolvedSchemasDir = schemasDir || findSchemasDir();
   const showTypes = options.types || (!options.types && !options.functions);
   const showFunctions = options.functions || (!options.types && !options.functions);
 
@@ -36,7 +68,7 @@ export async function listSchemas(
   // List type schemas
   if (showTypes) {
     try {
-      const typesDir = join(schemasDir, "types");
+      const typesDir = join(resolvedSchemasDir, "types");
       const typeEntries = await readdir(typesDir, { withFileTypes: true });
       types.push(
         ...typeEntries
@@ -52,7 +84,7 @@ export async function listSchemas(
   // List function schemas
   if (showFunctions) {
     try {
-      const functionsDir = join(schemasDir, "functions");
+      const functionsDir = join(resolvedSchemasDir, "functions");
       const funcEntries = await readdir(functionsDir, { withFileTypes: true });
       functions.push(
         ...funcEntries

package/src/cli/index.ts

@@ -45,6 +45,6 @@ cli
   });
 
 cli.help();
-cli.version("0.0.12");
+cli.version("0.0.14");
 
 cli.parse();