@nyar/nyar 0.0.0 → 0.0.1

package/README.md

@@ -0,0 +1,20 @@
+# @nyar/nyar
+
+Cross-platform npm facade for the Nyar VM CLI and host APIs. Native and Wasm sidecars are published as separate platform packages under `projects/packages/`.
+
+## Example
+
+```typescript
+import { createNyarHost } from "@nyar/nyar";
+
+const host = await createNyarHost();
+await host.runBytecode(bytes);
+```
+
+Platform-specific binaries (`nyar-win32-x64`, `nyar-linux-x64`, `nyar-darwin-*`, `nyar-unknown-wasm32`) are resolved automatically when this package is installed on a matching host.
+
+Build collect steps (`pnpm build:napi`, `pnpm build:wasm`) live in repository maintainer docs, not on this registry page.
+
+## License
+
+MIT

package/bin/nyar.js

@@ -1,53 +1,53 @@
-#!/usr/bin/env node
-import { spawnSync } from 'node:child_process';
-import { createRequire } from 'node:module';
-
-import { hostPlatformKey, resolveCollect } from '../src/platform.ts';
-
-const require = createRequire(import.meta.url);
-const pkg = require('../package.json');
-
-function printUsage() {
-    console.error(`@nyar/nyar ${pkg.version} (${hostPlatformKey()})`);
-    console.error('Usage: nyar <command> [args...]');
-    console.error('Commands:');
-    console.error('  host-info   Print resolved platform collect metadata');
-    console.error('  version     Print package version');
-}
-
-function cmdHostInfo() {
-    const collect = resolveCollect();
-    console.log(JSON.stringify({ version: pkg.version, host: hostPlatformKey(), collect }, null, 2));
-}
-
-function cmdVersion() {
-    console.log(pkg.version);
-}
-
-const [command, ...rest] = process.argv.slice(2);
-
-if (!command || command === '--help' || command === '-h') {
-    printUsage();
-    process.exit(command ? 0 : 1);
-}
-
-if (command === 'version' || command === '--version' || command === '-V') {
-    cmdVersion();
-    process.exit(0);
-}
-
-if (command === 'host-info') {
-    cmdHostInfo();
-    process.exit(0);
-}
-
-// Forward unknown commands to wasmtime when the wasm collect is present (maintainer / CI path).
-const collect = resolveCollect();
-if (collect.kind === 'wasm' && rest.length > 0) {
-    const result = spawnSync('wasmtime', [collect.entry, ...rest], { stdio: 'inherit', shell: false });
-    process.exit(result.status ?? 1);
-}
-
-console.error(`nyar: unknown command '${command}'`);
-printUsage();
-process.exit(1);
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+import { hostPlatformKey, resolveCollect } from '../src/platform.ts';
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
+function printUsage() {
+    console.error(`@nyar/nyar ${pkg.version} (${hostPlatformKey()})`);
+    console.error('Usage: nyar <command> [args...]');
+    console.error('Commands:');
+    console.error('  host-info   Print resolved platform collect metadata');
+    console.error('  version     Print package version');
+}
+
+function cmdHostInfo() {
+    const collect = resolveCollect();
+    console.log(JSON.stringify({ version: pkg.version, host: hostPlatformKey(), collect }, null, 2));
+}
+
+function cmdVersion() {
+    console.log(pkg.version);
+}
+
+const [command, ...rest] = process.argv.slice(2);
+
+if (!command || command === '--help' || command === '-h') {
+    printUsage();
+    process.exit(command ? 0 : 1);
+}
+
+if (command === 'version' || command === '--version' || command === '-V') {
+    cmdVersion();
+    process.exit(0);
+}
+
+if (command === 'host-info') {
+    cmdHostInfo();
+    process.exit(0);
+}
+
+// Forward unknown commands to wasmtime when the wasm collect is present (maintainer / CI path).
+const collect = resolveCollect();
+if (collect.kind === 'wasm' && rest.length > 0) {
+    const result = spawnSync('wasmtime', [collect.entry, ...rest], { stdio: 'inherit', shell: false });
+    process.exit(result.status ?? 1);
+}
+
+console.error(`nyar: unknown command '${command}'`);
+printUsage();
+process.exit(1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nyar/nyar",
-  "version": "0.0.0",
-  "description": "Nyar VM ? cross-platform CLI (assembled from platform collects).",
+  "version": "0.0.1",
+  "description": "Nyar VM — cross-platform CLI (assembled from platform collects).",
   "type": "module",
   "license": "MIT",
   "main": "src/index.ts",
@@ -18,13 +18,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@nyar/nyar-unknown-wasm32": "0.0.0"
+    "@nyar/nyar-unknown-wasm32": "0.0.1"
   },
   "optionalDependencies": {
-    "@nyar/nyar-win32-x64": "0.0.0",
-    "@nyar/nyar-darwin-x64": "0.0.0",
-    "@nyar/nyar-linux-x64": "0.0.0",
-    "@nyar/nyar-darwin-arm64": "0.0.0"
+    "@nyar/nyar-win32-x64": "0.0.1",
+    "@nyar/nyar-linux-x64": "0.0.1",
+    "@nyar/nyar-darwin-x64": "0.0.1",
+    "@nyar/nyar-darwin-arm64": "0.0.1"
   },
   "engines": {
     "node": ">=20"
@@ -42,6 +42,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {}
-}
+  }
+}

