zyzz 0.0.0 → 0.0.3

package/dist/metro/index.d.ts

@@ -0,0 +1,30 @@
+/** Configures native Zyzz compilation in Metro without a separate generation command. @module */
+import type { NativeOptions } from '../babel/index.js';
+/** Minimum Metro configuration consumed by the adapter. */
+export type Config = {
+    /** Existing development middleware settings. */
+    readonly server?: object | undefined;
+    /** Application root used for the adapter cache. */
+    readonly projectRoot?: string | undefined;
+    /** Existing transformer configuration, including Expo's Babel transformer. */
+    readonly transformer?: {
+        /** Upstream Babel transformer to preserve. */
+        readonly babelTransformerPath?: string | undefined;
+    } | undefined;
+};
+/**
+ * Preserves Metro configuration and chains Zyzz before the existing Babel transformer.
+ * Writes an immutable adapter entrypoint under `.zyzz/metro`, not compiled application files.
+ */
+export declare function zyzz<const config extends Config>(config: config, options?: Omit<NativeOptions, 'platform' | 'target' | 'moduleId' | 'modules' | 'imports' | 'colorScheme'>): zyzz.ReturnType<config>;
+/** Configuration returned by the Metro adapter. */
+export declare namespace zyzz {
+    /** Preserves caller configuration fields and the existing transformer options. */
+    type ReturnType<config extends Config> = Omit<config, 'transformer'> & {
+        /** Existing transformer configuration with the native compilation entrypoint. */
+        transformer: Omit<NonNullable<config['transformer']>, 'babelTransformerPath'> & {
+            babelTransformerPath: string;
+        };
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/metro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metro/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAOtD,2DAA2D;AAC3D,MAAM,MAAM,MAAM,GAAG;IACnB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EACjB;QACE,8CAA8C;QAC9C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACnD,GACD,SAAS,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,EAC9C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CACX,aAAa,EACb,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CACtE,GACL,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAqDzB;AAED,mDAAmD;AACnD,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,kFAAkF;IAClF,KAAK,UAAU,CAAC,MAAM,SAAS,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG;QACrE,iFAAiF;QACjF,WAAW,EAAE,IAAI,CACf,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,EAClC,sBAAsB,CACvB,GAAG;YAAE,oBAAoB,EAAE,MAAM,CAAA;SAAE,CAAA;KACrC,CAAA;CACF"}

package/dist/metro/index.js

@@ -0,0 +1,52 @@
+import * as Crypto from 'node:crypto';
+import * as Fs from 'node:fs';
+import * as Module from 'node:module';
+import * as Path from 'node:path';
+import * as Watch from './Watch.js';
+/**
+ * Preserves Metro configuration and chains Zyzz before the existing Babel transformer.
+ * Writes an immutable adapter entrypoint under `.zyzz/metro`, not compiled application files.
+ */
+export function zyzz(config, options = {}) {
+    if (Object.hasOwn(options, 'colorScheme'))
+        throw new Error('Select colorScheme through the React provider, not Metro configuration.');
+    const root = Path.resolve(config.projectRoot ?? process.cwd());
+    const require = Module.createRequire(Path.join(root, 'package.json'));
+    const upstream = config.transformer?.babelTransformerPath;
+    if (!upstream)
+        throw new Error('Zyzz requires a configured Metro Babel transformer.');
+    const adapter = Module.createRequire(import.meta.url).resolve('zyzz/metro/transformer');
+    const code = `module.exports = require(${JSON.stringify(adapter)}).create(${JSON.stringify(require.resolve(upstream))}, ${JSON.stringify({ ...options, root })});\n`;
+    const directory = Path.join(root, '.zyzz', 'metro');
+    const filename = Path.join(directory, `${Crypto.hash('sha256', code)}.cjs`);
+    Fs.mkdirSync(directory, { recursive: true });
+    try {
+        Fs.writeFileSync(filename, code, { flag: 'wx' });
+    }
+    catch (error) {
+        if (!(error instanceof Error && 'code' in error && error.code === 'EEXIST'))
+            throw error;
+    }
+    const enhance = config.server &&
+        Reflect.get(config.server, 'enhanceMiddleware');
+    return {
+        ...config,
+        server: {
+            ...config.server,
+            enhanceMiddleware(middleware, server) {
+                const ready = Watch.attach(server, root);
+                const next = enhance
+                    ? enhance.call(config.server, middleware, server)
+                    : middleware;
+                return (...args) => ready.then(() => next(...args), (error) => {
+                    const report = args[2];
+                    if (typeof report === 'function')
+                        return report(error);
+                    throw error;
+                });
+            },
+        },
+        transformer: { ...config.transformer, babelTransformerPath: filename },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/metro/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metro/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAiBnC;;;GAGG;AACH,MAAM,UAAU,IAAI,CAClB,MAAc,EACd,OAAO,GAGH,EAAE;IAEN,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAA;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,oBAAoB,CAAA;IACzD,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IAExE,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAC3D,wBAAwB,CACzB,CAAA;IACD,MAAM,IAAI,GAAG,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAA;IACpK,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3E,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5C,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;YACzE,MAAM,KAAK,CAAA;IACf,CAAC;IAED,MAAM,OAAO,GACX,MAAM,CAAC,MAAM;QACZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAEjC,CAAA;IAEhB,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE;YACN,GAAG,MAAM,CAAC,MAAM;YAChB,iBAAiB,CAAC,UAAsB,EAAE,MAAoB;gBAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;gBACxC,MAAM,IAAI,GAAG,OAAO;oBAClB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC;oBACjD,CAAC,CAAC,UAAU,CAAA;gBACd,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAC5B,KAAK,CAAC,IAAI,CACR,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EACnB,CAAC,KAAc,EAAE,EAAE;oBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;oBACtB,IAAI,OAAO,MAAM,KAAK,UAAU;wBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;oBACtD,MAAM,KAAK,CAAA;gBACb,CAAC,CACF,CAAA;YACL,CAAC;SACF;QACD,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE;KAC5C,CAAA;AAC9B,CAAC"}

package/dist/metro/transformer.d.ts

@@ -0,0 +1,21 @@
+/** Chains native authoring compilation into the configured Metro Babel transformer. @module */
+import type * as Babel from '@babel/core';
+import { type NativeOptions } from '../babel/index.js';
+/** Babel transformer inputs passed through without removing upstream fields. */
+type Input = {
+    readonly filename: string;
+    readonly options: {
+        readonly platform?: string | undefined;
+    };
+    readonly plugins?: readonly Babel.PluginItem[] | undefined;
+    readonly src: string;
+};
+/** Creates a transformer with isolated options and the existing upstream implementation. */
+export declare function create(upstreamPath: string, options: Omit<NativeOptions, 'platform' | 'target' | 'moduleId' | 'modules' | 'imports' | 'colorScheme'> & {
+    readonly root: string;
+}): {
+    getCacheKey(...args: readonly unknown[]): string;
+    transform(input: Input): unknown;
+};
+export {};
+//# sourceMappingURL=transformer.d.ts.map

package/dist/metro/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../src/metro/transformer.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AAMzC,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,mBAAmB,CAAA;AAE5D,gFAAgF;AAChF,KAAK,KAAK,GAAG;IACX,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,CAAC,UAAU,EAAE,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,CAAA;AAOD,4FAA4F;AAC5F,wBAAgB,MAAM,CACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,IAAI,CACX,aAAa,EACb,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAC3E,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;IAI3B,WAAW,UAAU,SAAS,OAAO,EAAE;IAqCvC,SAAS,QAAQ,KAAK;EA2BzB"}

package/dist/metro/transformer.js

@@ -0,0 +1,71 @@
+import * as Crypto from 'node:crypto';
+import * as Fs from 'node:fs';
+import * as Module from 'node:module';
+import * as Path from 'node:path';
+import * as Graph from './Graph.js';
+import { zyzz } from '../babel/index.js';
+/** Creates a transformer with isolated options and the existing upstream implementation. */
+export function create(upstreamPath, options) {
+    const upstream = Module.createRequire(import.meta.url)(upstreamPath);
+    return {
+        getCacheKey(...args) {
+            const hash = Crypto.createHash('sha256');
+            hash.update(upstream.getCacheKey?.(...args) ?? '');
+            hash.update(JSON.stringify(options));
+            function sources(directory) {
+                for (const entry of Fs.readdirSync(directory, {
+                    withFileTypes: true,
+                }).sort((a, b) => a.name.localeCompare(b.name))) {
+                    if (entry.name.startsWith('.') ||
+                        ['node_modules', 'dist'].includes(entry.name))
+                        continue;
+                    const path = Path.join(directory, entry.name);
+                    if (entry.isDirectory())
+                        sources(path);
+                    else if (entry.isFile() && /\.[cm]?[jt]sx?$/.test(entry.name)) {
+                        hash.update(path);
+                        hash.update(Fs.readFileSync(path));
+                    }
+                }
+            }
+            sources(options.root);
+            // Metro only hashes the generated entrypoint. Include the library implementation it delegates to.
+            const root = Path.resolve(import.meta.dirname, '..');
+            for (const name of Fs.readdirSync(root, { recursive: true })
+                .map(String)
+                .sort()) {
+                if (/\.[cm]?[jt]sx?$/.test(name) &&
+                    !/\.(?:d|test|test-d|bench|bench-d)\.[cm]?[jt]sx?$/.test(name)) {
+                    hash.update(name);
+                    hash.update(Fs.readFileSync(Path.join(root, name)));
+                }
+            }
+            return hash.digest('hex');
+        },
+        transform(input) {
+            const platform = input.options.platform;
+            const filename = Path.resolve(options.root, input.filename);
+            if ((platform !== 'ios' && platform !== 'android') ||
+                !/\.[cm]?[jt]sx?$/.test(input.filename) ||
+                input.filename.split(/[\\/]/).includes('node_modules') ||
+                Path.relative(options.root, filename).startsWith(`..${Path.sep}`))
+                return upstream.transform(input);
+            return upstream.transform({
+                ...input,
+                plugins: [
+                    [
+                        zyzz,
+                        {
+                            ...options,
+                            platform,
+                            target: 'native',
+                            ...Graph.read(filename, input.src, platform, options.root),
+                        },
+                    ],
+                    ...(input.plugins ?? []),
+                ],
+            });
+        },
+    };
+}
+//# sourceMappingURL=transformer.js.map

package/dist/metro/transformer.js.map

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

package/dist/next/index.d.ts

@@ -0,0 +1,18 @@
+/** Connects Next.js configuration to the shared static compiler. @module */
+import type { NextConfig } from 'next';
+/**
+ * Adds source transformation, CSS delivery, and project dependency watching to both bundlers.
+ * Preserves existing configuration hooks and creates `.zyzz/next` beneath the working directory.
+ * Throws file-system errors during setup; compilation errors are reported by the bundler.
+ */
+export declare function zyzz(config: NextConfig): NextConfig;
+export declare function zyzz(config: zyzz.Factory): zyzz.Factory;
+export declare function zyzz(config: Promise<NextConfig>): Promise<NextConfig>;
+/** Next.js configuration callback contracts. */
+export declare namespace zyzz {
+    /** Receives the Next.js phase and defaults and returns application options. */
+    type Factory = (phase: string, context: {
+        defaultConfig: NextConfig;
+    }) => NextConfig | Promise<NextConfig>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAKtC;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;AACpD,wBAAgB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;AACxD,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AA6FtE,gDAAgD;AAChD,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,OAAO,GAAG,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,aAAa,EAAE,UAAU,CAAA;KAAE,KACnC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACtC"}

package/dist/next/index.js

@@ -0,0 +1,92 @@
+import * as Fs from 'node:fs';
+import * as Module from 'node:module';
+import * as Path from 'node:path';
+export function zyzz(config) {
+    if (typeof config === 'function')
+        return async (phase, context) => zyzz(await config(phase, context));
+    if (config instanceof Promise)
+        return config.then(zyzz);
+    const loader = Module.createRequire(import.meta.url).resolve('zyzz/next/loader');
+    const options = { root: process.cwd() };
+    const shared = Path.join(options.root, '.zyzz', 'next', 'shared.css');
+    Fs.mkdirSync(Path.dirname(shared), { recursive: true });
+    try {
+        Fs.writeFileSync(shared, '', { flag: 'wx' });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+    const pattern = '*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}';
+    const existing = config.turbopack?.rules?.[pattern];
+    const rule = {
+        condition: {
+            all: [{ not: 'foreign' }, { not: { query: /zyzz-style/ } }],
+        },
+        loaders: [
+            { loader, options: { ...options, bundler: 'turbopack', mode: 'source' } },
+        ],
+    };
+    return {
+        ...config,
+        experimental: {
+            ...config.experimental,
+            lightningCssFeatures: {
+                ...config.experimental?.lightningCssFeatures,
+                exclude: [
+                    ...new Set([
+                        ...(config.experimental?.lightningCssFeatures?.exclude ?? []),
+                        'light-dark',
+                    ]),
+                ],
+            },
+        },
+        turbopack: {
+            ...config.turbopack,
+            rules: {
+                ...config.turbopack?.rules,
+                [pattern]: [
+                    ...(Array.isArray(existing) ? existing : existing ? [existing] : []),
+                    rule,
+                    {
+                        condition: { query: /zyzz-style/ },
+                        loaders: [
+                            {
+                                loader,
+                                options: { ...options, bundler: 'turbopack', mode: 'style' },
+                            },
+                        ],
+                        as: '*.css',
+                    },
+                ],
+                '**/.zyzz/next/shared.css': {
+                    loaders: [
+                        {
+                            loader,
+                            options: { ...options, bundler: 'turbopack', mode: 'shared' },
+                        },
+                    ],
+                },
+            },
+        },
+        webpack(value, context) {
+            const result = config.webpack?.(value, context) ?? value;
+            result.module ??= {};
+            result.module.rules ??= [];
+            result.module.rules.push({
+                enforce: 'pre',
+                exclude: /node_modules/,
+                include: options.root,
+                test: /\.[cm]?[jt]sx?$/,
+                use: [
+                    {
+                        loader,
+                        options: { ...options, bundler: 'webpack', mode: 'source' },
+                    },
+                ],
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

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

package/dist/next/loader.d.ts

@@ -0,0 +1,16 @@
+type Context = {
+    addContextDependency(directory: string): void;
+    addDependency(file: string): void;
+    async(): (error: Error | null, code?: string, map?: object) => void;
+    getOptions(): {
+        bundler: string;
+        mode: 'shared' | 'source' | 'style';
+        root: string;
+    };
+    getResolve(options: object): (directory: string, specifier: string, callback: (error: Error | null, file?: string | false) => void) => void;
+    resourcePath: string;
+};
+/** Loader-runner boundary used by Webpack and Turbopack. */
+export default function loader(this: Context, source: string): void;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/next/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/next/loader.ts"],"names":[],"mappings":"AASA,KAAK,OAAO,GAAG;IACb,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnE,UAAU,IAAI;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;QACnC,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,UAAU,CACR,OAAO,EAAE,MAAM,GACd,CACD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,KAAK,IAAI,KAC3D,IAAI,CAAA;IACT,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,4DAA4D;AAC5D,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOlE"}

package/dist/next/loader.js

@@ -0,0 +1,282 @@
+/** Loads a physical source graph through Next.js resolution and emits cache-owned CSS. @module */
+import * as Crypto from 'node:crypto';
+import * as Fs from 'node:fs/promises';
+import * as Path from 'node:path';
+import * as Parser from 'oxc-parser';
+import * as Graph from '../compiler/Graph.js';
+import * as AtRules from '../compiler/internal/AtRules.js';
+import * as Contract from '../compiler/internal/Contract.js';
+/** Loader-runner boundary used by Webpack and Turbopack. */
+export default function loader(source) {
+    const callback = this.async();
+    compile(this, source).then((result) => callback(null, result.code, result.map), (error) => callback(error instanceof Error ? error : new Error(String(error))));
+}
+async function compile(context, source) {
+    const options = context.getOptions();
+    const root = options.root;
+    const directory = Path.resolve(root, '.zyzz', 'next');
+    const modules = Object.create(null);
+    const imports = Object.create(null);
+    const contracts = Object.create(null);
+    const resolve = context.getResolve({});
+    const id = (file) => `app/${Path.relative(root, file).split(Path.sep).join('/')}`;
+    const eligible = (file) => /\.[cm]?[jt]sx?$/.test(file) &&
+        !/\.(?:d|test|test-d|bench|bench-d)\.[cm]?[jt]sx?$/.test(file) &&
+        !Path.relative(root, file)
+            .split(Path.sep)
+            .some((part) => part === '..' || part === 'node_modules' || part.startsWith('.'));
+    if (options.mode !== 'shared' && !eligible(context.resourcePath))
+        return { code: source, map: undefined };
+    async function visit(file, text) {
+        const name = id(file);
+        if (Object.hasOwn(modules, name))
+            return;
+        context.addDependency(file);
+        modules[name] = text ?? (await Fs.readFile(file, 'utf8'));
+        const links = Object.create(null);
+        imports[name] = links;
+        const parsed = Parser.parseSync(file, modules[name], {
+            sourceType: 'module',
+        });
+        for (const node of parsed.program.body) {
+            if ((node.type !== 'ImportDeclaration' &&
+                node.type !== 'ExportNamedDeclaration' &&
+                node.type !== 'ExportAllDeclaration') ||
+                !node.source)
+                continue;
+            if (node.type === 'ImportDeclaration'
+                ? node.importKind === 'type'
+                : node.exportKind === 'type')
+                continue;
+            const specifier = node.source.value;
+            links[specifier] = null;
+            if (specifier === 'zyzz' ||
+                (specifier.startsWith('zyzz/') &&
+                    specifier !== 'zyzz/default') ||
+                specifier.startsWith('node:'))
+                continue;
+            const resolved = await new Promise((accept, reject) => {
+                resolve(Path.dirname(file), specifier, (error, value) => error ? reject(error) : accept(value));
+            });
+            if (!resolved || !/\.[cm]?[jt]sx?$/.test(resolved))
+                continue;
+            if (eligible(resolved)) {
+                links[specifier] = id(resolved);
+                await visit(resolved);
+                continue;
+            }
+            const sidecar = `${resolved}.zyzz.json`;
+            try {
+                contracts[resolved] = await Fs.readFile(sidecar, 'utf8');
+                context.addDependency(sidecar);
+                links[specifier] = resolved;
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+    }
+    async function discover(directory) {
+        const items = await Fs.readdir(directory, { withFileTypes: true });
+        // Recursive tracking of a package root follows every installed dependency.
+        // A dependency symlink back to an ancestor, as a package linked from its
+        // own repository, is rejected as a loop, so such a root is tracked through
+        // its files and subdirectories instead.
+        if (!items.some((item) => item.name === 'node_modules') ||
+            !(await loops(directory)))
+            context.addContextDependency(directory);
+        for (const item of items) {
+            if (item.name.startsWith('.') ||
+                [
+                    'node_modules',
+                    'dist',
+                    'build',
+                    'coverage',
+                    'test',
+                    'tests',
+                    '__tests__',
+                ].includes(item.name))
+                continue;
+            const file = Path.join(directory, item.name);
+            if (item.isDirectory())
+                await discover(file);
+            else if (item.isFile() && eligible(file))
+                await visit(file);
+        }
+    }
+    if (options.mode !== 'shared')
+        await visit(context.resourcePath, source);
+    await discover(root);
+    const loaded = new Set();
+    async function dependencies(file) {
+        if (loaded.has(file))
+            return;
+        loaded.add(file);
+        const metadata = Contract.read(contracts[file], new Map(), file);
+        for (const section of metadata.stylesheets) {
+            let owner = file;
+            for (const specifier of section.dependency ?? []) {
+                const target = await new Promise((accept, reject) => {
+                    resolve(Path.dirname(owner), specifier, (error, value) => error ? reject(error) : accept(value));
+                });
+                if (!target || !Path.isAbsolute(target))
+                    throw new Error('Unable to resolve packed stylesheet dependency.');
+                const links = (imports[owner] ??= Object.create(null));
+                links[specifier] = target;
+                if (!Object.hasOwn(contracts, target)) {
+                    const sidecar = `${target}.zyzz.json`;
+                    contracts[target] = await Fs.readFile(sidecar, 'utf8');
+                    context.addDependency(sidecar);
+                }
+                await dependencies(target);
+                owner = target;
+            }
+        }
+    }
+    for (const file of Object.keys(contracts))
+        await dependencies(file);
+    const graph = Graph.compile({ contracts, imports, modules });
+    const output = graph.modules[id(context.resourcePath)];
+    const assets = new Map();
+    for (const [placeholder, target] of Object.entries(graph.sharedAssets ?? {})) {
+        const raw = target.split(/[?#]/)[0];
+        const file = await Fs.realpath(target.startsWith('app/')
+            ? Path.join(root, decodeURIComponent(raw.slice(4)))
+            : decodeURIComponent(raw));
+        const identity = graph.sharedAssetOwners?.[placeholder];
+        let owner = root;
+        if (identity && Path.isAbsolute(identity)) {
+            owner = Path.dirname(identity);
+            for (;;) {
+                try {
+                    await Fs.access(Path.join(owner, 'package.json'));
+                    break;
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                    const parent = Path.dirname(owner);
+                    if (parent === owner)
+                        throw new Error('Packed assets require an owning package.json.');
+                    owner = parent;
+                }
+            }
+        }
+        const relative = Path.relative(await Fs.realpath(owner), file);
+        if (!identity ||
+            relative === '..' ||
+            relative.startsWith(`..${Path.sep}`) ||
+            Path.isAbsolute(relative))
+            throw new Error('Asset path escapes its owning package.');
+        context.addDependency(file);
+        assets.set(placeholder, Path.relative(options.bundler === 'turbopack'
+            ? Path.dirname(context.resourcePath)
+            : directory, file)
+            .split(Path.sep)
+            .map(encodeURIComponent)
+            .join('/') + target.slice(raw.length));
+    }
+    const shared = graph.sharedCss
+        ? AtRules.transform({
+            code: Buffer.from(graph.sharedCss),
+            filename: 'shared.css',
+            inputSourceMap: JSON.stringify(graph.sharedCssMap),
+            sourceMap: true,
+            visitor: {
+                Url: (url) => assets.has(url.url)
+                    ? { ...url, url: assets.get(url.url) }
+                    : undefined,
+            },
+        })
+        : undefined;
+    if (options.mode === 'shared')
+        return {
+            code: shared?.code.toString() ?? '',
+            map: shared?.map
+                ? JSON.parse(shared.map.toString())
+                : undefined,
+        };
+    if (!output)
+        throw new Error('Missing Next.js source compilation.');
+    // Bundlers resolve map sources relative to the loader resource, not graph identities.
+    const sources = (names) => names.map((name) => name?.startsWith('app/') ? Path.resolve(root, name.slice(4)) : name);
+    const map = {
+        ...output.map,
+        file: context.resourcePath,
+        sources: sources(output.map.sources),
+    };
+    const cssMap = { ...output.cssMap, sources: sources(output.cssMap.sources) };
+    if (options.mode === 'style')
+        return { code: output.css, map: cssMap };
+    if (options.bundler === 'turbopack') {
+        const sharedFile = Path.relative(Path.dirname(context.resourcePath), Path.join(directory, 'shared.css'))
+            .split(Path.sep)
+            .join('/');
+        const requests = [
+            ...(graph.sharedCss
+                ? [
+                    `import ${JSON.stringify(sharedFile.startsWith('.') ? sharedFile : `./${sharedFile}`)};`,
+                ]
+                : []),
+            ...(output.css
+                ? [
+                    `import ${JSON.stringify(`./${Path.basename(context.resourcePath)}?zyzz-style`)};`,
+                ]
+                : []),
+        ];
+        return { code: `${output.code}\n${requests.join('\n')}`, map };
+    }
+    const styles = [
+        { css: shared?.code.toString(), map: shared?.map?.toString() },
+        { css: output.css, map: JSON.stringify(cssMap) },
+    ];
+    const requests = [];
+    await Fs.mkdir(directory, { recursive: true });
+    for (const stylesheet of styles) {
+        if (!stylesheet.css)
+            continue;
+        const css = stylesheet.css +
+            (stylesheet.map
+                ? `\n/*# sourceMappingURL=data:application/json;base64,${Buffer.from(stylesheet.map).toString('base64')} */`
+                : '');
+        const hash = Crypto.createHash('sha256').update(css).digest('hex');
+        const file = Path.join(directory, `${hash}.css`);
+        try {
+            await Fs.writeFile(file, css, { flag: 'wx' });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+        const relative = Path.relative(Path.dirname(context.resourcePath), file)
+            .split(Path.sep)
+            .join('/');
+        requests.push(`import ${JSON.stringify(relative.startsWith('.') ? relative : `./${relative}`)};`);
+    }
+    return { code: `${output.code}\n${requests.join('\n')}`, map };
+}
+/** Whether an installed dependency links back to the directory or one of its ancestors. */
+async function loops(directory) {
+    const installed = Path.join(directory, 'node_modules');
+    const entries = await Fs.readdir(installed, { withFileTypes: true }).catch(() => []);
+    const candidates = (await Promise.all(entries.map(async (entry) => {
+        if (!entry.name.startsWith('@'))
+            return [Path.join(installed, entry.name)];
+        const scoped = Path.join(installed, entry.name);
+        return (await Fs.readdir(scoped).catch(() => [])).map((name) => Path.join(scoped, name));
+    }))).flat();
+    for (const candidate of candidates) {
+        const stat = await Fs.lstat(candidate).catch(() => undefined);
+        if (!stat?.isSymbolicLink())
+            continue;
+        const target = await Fs.realpath(candidate).catch(() => undefined);
+        if (target === undefined)
+            continue;
+        const relative = Path.relative(target, directory);
+        if (!relative.startsWith('..') && !Path.isAbsolute(relative))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=loader.js.map