@knighted/css 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/cjs/css.d.cts

@@ -1,4 +1,4 @@
-import type { DependencyTreeOptions } from 'dependency-tree';
+import type { Options as DependencyTreeOpts } from 'dependency-tree';
 import { type TransformOptions as LightningTransformOptions } from 'lightningcss';
 export declare const DEFAULT_EXTENSIONS: string[];
 type LightningCssConfig = boolean | Partial<Omit<LightningTransformOptions<never>, 'code'>>;
@@ -11,7 +11,7 @@ export interface CssOptions {
     cwd?: string;
     filter?: (filePath: string) => boolean;
     lightningcss?: LightningCssConfig;
-    dependencyTree?: Partial<Omit<DependencyTreeOptions, 'filename' | 'directory'>>;
+    dependencyTree?: Partial<Omit<DependencyTreeOpts, 'filename' | 'directory'>>;
     resolver?: CssResolver;
     peerResolver?: PeerLoader;
 }

package/dist/cjs/loader.cjs

@@ -4,14 +4,7 @@ const css_js_1 = require("./css.cjs");
 const DEFAULT_EXPORT_NAME = 'knightedCss';
 const loader = async function loader(source) {
     const rawOptions = (typeof this.getOptions === 'function' ? this.getOptions() : {});
-    const queryParams = typeof this.resourceQuery === 'string' && this.resourceQuery.startsWith('?')
-        ? new URLSearchParams(this.resourceQuery.slice(1))
-        : undefined;
-    const queryExportName = queryParams?.get('exportName')?.trim();
-    const isValidIdentifier = typeof queryExportName === 'string' &&
-        /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(queryExportName);
-    const { exportName = DEFAULT_EXPORT_NAME, ...cssOptions } = rawOptions;
-    const resolvedExportName = isValidIdentifier ? queryExportName : exportName;
+    const cssOptions = rawOptions;
     const normalizedOptions = {
         ...cssOptions,
         cwd: cssOptions.cwd ?? this.rootContext ?? process.cwd(),
@@ -22,8 +15,11 @@ const loader = async function loader(source) {
         this.addDependency(file);
     }
     const input = typeof source === 'string' ? source : source.toString('utf8');
-    const injection = `\n\nexport const ${resolvedExportName} = ${JSON.stringify(css)};\n`;
-    const output = `${input}${injection}`;
+    const injection = `\n\nexport const ${DEFAULT_EXPORT_NAME} = ${JSON.stringify(css)};\n`;
+    const isStyleModule = this.resourcePath.endsWith('.css.ts');
+    const output = isStyleModule
+        ? `${injection}export default {};\n`
+        : `${input}${injection}`;
     return output;
 };
 exports.default = loader;

package/dist/cjs/loader.d.cts

@@ -1,11 +1,6 @@
 import type { LoaderDefinitionFunction } from 'webpack';
 import { type CssOptions } from './css.cjs';
 export interface KnightedCssLoaderOptions extends CssOptions {
-    /**
-     * Named export that will contain the compiled CSS string.
-     * Defaults to "knightedCss".
-     */
-    exportName?: string;
 }
 declare const loader: LoaderDefinitionFunction<KnightedCssLoaderOptions>;
 export default loader;

package/dist/css.d.ts

@@ -1,4 +1,4 @@
-import type { DependencyTreeOptions } from 'dependency-tree';
+import type { Options as DependencyTreeOpts } from 'dependency-tree';
 import { type TransformOptions as LightningTransformOptions } from 'lightningcss';
 export declare const DEFAULT_EXTENSIONS: string[];
 type LightningCssConfig = boolean | Partial<Omit<LightningTransformOptions<never>, 'code'>>;
@@ -11,7 +11,7 @@ export interface CssOptions {
     cwd?: string;
     filter?: (filePath: string) => boolean;
     lightningcss?: LightningCssConfig;
-    dependencyTree?: Partial<Omit<DependencyTreeOptions, 'filename' | 'directory'>>;
+    dependencyTree?: Partial<Omit<DependencyTreeOpts, 'filename' | 'directory'>>;
     resolver?: CssResolver;
     peerResolver?: PeerLoader;
 }

package/dist/loader.d.ts

@@ -1,11 +1,6 @@
 import type { LoaderDefinitionFunction } from 'webpack';
 import { type CssOptions } from './css.js';
 export interface KnightedCssLoaderOptions extends CssOptions {
-    /**
-     * Named export that will contain the compiled CSS string.
-     * Defaults to "knightedCss".
-     */
-    exportName?: string;
 }
 declare const loader: LoaderDefinitionFunction<KnightedCssLoaderOptions>;
 export default loader;

package/dist/loader.js

@@ -2,14 +2,7 @@ import { cssWithMeta } from './css.js';
 const DEFAULT_EXPORT_NAME = 'knightedCss';
 const loader = async function loader(source) {
     const rawOptions = (typeof this.getOptions === 'function' ? this.getOptions() : {});
-    const queryParams = typeof this.resourceQuery === 'string' && this.resourceQuery.startsWith('?')
-        ? new URLSearchParams(this.resourceQuery.slice(1))
-        : undefined;
-    const queryExportName = queryParams?.get('exportName')?.trim();
-    const isValidIdentifier = typeof queryExportName === 'string' &&
-        /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(queryExportName);
-    const { exportName = DEFAULT_EXPORT_NAME, ...cssOptions } = rawOptions;
-    const resolvedExportName = isValidIdentifier ? queryExportName : exportName;
+    const cssOptions = rawOptions;
     const normalizedOptions = {
         ...cssOptions,
         cwd: cssOptions.cwd ?? this.rootContext ?? process.cwd(),
@@ -20,8 +13,11 @@ const loader = async function loader(source) {
         this.addDependency(file);
     }
     const input = typeof source === 'string' ? source : source.toString('utf8');
-    const injection = `\n\nexport const ${resolvedExportName} = ${JSON.stringify(css)};\n`;
-    const output = `${input}${injection}`;
+    const injection = `\n\nexport const ${DEFAULT_EXPORT_NAME} = ${JSON.stringify(css)};\n`;
+    const isStyleModule = this.resourcePath.endsWith('.css.ts');
+    const output = isStyleModule
+        ? `${injection}export default {};\n`
+        : `${input}${injection}`;
     return output;
 };
 export default loader;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/css",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "A build-time utility that traverses JavaScript/TypeScript module dependency graphs to extract, compile, and optimize all imported CSS into a single, in-memory string.",
   "type": "module",
   "main": "./dist/css.js",
@@ -17,41 +17,26 @@
       "require": "./dist/cjs/loader.cjs"
     }
   },
