@hanzo/next 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 hanzo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/** The subset of a Next config this package touches. Structural on purpose: it
+ *  must not pin a `next` version to type-check, and `NextConfig` moves. */
+export type Config = Record<string, unknown>;
+export type Options = {
+    /** App root — where node_modules and src live. Almost always `import.meta.dirname`. */
+    root: string;
+    /**
+     * Source aliases. Defaults to the one every Hanzo app uses, `~` → `<root>/src`.
+     * Values are resolved against `root`, so pass them relative.
+     */
+    alias?: Record<string, string>;
+    /**
+     * Extra packages to transpile, ON TOP of every discovered `@hanzogui/*` and the
+     * `@hanzo/*` packages that ship source. Additive — the discovered set is never
+     * replaced, because replacing it is how a satellite goes missing.
+     */
+    transpile?: string[];
+};
+/**
+ * Every installed `@hanzogui/*`, discovered rather than declared. An absent
+ * scope is not an error — an app may carry none.
+ */
+export declare function guiPackages(root: string): string[];
+/** The full transpile list for an app: the source packages, every installed gui
+ *  satellite, and whatever else the app names. Deduped, order-stable. */
+export declare function transpileList(root: string, extra?: string[]): string[];
+/**
+ * Wrap an app's own Next config with the shared answers.
+ *
+ * The app's config WINS on every key it states — this adds, it does not overrule.
+ * `webpack` is the one exception and it composes rather than replaces: the shared
+ * resolution is applied first, then the app's hook runs on the result, so an app
+ * can still reach the config without losing the aliases underneath it.
+ */
+export declare function hanzo(config: Config | undefined, options: Options): Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4CA;2EAC2E;AAC3E,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE5C,MAAM,MAAM,OAAO,GAAG;IACpB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlD;AAED;yEACyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,YAAK,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAgCnE"}

package/dist/index.js