package/readme.md

@@ -1,20 +1,20 @@
-# @nyar/nyar
-
-Cross-platform npm facade for the Nyar VM CLI and host APIs. Native and Wasm sidecars are published as separate platform packages under `projects/packages/`.
-
-## Example
-
-```typescript
-import { createNyarHost } from "@nyar/nyar";
-
-const host = await createNyarHost();
-await host.runBytecode(bytes);
-```
-
-Platform-specific binaries (`nyar-win32-x64`, `nyar-linux-x64`, `nyar-darwin-*`, `nyar-unknown-wasm32`) are resolved automatically when this package is installed on a matching host.
-
-Build collect steps (`pnpm build:napi`, `pnpm build:wasm`) live in repository maintainer docs, not on this registry page.
-
-## License
-
-MIT
+# @nyar/nyar
+
+Cross-platform npm facade for the Nyar VM CLI and host APIs. Native and Wasm sidecars are published as separate platform packages under `projects/packages/`.
+
+## Example
+
+```typescript
+import { createNyarHost } from "@nyar/nyar";
+
+const host = await createNyarHost();
+await host.runBytecode(bytes);
+```
+
+Platform-specific binaries (`nyar-win32-x64`, `nyar-linux-x64`, `nyar-darwin-*`, `nyar-unknown-wasm32`) are resolved automatically when this package is installed on a matching host.
+
+Build collect steps (`pnpm build:napi`, `pnpm build:wasm`) live in repository maintainer docs, not on this registry page.
+
+## License
+
+MIT

package/src/index.ts

@@ -1,38 +1,38 @@
-import { readFile } from 'node:fs/promises';
-
-import { type NyarCollect, resolveCollect } from './platform.ts';
-
-export { hostPlatformKey, type NyarCollect, resolveCollect } from './platform.ts';
-
-export type NyarHost = {
-    /** Resolved platform collect metadata for diagnostics and tooling. */
-    collect: NyarCollect;
-    /** Load bytecode bytes (0.0.0 placeholder — execution wiring lands with Node-API host exports). */
-    runBytecode(bytes: Uint8Array): Promise<void>;
-};
-
-/**
- * Create a Nyar host for the current platform.
- *
- * Native collects are preferred when the matching optional dependency is installed;
- * otherwise the Wasm GC collect from `@nyar/nyar-unknown-wasm32` is used.
- */
-export async function createNyarHost(): Promise<NyarHost> {
-    const collect = resolveCollect();
-    return {
-        collect,
-        async runBytecode(bytes: Uint8Array) {
-            if (bytes.length === 0) {
-                throw new Error('nyar host received empty bytecode payload');
-            }
-            // 0.0.0 ships collect layout only; bytecode execution is wired in the next host export drop.
-            await readFile(collect.entry);
-            throw new Error(
-                `nyar host collect resolved (${collect.kind} via ${collect.packageName}) but bytecode execution is not wired in 0.0.0`,
-            );
-        },
-    };
-}
-
-/** @deprecated Use {@link createNyarHost}. */
-export const NYAR_CLI_PLACEHOLDER = 'nyar';
+import { readFile } from 'node:fs/promises';
+
+import { type NyarCollect, resolveCollect } from './platform.ts';
+
+export { hostPlatformKey, type NyarCollect, resolveCollect } from './platform.ts';
+
+export type NyarHost = {
+    /** Resolved platform collect metadata for diagnostics and tooling. */
+    collect: NyarCollect;
+    /** Load bytecode bytes (0.0.0 placeholder — execution wiring lands with Node-API host exports). */
+    runBytecode(bytes: Uint8Array): Promise<void>;
+};
+
+/**
+ * Create a Nyar host for the current platform.
+ *
+ * Native collects are preferred when the matching optional dependency is installed;
+ * otherwise the Wasm GC collect from `@nyar/nyar-unknown-wasm32` is used.
+ */
+export async function createNyarHost(): Promise<NyarHost> {
+    const collect = resolveCollect();
+    return {
+        collect,
+        async runBytecode(bytes: Uint8Array) {
+            if (bytes.length === 0) {
+                throw new Error('nyar host received empty bytecode payload');
+            }
+            // 0.0.0 ships collect layout only; bytecode execution is wired in the next host export drop.
+            await readFile(collect.entry);
+            throw new Error(
+                `nyar host collect resolved (${collect.kind} via ${collect.packageName}) but bytecode execution is not wired in 0.0.0`,
+            );
+        },
+    };
+}
+
+/** @deprecated Use {@link createNyarHost}. */
+export const NYAR_CLI_PLACEHOLDER = 'nyar';

