zyzz 0.0.0 → 0.0.2

package/dist/compiler/Source.d.ts

@@ -0,0 +1,165 @@
+import type * as Ast from '@oxc-project/types';
+import type * as Composition from '../runtime/Composition.js';
+import * as Contributions from './internal/Contributions.js';
+import * as Css from '../web/Css.js';
+import * as Dynamic from './internal/Dynamic.js';
+import type * as Namespace from '../web/internal/Namespace.js';
+import type * as Recipe from '../runtime/Recipe.js';
+import type * as StaticRecipe from '../internal/Recipe.js';
+import type * as Shorthands from '../internal/Shorthands.js';
+import * as Style from '../Style.js';
+import type * as Theme from '../Theme.js';
+import * as Themes from './internal/Themes.js';
+import * as Variables from './internal/Variables.js';
+/** A direct definition call available for a later source rewriter. */
+export type Call = {
+    /** Resolved native alternatives for this authoring contract. */
+    readonly nativeContext?: {
+        /** Default label selected when the provider omits its theme. */
+        readonly defaultTheme: string;
+        /** Compatible alternatives from the owning configuration. */
+        readonly themes: Readonly<Record<string, Theme.Definition>>;
+    } | undefined;
+    /** Class identity available without source rewriting. */
+    readonly portable?: string | undefined;
+    /** Flattened definition identities for nested compositions. */
+    readonly portableInputs?: readonly string[] | undefined;
+    /** Ownership retained by a separately compiled callable. */
+    readonly ownership?: Composition.Owner | undefined;
+    /** CSS-only presence alternative for a runtime composition. */
+    readonly compositionCase?: boolean | undefined;
+    /** Names of precompiled presence alternatives in bitmask order. */
+    readonly compositionCases?: readonly string[] | undefined;
+    /** Fixed runtime applications over an already resolved CSS sequence. */
+    readonly runtimeComposition?: readonly {
+        /** Original resolved application start retained for selective HTML preparation. */
+        readonly applicationStart?: number | undefined;
+        /** Presence bit for a conditional argument. */
+        readonly condition?: number | undefined;
+        /** Application argument end. */
+        readonly end: number;
+        /** Replaced generated class owner. */
+        readonly name: string;
+        /** Attribute and private variable ownership. */
+        readonly owners: readonly Composition.Owner[];
+        /** Application argument start. */
+        readonly start: number;
+    }[] | undefined;
+    /** Binding reads preserved by compile-time composition. */
+    readonly composition?: readonly string[] | undefined;
+    /** Finite recipe selection metadata, with all alternatives retained in CSS. */
+    readonly recipe?: Recipe.Definition | undefined;
+    /** Ordered dynamic alternatives retained with scalar binding references. */
+    readonly dynamicRecipe?: StaticRecipe.Definition | undefined;
+    /** Ordered static alternatives retained without CSS selector lowering. */
+    readonly staticRecipe?: StaticRecipe.Definition | undefined;
+    /** Typed payload signatures retained across transformed declarations. */
+    readonly recipeTypes?: {
+        readonly [axis: string]: {
+            readonly [choice: string]: string;
+        };
+    } | undefined;
+    /** Stable selector identity retained independently of declaration deduplication. */
+    readonly identity?: string | undefined;
+    /** Expanded immutable source data retained for declaration mapping. */
+    readonly body?: Ast.ObjectExpression | undefined;
+    /** Alias targets retained for declaration source locations. */
+    readonly shorthands?: Shorthands.Map | undefined;
+    /** Native HTML attribute output selected by the bound configuration. */
+    readonly output?: 'html' | undefined;
+    /** Typed runtime slots for callback definitions. */
+    readonly slots?: Dynamic.Slots | undefined;
+    /** Authored scalar input type retained in packed declarations. */
+    readonly valuesType?: string | undefined;
+    /** Exclusive UTF-16 offset of the complete call. */
+    readonly end: number;
+    /** Matching name in the extracted style definition. */
+    readonly name: string;
+    /** Inclusive UTF-16 offset of the complete call. */
+    readonly start: number;
+};
+/** A source-owned extraction failure. */
+export type Diagnostic = {
+    /** Stable failure category. */
+    readonly code: 'invalid_literal' | 'invalid_module' | 'syntax_error' | 'unsupported_syntax';
+    /** Exclusive UTF-16 source offset. */
+    readonly end: number;
+    /** Explanation of the supported input boundary. */
+    readonly message: string;
+    /** Portable module identity supplied by the host. */
+    readonly source: string;
+    /** Inclusive UTF-16 source offset. */
+    readonly start: number;
+};
+/**
+ * Extracts direct style calls and local Theme definitions imported from zyzz.
+ * Parses TypeScript and JSX without reading files, loading config, or evaluating source.
+ * @param options - Source text and a portable package-relative module identity.
+ * @returns Frozen style/theme definitions and rewrite spans. Source text is unchanged.
+ * @throws {ExtractError} For syntax errors, unsupported imported references, or invalid literals.
+ */
+export declare function extract(options: extract.Options): extract.ReturnType;
+/** Input and output of source extraction. */
+export declare namespace extract {
+    /** Structured source failure. */
+    type ErrorType = ExtractError;
+    /** Source text supplied by an adapter. */
+    type Options = {
+        /** Native extraction retains applications for native props composition. */
+        readonly target?: 'native' | 'web' | undefined;
+        /** Collect portable runtime identities when source rewriting is disabled. */
+        readonly compiler?: boolean | undefined;
+        /** Portable identity including package and module path; no filesystem access occurs. */
+        readonly moduleId: string;
+        /** Compiler-owned graph context. */
+        readonly [Themes.context]?: Themes.Context | undefined;
+        /** Complete module text, parsed as TypeScript with JSX. */
+        readonly source: string;
+    };
+    /** Ordered public compiler input and spans for later rewriting. */
+    type ReturnType = {
+        /** Module-owned namespace bindings retained when contributions are shared. */
+        readonly namespaces?: readonly Namespace.Definition[] | undefined;
+        /** Static stylesheet effects and their source replacements. */
+        readonly contributionStarts?: readonly number[] | undefined;
+        readonly contributions?: readonly Css.Contribution[] | undefined;
+        readonly contributionCalls?: readonly Contributions.Call[] | undefined;
+        /** Explicit variable contracts replaced by fixed slot data. */
+        readonly variableCalls?: readonly Variables.Call[] | undefined;
+        /** Direct calls in source order. */
+        readonly calls: readonly Call[];
+        /** Validated definitions accepted by Css.compile. */
+        readonly styles: Style.Definition;
+        /** Local bound-authoring initializers and their retained token types. */
+        readonly themeAliases: readonly Themes.Alias[];
+        /** Configuration identities retaining their root controls. */
+        readonly themeAppearances?: readonly string[] | undefined;
+        /** Configuration identities retaining their initialization helper. */
+        readonly themeScripts?: readonly string[] | undefined;
+        /** Configuration identities whose theme selector is called, passed, or bound. */
+        readonly themeSelections?: readonly string[] | undefined;
+        /** Local factory spans replaced by compiled scope data. */
+        readonly themeCalls: readonly Themes.Call[];
+        /** Scope reads replaced by class constants. */
+        readonly staticThemeReferences?: readonly {
+            readonly start: number;
+            readonly end: number;
+            readonly value: string;
+        }[] | undefined;
+        readonly themeReferences: readonly Themes.Reference[];
+        /** Resolved authoring exports when extracted as part of a source graph. */
+        readonly themeExports?: Readonly<Record<string, Themes.Link>> | undefined;
+        /** Stable scope keys and validated local theme definitions. */
+        readonly themes: Readonly<Record<string, Theme.Definition>>;
+    };
+}
+/** Aggregated source diagnostics; no partial result is returned. */
+export declare class ExtractError extends Error {
+    /** Freezes source diagnostics in source order. */
+    constructor(diagnostics: readonly Diagnostic[]);
+    /** Immutable source failures. */
+    readonly diagnostics: readonly Diagnostic[];
+    /** Stable namespaced error identifier. */
+    name: string;
+}
+//# sourceMappingURL=Source.d.ts.map

package/dist/compiler/Source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../src/compiler/Source.ts"],"names":[],"mappings":"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"}