-  "engines": {
-    "node": ">= 22.15.0",
-    "npm": ">= 10.9.0"
-  },
-  "engineStrict": true,
   "keywords": [
     "css",
-    "extract-css",
-    "styles",
     "dependency-graph",
-    "module-dependencies",
-    "lit",
-    "web-components",
-    "shadow-dom",
+    "build-time",
+    "compile",
+    "styles",
     "sass",
     "scss",
     "less",
     "vanilla-extract",
-    "lightningcss",
-    "build-time",
-    "static-analysis",
-    "css-in-js-zero-runtime"
+    "lightningcss"
   ],
   "scripts": {
     "build": "duel",
     "check-types": "tsc --noEmit",
     "test": "c8 --reporter=text --reporter=text-summary --reporter=lcov --include \"src/**/*.ts\" tsx --test test/**/*.test.ts",
-    "prettier": "prettier --write .",
-    "prettier:check": "prettier --check .",
-    "lint": "oxlint src test",
-    "prepack": "npm run build",
-    "prepare": "husky"
+    "prepack": "npm run build"
   },
   "dependencies": {
-    "dependency-tree": "^9.0.0",
+    "dependency-tree": "^11.2.0",
     "lightningcss": "^1.30.2"
   },
   "peerDependencies": {
@@ -70,24 +55,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@knighted/duel": "^2.1.6",
-    "@rspack/core": "^1.0.0",
-    "@types/less": "^3.0.8",
-    "@types/webpack": "^5.28.5",
-    "@vanilla-extract/css": "^1.15.2",
-    "@vanilla-extract/integration": "^8.0.6",
-    "@vanilla-extract/recipes": "^0.5.7",
-    "c8": "^10.1.2",
-    "husky": "^9.1.7",
-    "less": "^4.2.0",
-    "lint-staged": "^16.2.7",
-    "oxlint": "^0.4.1",
-    "prettier": "^3.7.4",
-    "sass": "^1.80.7",
-    "tsx": "^4.19.2",
-    "typescript": "^5.9.3"
-  },
   "files": [
     "dist"
   ],
