@tokens-studio/tokenscript-schemas 0.1.1 → 0.1.3

package/README.md

@@ -39,12 +39,19 @@ npx @tokens-studio/tokenscript-schemas bundle --config schemas.json
 # Preview what would be bundled (dry-run)
 npx @tokens-studio/tokenscript-schemas bundle oklch-color rgb-color --dry-run
 
+# Bundle from custom schema directory
+npx @tokens-studio/tokenscript-schemas bundle type:my-color -o ./schemas.js --schemas-dir ./my-schemas
+
 # List available schemas
 npx @tokens-studio/tokenscript-schemas list
 npx @tokens-studio/tokenscript-schemas list --types
 npx @tokens-studio/tokenscript-schemas list --functions
 ```
 
+#### Docs
+
+- [Custom Schema Directories Documentation](docs/cli/custom-schemas.md) - Bundle schemas from custom directories
+
 ### Available Presets
 
 - **`preset:css`** - Modern CSS color types (CSS Color Level 4+)
@@ -120,19 +127,36 @@ src/schemas/types/srgb-color/
 - Tests use runtime bundling - no build step required
 - The bundler inlines script content for distribution
 
+## Working with Custom Schemas
+
+You can use the bundler with your own custom schema directories, useful for:
+- Developing experimental schemas without modifying the main repository
+- Working with schemas from external projects
+- Testing new color types before committing them
+
+See **[Custom Schema Directories Documentation](docs/cli/custom-schemas.md)** for detailed examples and usage.
+
+```bash
+# Bundle from custom directory
+npm run cli -- bundle my-color -o ./output.js --schemas-dir ./path/to/custom/schemas
+
+# Build from custom directory
+npm run build-schemas -- --schemas-dir ./path/to/custom/schemas
+```
+
 ## Scripts
 
-### Bundle Schemas
+### Build Schemas
 
 ```bash
