tungsten 0.2.7 → 0.2.9

package/readme.md

@@ -2,6 +2,71 @@
 
 [Docs](https://robertsandiford.co.uk/tungsten)
 
+## Component testing
+
+Test-specific APIs are available from `tungsten/testing` and are not exported
+from Tungsten's main entry point. A test project supplies its own DOM
+implementation, such as happy-dom or jsdom:
+
+```tsx
+import { Window } from 'happy-dom'
+import { createTestApp } from 'tungsten/testing'
+
+describe('RootComponent', () => {
+    it('responds to a button click', async () => {
+        const window = new Window()
+        const testApp = await createTestApp(RootComponent, {
+            document: window.document as unknown as Document,
+            props: { initialName: 'Robert' },
+            location: '/',
+        })
+
+        try {
+            const button = testApp.container.querySelector('button')
+            expect(button).not.toBeNull()
+
+            button!.dispatchEvent(new window.Event('click') as unknown as Event)
+            await testApp.resolved()
+
+            expect(testApp.container.textContent).toContain('Robert')
+        } finally {
+            await testApp.unmount()
+        }
+    })
+})
+```
+
+The casts are only needed when a DOM package publishes types which are not
+structurally compatible with the TypeScript DOM library version used by the
+test project.
+
+`createTestApp()` completes the initial client render before returning.
+`resolved()` subsequently waits for Tungsten updates, DOM reconciliation,
+lifecycle-triggered updates, and promises returned by registered event
+handlers. It does not wait for unrelated timers, network requests, or promises
+which the application has not returned to Tungsten.
+
+An automatically created container is appended to the supplied document body
+and removed by `unmount()`. A caller-supplied container must be empty; it is
+emptied but retained during unmount.
+
+Registered stores are created independently for each test application. Use
+`testStore()` to initialize one before the root component starts:
+
+```ts
+import { createTestApp, testStore } from 'tungsten/testing'
+
+const testApp = await createTestApp(RootComponent, {
+    document,
+    stores: [testStore(userStore, store => {
+        store.user.set(mockUser)
+    })],
+})
+```
+
+Tests containing Tungsten JSX must be compiled through `tungsten compile` so
+they use Tungsten's JSX runtime and application transforms.
+
 ## Preparing code for tests
 
 Run a one-shot development compilation without starting a server:
@@ -58,3 +123,18 @@ per-file transformation messages while retaining errors and cycle status:
 tungsten compile --watch --output .tungsten/test \
   --ready-file .tungsten/test.ready --quiet
 ```
+
+## Preserving package imports in selected files
+
+Use `skipPackageCompilation` in `tungsten.config.js` for files that should be
+transformed and emitted without Tungsten traversing or copying their package
+dependencies. Bare package imports in matching files are left unchanged:
+
+```js
+export default {
+    skipPackageCompilation: '**/*.domTest.js'
+}
+```
+
+The option accepts one glob or an array of globs. Patterns match the actual
+JavaScript files received by Tungsten; extensions are not translated.

package/dist/react-zone.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react-zone.d.ts","sourceRoot":"","sources":["../src/react-zone.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,IAC7C,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAC3B,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAA;AAEvC,KAAK,aAAa,GAAG;IACjB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,OAAO,IAAI,IAAI,CAAA;CAClB,CAAA;AAED,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAE7F,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,EAAE;QACH,SAAS,EAAE,GAAG,CAAA;QACd,aAAa,EAAE,kBAAkB,CAAA;KACpC,CAAA;IACD,MAAM,EAAE;QACJ,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAAA;QACxC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,aAAa,CAAA;KAC/D,CAAA;IACD,MAAM,EAAE;QACJ,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;KAC5C,CAAA;CACJ,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,IAAI;IAC/C,SAAS,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAA;CAC5B,CAAA;AAED,qBAAa,SAAS,CAAC,KAAK,SAAS,MAAM,CAAE,SAAQ,uBAAuB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/F,OAAO,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAqC;IAChF,SAAS,EAAE,aAAa,GAAG,SAAS,CAAA;IACpC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAClD,aAAa,EAAE,OAAO,GAAG,SAAS,CAAA;IAClC,SAAS,UAAQ;IAEjB,OAAO,QAAa,OAAO,CAAC,WAAW,CAAC,CAsBvC;IAED,iBAAiB,QAAO,IAAI,CAG3B;IAED,kBAAkB,QAAO,IAAI,CAE5B;IAED,oBAAoB,QAAO,IAAI,CAM9B;IAED,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,WAAW;CAOtB"}