@@ -0,0 +1,111 @@
+/**
+ * @hanzo/next — the Next.js config every Hanzo app shares.
+ *
+ *   import { hanzo } from '@hanzo/next'
+ *   export default hanzo(myOwnConfig, { root: import.meta.dirname })
+ *
+ * Not a preference: each item below is a thing that BREAKS, silently, and that
+ * every app on this stack hits identically. They were found one at a time, in
+ * one app, and re-deriving them per app is how a fleet drifts.
+ *
+ * WHAT IT ANSWERS
+ *
+ * 1. TypeScript 7 is a different engine with no JavaScript API. Next derives its
+ *    bundler aliases by reading tsconfig `paths` THROUGH the installed
+ *    typescript, so under 7 it reads nothing: every `~/…` import in a tree goes
+ *    unresolvable at once, while `tsc --noEmit` stays green — tsc resolves paths
+ *    itself and never asks the bundler. So a green typecheck and a dead build.
+ *    The alias is declared here instead, where it does not depend on which
+ *    compiler happens to be installed. (TS7 also REMOVED `baseUrl`, so the
+ *    tsconfig that used to carry one is now an error.)
+ *
+ * 2. The typecheck runs the local `tsc` BINARY (`experimental.useTypeScriptCli`,
+ *    which Next added for exactly this). The default backend calls the API TS7
+ *    does not publish, so the typecheck goes quietly ABSENT — the build passes by
+ *    not checking.
+ *
+ * 3. @hanzo/gui and its `@hanzogui/*` satellites ship ESM/TSX source, so they are
+ *    transpiled. The list is DISCOVERED from node_modules, never hardcoded: a
+ *    hardcoded list is wrong the day a satellite is added, and wrong quietly.
+ *
+ * 4. `react-native` means `react-native-web` on the web — EXACT match only, so a
+ *    deep `react-native/Libraries/*` import still finds the real package, which
+ *    is what its own `.web.js` files expect.
+ *
+ * A NOTE ON TURBOPACK. Next 16 defaults to it and these apps cannot use it yet:
+ * react-native-svg imports `TurboModuleRegistry` from `react-native`, which
+ * react-native-web does not export, and the alias that makes RN mean RNW is what
+ * surfaces it. That is a gap in the dependency, not a config mistake. So NAME the
+ * bundler at the call site (`next build --webpack`) rather than inheriting it —
+ * an inherited default is how this arrives as a CI failure instead of a decision.
+ */
+import { readdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/** Packages that ship ESM/TSX SOURCE rather than compiled dist, so a host must
+ *  transpile them. Kept here so one list serves the fleet. */
+const SOURCE_PACKAGES = [
+    '@hanzo/gui',
+    '@hanzo/ui',
+    '@hanzo/data',
+    '@hanzo/dash',
+    '@hanzo/canvas',
+    '@hanzo/usage',
+    'react-native-web',
+];
+/** Web builds prefer a `.web.*` implementation of a module. */
+const WEB_FIRST = ['.web.tsx', '.web.ts', '.web.jsx', '.web.js'];
+/**
+ * Every installed `@hanzogui/*`, discovered rather than declared. An absent
+ * scope is not an error — an app may carry none.
+ */
+export function guiPackages(root) {
+    try {
+        return readdirSync(join(root, 'node_modules', '@hanzogui')).map((n) => `@hanzogui/${n}`);
+    }
+    catch {
+        return [];
+    }
+}
+/** The full transpile list for an app: the source packages, every installed gui
+ *  satellite, and whatever else the app names. Deduped, order-stable. */
+export function transpileList(root, extra = []) {
+    return [...new Set([...SOURCE_PACKAGES, ...guiPackages(root), ...extra])];
+}
+/**
+ * Wrap an app's own Next config with the shared answers.
+ *
+ * The app's config WINS on every key it states — this adds, it does not overrule.
+ * `webpack` is the one exception and it composes rather than replaces: the shared
+ * resolution is applied first, then the app's hook runs on the result, so an app
+ * can still reach the config without losing the aliases underneath it.
+ */
+export function hanzo(config = {}, options) {
+    const { root, alias = { '~': './src' }, transpile = [] } = options;
+    const appWebpack = config.webpack;
+    const aliases = Object.fromEntries(Object.entries(alias).map(([from, to]) => [from, resolve(root, to)]));
+    return {
+        ...config,
+        transpilePackages: transpileList(root, [
+            ...transpile,
+            ...(config.transpilePackages ?? []),
+        ]),
+        experimental: {
+            esmExternals: true,
+            // Run the local tsc BINARY. See (2) above: the default backend reads an
+            // API TypeScript 7 does not publish, and a typecheck that silently does
+            // not run is worse than one that fails.
+            useTypeScriptCli: true,
+            ...(config.experimental ?? {}),
+        },
+        webpack(c, ctx) {
+            c.resolve.alias = { ...c.resolve.alias, ...aliases, 'react-native$': 'react-native-web' };
+            // Keep symlinked paths. A workspace-linked package resolved to its realpath
+            // walks up into ITS OWN node_modules and loads a second copy of the gui
+            // runtime — two copies, and React context identity dies at the boundary.
+            c.resolve.symlinks = false;
+            c.resolve.extensions = [...WEB_FIRST, ...c.resolve.extensions];
+            return appWebpack ? appWebpack(c, ctx) : c;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsBzC;8DAC8D;AAC9D,MAAM,eAAe,GAAG;IACtB,YAAY;IACZ,WAAW;IACX,aAAa;IACb,aAAa;IACb,eAAe;IACf,cAAc;IACd,kBAAkB;CACnB,CAAA;AAED,+DAA+D;AAC/D,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AAEhE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;yEACyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAK,GAAa,EAAE;IAC9D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,eAAe,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,MAAM,GAAW,EAAE,EAAE,OAAgB;IACzD,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAClE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAkD,CAAA;IAE5E,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CACrE,CAAA;IAED,OAAO;QACL,GAAG,MAAM;QACT,iBAAiB,EAAE,aAAa,CAAC,IAAI,EAAE;YACrC,GAAG,SAAS;YACZ,GAAG,CAAE,MAAM,CAAC,iBAA8B,IAAI,EAAE,CAAC;SAClD,CAAC;QACF,YAAY,EAAE;YACZ,YAAY,EAAE,IAAI;YAClB,wEAAwE;YACxE,wEAAwE;YACxE,wCAAwC;YACxC,gBAAgB,EAAE,IAAI;YACtB,GAAG,CAAE,MAAM,CAAC,YAAwC,IAAI,EAAE,CAAC;SAC5D;QACD,OAAO,CAAC,CAAM,EAAE,GAAQ;YACtB,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAA;YACzF,4EAA4E;YAC5E,wEAAwE;YACxE,yEAAyE;YACzE,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAA;YAC1B,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAC9D,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5C,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@hanzo/next",
+  "version": "0.1.0",
+  "description": "The Next.js config every Hanzo app shares — one runtime, one compiler, one way.",
+  "license": "MIT OR Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "next": ">=16"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hanzoai/ui.git",
+    "directory": "pkgs/next"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}