fix: use explicit .js extensions for ESM-compliant imports (#58)

This change fixes import resolution errors that occur when consuming
loro-mirror in strict ESM environments.

## Problem

The package used directory imports like `from "./schema"` which TypeScript
compiles as-is. This causes two distinct failures:

1. **Runtime** (Node.js ESM / Vitest): "Directory import is not supported
   resolving ES modules" - Node.js ESM requires explicit file extensions.

2. **Compile time** (TypeScript with `moduleResolution: "NodeNext"`):
   "Module 'loro-mirror' has no exported member 'RootSchemaType'" -
   TypeScript can't resolve `./schema` to `./schema/index.d.ts` in strict
   mode.

Consumers using lenient resolution modes (`bundler`, legacy `node`) were
unaffected, which is why this wasn't caught earlier.

## Solution

1. Changed tsconfig.json to use `module: "NodeNext"` and
   `moduleResolution: "NodeNext"`
2. Added explicit `.js` extensions to all relative imports

## Sources

- "How to Create an NPM Package" by Matt Pocock (Total TypeScript)
  https://www.totaltypescript.com/how-to-create-an-npm-package

- "Is NodeNext right for libraries?" by Andrew Branch (TypeScript team)
  https://blog.andrewbran.ch/is-nodenext-right-for-libraries-that-dont-target-node-js/

## Consequences

- All relative imports must now include explicit `.js` extensions
- TypeScript will error at compile time if extensions are missing
- Consumers no longer need workarounds like Vitest's `server.deps.inline`
- Works with all TypeScript moduleResolution modes (bundler, node, NodeNext)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: kimjoar

packages/core/src/core/diff.ts

@@ -22,9 +22,9 @@ import {
     LoroTreeSchema,
     RootSchemaType,
     SchemaType,
-} from "../schema";
-import { ChangeKinds, InferContainerOptions, type Change } from "./mirror";
-import { CID_KEY } from "../constants";
+} from "../schema/index.js";
+import { ChangeKinds, InferContainerOptions, type Change } from "./mirror.js";
+import { CID_KEY } from "../constants.js";
 
 import {
     containerIdToContainerType,
@@ -42,7 +42,7 @@ import {
     isArrayLike,
     isTreeID,
     defineCidProperty,
-} from "./utils";
+} from "./utils.js";
 
 /**
  * Finds the longest increasing subsequence of a sequence of numbers

packages/core/src/core/index.ts

@@ -2,11 +2,11 @@
  * Core mirroring functionality for syncing application state with Loro CRDT
  */
 
-export { Mirror, SyncDirection, toNormalizedJson } from "./mirror";
+export { Mirror, SyncDirection, toNormalizedJson } from "./mirror.js";
 export type {
     InferContainerOptions,
     MirrorOptions,
     SetStateOptions,
     SubscriberCallback,
     UpdateMetadata,
-} from "./mirror";
+} from "./mirror.js";

packages/core/src/core/loroEventApply.test.ts

@@ -1,7 +1,7 @@
 /* eslint-disable unicorn/consistent-function-scoping */
 import { describe, it, expect } from "vitest";
 import { LoroDoc, LoroText, LoroList, LoroMap, LoroCounter } from "loro-crdt";