-npm run bundle
+npm run build-schemas
 ```
 
-Bundles all schemas using the **shared bundling logic** from `@/bundler/bundle-schema.ts`:
+Builds all schemas using the **shared build logic** from `@/bundler/build-schema.ts`:
 - Reads `schema.json` from each schema directory
 - Finds all `./file.tokenscript` references in the schema
 - Reads and inlines the script file content
-- Outputs bundled schemas to `bundled/` directory:
+- Outputs built schemas to `result/` directory:
   - `registry.json` - Complete registry
   - `types.json` - All type schemas
   - `functions.json` - All function schemas
@@ -163,9 +187,9 @@ npm test -- src/schemas/types/rgb-color/unit.test.ts
 - Logs are **disabled by default** to reduce noise (only errors shown)
 - Use `LOG_LEVEL` environment variable to enable logs: `debug`, `info`, `warn`, `error`
 - See [tests/helpers/LOGGING.md](tests/helpers/LOGGING.md) for detailed logging documentation
-- Tests use `bundleSchemaFromDirectory()` from `@/bundler/bundle-schema.ts`
-- No build step required - schemas are bundled on-demand
-- Same bundling logic as build-time for consistency
+- Tests use `buildSchemaFromDirectory()` from `@/bundler/build-schema.ts`
+- No build step required - schemas are built on-demand
+- Same build logic as build-time for consistency
 
 ## Links
 

package/dist/cli/index.cjs

@@ -6,7 +6,7 @@ var ulog = require('ulog');
 var promises = require('fs/promises');
 var path = require('path');
 var url = require('url');
-var child_process = require('child_process');
+require('child_process');
 var fs = require('fs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -64,7 +64,7 @@ function expandPresetSchemas(schemas) {
   }
   return expanded;
 }
-async function bundleSchemaFromDirectory(schemaDir, options) {
+async function buildSchemaFromDirectory(schemaDir, options) {
   const schemaJsonPath = path.join(schemaDir, "schema.json");
   const schemaContent = await promises.readFile(schemaJsonPath, "utf-8");
   const schema = JSON.parse(schemaContent);
@@ -290,7 +290,7 @@ async function collectRequiredSchemas(slugOrUri, type, options = {}) {
       const categoryDir = effectiveType === "type" ? "types" : "functions";
       const resolvedSchemasDir = schemasDir || process.env.SCHEMAS_DIR || path.join(process.cwd(), "src/schemas");
       const schemaDir = path.join(resolvedSchemasDir, categoryDir, slug);
-      spec = await bundleSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : void 0);
+      spec = await buildSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : void 0);
     } catch (error) {
       log.warn(`Failed to load schema ${slug} (${effectiveType}):`, error);
       return;
@@ -344,7 +344,7 @@ async function collectDependencyTree(schemas, options = {}) {
     const resolvedSchemasDir = schemasDir || process.env.SCHEMAS_DIR || path.join(process.cwd(), "src/schemas");
     const schemaDir = path.join(resolvedSchemasDir, categoryDir, schema.slug);
     try {
-      const spec = await bundleSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : void 0);
+      const spec = await buildSchemaFromDirectory(schemaDir, baseUrl ? { baseUrl } : void 0);
       const requirements = extractRequirements(spec, extractOptions);
       const dependencySlugs = requirements.map((uri) => {
         const ref = resolveSchemaReference(uri);
@@ -418,7 +418,7 @@ async function bundleSelectiveSchemas(options) {
   const bundledSchemas = [];
   for (const typeSlug of deps.types) {
     const schemaDir = path.join(schemasDir, "types", typeSlug);
-    const bundled = await bundleSchemaFromDirectory(schemaDir, { baseUrl });
+    const bundled = await buildSchemaFromDirectory(schemaDir, { baseUrl });
     if (bundled.type === "color") {
       const uri = `${baseUrl}/api/v1/core/${typeSlug}/0/`;
       bundledSchemas.push({
@@ -429,7 +429,7 @@ async function bundleSelectiveSchemas(options) {
   }
   for (const funcSlug of deps.functions) {
     const schemaDir = path.join(schemasDir, "functions", funcSlug);
-    const bundled = await bundleSchemaFromDirectory(schemaDir, { baseUrl });
+    const bundled = await buildSchemaFromDirectory(schemaDir, { baseUrl });
     if (bundled.type === "function") {
       const uri = `${baseUrl}/api/v1/function/${funcSlug}/0/`;
       bundledSchemas.push({
@@ -474,26 +474,6 @@ function validateBundleConfig(data) {
 }
 var __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
 var __dirname$1 = path.dirname(__filename$1);
-function getGitSha() {
-  try {
-    return child_process.execSync("git rev-parse --short HEAD", {
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "ignore"]
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-function isGitRepo() {
-  try {
-    child_process.execSync("git rev-parse --git-dir", {
-      stdio: ["pipe", "pipe", "ignore"]
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
 function getPackageVersion() {
   try {
     const paths = [
@@ -516,13 +496,12 @@ function getPackageVersion() {
 }
 function getVersionInfo() {
   const githubUrl = "https://github.com/tokens-studio/tokenscript-schemas";
-  const isLocal = isGitRepo();
+  const packageVersion = getPackageVersion();
   let version;
-  if (isLocal) {
-    const sha = getGitSha();
-    version = sha ? `local-${sha}` : "local";
-  } else {
-    version = getPackageVersion();
+  let isLocal;
+  {
+    version = `@tokens-studio/tokenscript-schemas@v${packageVersion}`;
+    isLocal = false;
   }
   return {
     version,
@@ -647,7 +626,7 @@ function findSchemasDir() {
   return fromDist;
 }
 async function bundleSchemas(schemas, schemasDir, cliArgs) {
-  const resolvedSchemasDir = findSchemasDir();
+  const resolvedSchemasDir = schemasDir || findSchemasDir();
   log2.info("Bundling schemas:", schemas);
   log2.debug("Schemas directory:", resolvedSchemasDir);
   const result = await bundleSelectiveSchemas({
@@ -698,9 +677,16 @@ async function handleBundleCommand(schemas, options = {}) {
     if (options.dryRun) {
       cliArgs.push("--dry-run");
     }
+    if (options.schemasDir) {
+      cliArgs.push("--schemas-dir", options.schemasDir);
+    }
+    const customSchemasDir = options.schemasDir;
+    if (customSchemasDir) {
+      log2.info(`Using custom schema directory: ${customSchemasDir}`);
+    }
     const { output, metadata, dependencyTree } = await bundleSchemas(
       configSchemas,
-      void 0,
+      customSchemasDir,
       cliArgs
     );
     console.log("");
@@ -853,7 +839,7 @@ async function handlePresetsCommand() {
 // src/cli/index.ts
 var log5 = ulog__default.default("cli");
 var cli = cac__default.default("tokenscript-schemas");
-cli.command("bundle [...schemas]", "Bundle schemas into a JS file").option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path", { default: "./tokenscript-schemas.js" }).option("-d, --dry-run", "Preview what would be bundled without writing").action(async (schemas, options) => {
+cli.command("bundle [...schemas]", "Bundle schemas into a JS file").option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path", { default: "./tokenscript-schemas.js" }).option("-d, --dry-run", "Preview what would be bundled without writing").option("-s, --schemas-dir <path>", "Custom schema directory (overrides default)").action(async (schemas, options) => {
   try {
     await handleBundleCommand(schemas, options);
   } catch (error) {