@csszyx/types 0.9.9 → 0.10.0

package/dist/config.d.cts

@@ -334,6 +334,27 @@ type PartialCsszyxConfig = {
      * marker and would otherwise hit the AST budget guard.
      */
     exclude?: FilePattern | FilePattern[];
+    /**
+     * Opt workspace packages under `/packages/` into compilation.
+     *
+     * csszyx hard-ignores `/packages/` by default because published libraries
+     * are expected to ship pre-extracted CSS. In a monorepo, however, a
+     * design-system package is first-class source the developer authors, so its
+     * `sz` props must be compiled like app code. List the package directory
+     * names here (e.g. `['vui']`) to compile `**\/packages/<name>/**`. Only the
+     * `/packages/` rule is relaxed — `node_modules` and `.next` stay ignored.
+     */
+    compilePackages?: string[];
+    /**
+     * Warn when, inside a monorepo, the Tailwind entry imports `tailwindcss`
+     * without scoping its content detection (no `source(none)` / `source(...)` /
+     * `@source not`). Unscoped, Tailwind v4 climbs to the workspace root and
+     * scans sibling packages + docs (`.md`/`.mdx`/`.txt` are not ignored),
+     * which can generate phantom or broken `url()` classes and fail the build.
+     * The warning prints the one-time fix; set `false` to silence it when a
+     * broad scan is intentional. Defaults to `true`.
+     */
+    contentScopeCheck?: boolean;
     development?: Partial<DevelopmentConfig>;
     production?: Partial<ProductionConfig>;
     build?: Partial<BuildConfig>;

package/dist/config.d.mts

@@ -334,6 +334,27 @@ type PartialCsszyxConfig = {
      * marker and would otherwise hit the AST budget guard.
      */
     exclude?: FilePattern | FilePattern[];
+    /**
+     * Opt workspace packages under `/packages/` into compilation.
+     *
+     * csszyx hard-ignores `/packages/` by default because published libraries
+     * are expected to ship pre-extracted CSS. In a monorepo, however, a
+     * design-system package is first-class source the developer authors, so its
+     * `sz` props must be compiled like app code. List the package directory
+     * names here (e.g. `['vui']`) to compile `**\/packages/<name>/**`. Only the
+     * `/packages/` rule is relaxed — `node_modules` and `.next` stay ignored.
+     */
+    compilePackages?: string[];
+    /**
+     * Warn when, inside a monorepo, the Tailwind entry imports `tailwindcss`
+     * without scoping its content detection (no `source(none)` / `source(...)` /
+     * `@source not`). Unscoped, Tailwind v4 climbs to the workspace root and
+     * scans sibling packages + docs (`.md`/`.mdx`/`.txt` are not ignored),
+     * which can generate phantom or broken `url()` classes and fail the build.
+     * The warning prints the one-time fix; set `false` to silence it when a
+     * broad scan is intentional. Defaults to `true`.
+     */
+    contentScopeCheck?: boolean;
     development?: Partial<DevelopmentConfig>;
     production?: Partial<ProductionConfig>;
     build?: Partial<BuildConfig>;

package/dist/jsx-solid.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SolidJS JSX type augmentation for the csszyx sz prop.
+ *
+ * Solid maintains its own JSX namespace (not React's), so the React
+ * augmentation in `@csszyx/types/jsx` does not apply. Reference this
+ * module instead in Solid projects:
+ *
+ * ```ts
+ * // csszyx-env.d.ts
+ * /// <reference types="@csszyx/types/jsx-solid" />
+ * ```
+ *
+ * Types-only: solid-js is required as a type dependency by consumers of
+ * this subpath (every Solid project already has it) and is never imported
+ * at runtime.
+ *
+ * @module @csszyx/types/jsx-solid
+ */
+
+import 'solid-js';
+
+import type { RecoveryMode, SzPropValue } from '@csszyx/compiler';
+
+export type { RecoveryMode, SzPropValue };
+
+declare module 'solid-js' {
+    namespace JSX {
+        /**
+         *
+         */
+        interface HTMLAttributes<T> {
+            /**
+             * csszyx styling prop — Tailwind CSS via object syntax or class string.
+             *
+             * @example
+             * ```tsx
+             * <div sz={{ p: 4, bg: 'blue-500', hover: { bg: 'blue-700' } }} />
+             * <div sz="p-4 bg-blue-500 hover:bg-blue-700" />
+             * ```
+             */
+            sz?: SzPropValue;
+            /**
+             * Hydration recovery mode for the element. The csszyx unplugin
+             * compiles this attribute into a `data-sz-recovery-token` and
+             * registers the element in the SSR recovery manifest read by
+             * `@csszyx/runtime/verify` at hydration time.
+             *
+             * - `'csr'` — recovery permitted in both dev and production
+             * - `'dev-only'` — recovery permitted in development only;
+             *   stripped from the production manifest at build time.
+             *
+             * @example
+             * ```tsx
+             * <section szRecover="csr">…</section>
+             * ```
+             */
+            szRecover?: RecoveryMode;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/types",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "description": "TypeScript definitions for csszyx",
   "keywords": [
     "csszyx",
@@ -45,6 +45,9 @@
     },
     "./jsx": {
       "types": "./dist/jsx.d.ts"
+    },
+    "./jsx-solid": {
+      "types": "./dist/jsx-solid.d.ts"
     }
   },
   "files": [
@@ -54,7 +57,7 @@
     "@types/node": "^20.11.0",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1",
-    "@csszyx/compiler": "0.9.9"
+    "@csszyx/compiler": "0.10.0"
   },
   "sideEffects": false,
   "engines": {