@netless/app-presentation 0.1.13 → 0.1.14

package/README-zh.md

@@ -32,6 +32,17 @@ install(register, {
 })
 ```
 
+### 依赖边界与本地开发
+
+库代码通过 `import type` 引用 WindowManager 和 White SDK 类型；运行时由宿主通过
+`AppContext` 和 `install(register)` 提供。`install()` 也可以直接接收
+`WindowManager.register`。Fastboard 仅用于集成示例中的房间创建和 UI。
+
+使用 `pnpm install` 安装库构建依赖。运行 Fastboard 示例时，再执行
+`pnpm --dir e2e install`，然后运行 `pnpm dev:e2e`；房间的 `VITE_*` 配置放在
+仓库根目录的 `.env.local`。Fastboard 和教具插件依赖由独立的 `e2e` 私有包管理，
+不会随库发布。库构建会拒绝对宿主包的运行时导入。
+
 ### 将应用插入房间
 
 如果你以 `{ as: 'DocsViewer' }` 的方式安装了这个应用，请调用 [`fastboard.insertDocs()`](https://github.com/netless-io/fastboard#insert-pdf-ppt-and-pptx)。

package/README.md

@@ -34,6 +34,19 @@ install(register, {
 })
 ```
 
+### Dependency boundary and local development
+
+The library imports WindowManager and White SDK types with `import type`; their
+runtime is supplied by the host through `AppContext` and `install(register)`.
+`install()` also accepts `WindowManager.register` directly. Fastboard is only
+needed by the integration demo, where it creates the room and UI.
+
+Install the library build dependencies with `pnpm install`. To run the Fastboard
+demo, also run `pnpm --dir e2e install`, then `pnpm dev:e2e`. Configure its
+`VITE_*` room settings in the repository's `.env.local`. The private `e2e`
+package owns the Fastboard and appliance plugin dependencies and is not published.
+The library build rejects runtime imports of host packages.
+
 ### Insert This App Into Room
 
 Call [`fastboard.insertDocs()`](https://github.com/netless-io/fastboard#insert-pdf-ppt-and-pptx)

package/build.ts

@@ -46,6 +46,20 @@ const lazyload = (): esbuild.Plugin => ({
   }
 })
 
+// Host APIs are provided by AppContext or install(register), never imported at runtime.
+const hostTypesOnly = (): esbuild.Plugin => ({
+  name: 'host-types-only',
+  setup({ onResolve }) {
+    onResolve({
+      filter: /^(?:@netless\/(?:window-manager|fastboard(?:-[^/]+)?|appliance-plugin)|white-web-sdk)(?:\/|$)/,
+    }, args => ({
+      errors: [{
+        text: `Presentation cannot import ${args.path} at runtime. Use import type for host types; keep host runtime imports in e2e.`,
+      }],
+    }))
+  },
+})
+
 fs.rmSync('dist', { recursive: true, force: true })
 
 let bundle = await rollup.rollup({
@@ -62,17 +76,11 @@ let bundle = await rollup.rollup({
         sourcemap: true,
         write: false,
         target: ['es2017'],
-        plugins: [sass(), lazyload()],
+        plugins: [hostTypesOnly(), sass(), lazyload()],
         define: {
           __VERSION__: JSON.stringify(version)
         },
-        external: Object.keys({
-          '@netless/window-manager': '*',
-          '@netless/appliance-plugin': '*',
-          '@netless/fastboard': '*',
-          'white-web-sdk': '*',
-          ...peerDependencies,
-        })
+        external: Object.keys(peerDependencies)
       })
       let code: any, map: any
       for (const { path, text } of outputFiles) {
@@ -98,4 +106,6 @@ code = code.replace(`await import('jspdf')`, `jspdf`)
 fs.writeFileSync('dist/index.global.js', code)
 
 if (process.env.DTS != '0')
-  await dts.build('src/index.ts', 'dist/index.d.ts', { exclude: ['@netless/window-manager'] })
+  await dts.build('src/index.ts', 'dist/index.d.ts', {
+    exclude: ['@netless/window-manager', 'white-web-sdk'],
+  })

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { View, NetlessApp, Size, AppContext, WindowManager } from '@netless/window-manager';
+import { View, NetlessApp, AppContext, WindowManager } from '@netless/window-manager';
+import { Size } from 'white-web-sdk';
 
 /**
  * A combination of {@link Disposer} and {@link IDisposable}.

package/dist/index.global.js

@@ -2187,6 +2187,7 @@ var NetlessAppPresentation = (function (exports) {
       }
     };
     const restoreFocusedResources = () => {
+      appliedFocusState = true;
       if (!blurEpisode)
         return;
       blurEpisode = false;
@@ -2707,7 +2708,7 @@ var NetlessAppPresentation = (function (exports) {
           }
         )
       );
-      app.contentDOM.dataset.appPresentationVersion = "0.1.13";
+      app.contentDOM.dataset.appPresentationVersion = "0.1.14";
       app.scaleDocsToFit = scaleDocsToFit;
       app.log = log;
       app.warn = warn;
@@ -3278,7 +3279,7 @@ var NetlessAppPresentation = (function (exports) {
   };
 
   // src/index.ts
-  var version = "0.1.13";
+  var version = "0.1.14";
 
   exports.NetlessAppPresentation = NetlessAppPresentation;
   exports.Presentation = Presentation;

package/dist/index.js

@@ -2188,6 +2188,7 @@ var setupBlurThumbnailDegradation = (config) => {
     }
   };
   const restoreFocusedResources = () => {
+    appliedFocusState = true;
     if (!blurEpisode)
       return;
     blurEpisode = false;
@@ -2708,7 +2709,7 @@ var NetlessAppPresentation = {
         }
       )
     );
-    app.contentDOM.dataset.appPresentationVersion = "0.1.13";
+    app.contentDOM.dataset.appPresentationVersion = "0.1.14";
     app.scaleDocsToFit = scaleDocsToFit;
     app.log = log;
     app.warn = warn;
@@ -3279,7 +3280,7 @@ var install = (register, options = {}) => {
 };
 
 // src/index.ts
-var version = "0.1.13";
+var version = "0.1.14";
 
 exports.NetlessAppPresentation = NetlessAppPresentation;
 exports.Presentation = Presentation;