@gesslar/sassy 0.21.1 → 0.21.3

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@gesslar/sassy",
-  "version": "0.21.1",
+  "version": "0.21.3",
   "displayName": "Sassy",
   "description": "Make gorgeous themes that speak as boldly as you do.",
   "publisher": "gesslar",
   "license": "Unlicense",
   "type": "module",
-  "main": "src/cli.js",
+  "main": "src/index.js",
   "bin": "src/cli.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./cli": "./src/cli.js"
+  },
   "files": [
     "src/",
     "UNLICENSE.txt"
@@ -43,6 +47,7 @@
   ],
   "dependencies": {
     "@gesslar/colours": "^0.0.1",
+    "@gesslar/toolkit": "^0.0.3",
     "chokidar": "^4.0.3",
     "color-support": "^1.1.3",
     "commander": "^14.0.1",
@@ -52,13 +57,13 @@
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@stylistic/eslint-plugin": "^5.3.1",
+    "@stylistic/eslint-plugin": "^5.4.0",
     "@types/vscode": "^1.104.0",
     "@typescript-eslint/eslint-plugin": "^8.44.0",
     "@typescript-eslint/parser": "^8.44.0",
     "esbuild": "^0.25.10",
-    "eslint": "^9.35.0",
-    "eslint-plugin-jsdoc": "^59.0.1",
+    "eslint": "^9.36.0",
+    "eslint-plugin-jsdoc": "^60.1.0",
     "typescript": "^5.9.2"
   }
 }

package/src/BuildCommand.js

@@ -1,10 +1,9 @@
 import {EventEmitter} from "node:events"
 import process from "node:process"
 
+import {Sass, Term} from "@gesslar/toolkit"
 import Command from "./Command.js"
-import Sass from "./Sass.js"
 import Session from "./Session.js"
-import Term from "./Term.js"
 import Theme from "./Theme.js"
 
 /**

package/src/Colour.js

@@ -13,10 +13,8 @@ import {
   parse
 } from "culori"
 
-import Sass from "./Sass.js"
+import {Util, Sass} from "@gesslar/toolkit"
 import ThemeToken from "./ThemeToken.js"
-import Util from "./Util.js"
-
 // Cache for parsed colours to improve performance
 const _colourCache = new Map()
 

package/src/Command.js

@@ -1,7 +1,4 @@
-import Sass from "./Sass.js"
-import FileObject from "./FileObject.js"
-import DirectoryObject from "./DirectoryObject.js"
-import Cache from "./Cache.js"
+import {Sass, FileObject, DirectoryObject, Cache} from "@gesslar/toolkit"
 
 /**
  * Base class for command-line interface commands.

package/src/Compiler.js

@@ -11,14 +11,9 @@
  * Supports extension points for custom phases and output formats.
  */
 
-import Sass from "./Sass.js"
-import Data from "./Data.js"
+import {Sass, Data, File, FileObject, Term, Util} from "@gesslar/toolkit"
 import Evaluator from "./Evaluator.js"
-import File from "./File.js"
-import FileObject from "./FileObject.js"
-import Term from "./Term.js"
 import Theme from "./Theme.js"
-import Util from "./Util.js"
 
 /**
  * Main compiler class for processing theme source files.

package/src/Evaluator.js

@@ -13,7 +13,7 @@
 
 import {parse} from "culori"
 
-import Sass from "./Sass.js"
+import {Sass} from "@gesslar/toolkit"
 import Colour from "./Colour.js"
 import ThemePool from "./ThemePool.js"
 import ThemeToken from "./ThemeToken.js"

package/src/LintCommand.js

@@ -20,9 +20,8 @@ import c from "@gesslar/colours"
 
 import Command from "./Command.js"
 import Evaluator from "./Evaluator.js"
-import File from "./File.js"
-import Term from "./Term.js"
 import Theme from "./Theme.js"
+import {Term} from "@gesslar/toolkit"
 import ThemePool from "./ThemePool.js"
 
 // oops, need to have @gesslar/colours support this, too!

package/src/ResolveCommand.js

@@ -2,13 +2,10 @@ import c from "@gesslar/colours"
 // import colorSupport from "color-support"
 
 import Command from "./Command.js"
-import Sass from "./Sass.js"
+import {Sass, Term, Util, Data} from "@gesslar/toolkit"
 import Colour from "./Colour.js"
 import Evaluator from "./Evaluator.js"
-import Term from "./Term.js"
 import Theme from "./Theme.js"
-import Util from "./Util.js"
-import Data from "./Data.js"
 
 // ansiColors.enabled = colorSupport.hasBasic
 
@@ -436,10 +433,10 @@ export default class ResolveCommand extends Command {
 
     if(this.#func.test(value)) {
       const result = Evaluator.extractFunctionCall(value)
-      
+
       if(!result)
         return [c`{leaf}${value}{/}`, "literal"]
-        
+
       const {func, args} = result
 
       return [

package/src/Session.js

@@ -1,11 +1,8 @@
 import chokidar from "chokidar"
 
 import Command from "./Command.js"
-import Sass from "./Sass.js"
-import File from "./File.js"
-import Term from "./Term.js"
+import {Sass, File, Term, Util} from "@gesslar/toolkit"
 import Theme from "./Theme.js"
-import Util from "./Util.js"
 
 /**
  * @typedef {object} SessionOptions

package/src/Theme.js

@@ -13,15 +13,9 @@
  * - Write output files, supporting dry-run and hash-based skip
  * - Support watch mode for live theme development
  */
-import Sass from "./Sass.js"
+import {Sass, DirectoryObject, File, FileObject, Term, Util, Cache} from "@gesslar/toolkit"
 import Compiler from "./Compiler.js"
