rnwind 0.0.1 → 0.0.3

package/lib/cjs/metro/state.d.ts

@@ -0,0 +1,88 @@
+import { UnionBuilder } from '../core/style-builder';
+import { TailwindParser } from '../core/parser';
+/**
+ * Worker-local state. Lazy-initialised on first access so files that
+ * bypass the transform don't pay for construction.
+ */
+export interface RnwindState {
+    parser: TailwindParser;
+    builder: UnionBuilder;
+    themeCss: string;
+    themeHash: string;
+    projectRoot: string;
+}
+/**
+ * Publish the theme CSS path + cache dir to the environment so worker
+ * subprocesses (spawned by Metro once `babelTransformerPath` is set)
+ * can rebuild the same state without re-reading the Metro config.
+ * @param cssEntryFile Absolute path to the user's theme CSS.
+ * @param cacheDir Absolute path to the cache dir (`.rnwind`).
+ * @param watchFolders
+ * @param classNamePrefixes Extra JSX prop-name prefixes to rewrite.
+ * @param hostSources
+ * @param hostComponents
+ */
+export declare function configureRnwindState(cssEntryFile: string, cacheDir: string, watchFolders?: readonly string[], classNamePrefixes?: readonly string[], hostSources?: readonly string[], hostComponents?: readonly string[]): void;
+/**
+ * Read the caller-configured extra className prefixes out of the
+ * worker environment. Returns an empty array when unset — the
+ * transformer applies the built-in `contentContainer` default on top
+ * either way.
+ * @returns User-supplied extra prefixes.
+ */
+export declare function getClassNamePrefixes(): readonly string[];
+/**
+ * Read the caller-configured extra host module sources out of the
+ * worker environment. Empty array when unset — the transformer applies
+ * its built-in default list on top either way.
+ * @returns User-supplied extra host sources.
+ */
+export declare function getHostSources(): readonly string[];
+/**
+ * Read the caller-configured extra host JSX tag names out of the worker
+ * environment. Verbatim names — may include `.` for member expressions
+ * like `'Animated.View'`.
+ * @returns User-supplied extra host component names.
+ */
+export declare function getHostComponents(): readonly string[];
+/**
+ * Fetch (or build) the worker-local rnwind state. Re-reads the theme
+ * CSS hash on every call: if the user edited `global.css` while Metro
+ * is running, the cached state is dropped and a fresh parser + ledger
+ * is built. Combined with the `getCacheKey()` export on the
+ * transformer (which folds the same hash into Metro's per-file cache
+ * key) every CSS edit produces a full, correct re-bundle.
+ * @param projectRoot
+ * @returns The live rnwind state.
+ */
+export declare function getRnwindState(projectRoot: string): RnwindState;
+/**
+ * Compute the rnwind cache-key suffix Metro mixes into every per-file
+ * transform cache entry via the transformer's `getCacheKey()` export.
+ * Includes the CSS path + its current content hash + the rnwind
+ * library fingerprint, so any edit to `global.css` OR a library
+ * upgrade flips the cache key and forces Metro to re-run the
+ * transformer.
+ * @returns Deterministic string suitable for appending to Metro's cache key.
+ */
+export declare function getRnwindCacheKey(): string;
+/** Drop the cached state — call after editing the theme CSS. */
+export declare function resetRnwindState(): void;
+/**
+ * Drop cached state, rebuild parser/builder with the fresh CSS, rescan
+ * the project, and rewrite every scheme file on disk. This is what
+ * `withRnwindConfig`'s CSS file-watcher invokes so `global.css` edits
+ * propagate to the app via Metro's HMR — without this, the CSS-as-JS
+ * module would re-emit `export {}` whose bytes never change, so Metro
+ * would never invalidate downstream modules.
+ * @param projectRoot Absolute project root (from `metroConfig.projectRoot`).
+ */
+export declare function onThemeChange(projectRoot: string): Promise<void>;
+/**
+ * Resolve the on-disk path of the scheme manifest module for the
+ * resolver. The manifest eager-imports `common.style.js` and
+ * lazy-requires each variant scheme; SchemeProvider calls its
+ * `ensureSchemeLoaded` export to trigger per-scheme requires.
+ * @returns Absolute path to `<cacheDir>/schemes.js`.
+ */
+export declare function manifestPathFor(): string;