-import { applyEventBatchToState } from "./loroEventApply";
+import { applyEventBatchToState } from "./loroEventApply.js";
 
 const commitAndAssert = (doc: LoroDoc, getState: () => unknown) => {
     doc.commit();

packages/core/src/core/loroEventApply.ts

@@ -8,7 +8,7 @@ import {
     LoroEventBatch,
     TreeID,
 } from "loro-crdt";
-import { defineCidProperty, isTreeID } from "./utils";
+import { defineCidProperty, isTreeID } from "./utils.js";
 
 // Plain JSON-like value held in Mirror state (no `any`)
 type JSONPrimitive = string | number | boolean | null | undefined;

packages/core/src/core/mirror.ts

@@ -18,7 +18,7 @@ import {
     TreeID,
 } from "loro-crdt";
 
-import { applyEventBatchToState } from "./loroEventApply";
+import { applyEventBatchToState } from "./loroEventApply.js";
 import {
     ContainerSchemaType,
     getDefaultValue,
@@ -36,7 +36,7 @@ import {
     RootSchemaType,
     SchemaType,
     validateSchema,
-} from "../schema";
+} from "../schema/index.js";
 import {
     deepEqual,
     inferContainerTypeFromValue,
@@ -46,9 +46,9 @@ import {
     tryInferContainerType,
     getRootContainerByType,
     defineCidProperty,
-} from "./utils";
-import { diffContainer, diffTree } from "./diff";
-import { CID_KEY } from "../constants";
+} from "./utils.js";
+import { diffContainer, diffTree } from "./diff.js";
+import { CID_KEY } from "../constants.js";
 
 // Plain JSON-like value used for state snapshots
 type JSONPrimitive = string | number | boolean | null | undefined;
@@ -98,7 +98,7 @@ export interface MirrorOptions<S extends SchemaType> {
     /**
      * Initial state (optional)
      */
-    initialState?: Partial<import("../schema").InferInputType<S>>;
+    initialState?: Partial<import("../schema/index.js").InferInputType<S>>;
 
     /**
      * Whether to validate state updates against the schema
@@ -726,10 +726,7 @@ export class Mirror<S extends SchemaType> {
     /**
      * Update Loro based on state changes
      */
-    private updateLoro(
-        newState: InferType<S>,
-        options?: SetStateOptions,
-    ) {
+    private updateLoro(newState: InferType<S>, options?: SetStateOptions) {
         if (this.syncing) return;
 
         this.syncing = true;

packages/core/src/core/utils.ts

@@ -3,9 +3,9 @@
  */
 
 import { Container, ContainerID, ContainerType, LoroDoc } from "loro-crdt";
-import { SchemaType } from "../schema";
-import { Change, InferContainerOptions } from "./mirror";
-import { CID_KEY } from "../constants";
+import { SchemaType } from "../schema/index.js";
+import { Change, InferContainerOptions } from "./mirror.js";
+import { CID_KEY } from "../constants.js";
 
 export function defineCidProperty(target: unknown, cid: ContainerID) {
     if (

packages/core/src/index.ts

@@ -4,7 +4,7 @@
  */
 
 // Re-export all public APIs
-export * from "./schema";
+export * from "./schema/index.js";
 export {
     Mirror,
     toNormalizedJson,
@@ -14,11 +14,11 @@ export {
     type SubscriberCallback,
     type InferContainerOptions,
     SyncDirection,
-} from "./core";
+} from "./core/index.js";
 
 // Default export
-import * as schema from "./schema";
-import * as core from "./core";
+import * as schema from "./schema/index.js";
+import * as core from "./core/index.js";
 
 type Combined = typeof schema & typeof core;
 const loroMirror: Combined = Object.assign({}, schema, core);

packages/core/src/schema/index.ts

@@ -21,10 +21,10 @@ import {
     SchemaType,
     StringSchemaType,
     InferType,
-} from "./types";
+} from "./types.js";
 
-export * from "./types";
-export * from "./validators";
+export * from "./types.js";
+export * from "./validators.js";
 
 /**
  * Create a schema definition

packages/core/src/schema/validators.ts

@@ -12,8 +12,8 @@ import {
     LoroTreeSchema,
     RootSchemaType,
     SchemaType,
-} from "./types";
-import { isObject } from "../core/utils";
+} from "./types.js";
+import { isObject } from "../core/utils.js";
 
 const schemaValidationCache = new WeakMap<object, WeakSet<object>>();
 

packages/core/tests/cid.test.ts

@@ -1,10 +1,10 @@
 import { describe, it, expect, expectTypeOf } from "vitest";
 import { LoroDoc, LoroMap } from "loro-crdt";
-import { Mirror } from "../src/core/mirror";
-import { schema } from "../src/schema";
-import { InferType } from "../src";
-import { CID_KEY } from "../src/constants";
-import { diffMap } from "../src/core/diff";
+import { Mirror } from "../src/core/mirror.js";
+import { schema } from "../src/schema/index.js";
+import { InferType } from "../src/index.js";
+import { CID_KEY } from "../src/constants.js";
+import { diffMap } from "../src/core/diff.js";
 
 describe("$cid: state injection and write ignoring (always-on for LoroMap)", () => {
     it("types: LoroMap includes $cid by default", () => {