zyzz 0.0.2 → 0.0.5

package/src/esbuild/index.ts

@@ -0,0 +1,5 @@
+/** Exposes the Zyzz esbuild build adapter. @module */
+import { zyzz as unplugin } from '../unplugin/index.js'
+
+/** Compiles project sources and emits `zyzz.css` into the bundler output directory. */
+export const zyzz = unplugin.esbuild

package/src/index.ts

@@ -1,8 +1,8 @@
 /**
- * Exposes token-free authoring, ordered style definitions, and theme contracts.
+ * Exposes token-free authoring, ordered style definitions, and variable contracts.
  * @module
  */
-/** Explicit theme and layer authoring contracts. */
+/** Explicit variable and layer authoring contracts. */
 export * as Config from './Config.js'
 /** Token-free literal authoring; requires a compile-time source transform. */
 export { style } from './styleFunction.js'
@@ -12,9 +12,9 @@ export { cx } from './cx.js'
 export type * as Props from './Props.js'
 /** Typed literal style definitions and validation diagnostics. */
 export * as Style from './Style.js'
-/** Typed theme contracts and compatible token overrides. */
-export * as Theme from './Theme.js'
 /** Typed CSS variable declarations and inline assignments. */
 export { variable } from './variable.js'
+/** Immutable shared values, conditions, and compatible variable sets. */
+export * as Vars from './Vars.js'
 /** Single-element finite recipes compiled ahead of time. */
 export { variants } from './variants.js'

package/src/internal/Authoring.ts

@@ -4,7 +4,7 @@ import * as Html from '../runtime/CompositionHtml.js'
 import * as Identity from './Identity.js'
 import * as Props from '../runtime/Props.js'
 import * as Style from '../Style.js'
-import type * as Theme from '../Theme.js'
+import type * as Theme from './Theme.js'
 
 /** Private ownership used by uncompiled composition; never spread onto DOM props. */
 export const metadata = Symbol.for('zyzz.authoring')
@@ -44,7 +44,7 @@ export function body(input: Record<string, unknown>): Record<string, unknown> {
           descriptors.web = { ...web, value: body(web.value) }
         return [[key, Object.create(Object.getPrototypeOf(value), descriptors)]]
       }
-      if (key === 'selectors' || key === 'variables')
+      if (key === 'selectors' || key === 'vars')
         return Object.entries(value as Record<string, unknown>).map(
           ([name, entry]) => [
             name,
@@ -84,7 +84,7 @@ export function create(
           ) => Style.Definition
         )(
           { style: body(input as Record<string, unknown>) },
-          { theme: options.theme },
+          { vars: options.theme },
         ).styles[0]!,
       )
   const props = Props.create({ className })
@@ -95,7 +95,7 @@ export function create(
         ...result.style,
       }
       for (const [field, value] of Object.entries(values ?? {})) {
-        if (['className', 'style', 'variables'].includes(field)) continue
+        if (['className', 'style', 'vars'].includes(field)) continue
         style[Identity.slot(id!, field)] =
           value === '' ? ' ' : (value as string | number)
       }
@@ -107,9 +107,7 @@ export function create(
         attributes: [],
         slots: dynamic
           ? Object.keys(values ?? {})
-              .filter(
-                (key) => !['className', 'style', 'variables'].includes(key),
-              )
+              .filter((key) => !['className', 'style', 'vars'].includes(key))
               .map((key) => Identity.slot(id!, key))
           : [],
       },

package/src/internal/Binding.ts

@@ -135,7 +135,7 @@ export type Inputs<values> = {
     | 'key'
     | 'ref'
     | 'style'
-    | 'variables'
+    | 'vars'
     | '__proto__'
     ? never
     : Extract<values[key], `${string}!${string}`> extends never

package/src/internal/Completion.ts

@@ -0,0 +1,42 @@
+/** Supplies editor hints independently of inferred declaration validation. @module */
+import type * as Theme from './Theme.js'
+import type * as Condition from './Condition.js'
+import type * as Literal from './Literal.js'
+import type * as Token from './Token.js'
+import type * as Typography from './Typography.js'
+
+/** Recursive hints do not determine which authored declarations are accepted. */
+export type Properties<
+  tokens extends Theme.Tokens = {},
+  styles = Record<string, unknown>,
+> = {
+  readonly [property in keyof Literal.Properties & keyof styles]?:
+    | (string extends Literal.Properties[property]
+        ? never
+        : Literal.Properties[property])
+    | Token.Names<tokens, property>
+    | (string & {})
+    | number
+    | object
+} & {
+  // Escaped custom-property names can contain nesting characters.
+  readonly [key in (`@${string}` | `:${string}` | `${string}&${string}`) &
+    keyof styles]?:
+    | Nested<tokens>
+    | (key extends `${string}&${string}` ? string | number : never)
+} & {
+  readonly [key in (
+    | Condition.Suggestions
+    | Exclude<Condition.Keys<tokens>, Condition.Raw>
+  ) &
+    keyof styles]?: Nested<tokens>
+} & {
+  readonly [property in (Typography.Names<tokens> extends never
+    ? never
+    : 'typography') &
+    keyof styles]?: Typography.Names<tokens> | (string & {})
+}
+
+// Inferred validation checks extra fields, including vars and configured shorthands.
+type Nested<tokens extends Theme.Tokens> = Properties<tokens> &
+  Readonly<Record<string, unknown>>

package/src/internal/Condition.ts

@@ -1,5 +1,35 @@
 /** Typed nested selector and condition keys without a general string index. @module */
-import type * as Theme from '../Theme.js'
+import type * as Theme from './Theme.js'
+
+/** Concrete suggestions supplement open selector and query patterns. */
+export type Suggestions =
+  | '::after'
+  | '::backdrop'
+  | '::before'
+  | '::first-letter'
+  | '::first-line'
+  | '::marker'
+  | '::placeholder'
+  | '::selection'
+  | ':active'
+  | ':checked'
+  | ':disabled'
+  | ':empty'
+  | ':enabled'
+  | ':first-child'
+  | ':focus'
+  | ':focus-visible'
+  | ':focus-within'
+  | ':hover'
+  | ':last-child'
+  | ':only-child'
+  | ':visited'
+  | '@container'
+  | '@layer'
+  | '@media'
+  | '@scope'
+  | '@starting-style'
+  | '@supports'
 
 type Case<text extends string> = text extends `${infer first}${infer rest}`
   ? `${Lowercase<first> | Uppercase<first>}${Case<rest>}`