zyzz 0.0.0 → 0.0.2

package/dist/node/Host.d.ts

@@ -0,0 +1,80 @@
+import type * as LightningCss from 'lightningcss';
+import * as Graph from '../compiler/Graph.js';
+/** A successful publication; paths are relative to the output directory. */
+export type Build = {
+    /** Written or removed artifacts, excluding the ownership manifest. */
+    readonly changed: readonly string[];
+    /** Complete live artifact list, excluding the ownership manifest. */
+    readonly files: readonly string[];
+};
+/**
+ * Opens an exclusively owned output lifecycle around the literal source transform.
+ * Source modules remain TypeScript/JSX; transpilation belongs to the consumer.
+ * Besides per-module stylesheets, every build publishes `zyzz.css`: shared
+ * contributions followed by module stylesheets with dependencies before their
+ * consumers, so an application loads one file. Configurations also publish
+ * `zyzz.js`, the initialization that restores a saved theme and scheme, at
+ * the configurable script path.
+ * Lightning CSS processes stylesheets and composes maps before publication by default.
+ * @param options - Source directory, separate output directory, and portable package identity.
+ * @returns Explicit build, watch, and close operations. Close releases the output lock.
+ */
+export declare function create(options: create.Options): Promise<Runtime>;
+/** File host creation contracts. */
+export declare namespace create {
+    /** Explicit filesystem and module-identity boundaries. */
+    type Options = {
+        /** Rewrite source calls. False requires runtime-compatible explicit identities. */
+        readonly compiler?: boolean | undefined;
+        /** Publish rewritten modules and metadata alongside CSS. Defaults to true. */
+        readonly modules?: boolean | undefined;
+        /** Lightning CSS processing; false preserves intermediate CSS. Enabled by default. */
+        readonly css?: false | {
+            /** Minify emitted stylesheets. Defaults to false. */
+            readonly minify?: boolean | undefined;
+            /** Lightning CSS browser versions, encoded as major << 16 | minor << 8 | patch. No targets by default. */
+            readonly targets?: Readonly<LightningCss.Targets> | undefined;
+        } | undefined;
+        /** Native context captured at creation. Emits modules and maps without CSS or web initialization. */
+        readonly native?: Graph.compile.Options['native'];
+        /** Output directory exclusively locked until close; may be nested under root. Defaults to `dist`. */
+        readonly outDir?: string | undefined;
+        /** Stable package identity prepended to relative source module IDs. */
+        readonly packageId: string;
+        /** Directory scanned for supported JavaScript/TypeScript source files. */
+        readonly root: string;
+        /**
+         * Path of the initialization script restoring saved theme selections.
+         * Defaults to `zyzz.js` inside the output directory, where it is an owned
+         * artifact. A path elsewhere, such as a bundler's public directory, is
+         * rewritten in place without ownership. False disables the script.
+         */
+        readonly script?: string | false | undefined;
+    };
+}
+/** Watch builds report failures without discarding the last successful output. */
+export type Event = {
+    readonly error: unknown;
+} | {
+    readonly result: Build;
+};
+/** An explicitly disposed file host. */
+export type Runtime = {
+    /** Stops watching, drains builds, and releases ownership when an await using scope exits. */
+    readonly [Symbol.asyncDispose]: () => Promise<void>;
+    /** Serializes a complete scan, compile, and publication; failures reject. */
+    readonly build: () => Promise<Build>;
+    /** Stops watching, drains builds, and releases ownership. Idempotent. */
+    readonly close: () => Promise<void>;
+    /** Starts recursive filesystem watching and an initial build. */
+    readonly watch: (options: watch.Options) => void;
+};
+/** Watch notification contracts. */
+export declare namespace watch {
+    /** Callback ownership remains with the host consumer. */
+    type Options = {
+        /** Receives successful builds and failures; must not throw. */
+        readonly onResult: (event: Event) => void;
+    };
+}
+//# sourceMappingURL=Host.d.ts.map

package/dist/node/Host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Host.d.ts","sourceRoot":"","sources":["../../src/node/Host.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,YAAY,MAAM,cAAc,CAAA;AAMjD,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAA;AAQ7C,4EAA4E;AAC5E,MAAM,MAAM,KAAK,GAAG;IAClB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAm3BtE;AAED,oCAAoC;AACpC,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,KAAK,OAAO,GAAG;QACb,mFAAmF;QACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACvC,8EAA8E;QAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACtC,sFAAsF;QACtF,QAAQ,CAAC,GAAG,CAAC,EACT,KAAK,GACL;YACE,qDAAqD;YACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;YACrC,0GAA0G;YAC1G,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;SAC9D,GACD,SAAS,CAAA;QACb,qGAAqG;QACrG,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjD,qGAAqG;QACrG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACpC,uEAAuE;QACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,0EAA0E;QAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB;;;;;WAKG;QACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;KAC7C,CAAA;CACF;AAED,kFAAkF;AAClF,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;CAAE,CAAA;AAE5E,wCAAwC;AACxC,MAAM,MAAM,OAAO,GAAG;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,CAAA;CACjD,CAAA;AAED,oCAAoC;AACpC,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,yDAAyD;IACzD,KAAK,OAAO,GAAG;QACb,+DAA+D;QAC/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KAC1C,CAAA;CACF"}