@@ -99,15 +66,5 @@
   },
   "bugs": {
     "url": "https://github.com/knightedcodemonkey/css/issues"
-  },
-  "prettier": {
-    "arrowParens": "avoid",
-    "printWidth": 90,
-    "semi": false,
-    "singleQuote": true
-  },
-  "lint-staged": {
-    "*.{js,jsx,ts,tsx,mjs,cjs,cts,mts}": "oxlint",
-    "*.{js,jsx,ts,tsx,mjs,cjs,cts,mts,json,md,css,scss,html}": "prettier --check"
   }
 }

package/README.md

@@ -1,162 +0,0 @@
-# [`@knighted/css`](https://github.com/knightedcodemonkey/css)
-
-![CI](https://github.com/knightedcodemonkey/css/actions/workflows/ci.yml/badge.svg)
-[![codecov](https://codecov.io/gh/knightedcodemonkey/css/graph/badge.svg?token=q93Qqwvq6l)](https://codecov.io/gh/knightedcodemonkey/css)
-[![NPM version](https://img.shields.io/npm/v/@knighted/css.svg)](https://www.npmjs.com/package/@knighted/css)
-
-`@knighted/css` is a build-time helper that walks a JavaScript/TypeScript module graph, finds every CSS-like dependency (plain CSS, Sass/SCSS, Less, vanilla-extract), compiles them, and returns a single concatenated stylesheet string. It is designed for workflows where you want fully materialized styles ahead of time—feeding Lit components, server-rendered routes, static site builds, or any pipeline that needs all CSS for a specific entry point without running a full bundler.
-
-## Features
-
-- Traverses module graphs using [`dependency-tree`](https://github.com/dependents/node-dependency-tree) to find transitive style imports.
-- Compiles `*.css`, `*.scss`, `*.sass`, `*.less`, and `*.css.ts` (vanilla-extract) files out of the box.
-- Optional post-processing via [`lightningcss`](https://github.com/parcel-bundler/lightningcss) for minification, prefixing, and media query optimizations.
-- Pluggable resolver/filter hooks for custom module resolution (e.g., Rspack/Vite/webpack aliases) or selective inclusion.
-- Peer-resolution helper for optional toolchains (`sass`, `less`, `@vanilla-extract/integration`) so consumers control their dependency graph.
-
-## Requirements
-
-- Node.js `>= 22.15.0`
-- npm `>= 10.9.0`
-- Install peer toolchains you intend to use (`sass`, `less`, `@vanilla-extract/integration`, `@vanilla-extract/recipes`, etc.).
-
-## Installation
-
-```bash
-npm install @knighted/css
-```
-
-Install the peers your project is using, for example `less`, or `sass`, etc.
-
-## Quick Start
-
-```ts
-// scripts/extract-styles.ts
-import { css } from '@knighted/css'
-
-const styles = await css('./src/components/app.ts', {
-  cwd: process.cwd(),
-  lightningcss: { minify: true },
-})
-
-console.log(styles)
-```
-
-Run it with `tsx`/`node` and you will see a fully inlined stylesheet for `app.ts` and every style import it references, regardless of depth.
-
-## API
-
-```ts
-type CssOptions = {
-  extensions?: string[] // customize file extensions to scan
-  cwd?: string // working directory (defaults to process.cwd())
-  filter?: (filePath: string) => boolean
-  lightningcss?: boolean | LightningTransformOptions
-  dependencyTree?: DependencyTreeOptions
-  resolver?: (
-    specifier: string,
-    ctx: { cwd: string },
-  ) => string | Promise<string | undefined>
-  peerResolver?: (name: string) => Promise<unknown> // for custom module loading
-}
-
-async function css(entry: string, options?: CssOptions): Promise<string>
-```
-
-Typical customizations:
-
-- **filter** – Skip certain paths (e.g., storybook-only styles) before compilation.
-- **resolver** – Resolve virtual specifiers the way your bundler does (the repo ships test fixtures for webpack, Vite, and Rspack).
-- **lightningcss** – Pass `true` for defaults or a config object for minification/autoprefixing.
-
-## Examples
-
-### Generate standalone stylesheets
-
-```ts
-import { writeFile } from 'node:fs/promises'
-import { css } from '@knighted/css'
-
-// Build-time script that gathers all CSS imported by a React route
-const sheet = await css('./src/routes/marketing-page.tsx', {
-  lightningcss: { minify: true, targets: { chrome: 120, safari: 17 } },
-})
-
-await writeFile('./dist/marketing-page.css', sheet)
-```
-
-### Inline CSS during SSR
-
-```ts
-import { renderToString } from 'react-dom/server'
-import { css } from '@knighted/css'
-
-export async function render(url: string) {
-  const styles = await css('./src/routes/root.tsx')
-  const html = renderToString(<App url={url} />)
-  return `<!doctype html><style>${styles}</style>${html}`
-}
-```
-
-### Bundler loader (`?knighted-css` query)
-
-When using Webpack/Rspack, add the provided loader so importing a module with a specific query also returns the compiled stylesheet:
-
-```js
-// webpack.config.js
-module.exports = {
-  module: {
-    rules: [
-      {
-        test: /\.[jt]sx?$/,
-        resourceQuery: /knighted-css/,
-        use: [
-          {
-            loader: '@knighted/css/loader',
-            options: {
-              exportName: 'reactStyles', // optional (default: "knightedCss")
-              lightningcss: { minify: true }, // all css() options supported
-            },
-          },
-        ],
-      },
-    ],
-  },
-}
-```
-
-```ts
-// lit wrapper
-import { LitElement, html, unsafeCSS } from 'lit'
-import { Button, reactStyles } from './button.tsx?knighted-css'
-
-export class ButtonWrapper extends LitElement {
-  static styles = [unsafeCSS(reactStyles)]
-  render() {
-    return html`<${Button} />`
-  }
-}
-
-// per-import override:
-// import { Button, cardCss } from './button.tsx?knighted-css&exportName=cardCss'
-// (exportName in the query wins over the loader option)
-```
-
-The loader appends `export const reactStyles = "/* compiled css */"` to the module, so you can wire it directly into Lit’s `static styles` or any other runtime.
-
-## Scripts
-
-- `npm run build` – Produce CJS/ESM outputs via `@knighted/duel`.
-- `npm test` – Runs the Node test suite with `tsx` and reports coverage via `c8`.
-- `npm run lint` – Static analysis through `oxlint`.
-
-## Contributing
-
-1. Clone the repo and install dependencies with `npm install`.
-2. Run `npm test` to ensure fixtures compile across Sass/Less/vanilla-extract.
-3. Add/adjust fixtures in `fixtures/` when adding new language features to keep coverage high.
-4. Open a PR with a description of the change and tests.
-
-## License
-
-MIT © Knighted Code Monkey