@hagicode/hagiscript 0.1.0

package/dist/runtime/node-verify.d.ts

@@ -0,0 +1,20 @@
+export interface RuntimeExecutablePaths {
+    nodePath: string;
+    npmPath: string;
+}
+export interface NodeRuntimeVerificationResult {
+    valid: boolean;
+    targetDirectory: string;
+    nodeVersion?: string;
+    npmVersion?: string;
+    nodePath?: string;
+    npmPath?: string;
+    failureReason?: string;
+}
+export interface VerifyNodeRuntimeOptions {
+    platform?: NodeJS.Platform;
+    timeoutMs?: number;
+    runCommand?: (command: string, args: string[], timeoutMs: number) => Promise<string>;
+}
+export declare function verifyNodeRuntime(targetDirectory: string, options?: VerifyNodeRuntimeOptions): Promise<NodeRuntimeVerificationResult>;
+export declare function getRuntimeExecutablePaths(targetDirectory: string, platform?: NodeJS.Platform): RuntimeExecutablePaths;

package/dist/runtime/node-verify.js

@@ -0,0 +1,66 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { constants } from "node:fs";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function verifyNodeRuntime(targetDirectory, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const runCommand = options.runCommand ?? runVersionCommand;
+    const paths = getRuntimeExecutablePaths(targetDirectory, options.platform);
+    try {
+        await access(paths.nodePath, constants.X_OK);
+        await access(paths.npmPath, constants.X_OK);
+        const [nodeVersion, npmVersion] = await Promise.all([
+            runCommand(paths.nodePath, ["--version"], timeoutMs),
+            runCommand(paths.npmPath, ["--version"], timeoutMs)
+        ]);
+        return {
+            valid: true,
+            targetDirectory,
+            nodeVersion: nodeVersion.trim(),
+            npmVersion: npmVersion.trim(),
+            nodePath: paths.nodePath,
+            npmPath: paths.npmPath
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            targetDirectory,
+            nodePath: paths.nodePath,
+            npmPath: paths.npmPath,
+            failureReason: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+export function getRuntimeExecutablePaths(targetDirectory, platform = process.platform) {
+    if (platform === "win32") {
+        return {
+            nodePath: join(targetDirectory, "node.exe"),
+            npmPath: join(targetDirectory, "npm.cmd")
+        };
+    }
+    return {
+        nodePath: join(targetDirectory, "bin", "node"),
+        npmPath: join(targetDirectory, "bin", "npm")
+    };
+}
+async function runVersionCommand(command, args, timeoutMs) {
+    try {
+        const { stdout } = await execFileAsync(command, args, {
+            timeout: timeoutMs,
+            windowsHide: true,
+            maxBuffer: 1024 * 1024
+        });
+        return stdout;
+    }
+    catch (error) {
+        const execError = error;
+        const stderr = typeof execError.stderr === "string" ? execError.stderr.trim() : "";
+        throw new Error(stderr.length > 0
+            ? stderr
+            : `Command failed: ${command} ${args.join(" ")}`);
+    }
+}
+//# sourceMappingURL=node-verify.js.map

package/dist/runtime/node-verify.js.map

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

package/dist/runtime/npm-global.d.ts

@@ -0,0 +1,20 @@
+export interface NpmCommandResult {
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+}
+export interface NpmCommandFailureContext extends NpmCommandResult {
+    exitCode?: string | number | null;
+}
+export declare class NpmCommandError extends Error {
+    readonly context: NpmCommandFailureContext;
+    constructor(message: string, context: NpmCommandFailureContext);
+}
+export interface NpmGlobalCommandOptions {
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    runCommand?: (command: string, args: string[], timeoutMs: number) => Promise<NpmCommandResult>;
+}
+export declare function listGlobalPackages(npmPath: string, options?: NpmGlobalCommandOptions): Promise<NpmCommandResult>;
+export declare function installGlobalPackage(npmPath: string, selector: string, options?: NpmGlobalCommandOptions): Promise<NpmCommandResult>;

package/dist/runtime/npm-global.js

@@ -0,0 +1,53 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export class NpmCommandError extends Error {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.name = "NpmCommandError";
+        this.context = context;
+    }
+}
+export async function listGlobalPackages(npmPath, options = {}) {
+    return runNpmCommand(npmPath, ["list", "-g", "--depth=0", "--json"], options);
+}
+export async function installGlobalPackage(npmPath, selector, options = {}) {
+    return runNpmCommand(npmPath, ["install", "-g", selector], options);
+}
+async function runNpmCommand(npmPath, args, options) {
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    const runner = options.runCommand
+        ? options.runCommand
+        : (command, commandArgs, commandTimeoutMs) => execNpmCommand(command, commandArgs, commandTimeoutMs, options.env);
+    return runner(npmPath, args, timeoutMs);
+}
+async function execNpmCommand(command, args, timeoutMs, env) {
+    try {
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            timeout: timeoutMs,
+            windowsHide: true,
+            env,
+            maxBuffer: 10 * 1024 * 1024
+        });
+        return {
+            command,
+            args,
+            stdout,
+            stderr
+        };
+    }
+    catch (error) {
+        const execError = error;
+        const stdout = typeof execError.stdout === "string" ? execError.stdout : "";
+        const stderr = typeof execError.stderr === "string" ? execError.stderr : "";
+        throw new NpmCommandError(`npm command failed: ${command} ${args.join(" ")}`, {
+            command,
+            args,
+            stdout,
+            stderr,
+            exitCode: execError.code
+        });
+    }
+}
+//# sourceMappingURL=npm-global.js.map

