Colby McHenry
c15413f200
`ui/src` now builds two ways from one tree: the static app `codegraph ui` serves, and — via `svelte-package` — a Svelte library the Pro app imports. A forked component would be a second answer to the same question about the same graph, so there is no fork. Everything a screen knows arrives through a `GraphAdapter`: eleven methods answering the wire shapes verbatim, with `createHttpAdapter()` (the loopback JSON API) as the default and a host's in-process engine reads as the point. `lib/api.ts` became a one-line-per-call facade over it, which is why no call site in the views changed. The payload types moved to `lib/wire.ts` — no imports, no runtime — so a host can depend on the vocabulary alone. Two more seams and one guard: - `lib/navigation.ts` holds the href builders behind a `NavigationDriver`, so a host addresses its own URL space. The app's half — the hash parser and the live route, which attach window listeners at module scope — stays in `router.svelte.ts` and is pruned out of the package: rendering a Symbol view must not install a hash router in somebody else's application. - `lib/theme.css` carries the design tokens and maps Svelte Flow's `--xy-*` variables onto them, so a host never sees library defaults. Dark now also answers to a bare `[data-theme]`, which is how `<CodegraphUi theme>` themes a container rather than the document. - `scripts/check-ui-package.mjs` prunes the app's shell, resolves the extensionless specifiers svelte-package leaves behind, and asserts that nothing but `lib/adapter.js` reaches the network. The search box, its keyboard and its panel are one component now (`SearchPalette`), because splitting them is what breaks a palette. `__tests__/ui-package.test.ts` mounts the three screens from the package entry against a mock adapter in jsdom; it runs as a second vitest project so the `browser` resolve condition it needs cannot reach the engine's suites. Versioned with the engine. Prepared, not published: `private: true` is the guard and `pack-npm.sh` only packs a tarball under CODEGRAPH_PACK_UI=1.
154 lines
6.7 KiB
Bash
Executable File
154 lines
6.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
#
|
|
# Assemble the npm thin-installer packages from built bundles (esbuild pattern).
|
|
#
|
|
# Produces, under release/npm/:
|
|
# codegraph-<target>/ one per built bundle — the vendored Node + app, tagged
|
|
# with os/cpu so npm installs only the matching one.
|
|
# main/ the @colbymchenry/codegraph shim package: a tiny bin
|
|
# that execs the matching platform bundle, with every
|
|
# platform package in optionalDependencies.
|
|
#
|
|
# The release pipeline then `npm publish`es each dir. This does NOT touch the
|
|
# repo's package.json — the dev/from-source path keeps working; the *published*
|
|
# main package's shape is generated here.
|
|
#
|
|
# Prereq: run build-bundle.sh for each target first (release/codegraph-*.tar.gz).
|
|
# Usage: scripts/pack-npm.sh [version] (default: version from package.json)
|
|
set -euo pipefail
|
|
|
|
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
|
VERSION="${1:-$(node -p "require('$ROOT/package.json').version")}"
|
|
SCOPE="@colbymchenry"
|
|
REL="$ROOT/release"
|
|
NPM="$REL/npm"
|
|
|
|
rm -rf "$NPM"
|
|
mkdir -p "$NPM/main"
|
|
|
|
shopt -s nullglob
|
|
archives=("$REL"/codegraph-*.tar.gz "$REL"/codegraph-*.zip)
|
|
[ ${#archives[@]} -gt 0 ] || { echo "[pack-npm] no bundles in $REL — run build-bundle.sh first" >&2; exit 1; }
|
|
|
|
targets=()
|
|
for archive in "${archives[@]}"; do
|
|
fname="$(basename "$archive")"
|
|
case "$fname" in
|
|
*.tar.gz) base="${fname%.tar.gz}" ;; # codegraph-<target>
|
|
*.zip) base="${fname%.zip}" ;;
|
|
esac
|
|
target="${base#codegraph-}" # <target>, e.g. darwin-arm64 / win32-x64
|
|
os="${target%-*}" # darwin | linux | win32
|
|
arch="${target##*-}" # arm64 | x64
|
|
pkgdir="$NPM/$base"
|
|
mkdir -p "$pkgdir"
|
|
case "$fname" in
|
|
*.zip)
|
|
tmpx="$(mktemp -d)"
|
|
unzip -q "$archive" -d "$tmpx"
|
|
mv "$tmpx/codegraph-${target}"/* "$pkgdir"/
|
|
rm -rf "$tmpx"
|
|
nodefile="node.exe"
|
|
;;
|
|
*)
|
|
tar -xzf "$archive" -C "$pkgdir" --strip-components=1
|
|
nodefile="node"
|
|
;;
|
|
esac
|
|
# The browser viewer must survive the archive round-trip too: a tar/zip that
|
|
# dropped dist/viewer would publish a platform package whose `codegraph ui`
|
|
# serves a 404.
|
|
node "$ROOT/scripts/check-ui-build.mjs" --root "$pkgdir/lib"
|
|
VERSION="$VERSION" SCOPE="$SCOPE" TARGET="$target" OSV="$os" ARCHV="$arch" NODEFILE="$nodefile" \
|
|
node -e '
|
|
const fs=require("fs");
|
|
fs.writeFileSync(process.argv[1], JSON.stringify({
|
|
name: `${process.env.SCOPE}/codegraph-${process.env.TARGET}`,
|
|
version: process.env.VERSION,
|
|
description: `CodeGraph self-contained bundle for ${process.env.TARGET}`,
|
|
os: [process.env.OSV], cpu: [process.env.ARCHV],
|
|
files: [process.env.NODEFILE, "lib", "bin"],
|
|
license: "MIT",
|
|
// npm --provenance refuses to publish unless this matches the repo
|
|
// the release workflow runs in.
|
|
repository: { type: "git", url: "git+https://github.com/colbymchenry/codegraph.git" }
|
|
}, null, 2) + "\n");
|
|
' "$pkgdir/package.json"
|
|
targets+=("$target")
|
|
echo "[pack-npm] ${SCOPE}/codegraph-${target}@${VERSION}"
|
|
done
|
|
|
|
# Main shim package.
|
|
# npm-shim.js CLI/MCP launcher (execs the bundled Node) — the `bin`.
|
|
# npm-sdk.js programmatic/embedded entry (#354): re-exports the installed
|
|
# platform bundle's compiled library — the `main`.
|
|
# dist/ the .d.ts tree only (types). The runtime .js stays in the
|
|
# per-platform bundle so its deps aren't duplicated here.
|
|
cp "$ROOT/scripts/npm-shim.js" "$NPM/main/npm-shim.js"
|
|
cp "$ROOT/scripts/npm-sdk.js" "$NPM/main/npm-sdk.js"
|
|
[ -f "$ROOT/README.md" ] && cp "$ROOT/README.md" "$NPM/main/README.md"
|
|
|
|
# Ship the type declarations so `types`/`exports.types` resolve. Built from this
|
|
# same release, so they can't skew from the runtime npm-sdk.js re-exports.
|
|
[ -f "$ROOT/dist/index.d.ts" ] || ( echo "[pack-npm] building dist for .d.ts" >&2 && cd "$ROOT" && npm run build >/dev/null )
|
|
ROOT="$ROOT" DEST="$NPM/main" node -e '
|
|
const fs=require("fs"), path=require("path");
|
|
const src=path.join(process.env.ROOT,"dist"), dest=path.join(process.env.DEST,"dist");
|
|
fs.cpSync(src, dest, { recursive:true, filter(s){
|
|
try { return fs.statSync(s).isDirectory() || s.endsWith(".d.ts"); } catch (e) { return false; }
|
|
}});
|
|
'
|
|
|
|
VERSION="$VERSION" SCOPE="$SCOPE" TARGETS="${targets[*]}" \
|
|
node -e '
|
|
const fs=require("fs");
|
|
const opt={};
|
|
for (const t of process.env.TARGETS.split(/\s+/).filter(Boolean))
|
|
opt[`${process.env.SCOPE}/codegraph-${t}`]=process.env.VERSION;
|
|
fs.writeFileSync(process.argv[1], JSON.stringify({
|
|
name: `${process.env.SCOPE}/codegraph`,
|
|
version: process.env.VERSION,
|
|
description: "Local-first code intelligence for AI agents (MCP). Self-contained — bundles its own runtime.",
|
|
bin: { codegraph: "npm-shim.js" },
|
|
main: "npm-sdk.js",
|
|
types: "dist/index.d.ts",
|
|
exports: {
|
|
".": { types: "./dist/index.d.ts", default: "./npm-sdk.js" },
|
|
"./package.json": "./package.json"
|
|
},
|
|
optionalDependencies: opt,
|
|
files: ["npm-shim.js","npm-sdk.js","dist","README.md"],
|
|
license: "MIT",
|
|
repository: { type: "git", url: "git+https://github.com/colbymchenry/codegraph.git" }
|
|
}, null, 2) + "\n");
|
|
' "$NPM/main/package.json"
|
|
|
|
echo "[pack-npm] ${SCOPE}/codegraph@${VERSION} (${#targets[@]} platform packages in optionalDependencies)"
|
|
echo "[pack-npm] output: $NPM"
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# @colbymchenry/codegraph-ui — the viewer's components as a Svelte library.
|
|
#
|
|
# Staged into release/npm-ui/, NOT release/npm/: the workflow publishes
|
|
# `release/npm/codegraph-*` by glob, and a directory named codegraph-ui in
|
|
# there would be swept into that loop the moment it existed.
|
|
#
|
|
# OFF by default. The package is prepared, versioned with the engine and
|
|
# tested (CG-61), but publishing it is a decision the maintainer has not
|
|
# made — and `ui/package.json` still carries `"private": true`, which is what
|
|
# actually stops an accidental `npm publish`. Set CODEGRAPH_PACK_UI=1 to build
|
|
# the tarball; publishing it additionally means removing that flag.
|
|
# ---------------------------------------------------------------------------
|
|
if [ "${CODEGRAPH_PACK_UI:-0}" = "1" ]; then
|
|
UIREL="$REL/npm-ui"
|
|
rm -rf "$UIREL"
|
|
mkdir -p "$UIREL"
|
|
( cd "$ROOT" && npm run build:lib --workspace ui )
|
|
# `npm pack` honours "files" and works on a private package; `npm publish`
|
|
# does not, which is exactly the guard we want to keep for now.
|
|
( cd "$ROOT/ui" && npm pack --pack-destination "$UIREL" >/dev/null )
|
|
echo "[pack-npm] ${SCOPE}/codegraph-ui@${VERSION} packed (not published) -> $UIREL"
|
|
else
|
|
echo "[pack-npm] skipping ${SCOPE}/codegraph-ui (set CODEGRAPH_PACK_UI=1 to pack it)"
|
|
fi
|