ember-repl 2.0.63 → 3.0.0-beta.1

package/README.md

@@ -21,6 +21,11 @@ your app's initial time-to-interactive/etc stats.
 * ember-auto-import v2 or above
 * Node.js v14 or above
 
+## Capabilities 
+
+* gjs 
+* hbs 
+* markdown with gjs/hbs blocks (glimdown)
 
 ## Installation
 
@@ -28,9 +33,91 @@ your app's initial time-to-interactive/etc stats.
 ember install ember-repl
 ```
 
+## Setup
+
+This library uses babel, which does some goofy things in the browser.
+You'll need to define a global `process` and `Buffer` somewhere in your app.
+
+For example:
+```js 
+// app/app.js
+
+// @babel/traverse (from babel-plugin-ember-template-imports)
+// accesses process.....
+// maybe one day we can have a browser-only verison?
+// But they aren't used.... so.. that's fun.
+Object.assign(window, {
+  process: { env: {} },
+  Buffer: {},
+});
+
+```
+
 ## Usage
 
-**`compileJS`**
+### Compiling GJS 
+
+There are two ways to compile gjs text, imperatively via `compileJS`, where you manage the reactivity yourself. 
+Or `Compiled`, which is a resource that manages the reactivity for you.
+
+#### Automatic reactivity via the Resource
+
+Following the Resources documentation, you can use `Compiled` in both 
+template-only or class-backed contexts:
+
+```js 
+import { Compiled } from 'ember-repl';
+
+<template>
+  {{#let (Compiled @gjsText 'gjs') as |compileResult|}}
+
+    {{#if compileResult.error}}
+      an error! {{compileResult.error}}
+    {{/if}}
+
+    {{#if compileResult.component}}
+      <compileResult.component />
+    {{/if}}
+
+  {{/let}}
+</template>
+
+```
+
+One advantage of using a backing JS context, is that you can utilize the `keepLatest` 
+resource so that when an error occurs, you could keep rendering the latest successful compile.
+
+```js 
+import Component from '@glimmer/component';
+import { Compiled } from 'ember-repl';
+import { use } from 'ember-resources'; 
+import { keepLatest } from 'ember-resources/util/keep-latest';
+
+export class Renderer extends Component {
+  @use compile = Compiled(() => this.args.gjsText, 'gjs');
+
+  @use latest = keepLatest({
+    value: () => this.compile.component,
+    when: () => this.compile.error,
+  }); 
+
+  <template> 
+    {{#if this.compile.error}}
+      Error! {{this.compile.error}}
+    {{/if}}
+
+    {{! This will keep showing even when there is an error.
+        Which can help reduce visual jitter }} 
+    {{#if this.latest.value}}
+      <this.latest.latest />
+    {{/if}}
+
+  </template>
+}
+```
+
+
+#### Managing your own reactivity
 
 ```js
 import Component from '@glimmer/component';
@@ -53,7 +140,14 @@ export class Renderer extends Component {
 {{/if}}
 ```
 
-**`compileHBS`**
+
+### Compiling HBS 
+
+#### Automatic reactivity via the Resource
+
+The hbs utilities do not provide a utility Resource. 
+
+#### Managing your own reactivity
 
 ```js
 import Component from '@glimmer/component';
@@ -67,6 +161,110 @@ export class Renderer extends Component {
 <this.compileResult.component />
 ```
 
+
+### Compiling Markdown
+
+There are two ways to compile markdown text, imperatively via `compile` (passing the `glimdown` format), where you manage the reactivity yourself. 
+Or `CompileMarkdown`, which is a resource that manages the reactivity for you.
+
+#### Automatic reactivity via the Resource
+
+Following the Resources documentation, you can use `Compiled` in both 
+template-only or class-backed contexts:
+
+```js 
+import { Compiled } from 'ember-repl';
+
+<template>
+  {{#let (Compiled @mdText 'glimdown') as |compileResult|}}
+
+    {{#if compileResult.error}}
+      an error! {{compileResult.error}}
+    {{/if}}
+
+    {{#if compileResult.component}}
+      <compileResult.component />
+    {{/if}}
+
+  {{/let}}
+</template>
+
+```
+
+One advantage of using a backing JS context, is that you can utilize the `keepLatest` 
+resource so that when an error occurs, you could keep rendering the latest successful compile.
+
+```js 
+import Component from '@glimmer/component';
+import { Compiled } from 'ember-repl';
+import { use } from 'ember-resources'; 
+import { keepLatest } from 'ember-resources/util/keep-latest';
+
+export class Renderer extends Component {
+  @use compile = Compiled(() => this.args.mdText, 'glimdown');
+
+  @use latest = keepLatest({
+    value: () => this.compile.component,
+    when: () => this.compile.error,
+  }); 
+
+  <template> 
+    {{#if this.compile.error}}
+      Error! {{this.compile.error}}
+    {{/if}}
+
+    {{! This will keep showing even when there is an error.
+        Which can help reduce visual jitter }} 
+    {{#if this.latest.value}}
+      <this.latest.latest />
+    {{/if}}
+
+  </template>
+}
+```
+
+
+#### Managing your own reactivity
+
+```js
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { compile } from 'ember-repl';
+
+export class Renderer extends Component {
+  @tracked component;
+  @tracked error;
+  @tracked isCompiling;
+
+  constructor(...args) {
+    super(...args);
+
+    compile('...', {
+      format: 'glimdown', // or 'gjs' or 'hbs'
+      onSuccess: async (component) => {
+        this.error = null;
+        this.isCompiling = false; 
+        this.component = component;
+        
+      },
+      onError: async (error) => {
+        this.isCompiling = false; 
+        this.error = error;
+      },
+      onCompileStart: async () => {
+        this.isCompiling = true; 
+      }
+    });
+  }
+}
+```
+```hbs
+{{#if this.component}}
+  <this.component />
+{{/if}}
+```
+
+
 ### Using existing components
 
 `ember-repl` is strict-mode only, so any component that you want to invoke
@@ -211,39 +409,6 @@ packagerOptions: {
 },
 ```
 
-If you are using ember-repl to showcase a styleguide _and_ have maximum strictness enabled in embroider,
-you'll need to manually (or programatically) list out each of the components you want to force to be
-included in the build output using the `buildComponentMap` function in your `ember-cli-build.js`.
-For example:
-
-```js
-const { Webpack } = require('@embroider/webpack');
-const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
-
-return require('@embroider/compat').compatBuild(app, Webpack, {
-  extraPublicTrees: [
-    require('ember-repl').buildComponentMap([
-      'limber/components/limber/menu',
-      'limber/components/limber/header',
-      'limber/components/external-link',
-      'limber/components/popper-j-s',
-      'ember-repl',
-    ]),
-  ],
-  // ...
-});
-```
-
-this emits an `/ember-repl/component-map.js` file in your public tree,
-which can then be `await import`ed and used via:
-
-```js
-let { COMPONENT_MAP } = await import('/ember-repl/component-map.js');
-
-let { component, error, name } = await compileJS(code, COMPONENT_MAP);
-```
-
-
 ## Security
 
 Many developers know that evaluating runnable user input is a huge security risk.

package/addon-main.cjs

@@ -0,0 +1,5 @@
+'use strict';
+
+const { addonV1Shim } = require('@embroider/addon-shim');
+
+module.exports = addonV1Shim(__dirname);

package/dist/browser/cjs/eval.d.ts

@@ -0,0 +1,10 @@
+import { ExtraModules } from "../types.js";
+import Component from '@glimmer/component';
+declare function evalSnippet(compiled: string, extraModules?: ExtraModules): {
+    default: Component;
+    services?: {
+        [key: string]: unknown;
+    };
+};
+export { evalSnippet };
+//# sourceMappingURL=browser/cjs/eval.d.ts.map

package/dist/browser/cjs/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser/cjs/eval.d.ts","sourceRoot":"","sources":["../src/browser/cjs/eval.ts"],"names":[],"mappings":"AAGA,OAAO,gBAAqB,oBAAiB;AAC7C,OAAO,SAAc,MAAM,oBAAoB,CAAC;AAEhD,iBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,YAAiB,GAC9B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvC,CAmBA"}

package/dist/browser/cjs/eval.js

@@ -0,0 +1,22 @@
+import { modules } from '../known-modules.js';
+
+/* eslint-disable @typescript-eslint/no-unused-vars */
+function evalSnippet(compiled, extraModules = {}) {
+  const exports = {};
+  function require(moduleName) {
+    let preConfigured = modules[moduleName] || extraModules[moduleName];
+
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return preConfigured || window.require(moduleName);
+  }
+
+  // https://github.com/glimmerjs/glimmer-experimental/blob/master/packages/examples/playground/src/utils/eval-snippet.ts
+  eval(compiled);
+  return Object.assign(exports, {
+    require
+  });
+}
+
+export { evalSnippet };
+//# sourceMappingURL=eval.js.map

package/dist/browser/cjs/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sources":["../../../src/browser/cjs/eval.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\nimport { modules } from '../known-modules';\n\nimport type { ExtraModules } from '../types';\nimport type Component from '@glimmer/component';\n\nexport function evalSnippet(\n  compiled: string,\n  extraModules: ExtraModules = {}\n): {\n  default: Component;\n  services?: { [key: string]: unknown };\n} {\n  const exports = {};\n\n  function require(moduleName: keyof typeof modules): unknown {\n    let preConfigured = modules[moduleName] || extraModules[moduleName];\n\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    return preConfigured || window.require(moduleName);\n  }\n\n  // https://github.com/glimmerjs/glimmer-experimental/blob/master/packages/examples/playground/src/utils/eval-snippet.ts\n  eval(compiled);\n\n  return Object.assign(exports, { require }) as {\n    default: Component;\n    services?: { [key: string]: unknown };\n    require: unknown;\n  };\n}\n"],"names":["evalSnippet","compiled","extraModules","exports","require","moduleName","preConfigured","modules","window","eval","Object","assign"],"mappings":";;AAAA;AAMO,SAASA,WAAWA,CACzBC,QAAgB,EAChBC,YAA0B,GAAG,EAAE,EAI/B;EACA,MAAMC,OAAO,GAAG,EAAE,CAAA;EAElB,SAASC,OAAOA,CAACC,UAAgC,EAAW;IAC1D,IAAIC,aAAa,GAAGC,OAAO,CAACF,UAAU,CAAC,IAAIH,YAAY,CAACG,UAAU,CAAC,CAAA;;AAEnE;AACA;AACA,IAAA,OAAOC,aAAa,IAAIE,MAAM,CAACJ,OAAO,CAACC,UAAU,CAAC,CAAA;AACpD,GAAA;;AAEA;EACAI,IAAI,CAACR,QAAQ,CAAC,CAAA;AAEd,EAAA,OAAOS,MAAM,CAACC,MAAM,CAACR,OAAO,EAAE;AAAEC,IAAAA,OAAAA;AAAQ,GAAC,CAAC,CAAA;AAK5C;;;;"}

package/dist/browser/cjs/index.d.ts

@@ -0,0 +1,7 @@
+import { CompileResult, ExtraModules } from "../types.js";
+interface Info {
+    code: string;
+    name: string;
+}
+declare function compileJS(code: string, extraModules?: ExtraModules): Promise<CompileResult>;
+export { Info, compileJS };

package/dist/browser/cjs/index.js

@@ -0,0 +1,43 @@
+import { preprocess, transform } from '../gjs.js';
+import { nameFor } from '../utils.js';
+import { evalSnippet } from './eval.js';
+
+async function compileJS(code, extraModules) {
+  let name = nameFor(code);
+  let component;
+  let error;
+  try {
+    let compiled = await compileGJS({
+      code: code,
+      name
+    });
+    if (!compiled) {
+      throw new Error(`Compiled output is missing`);
+    }
+    component = evalSnippet(compiled, extraModules).default;
+  } catch (e) {
+    error = e;
+  }
+  return {
+    name,
+    component,
+    error
+  };
+}
+async function compileGJS({
+  code: input,
+  name
+}) {
+  let preprocessed = preprocess(input, name);
+  let result = await transform(preprocessed, name);
+  if (!result) {
+    return;
+  }
+  let {
+    code
+  } = result;
+  return code;
+}
+
+export { compileJS };
+//# sourceMappingURL=index.js.map

package/dist/browser/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/browser/cjs/index.ts"],"sourcesContent":["import { preprocess, transform } from '../gjs';\nimport { nameFor } from '../utils';\nimport { evalSnippet } from './eval';\n\nimport type { CompileResult, ExtraModules } from '../types';\nimport type { ComponentLike } from '@glint/template';\n\nexport interface Info {\n  code: string;\n  name: string;\n}\n\nexport async function compileJS(code: string, extraModules?: ExtraModules): Promise<CompileResult> {\n  let name = nameFor(code);\n  let component: undefined | ComponentLike;\n  let error: undefined | Error;\n\n  try {\n    let compiled = await compileGJS({ code: code, name });\n\n    if (!compiled) {\n      throw new Error(`Compiled output is missing`);\n    }\n\n    component = evalSnippet(compiled, extraModules).default as unknown as ComponentLike;\n  } catch (e) {\n    error = e as Error | undefined;\n  }\n\n  return { name, component, error };\n}\n\nasync function compileGJS({ code: input, name }: Info) {\n  let preprocessed = preprocess(input, name);\n  let result = await transform(preprocessed, name);\n\n  if (!result) {\n    return;\n  }\n\n  let { code } = result;\n\n  return code;\n}\n"],"names":["compileJS","code","extraModules","name","nameFor","component","error","compiled","compileGJS","Error","evalSnippet","default","e","input","preprocessed","preprocess","result","transform"],"mappings":";;;;AAYO,eAAeA,SAASA,CAACC,IAAY,EAAEC,YAA2B,EAA0B;AACjG,EAAA,IAAIC,IAAI,GAAGC,OAAO,CAACH,IAAI,CAAC,CAAA;AACxB,EAAA,IAAII,SAAoC,CAAA;AACxC,EAAA,IAAIC,KAAwB,CAAA;EAE5B,IAAI;AACF,IAAA,IAAIC,QAAQ,GAAG,MAAMC,UAAU,CAAC;AAAEP,MAAAA,IAAI,EAAEA,IAAI;AAAEE,MAAAA,IAAAA;AAAK,KAAC,CAAC,CAAA;IAErD,IAAI,CAACI,QAAQ,EAAE;AACb,MAAA,MAAM,IAAIE,KAAK,CAAE,CAAA,0BAAA,CAA2B,CAAC,CAAA;AAC/C,KAAA;IAEAJ,SAAS,GAAGK,WAAW,CAACH,QAAQ,EAAEL,YAAY,CAAC,CAACS,OAAmC,CAAA;GACpF,CAAC,OAAOC,CAAC,EAAE;AACVN,IAAAA,KAAK,GAAGM,CAAsB,CAAA;AAChC,GAAA;EAEA,OAAO;IAAET,IAAI;IAAEE,SAAS;AAAEC,IAAAA,KAAAA;GAAO,CAAA;AACnC,CAAA;AAEA,eAAeE,UAAUA,CAAC;AAAEP,EAAAA,IAAI,EAAEY,KAAK;AAAEV,EAAAA,IAAAA;AAAW,CAAC,EAAE;AACrD,EAAA,IAAIW,YAAY,GAAGC,UAAU,CAACF,KAAK,EAAEV,IAAI,CAAC,CAAA;EAC1C,IAAIa,MAAM,GAAG,MAAMC,SAAS,CAACH,YAAY,EAAEX,IAAI,CAAC,CAAA;EAEhD,IAAI,CAACa,MAAM,EAAE;AACX,IAAA,OAAA;AACF,GAAA;EAEA,IAAI;AAAEf,IAAAA,IAAAA;AAAK,GAAC,GAAGe,MAAM,CAAA;AAErB,EAAA,OAAOf,IAAI,CAAA;AACb;;;;"}

package/dist/browser/compile/formats.d.ts

@@ -0,0 +1,15 @@
+import { CompileResult } from "../types.js";
+import { EvalImportMap, ScopeMap } from "./types.js";
+declare function compileGJS(gjsInput: string, importMap?: EvalImportMap): Promise<CompileResult>;
+declare function compileHBS(hbsInput: string, options?: {
+    moduleName?: string;
+    scope?: Record<string, unknown>;
+}): Promise<CompileResult>;
+declare function compileMD(glimdownInput: string, options?: {
+    importMap?: EvalImportMap;
+    topLevelScope?: ScopeMap;
+    CopyComponent?: string;
+}): Promise<CompileResult & {
+    rootTemplate?: string;
+}>;
+export { compileGJS, compileHBS, compileMD };

package/dist/browser/compile/formats.js

@@ -0,0 +1,169 @@
+import { invocationName } from '../utils.js';
+
+async function compileAll(js, importMap) {
+  let modules = await Promise.all(js.map(async ({
+    code
+  }) => {
+    return await compileGJS(code, importMap);
+  }));
+  return modules;
+}
+async function compileGJS(gjsInput, importMap) {
+  try {
+    let {
+      compileJS
+    } = await import('../js.js');
+    return await compileJS(gjsInput, importMap);
+  } catch (error) {
+    return {
+      error: error,
+      name: 'unknown'
+    };
+  }
+}
+async function compileHBS(hbsInput, options) {
+  try {
+    let {
+      compileHBS
+    } = await import('../hbs.js');
+    return compileHBS(hbsInput, options);
+  } catch (error) {
+    return {
+      error: error,
+      name: 'unknown'
+    };
+  }
+}
+async function extractScope(liveCode, importMap) {
+  let scope = [];
+  let hbs = liveCode.filter(code => code.lang === 'hbs');
+  let js = liveCode.filter(code => ['js', 'gjs'].includes(code.lang));
+  if (js.length > 0) {
+    let compiled = await compileAll(js, importMap);
+    await Promise.all(compiled.map(async info => {
+      // using web worker + import maps is not available yet (need firefox support)
+      // (and to somehow be able to point at npm)
+      //
+      // if ('importPath' in info) {
+      //   return scope.push({
+      //     moduleName: name,
+      //     component: await import(/* webpackIgnore: true */ info.importPath),
+      //   });
+      // }
+
+      return scope.push(info);
+    }));
+  }
+  for (let {
+    code
+  } of hbs) {
+    let compiled = await compileHBS(code);
+    scope.push(compiled);
+  }
+  return scope;
+}
+async function compileMD(glimdownInput, options) {
+  let importMap = options?.importMap;
+  let topLevelScope = options?.topLevelScope ?? {};
+  let rootTemplate;
+  let liveCode;
+  let scope = [];
+
+  /**
+   * Step 1: Convert Markdown To HTML (Ember).
+   *
+   *         The remark plugin, remark-code-extra also extracts
+   *         and transforms the code blocks we care about.
+   *
+   *         These blocks will be compiled through babel and eval'd so the
+   *         compiled rootTemplate can invoke them
+   */
+  try {
+    let {
+      parseMarkdown
+    } = await import('./markdown-to-ember.js');
+    let {
+      templateOnlyGlimdown,
+      blocks
+    } = await parseMarkdown(glimdownInput, {
+      CopyComponent: options?.CopyComponent
+    });
+    rootTemplate = templateOnlyGlimdown;
+    liveCode = blocks;
+  } catch (error) {
+    return {
+      error: error,
+      name: 'unknown'
+    };
+  }
+
+  /**
+   * Step 2: Compile the live code samples
+   */
+  if (liveCode.length > 0) {
+    try {
+      scope = await extractScope(liveCode, importMap);
+    } catch (error) {
+      console.info({
+        scope
+      });
+      console.error(error);
+      return {
+        error: error,
+        rootTemplate,
+        name: 'unknown'
+      };
+    }
+  }
+
+  /**
+   * Make sure non of our snippets errored
+   *
+   * TODO: for these errors, report them differently so that we
+   * can render the 'Ember' and still highlight the correct line?
+   * or maybe there is a way to highlight in the editor instead?
+   */
+  for (let {
+    error,
+    component
+  } of scope) {
+    if (!component) {
+      if (error) {
+        return {
+          error,
+          rootTemplate,
+          name: 'unknown'
+        };
+      }
+    }
+  }
+
+  /**
+   * Step 4: Compile the Ember Template
+   */
+  try {
+    let localScope = scope.reduce((accum, {
+      component,
+      name
+    }) => {
+      accum[invocationName(name)] = component;
+      return accum;
+    }, {});
+    return await compileHBS(rootTemplate, {
+      moduleName: 'DynamicRootTemplate',
+      scope: {
+        ...topLevelScope,
+        ...localScope
+      }
+    });
+  } catch (error) {
+    return {
+      error: error,
+      rootTemplate,
+      name: 'unknown'
+    };
+  }
+}
+
+export { compileGJS, compileHBS, compileMD };
+//# sourceMappingURL=formats.js.map

package/dist/browser/compile/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sources":["../../../src/browser/compile/formats.ts"],"sourcesContent":["import { invocationName } from '../utils';\n\nimport type { CompileResult } from '../types';\nimport type { ExtractedCode } from './markdown-to-ember';\nimport type { EvalImportMap, ScopeMap } from './types';\n\nasync function compileAll(js: { code: string }[], importMap?: EvalImportMap) {\n  let modules = await Promise.all(\n    js.map(async ({ code }) => {\n      return await compileGJS(code, importMap);\n    })\n  );\n\n  return modules;\n}\n\nexport async function compileGJS(\n  gjsInput: string,\n  importMap?: EvalImportMap\n): Promise<CompileResult> {\n  try {\n    let { compileJS } = await import('../js');\n\n    return await compileJS(gjsInput, importMap);\n  } catch (error) {\n    return { error: error as Error, name: 'unknown' };\n  }\n}\n\nexport async function compileHBS(\n  hbsInput: string,\n  options?: {\n    moduleName?: string;\n    scope?: Record<string, unknown>;\n  }\n): Promise<CompileResult> {\n  try {\n    let { compileHBS } = await import('../hbs');\n\n    return compileHBS(hbsInput, options);\n  } catch (error) {\n    return { error: error as Error, name: 'unknown' };\n  }\n}\n\nasync function extractScope(\n  liveCode: ExtractedCode[],\n  importMap?: EvalImportMap\n): Promise<CompileResult[]> {\n  let scope: CompileResult[] = [];\n\n  let hbs = liveCode.filter((code) => code.lang === 'hbs');\n  let js = liveCode.filter((code) => ['js', 'gjs'].includes(code.lang));\n\n  if (js.length > 0) {\n    let compiled = await compileAll(js, importMap);\n\n    await Promise.all(\n      compiled.map(async (info) => {\n        // using web worker + import maps is not available yet (need firefox support)\n        // (and to somehow be able to point at npm)\n        //\n        // if ('importPath' in info) {\n        //   return scope.push({\n        //     moduleName: name,\n        //     component: await import(/* webpackIgnore: true */ info.importPath),\n        //   });\n        // }\n\n        return scope.push(info);\n      })\n    );\n  }\n\n  for (let { code } of hbs) {\n    let compiled = await compileHBS(code);\n\n    scope.push(compiled);\n  }\n\n  return scope;\n}\n\nexport async function compileMD(\n  glimdownInput: string,\n  options?: {\n    importMap?: EvalImportMap;\n    topLevelScope?: ScopeMap;\n    CopyComponent?: string;\n  }\n): Promise<CompileResult & { rootTemplate?: string }> {\n  let importMap = options?.importMap;\n  let topLevelScope = options?.topLevelScope ?? {};\n  let rootTemplate: string;\n  let liveCode: ExtractedCode[];\n  let scope: CompileResult[] = [];\n\n  /**\n   * Step 1: Convert Markdown To HTML (Ember).\n   *\n   *         The remark plugin, remark-code-extra also extracts\n   *         and transforms the code blocks we care about.\n   *\n   *         These blocks will be compiled through babel and eval'd so the\n   *         compiled rootTemplate can invoke them\n   */\n  try {\n    let { parseMarkdown } = await import('./markdown-to-ember');\n    let { templateOnlyGlimdown, blocks } = await parseMarkdown(glimdownInput, {\n      CopyComponent: options?.CopyComponent,\n    });\n\n    rootTemplate = templateOnlyGlimdown;\n    liveCode = blocks;\n  } catch (error) {\n    return { error: error as Error, name: 'unknown' };\n  }\n\n  /**\n   * Step 2: Compile the live code samples\n   */\n  if (liveCode.length > 0) {\n    try {\n      scope = await extractScope(liveCode, importMap);\n    } catch (error) {\n      console.info({ scope });\n      console.error(error);\n\n      return { error: error as Error, rootTemplate, name: 'unknown' };\n    }\n  }\n\n  /**\n   * Make sure non of our snippets errored\n   *\n   * TODO: for these errors, report them differently so that we\n   * can render the 'Ember' and still highlight the correct line?\n   * or maybe there is a way to highlight in the editor instead?\n   */\n  for (let { error, component } of scope) {\n    if (!component) {\n      if (error) {\n        return { error, rootTemplate, name: 'unknown' };\n      }\n    }\n  }\n\n  /**\n   * Step 4: Compile the Ember Template\n   */\n  try {\n    let localScope = scope.reduce((accum, { component, name }) => {\n      accum[invocationName(name)] = component;\n\n      return accum;\n    }, {} as Record<string, unknown>);\n\n    return await compileHBS(rootTemplate, {\n      moduleName: 'DynamicRootTemplate',\n      scope: {\n        ...topLevelScope,\n        ...localScope,\n      },\n    });\n  } catch (error) {\n    return { error: error as Error, rootTemplate, name: 'unknown' };\n  }\n}\n"],"names":["compileAll","js","importMap","modules","Promise","all","map","code","compileGJS","gjsInput","compileJS","error","name","compileHBS","hbsInput","options","extractScope","liveCode","scope","hbs","filter","lang","includes","length","compiled","info","push","compileMD","glimdownInput","topLevelScope","rootTemplate","parseMarkdown","templateOnlyGlimdown","blocks","CopyComponent","console","component","localScope","reduce","accum","invocationName","moduleName"],"mappings":"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"}

package/dist/browser/compile/index.d.ts

@@ -0,0 +1,32 @@
+import { EvalImportMap, ScopeMap } from "./types.js";
+import { ComponentLike } from '@glint/template';
+type Format = 'glimdown' | 'gjs' | 'hbs';
+declare const CACHE: Map<string, ComponentLike>;
+/**
+ * This compileMD is a more robust version of the raw compiling used in "formats".
+ * This function manages cache, and has events for folks building UIs to hook in to
+ */
+declare function compile(text: string, { format, onSuccess, onError, onCompileStart, ...options }: {
+    format: Format;
+    onSuccess: (component: ComponentLike) => Promise<unknown> | unknown;
+    onError: (error: string) => Promise<unknown> | unknown;
+    onCompileStart: () => Promise<unknown> | unknown;
+    importMap?: EvalImportMap;
+    CopyComponent?: string;
+    topLevelScope?: ScopeMap;
+}): Promise<void>;
+type Input = string | undefined | null;
+/**
+ * By default, this compiles to `glimdown`. A Markdown format which
+ * extracts `live` tagged code snippets and compiles them to components.
+ */
+declare const Compiled: ((markdownText: Input | (() => Input), format?: Format | (() => Format) | undefined) => {
+    isReady: boolean;
+    error: unknown;
+    component: ComponentLike;
+}) | (() => {
+    isReady: boolean;
+    error: unknown;
+    component: ComponentLike;
+});
+export { CACHE, compile, Compiled };