package/dist/runtime/npm-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-global.js","sourceRoot":"","sources":["../../src/runtime/npm-global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAa1C,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,OAAO,CAA2B;IAE3C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAYD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAAmC,EAAE;IAErC,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,QAAgB,EAChB,UAAmC,EAAE;IAErC,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,IAAc,EACd,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU;QAC/B,CAAC,CAAC,OAAO,CAAC,UAAU;QACpB,CAAC,CAAC,CAAC,OAAe,EAAE,WAAqB,EAAE,gBAAwB,EAAE,EAAE,CACnE,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1E,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,OAAe,EACf,IAAc,EACd,SAAiB,EACjB,GAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;YAC5D,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,IAAI;YACjB,GAAG;YACH,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,IAAI;YACJ,MAAM;YACN,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAE5E,MAAM,IAAI,eAAe,CACvB,uBAAuB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAClD;YACE,OAAO;YACP,IAAI;YACJ,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,SAAS,CAAC,IAAI;SACzB,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/npm-sync.d.ts

@@ -0,0 +1,94 @@
+import { NpmCommandError, type NpmGlobalCommandOptions } from "./npm-global.js";
+import { verifyNodeRuntime } from "./node-verify.js";
+export interface NpmSyncManifestEntry {
+    version: string;
+    target?: string;
+}
+export interface NpmSyncManifest {
+    packages: Record<string, NpmSyncManifestEntry>;
+}
+export type InstalledGlobalPackages = Record<string, string>;
+export type NpmSyncActionKind = "noop" | "install" | "upgrade" | "downgrade" | "sync";
+export interface NpmSyncPlannedAction {
+    packageName: string;
+    requiredRange: string;
+    targetSelector: string;
+    selectedInstallSelector: string;
+    installedVersion?: string;
+    action: NpmSyncActionKind;
+}
+export interface NpmSyncActionResult extends NpmSyncPlannedAction {
+    changed: boolean;
+    command?: string;
+    args?: string[];
+    stdout?: string;
+    stderr?: string;
+}
+export interface NpmSyncRuntimeMetadata {
+    targetDirectory: string;
+    nodePath: string;
+    npmPath: string;
+    nodeVersion: string;
+    npmVersion: string;
+}
+export interface NpmSyncSummary {
+    runtime: NpmSyncRuntimeMetadata;
+    manifestPath: string;
+    packageCount: number;
+    noopCount: number;
+    changedCount: number;
+    actions: NpmSyncActionResult[];
+}
+export interface NpmSyncOptions {
+    runtimePath: string;
+    manifestPath: string;
+    npmOptions?: NpmGlobalCommandOptions;
+    verifyRuntime?: typeof verifyNodeRuntime;
+    onLog?: (event: NpmSyncLogEvent) => void;
+}
+export type NpmSyncLogEvent = {
+    type: "manifest-loaded";
+    manifestPath: string;
+    packageCount: number;
+} | {
+    type: "runtime-valid";
+    runtime: NpmSyncRuntimeMetadata;
+} | {
+    type: "inventory";
+    packages: InstalledGlobalPackages;
+} | {
+    type: "planned-action";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "skip";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "install-start";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "install-complete";
+    action: NpmSyncActionResult;
+} | {
+    type: "summary";
+    summary: NpmSyncSummary;
+};
+export declare class NpmSyncError extends Error {
+    constructor(message: string);
+}
+export declare class NpmManifestValidationError extends NpmSyncError {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+export declare class NpmSyncCommandError extends NpmSyncError {
+    readonly packageName?: string;
+    readonly command: string;
+    readonly args: string[];
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(message: string, error: NpmCommandError, packageName?: string);
+}
+export declare function loadNpmSyncManifest(manifestPath: string): Promise<NpmSyncManifest>;
+export declare function validateNpmSyncManifest(value: unknown): NpmSyncManifest;
+export declare function normalizeGlobalInventory(stdout: string): InstalledGlobalPackages;
+export declare function createNpmSyncPlan(manifest: NpmSyncManifest, installed: InstalledGlobalPackages): NpmSyncPlannedAction[];
+export declare function syncNpmGlobals(options: NpmSyncOptions): Promise<NpmSyncSummary>;

package/dist/runtime/npm-sync.js

@@ -0,0 +1,290 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import semver from "semver";
+import { installGlobalPackage, listGlobalPackages, NpmCommandError } from "./npm-global.js";
+import { verifyNodeRuntime } from "./node-verify.js";
+export class NpmSyncError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NpmSyncError";
+    }
+}
+export class NpmManifestValidationError extends NpmSyncError {
+    errors;
+    constructor(errors) {
+        super(`Manifest validation failed: ${errors.join("; ")}`);
+        this.name = "NpmManifestValidationError";
+        this.errors = errors;
+    }
+}
+export class NpmSyncCommandError extends NpmSyncError {
+    packageName;
+    command;
+    args;
+    stdout;
+    stderr;
+    constructor(message, error, packageName) {
+        super(message);
+        this.name = "NpmSyncCommandError";
+        this.packageName = packageName;
+        this.command = error.context.command;
+        this.args = error.context.args;
+        this.stdout = error.context.stdout;
+        this.stderr = error.context.stderr;
+    }
+}
+export async function loadNpmSyncManifest(manifestPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new NpmSyncError(`Failed to read manifest ${manifestPath}: ${message}`);
+    }
+    return validateNpmSyncManifest(parsed);
+}
+export function validateNpmSyncManifest(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        throw new NpmManifestValidationError(["manifest must be a JSON object"]);
+    }
+    if (!isRecord(value.packages) || Array.isArray(value.packages)) {
+        throw new NpmManifestValidationError([
+            "manifest must contain a top-level packages object"
+        ]);
+    }
+    const packages = {};
+    for (const [packageName, entry] of Object.entries(value.packages)) {
+        if (!isValidPackageName(packageName)) {
+            errors.push(`invalid package name: ${packageName}`);
+            continue;
+        }
+        if (!isRecord(entry) || Array.isArray(entry)) {
+            errors.push(`${packageName} must be an object with a version range`);
+            continue;
+        }
+        const version = entry.version;
+        if (typeof version !== "string" || version.trim().length === 0) {
+            errors.push(`${packageName}.version must be a non-empty semver range`);
+            continue;
+        }
+        const normalizedRange = version.trim();
+        if (!semver.validRange(normalizedRange)) {
+            errors.push(`${packageName}.version is not a valid semver range: ${version}`);
+            continue;
+        }
+        const target = entry.target;
+        if (target !== undefined) {
+            if (typeof target !== "string" || target.trim().length === 0) {
+                errors.push(`${packageName}.target must be a non-empty npm selector`);
+                continue;
+            }
+            packages[packageName] = {
+                version: normalizedRange,
+                target: target.trim()
+            };
+            continue;
+        }
+        packages[packageName] = { version: normalizedRange };
+    }
+    if (errors.length > 0) {
+        throw new NpmManifestValidationError(errors);
+    }
+    return { packages };
+}
+export function normalizeGlobalInventory(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new NpmSyncError(`Failed to parse npm inventory JSON: ${message}`);
+    }
+    if (!isRecord(parsed) || !isRecord(parsed.dependencies)) {
+        return {};
+    }
+    const installed = {};
+    for (const [packageName, dependency] of Object.entries(parsed.dependencies)) {
+        if (!isRecord(dependency) || typeof dependency.version !== "string") {
+            continue;
+        }
+        installed[packageName] = dependency.version;
+    }
+    return installed;
+}
+export function createNpmSyncPlan(manifest, installed) {
+    return Object.entries(manifest.packages)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([packageName, entry]) => {
+        const installedVersion = installed[packageName];
+        const targetSelector = entry.target ?? entry.version;
+        const selectedInstallSelector = `${packageName}@${targetSelector}`;
+        if (!installedVersion) {
+            return {
+                packageName,
+                requiredRange: entry.version,
+                targetSelector,
+                selectedInstallSelector,
+                action: "install"
+            };
+        }
+        if (semver.satisfies(installedVersion, entry.version, {
+            includePrerelease: true
+        })) {
+            return {
+                packageName,
+                requiredRange: entry.version,
+                targetSelector,
+                selectedInstallSelector,
+                installedVersion,
+                action: "noop"
+            };
+        }
+        return {
+            packageName,
+            requiredRange: entry.version,
+            targetSelector,
+            selectedInstallSelector,
+            installedVersion,
+            action: classifyOutOfRangeVersion(installedVersion, entry.version)
+        };
+    });
+}
+export async function syncNpmGlobals(options) {
+    const manifest = await loadNpmSyncManifest(options.manifestPath);
+    options.onLog?.({
+        type: "manifest-loaded",
+        manifestPath: options.manifestPath,
+        packageCount: Object.keys(manifest.packages).length
+    });
+    const verifyRuntime = options.verifyRuntime ?? verifyNodeRuntime;
+    const runtimeResult = await verifyRuntime(options.runtimePath);
+    if (!runtimeResult.valid ||
+        !runtimeResult.nodePath ||
+        !runtimeResult.npmPath) {
+        throw new NpmSyncError(`Invalid Node.js runtime ${options.runtimePath}: ${runtimeResult.failureReason ?? "node/npm validation failed"}`);
+    }
+    const runtime = {
+        targetDirectory: runtimeResult.targetDirectory,
+        nodePath: runtimeResult.nodePath,
+        npmPath: runtimeResult.npmPath,
+        nodeVersion: runtimeResult.nodeVersion ?? "unknown",
+        npmVersion: runtimeResult.npmVersion ?? "unknown"
+    };
+    options.onLog?.({ type: "runtime-valid", runtime });
+    const npmOptions = {
+        ...options.npmOptions,
+        env: createRuntimeNpmEnv(runtime.targetDirectory, options.npmOptions?.env)
+    };
+    let inventoryResult;
+    try {
+        inventoryResult = await listGlobalPackages(runtime.npmPath, npmOptions);
+    }
+    catch (error) {
+        if (error instanceof NpmCommandError) {
+            throw new NpmSyncCommandError("Failed to list npm global packages", error);
+        }
+        throw error;
+    }
+    const installed = normalizeGlobalInventory(inventoryResult.stdout);
+    options.onLog?.({ type: "inventory", packages: installed });
+    const plan = createNpmSyncPlan(manifest, installed);
+    const actions = [];
+    for (const action of plan) {
+        options.onLog?.({ type: "planned-action", action });
+        if (action.action === "noop") {
+            const result = { ...action, changed: false };
+            actions.push(result);
+            options.onLog?.({ type: "skip", action });
+            continue;
+        }
+        options.onLog?.({ type: "install-start", action });
+        try {
+            const installResult = await installGlobalPackage(runtime.npmPath, action.selectedInstallSelector, npmOptions);
+            const result = {
+                ...action,
+                changed: true,
+                command: installResult.command,
+                args: installResult.args,
+                stdout: installResult.stdout,
+                stderr: installResult.stderr
+            };
+            actions.push(result);
+            options.onLog?.({ type: "install-complete", action: result });
+        }
+        catch (error) {
+            if (error instanceof NpmCommandError) {
+                throw new NpmSyncCommandError(`Failed to sync package ${action.packageName}`, error, action.packageName);
+            }
+            throw error;
+        }
+    }
+    const summary = {
+        runtime,
+        manifestPath: options.manifestPath,
+        packageCount: plan.length,
+        noopCount: actions.filter((action) => !action.changed).length,
+        changedCount: actions.filter((action) => action.changed).length,
+        actions
+    };
+    options.onLog?.({ type: "summary", summary });
+    return summary;
+}
+function createRuntimeNpmEnv(runtimePath, baseEnv = process.env) {
+    const env = { ...baseEnv };
+    delete env.PREFIX;
+    delete env.npm_config_prefix;
+    delete env.NPM_CONFIG_GLOBALCONFIG;
+    delete env.npm_config_globalconfig;
+    delete env.NPM_CONFIG_USERCONFIG;
+    delete env.npm_config_userconfig;
+    return {
+        ...env,
+        NPM_CONFIG_PREFIX: runtimePath,
+        npm_config_fund: "false",
+        npm_config_audit: "false"
+    };
+}
+function classifyOutOfRangeVersion(installedVersion, range) {
+    const minimum = semver.minVersion(range);
+    if (minimum && semver.lt(installedVersion, minimum)) {
+        return "upgrade";
+    }
+    if (isAboveAllowedRange(installedVersion, range)) {
+        return "downgrade";
+    }
+    return "sync";
+}
+function isAboveAllowedRange(version, range) {
+    const parsed = new semver.Range(range, { includePrerelease: true });
+    return parsed.set.every((comparators) => comparators.some((comparator) => (comparator.operator === "<" || comparator.operator === "<=") &&
+        semver.gt(version, comparator.semver.version)));
+}
+function isValidPackageName(packageName) {
+    if (packageName.trim() !== packageName || packageName.length === 0) {
+        return false;
+    }
+    if (packageName.includes("\\") || packageName.includes("/../")) {
+        return false;
+    }
+    if (packageName.startsWith("@")) {
+        const parts = packageName.split("/");
+        return (parts.length === 2 &&
+            parts[0].startsWith("@") &&
+            isValidPackageNamePart(parts[0].slice(1)) &&
+            isValidPackageNamePart(parts[1]));
+    }
+    return !packageName.includes("/") && isValidPackageNamePart(packageName);
+}
+function isValidPackageNamePart(value) {
+    return (value.length > 0 &&
+        value === basename(value) &&
+        !value.startsWith(".") &&
+        !/[\s@]/u.test(value));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=npm-sync.js.map

package/dist/runtime/npm-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-sync.js","sourceRoot":"","sources":["../../src/runtime/npm-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAGhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAwErD,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IACjD,MAAM,CAAW;IAE1B,YAAY,MAAgB;QAC1B,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAC1C,WAAW,CAAU;IACrB,OAAO,CAAS;IAChB,IAAI,CAAW;IACf,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,KAAsB,EAAE,WAAoB;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAAoB;IAEpB,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,YAAY,CACpB,2BAA2B,YAAY,KAAK,OAAO,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,0BAA0B,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,0BAA0B,CAAC;YACnC,mDAAmD;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAyC,EAAE,CAAC;IAE1D,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,yCAAyC,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,2CAA2C,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CACT,GAAG,WAAW,yCAAyC,OAAO,EAAE,CACjE,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,0CAA0C,CAAC,CAAC;gBACtE,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,WAAW,CAAC,GAAG;gBACtB,OAAO,EAAE,eAAe;gBACxB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;aACtB,CAAC;YACF,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAc;IAEd,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,YAAY,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAA4B,EAAE,CAAC;IAE9C,KAAK,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpE,SAAS;QACX,CAAC;QAED,SAAS,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAyB,EACzB,SAAkC;IAElC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE;QAC5B,MAAM,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;QACrD,MAAM,uBAAuB,GAAG,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC;QAEnE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO;gBACL,WAAW;gBACX,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,cAAc;gBACd,uBAAuB;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;QAED,IACE,MAAM,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,EAAE;YAChD,iBAAiB,EAAE,IAAI;SACxB,CAAC,EACF,CAAC;YACD,OAAO;gBACL,WAAW;gBACX,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,cAAc;gBACd,uBAAuB;gBACvB,gBAAgB;gBAChB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;QAED,OAAO;YACL,WAAW;YACX,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,cAAc;YACd,uBAAuB;YACvB,gBAAgB;YAChB,MAAM,EAAE,yBAAyB,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC;SACnE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,EAAE,iBAAiB;QACvB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM;KACpD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC;IACjE,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,IACE,CAAC,aAAa,CAAC,KAAK;QACpB,CAAC,aAAa,CAAC,QAAQ;QACvB,CAAC,aAAa,CAAC,OAAO,EACtB,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,2BAA2B,OAAO,CAAC,WAAW,KAAK,aAAa,CAAC,aAAa,IAAI,4BAA4B,EAAE,CACjH,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,eAAe,EAAE,aAAa,CAAC,eAAe;QAC9C,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,SAAS;QACnD,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,SAAS;KAClD,CAAC;IACF,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG;QACjB,GAAG,OAAO,CAAC,UAAU;QACrB,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;KAC3E,CAAC;IAEF,IAAI,eAAiC,CAAC;IACtC,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,IAAI,mBAAmB,CAC3B,oCAAoC,EACpC,KAAK,CACN,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,wBAAwB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpD,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAwB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAC9C,OAAO,CAAC,OAAO,EACf,MAAM,CAAC,uBAAuB,EAC9B,UAAU,CACX,CAAC;YACF,MAAM,MAAM,GAAwB;gBAClC,GAAG,MAAM;gBACT,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,MAAM,EAAE,aAAa,CAAC,MAAM;aAC7B,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,MAAM,IAAI,mBAAmB,CAC3B,0BAA0B,MAAM,CAAC,WAAW,EAAE,EAC9C,KAAK,EACL,MAAM,CAAC,WAAW,CACnB,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAmB;QAC9B,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,IAAI,CAAC,MAAM;QACzB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;QAC7D,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;QAC/D,OAAO;KACR,CAAC;IACF,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAmB,EACnB,UAA6B,OAAO,CAAC,GAAG;IAExC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3B,OAAO,GAAG,CAAC,MAAM,CAAC;IAClB,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC7B,OAAO,GAAG,CAAC,uBAAuB,CAAC;IACnC,OAAO,GAAG,CAAC,uBAAuB,CAAC;IACnC,OAAO,GAAG,CAAC,qBAAqB,CAAC;IACjC,OAAO,GAAG,CAAC,qBAAqB,CAAC;IAEjC,OAAO;QACL,GAAG,GAAG;QACN,iBAAiB,EAAE,WAAW;QAC9B,eAAe,EAAE,OAAO;QACxB,gBAAgB,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,gBAAwB,EACxB,KAAa;IAEb,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,KAAa;IACzD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CACtC,WAAW,CAAC,IAAI,CACd,CAAC,UAAU,EAAE,EAAE,CACb,CAAC,UAAU,CAAC,QAAQ,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,KAAK,IAAI,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAChD,CACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,CAAC;YAClB,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YACxB,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACjC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,CACL,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC;QACzB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACtB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+export declare const packageName = "@hagicode/hagiscript";
+export declare const packageVersion = "0.1.0";
+export interface PackageMetadata {
+    name: string;
+    version: string;
+}
+export declare function getPackageMetadata(): PackageMetadata;

package/dist/version.js

@@ -0,0 +1,9 @@
+export const packageName = "@hagicode/hagiscript";
+export const packageVersion = "0.1.0";
+export function getPackageMetadata() {
+    return {
+        name: packageName,
+        version: packageVersion
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAOtC,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@hagicode/hagiscript",
+  "version": "0.1.0",
+  "description": "Scoped npm package foundation for Hagiscript language tooling.",
+  "homepage": "https://github.com/HagiCode-org/hagiscript#readme",
+  "bugs": {
+    "url": "https://github.com/HagiCode-org/hagiscript/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HagiCode-org/hagiscript.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "hagiscript": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_cn.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist .vitest-temp .tmp coverage",
+    "dev": "tsx src/cli.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "integration:installed-runtime": "node scripts/integration-installed-runtime.mjs",
+    "pack:check": "node scripts/verify-package.mjs",
+    "publish:prepare-dev-version": "node scripts/prepare-dev-version.mjs",
+    "publish:verify-release": "node scripts/verify-release-version.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "hagiscript",
+    "scripting",
+    "language",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "commander": "^14.0.1",
+    "semver": "^7.7.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.38.0",
+    "@types/node": "^24.5.2",
+    "@types/semver": "^7.7.1",
+    "eslint": "^9.38.0",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
+    "vitest": "^3.2.4"
+  }
+}