@astrojs/compiler 1.1.2 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @astrojs/compiler
 
+## 1.2.0
+
+### Minor Changes
+
+- b2cfd00: Add teardown API to remove WASM instance after using the compiler
+
 ## 1.1.2
 
 ### Patch Changes

package/browser/index.d.ts

@@ -1,4 +1,5 @@
 import type * as types from '../shared/types';
 export declare const transform: typeof types.transform;
 export declare const parse: typeof types.parse;
+export declare const teardown: typeof types.teardown;
 export declare const initialize: typeof types.initialize;

package/browser/index.js

@@ -7,6 +7,11 @@ export const parse = (input, options) => {
 };
 let initializePromise;
 let longLivedService;
+export const teardown = () => {
+    initializePromise = undefined;
+    longLivedService = undefined;
+    globalThis['@astrojs/compiler'] = undefined;
+};
 export const initialize = async (options) => {
     let wasmURL = options.wasmURL;
     if (!wasmURL)

package/node/index.d.ts

@@ -4,3 +4,4 @@ export declare const transform: typeof types.transform;
 export declare const parse: typeof types.parse;
 export declare const convertToTSX: typeof types.convertToTSX;
 export declare const compile: (template: string) => Promise<string>;
+export declare const teardown: typeof types.teardown;

package/node/index.js

@@ -15,6 +15,10 @@ export const compile = async (template) => {
     return mod;
 };
 let longLivedService;
+export const teardown = () => {
+    longLivedService = undefined;
+    globalThis['@astrojs/compiler'] = undefined;
+};
 let getService = () => {
     if (!longLivedService) {
         longLivedService = startRunningService().catch((err) => {

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "bugs": "https://github.com/withastro/compiler/issues",
   "homepage": "https://astro.build",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "main": "./node/index.js",
   "types": "./node",
   "repository": {

package/shared/types.d.ts

@@ -94,6 +94,17 @@ export declare function transform(input: string, options?: TransformOptions): Pr
 export declare function parse(input: string, options?: ParseOptions): Promise<ParseResult>;
 export declare function convertToTSX(input: string, options?: ConvertToTSXOptions): Promise<TSXResult>;
 export declare function initialize(options: InitializeOptions): Promise<void>;
+/**
+ * When calling the core compiler APIs, e.g. `transform`, `parse`, etc, they
+ * would automatically instantiate a WASM instance to process the input. When
+ * done, you can call this to manually teardown the WASM instance.
+ *
+ * If the APIs are called again, they will automatically instantiate a new WASM
+ * instance. In browsers, you have to call `initialize()` again before using the APIs.
+ *
+ * Note: Calling teardown is optional and exists mostly as an optimization only.
+ */
+export declare function teardown(): void;
 export interface InitializeOptions {
     wasmURL?: string;
 }