package/src/platform.ts

@@ -1,68 +1,68 @@
-import { createRequire } from 'node:module';
-import { arch, platform } from 'node:os';
-import { fileURLToPath } from 'node:url';
-
-const HOST_KEY = `${platform()}-${arch()}`;
-
-const OPTIONAL_NATIVE_PACKAGES: Record<string, string> = {
-    'win32-x64': '@nyar/nyar-win32-x64',
-    'linux-x64': '@nyar/nyar-linux-x64',
-    'darwin-x64': '@nyar/nyar-darwin-x64',
-    'darwin-arm64': '@nyar/nyar-darwin-arm64',
-};
-
-const WASM_PACKAGE = '@nyar/nyar-unknown-wasm32';
-
-export type NyarCollectKind = 'native' | 'wasm';
-
-export type NyarCollect = {
-    kind: NyarCollectKind;
-    packageName: string;
-    entry: string;
-};
-
-export function hostPlatformKey(): string {
-    return HOST_KEY;
-}
-
-export function resolveNativeCollectPackage(): string | undefined {
-    return OPTIONAL_NATIVE_PACKAGES[HOST_KEY];
-}
-
-export function resolveWasmCollectPackage(): string {
-    return WASM_PACKAGE;
-}
-
-function requireOptional(packageName: string): { resolve(request: string): string } | undefined {
-    const require = createRequire(fileURLToPath(import.meta.url));
-    try {
-        require.resolve(packageName);
-        return createRequire(require.resolve(`${packageName}/package.json`));
-    } catch {
-        return undefined;
-    }
-}
-
-export function resolveCollect(): NyarCollect {
-    const nativePackage = resolveNativeCollectPackage();
-    if (nativePackage) {
-        const req = requireOptional(nativePackage);
-        if (req) {
-            const entry =
-                HOST_KEY === 'win32-x64'
-                    ? req.resolve('./nyar_napi.dll')
-                    : req.resolve(`./libnyar_napi.${HOST_KEY.startsWith('darwin') ? 'dylib' : 'so'}`);
-            return { kind: 'native', packageName: nativePackage, entry };
-        }
-    }
-
-    const wasmReq = requireOptional(WASM_PACKAGE);
-    if (!wasmReq) {
-        throw new Error(`missing required dependency ${WASM_PACKAGE}; install workspace collects before publishing`);
-    }
-    return {
-        kind: 'wasm',
-        packageName: WASM_PACKAGE,
-        entry: wasmReq.resolve(`${WASM_PACKAGE}/nyar.wasm`),
-    };
-}
+import { createRequire } from 'node:module';
+import { arch, platform } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const HOST_KEY = `${platform()}-${arch()}`;
+
+const OPTIONAL_NATIVE_PACKAGES: Record<string, string> = {
+    'win32-x64': '@nyar/nyar-win32-x64',
+    'linux-x64': '@nyar/nyar-linux-x64',
+    'darwin-x64': '@nyar/nyar-darwin-x64',
+    'darwin-arm64': '@nyar/nyar-darwin-arm64',
+};
+
+const WASM_PACKAGE = '@nyar/nyar-unknown-wasm32';
+
+export type NyarCollectKind = 'native' | 'wasm';
+
+export type NyarCollect = {
+    kind: NyarCollectKind;
+    packageName: string;
+    entry: string;
+};
+
+export function hostPlatformKey(): string {
+    return HOST_KEY;
+}
+
+export function resolveNativeCollectPackage(): string | undefined {
+    return OPTIONAL_NATIVE_PACKAGES[HOST_KEY];
+}
+
+export function resolveWasmCollectPackage(): string {
+    return WASM_PACKAGE;
+}
+
+function requireOptional(packageName: string): { resolve(request: string): string } | undefined {
+    const require = createRequire(fileURLToPath(import.meta.url));
+    try {
+        require.resolve(packageName);
+        return createRequire(require.resolve(`${packageName}/package.json`));
+    } catch {
+        return undefined;
+    }
+}
+
+export function resolveCollect(): NyarCollect {
+    const nativePackage = resolveNativeCollectPackage();
+    if (nativePackage) {
+        const req = requireOptional(nativePackage);
+        if (req) {
+            const entry =
+                HOST_KEY === 'win32-x64'
+                    ? req.resolve('./nyar_napi.dll')
+                    : req.resolve(`./libnyar_napi.${HOST_KEY.startsWith('darwin') ? 'dylib' : 'so'}`);
+            return { kind: 'native', packageName: nativePackage, entry };
+        }
+    }
+
+    const wasmReq = requireOptional(WASM_PACKAGE);
+    if (!wasmReq) {
+        throw new Error(`missing required dependency ${WASM_PACKAGE}; install workspace collects before publishing`);
+    }
+    return {
+        kind: 'wasm',
+        packageName: WASM_PACKAGE,
+        entry: wasmReq.resolve(`${WASM_PACKAGE}/nyar.wasm`),
+    };
+}