-import DirectoryObject from "./DirectoryObject.js"
-import File from "./File.js"
-import FileObject from "./FileObject.js"
-import Term from "./Term.js"
 import ThemePool from "./ThemePool.js"
-import Util from "./Util.js"
-import Cache from "./Cache.js"
 
 const outputFileExtension = "color-theme.json"
 const obviouslyASentinelYouCantMissSoShutUpAboutIt = "kakadoodoo"

package/src/ThemePool.js

@@ -6,7 +6,7 @@
  * Manages resolved values, raw resolutions, and token relationships during theme compilation.
  */
 
-import Sass from "./Sass.js"
+import {Sass} from "@gesslar/toolkit"
 import ThemeToken from "./ThemeToken.js"
 
 /**

package/src/ThemeToken.js

@@ -7,7 +7,7 @@
  * management, pool integration, and serialization during theme compilation.
  */
 
-import Sass from "./Sass.js"
+import {Sass} from "@gesslar/toolkit"
 import ThemePool from "./ThemePool.js"
 
 /**

package/src/cli.js

@@ -36,14 +36,10 @@ import process from "node:process"
 import url from "node:url"
 import c from "@gesslar/colours"
 
-import Cache from "./Cache.js"
-import Sass from "./Sass.js"
+import {Cache, Sass, DirectoryObject, FileObject, Term} from "@gesslar/toolkit"
 import BuildCommand from "./BuildCommand.js"
-import DirectoryObject from "./DirectoryObject.js"
-import FileObject from "./FileObject.js"
 import LintCommand from "./LintCommand.js"
 import ResolveCommand from "./ResolveCommand.js"
-import Term from "./Term.js"
 
 /**
  * Main application entry point.

package/src/index.js

@@ -0,0 +1,40 @@
+/**
+ * @file API entry point for @gesslar/sassy
+ *
+ * Exports classes and utilities for programmatic use by other npm packages.
+ *
+ * This allows other projects to import and use Sassy's functionality
+ * programmatically.
+ *
+ * @example
+ * // Import specific classes
+ * import { Theme, LintCommand, Compiler } from '@gesslar/sassy'
+ *
+ * // Import everything
+ * import * as Sassy from '@gesslar/sassy'
+ *
+ * // Create and use a Theme programmatically
+ * const theme = new Theme(fileObject)
+ * await theme.load('./my-theme.json5')
+ * await theme.build()
+ */
+
+// Core theme functionality
+export {default as Theme} from "./Theme.js"
+export {default as Compiler} from "./Compiler.js"
+export {default as Evaluator} from "./Evaluator.js"
+
+// Command classes for programmatic access
+export {default as Command} from "./Command.js"
+export {default as BuildCommand} from "./BuildCommand.js"
+export {default as LintCommand} from "./LintCommand.js"
+export {default as ResolveCommand} from "./ResolveCommand.js"
+
+// Data handling and utilities
+export {default as Session} from "./Session.js"
+
+// Color utilities
+export {default as Colour} from "./Colour.js"
+
+// Note: CLI functionality remains in cli.js and is accessible via the 'sassy'
+// command when installed globally or via npx

package/src/Cache.js

@@ -1,74 +0,0 @@
-import Sass from "./Sass.js"
-import File from "./File.js"
-import FileObject from "./FileObject.js"
-
-/**
- * File system cache for theme compilation data with automatic invalidation.
- * Provides intelligent caching of parsed JSON5/YAML files with mtime-based
- * cache invalidation to optimize parallel theme compilation performance.
- *
- * The cache eliminates redundant file reads and parsing when multiple themes
- * import the same dependency files, while ensuring data freshness through
- * modification time checking.
- */
-export default class Cache {
-  /** @type {Map<string, Date>} Map of file paths to last modification times */
-  #modifiedTimes = new Map()
-  /** @type {Map<string, object>} Map of file paths to parsed file data */
-  #dataCache = new Map()
-
-  /**
-   * Removes cached data for a specific file from both time and data maps.
-   * Used when files are modified or when cache consistency needs to be
-   * maintained.
-   *
-   * @private
-   * @param {FileObject} file - The file object to remove from cache
-   * @returns {void}
-   */
-  #cleanup(file) {
-    this.#modifiedTimes.delete(file.path)
-    this.#dataCache.delete(file.path)
-  }
-
-  /**
-   * Loads and caches parsed file data with automatic invalidation based on
-   * modification time.
-   *
-   * Implements a sophisticated caching strategy that checks file modification
-   * times to determine whether cached data is still valid, ensuring data
-   * freshness while optimizing performance for repeated file access during
-   * parallel theme compilation.
-   *
-   * @param {FileObject} fileObject - The file object to load and cache
-   * @returns {Promise<object>} The parsed file data (JSON5 or YAML)
-   * @throws {Sass} If the file cannot be found or accessed
-   */
-  async loadCachedData(fileObject) {
-    const lastModified = await File.fileModified(fileObject)
-
-    if(lastModified === null)
-      throw Sass.new(`Unable to find file '${fileObject.path}'`)
-
-    if(this.#modifiedTimes.has(fileObject.path)) {
-      const lastCached = this.#modifiedTimes.get(fileObject.path)
-
-      if(lastModified > lastCached) {
-        this.#cleanup(fileObject)
-      } else {
-        if(!(this.#dataCache.has(fileObject.path)))
-          this.#cleanup(fileObject)
-        else {
-          return this.#dataCache.get(fileObject.path)
-        }
-      }
-    }
-
-    const data = await File.loadDataFile(fileObject)
-
-    this.#modifiedTimes.set(fileObject.path, lastModified)
-    this.#dataCache.set(fileObject.path, data)
-
-    return data
-  }
-}