@cfp-studio/analyzer-api 0.1.15 → 0.1.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
- import { l as Story, n as AnalyzerFactory, o as Component } from "./api-3X9rm2RT.mjs";
1
+ import { l as Story, n as AnalyzerFactory, o as Component } from "./api-zlINpDQg.mjs";
2
2
  import { Reader } from "@cfp-studio/vfs";
3
- import { Logger } from "pino";
4
3
  import { TypeResolver, createTypeAnalyzer } from "@cfp-studio/type-analyzer";
4
+ import { Logger } from "@cfp-studio/api";
5
5
 
6
6
  //#region src/analyzer.d.ts
7
7
  type CreateTypeAnalyzerOptions = Parameters<typeof createTypeAnalyzer>[0];
package/dist/analyzer.mjs CHANGED
@@ -1 +1 @@
1
- import{factoryWithDefaultOptions as e}from"./factory.mjs";import t from"node:path";import{createTypeAnalyzer as n}from"@cfp-studio/type-analyzer";function r(r){return e(({rootDir:e,reader:i,logger:a})=>{let o={rootDir:e,reader:i,logger:a},s=n({rootDir:e,warn:a.warn.bind(a),...r.typeAnalyzerOptions(o)}),c=r.toTypeScriptPath??(e=>e);return{typeAnalyzer:s,crawlFiles:async n=>{let i=n.map(n=>t.isAbsolute(n)?n:t.join(e,n)),a=s.analyze(i.map(c)),l=[],u=[];for(let e of i)for(let t of await r.crawlFile({...o,resolver:a,absoluteFilePath:e}))`exported`in t?l.push(t):u.push(t);return{components:l,stories:u}},dispose:()=>{s.dispose()}}})}export{r as createAnalyzer};
1
+ import"./logging-yGWzkaBD.mjs";import{factoryWithDefaultOptions as e}from"./factory.mjs";import t from"node:path";import{createTypeAnalyzer as n}from"@cfp-studio/type-analyzer";function r(r){return e(({rootDir:e,reader:i,logger:a})=>{let o={rootDir:e,reader:i,logger:a},s=n({rootDir:e,warn:a.warn.bind(a),...r.typeAnalyzerOptions(o)}),c=r.toTypeScriptPath??(e=>e);return{typeAnalyzer:s,crawlFiles:async n=>{let i=n.map(n=>t.isAbsolute(n)?n:t.join(e,n)),a=s.analyze(i.map(c)),l=[],u=[];for(let e of i)for(let t of await r.crawlFile({...o,resolver:a,absoluteFilePath:e}))`exported`in t?l.push(t):u.push(t);return{components:l,stories:u}},dispose:()=>{s.dispose()}}})}export{r as createAnalyzer};
@@ -1,6 +1,6 @@
1
1
  import { Reader } from "@cfp-studio/vfs";
2
- import { Logger } from "pino";
3
2
  import { CollectedTypes, TypeAnalyzer, ValueType } from "@cfp-studio/type-analyzer";
3
+ import { Logger } from "@cfp-studio/api";
4
4
  import { SerializableValue } from "@cfp-studio/serializable-values";
5
5
 
6
6
  //#region src/api.d.ts
@@ -0,0 +1,86 @@
1
+ //#region src/error-panel.d.ts
2
+ /**
3
+ * 渲染错误面板:在**预览区域内部**显示错误,而不是白屏(`docs/todo/39`)。
4
+ *
5
+ * ## 为什么放在这里(`analyzer-api`)
6
+ *
7
+ * 5 个框架插件(react / vue3 / svelte / solid / preact)**都依赖本包**,
8
+ * 且都面临同一个问题:「被预览组件抛错 → 整片白屏,用户只知道坏了,不知道为什么」。
9
+ *
10
+ * 各插件各写一份错误 UI 会重复且容易漂移;这里用**纯 DOM**实现,
11
+ * 不引入任何框架依赖,因此 5 个插件都能直接用。
12
+ *
13
+ * ## 设计约束
14
+ *
15
+ * 1. **内联样式**:面板渲染在用户页面之上,会继承用户的全局 CSS
16
+ * (Umi / antd 的 reset 等)。用内联样式避免被覆盖。
17
+ * 2. **不污染 Runtime Tree**:面板元素带 `data-preview-error-panel`,
18
+ * `iframe` 的 `runtime-bridge.walk()` 会跳过它 —— 否则错误面板会出现在组件树里。
19
+ * 3. **不写源码、不发网络**:纯本地渲染。
20
+ * 4. **独立于框架渲染器**:面板挂在 `document.body` 下,不放进 `#root`(原因见 `renderErrorPanel`)。
21
+ */
22
+ interface RenderErrorPanelOptions {
23
+ /** 错误本体(`Error` 或任何被 throw 的值)。 */
24
+ error: unknown;
25
+ /** 被预览的可预览项名称(如 `Button`、`Default`),用于标题。 */
26
+ previewableName?: string;
27
+ /**
28
+ * React / Preact 的 `componentStack`,能指出**哪个组件**抛的错。
29
+ * 其它框架可为空。
30
+ */
31
+ componentStack?: string | null;
32
+ }
33
+ /** 面板元素的标记属性:`runtime-bridge.walk()` 据此跳过。 */
34
+ declare const ERROR_PANEL_ATTRIBUTE = "data-preview-error-panel";
35
+ /**
36
+ * 错误遮罩层的 id:整个预览页只存在一个。
37
+ *
38
+ * 固定在 `document.body` 下,**不放进 `#root`** —— `#root` 由框架的渲染器独占
39
+ *(ReactDOM 清非托管子节点、Vue/Solid 同理),面板放进去会跟着一起被抹掉。
40
+ */
41
+ declare const ERROR_PANEL_ID = "cfp-error-panel";
42
+ /**
43
+ * 把错误面板渲染成预览页的**独立覆盖层**。
44
+ *
45
+ * 返回一个清理函数,移除面板。重复调用会先移除旧面板(全页只留一个)。
46
+ *
47
+ * ## 为什么不再写进传进来的 container
48
+ *
49
+ * 旧实现 `container.appendChild(panel)` 把面板塞进 `#root`,实测症状(真实反馈):
50
+ * 「错误页面闪现一下,然后被正常页面/白屏覆盖」。原因是双重的:
51
+ * 1. `#root` 归框架渲染器管,它一重渲染就清掉非托管的子节点;
52
+ * 2. `runNewRender` 的 catch 会 `root.innerHTML = rootHtml` 回滚快照。
53
+ *
54
+ * 所以面板必须活在**框架渲染器管不到的地方**。`container` 参数保留仅用于
55
+ * 「遮罩要盖在哪个区域」—— 目前是整页,忽略该参数也符合语义,保留它是为了
56
+ * 兼容 5 个插件现有的调用点。
57
+ *
58
+ * ## 遮罩(`options.dimBackdrop`,默认开)
59
+ *
60
+ * 保存后失败时,上一次成功的内容可能还在(`runNewRender` 会回填快照)。
61
+ * 面板直接用半透明遮罩铺满并阻止穿透点击,避免成功画面干扰阅读错误信息。
62
+ */
63
+ declare function renderErrorPanel(_container: Element, options: RenderErrorPanelOptions & {
64
+ dimBackdrop?: boolean;
65
+ }): () => void;
66
+ /**
67
+ * 移除全页的错误面板(幂等)。
68
+ *
69
+ * `container` 参数保留只是为了兼容旧调用点 —— 面板现在挂在 `document.body` 下,
70
+ * 已不依赖具体容器。
71
+ */
72
+ declare function clearErrorPanel(_container?: Element): void;
73
+ /** 当前是否正显示错误面板(供宿主判断要不要保留旧画面)。 */
74
+ declare function isErrorPanelVisible(): boolean;
75
+ /**
76
+ * 把任意被 throw 的值归一成 `{ message, stack }`。
77
+ *
78
+ * 项目里见过 `throw "字符串"`、`throw { message }` 这类非 Error 值,
79
+ * 直接 `error.message` 会拿到 `undefined`。
80
+ */
81
+ declare function describeError(error: unknown): {
82
+ message: string;
83
+ stack: string | undefined;
84
+ };
85
+ //#endregion
86
+ export { ERROR_PANEL_ATTRIBUTE, ERROR_PANEL_ID, RenderErrorPanelOptions, clearErrorPanel, describeError, isErrorPanelVisible, renderErrorPanel };
@@ -0,0 +1,3 @@
1
+ const e=`data-preview-error-panel`,t=`cfp-error-panel`;function n(n,i){r();let{error:o,previewableName:c,componentStack:l}=i,{message:u,stack:d}=a(o),f=i.dimBackdrop!==!1,p=document.getElementById(`cfp-error-panel`)??document.createElement(`div`);p.id=t,p.setAttribute(e,``),p.style.cssText=[`position: fixed`,`inset: 0`,`z-index: 2147483647`,`box-sizing: border-box`,`margin: 0`,`padding: 24px`,`overflow: auto`,`display: flex`,`align-items: flex-start`,`justify-content: center`,f?`background: rgba(24, 24, 27, 0.55)`:`background: transparent`,f?`pointer-events: auto`:`pointer-events: none`].join(`;`);let m=document.createElement(`div`);m.setAttribute(e,``),m.style.cssText=[`position: relative`,`box-sizing: border-box`,`pointer-events: auto`,`width: 100%`,`max-width: 760px`,`margin: 0`,`padding: 20px 24px`,`font-family: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif`,`font-size: 13px`,`line-height: 1.6`,`color: #c0392b`,`background: #fff5f5`,`border: 1px solid #f5b7b1`,`border-radius: 8px`,`box-shadow: 0 8px 32px rgba(0, 0, 0, 0.28)`,`text-align: left`].join(`;`);let h=document.createElement(`div`);h.style.cssText=`font-size: 14px; font-weight: 600; margin-bottom: 8px`,h.textContent=c?`${c} 渲染失败`:`组件渲染失败`;let g=document.createElement(`pre`);if(g.style.cssText=[`margin: 0 0 12px`,`padding: 0`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 12px`,`line-height: 1.5`,`white-space: pre-wrap`,`word-break: break-word`,`color: #922b21`].join(`;`),g.textContent=u,m.appendChild(h),m.appendChild(g),l){let e=document.createElement(`pre`);e.style.cssText=[`margin: 0`,`padding: 10px 12px`,`background: rgba(192, 57, 43, 0.06)`,`border-radius: 6px`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 11px`,`line-height: 1.5`,`max-height: 240px`,`overflow: auto`,`white-space: pre-wrap`,`word-break: break-word`,`color: #7b241c`].join(`;`),e.textContent=s(l,12),m.appendChild(e)}if(!l&&d){let e=document.createElement(`pre`);e.style.cssText=[`margin: 0`,`padding: 10px 12px`,`background: rgba(192, 57, 43, 0.06)`,`border-radius: 6px`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 11px`,`line-height: 1.5`,`max-height: 200px`,`overflow: auto`,`white-space: pre-wrap`,`word-break: break-word`,`color: #7b241c`].join(`;`),e.textContent=s(d,6),m.appendChild(e)}return p.appendChild(m),p.isConnected||document.body.appendChild(p),()=>{p.remove()}}function r(n){document.getElementById(t)?.remove(),document.querySelectorAll(`[${e}]`).forEach(e=>e.remove())}function i(){return document.getElementById(t)!==null}function a(e){if(e instanceof Error)return{message:e.message||e.name,stack:e.stack};if(typeof e==`string`)return{message:e,stack:void 0};if(e&&typeof e==`object`){let t=e;return{message:typeof t.message==`string`?t.message:o(e),stack:typeof t.stack==`string`?t.stack:void 0}}return{message:String(e),stack:void 0}}function o(e){try{return JSON.stringify(e)}catch{return String(e)}}function s(e,t){let n=e.split(`
2
+ `);return n.length>t?`${n.slice(0,t).join(`
3
+ `)}\n…`:e}export{e as ERROR_PANEL_ATTRIBUTE,t as ERROR_PANEL_ID,r as clearErrorPanel,a as describeError,i as isErrorPanelVisible,n as renderErrorPanel};
@@ -1,4 +1,4 @@
1
- import { n as AnalyzerFactory, r as AnalyzerOptions, t as Analyzer } from "./api-3X9rm2RT.mjs";
1
+ import { n as AnalyzerFactory, r as AnalyzerOptions, t as Analyzer } from "./api-zlINpDQg.mjs";
2
2
 
3
3
  //#region src/factory.d.ts
4
4
  /**
package/dist/factory.mjs CHANGED
@@ -1 +1 @@
1
- import{createFileSystemReader as e}from"@cfp-studio/vfs";import t from"pino";import n from"pino-pretty";const{pino:r}=t,i=n;function a(t){return n=>t({...n,reader:n.reader||e(),logger:n.logger||r({level:`debug`},i({colorize:!0}))})}export{a as factoryWithDefaultOptions};
1
+ import{n as e}from"./logging-yGWzkaBD.mjs";import{createFileSystemReader as t}from"@cfp-studio/vfs";function n(n){return r=>n({...r,reader:r.reader||t(),logger:r.logger||e()})}export{n as factoryWithDefaultOptions};
package/dist/index.d.mts CHANGED
@@ -1,116 +1,75 @@
1
- import { a as BasicComponent, c as FileSourcePosition, d as StoryArgs, i as BasePreviewable, l as Story, n as AnalyzerFactory, o as Component, r as AnalyzerOptions, s as ComponentAnalysis, t as Analyzer, u as StoryAnalysis } from "./api-3X9rm2RT.mjs";
1
+ import { a as BasicComponent, c as FileSourcePosition, d as StoryArgs, i as BasePreviewable, l as Story, n as AnalyzerFactory, o as Component, r as AnalyzerOptions, s as ComponentAnalysis, t as Analyzer, u as StoryAnalysis } from "./api-zlINpDQg.mjs";
2
+ import { ERROR_PANEL_ATTRIBUTE, ERROR_PANEL_ID, RenderErrorPanelOptions, clearErrorPanel, describeError, isErrorPanelVisible, renderErrorPanel } from "./error-panel.mjs";
3
+ import { PreviewableId, decodePreviewableId, generatePreviewableId } from "./previewable-id.mjs";
2
4
  import { ValueType } from "@cfp-studio/type-analyzer";
5
+ import { Logger } from "@cfp-studio/api";
3
6
 
4
- //#region src/error-panel.d.ts
7
+ //#region src/logging.d.ts
5
8
  /**
6
- * 渲染错误面板:在**预览区域内部**显示错误,而不是白屏(`docs/todo/39`)。
9
+ * 运行时日志的**统一默认级别**。
7
10
  *
8
- * ## 为什么放在这里(`analyzer-api`)
11
+ * 之前三处各写一个值,不传 logger 时同一份代码在不同入口的日志量级完全不同:
9
12
  *
10
- * 5 个框架插件(react / vue3 / svelte / solid / preact)**都依赖本包**,
11
- * 且都面临同一个问题:「被预览组件抛错 → 整片白屏,用户只知道坏了,不知道为什么」。
13
+ * | 位置 | 旧默认值 |
14
+ * | --- | --- |
15
+ * | `core/src/index.ts` 的 `createWorkspace` | `warn` |
16
+ * | `analyzer-api/src/factory.ts` | `debug` |
17
+ * | `loader/src/runner.ts` | `info` |
12
18
  *
13
- * 各插件各写一份错误 UI 会重复且容易漂移;这里用**纯 DOM**实现,
14
- * 不引入任何框架依赖,因此 5 个插件都能直接用。
15
- *
16
- * ## 设计约束
17
- *
18
- * 1. **内联样式**:面板渲染在用户页面之上,会继承用户的全局 CSS
19
- * (Umi / antd 的 reset 等)。用内联样式避免被覆盖。
20
- * 2. **不污染 Runtime Tree**:面板元素带 `data-preview-error-panel`,
21
- * `iframe` 的 `runtime-bridge.walk()` 会跳过它 —— 否则错误面板会出现在组件树里。
22
- * 3. **不写源码、不发网络**:纯本地渲染。
23
- * 4. **独立于框架渲染器**:面板挂在 `document.body` 下,不放进 `#root`(原因见 `renderErrorPanel`)。
19
+ * 现在统一到 `info`:用户默认能看到「发生了什么」,看不到逐帧的内部细节。
20
+ * 与扩展侧的 `cfp.logLevel` 默认值一致(`apps/vscode/src/Logger.ts`),
21
+ * 这样从宿主到运行时是同一个口径。
24
22
  */
25
- interface RenderErrorPanelOptions {
26
- /** 错误本体(`Error` 或任何被 throw 的值)。 */
27
- error: unknown;
28
- /** 被预览的可预览项名称(如 `Button`、`Default`),用于标题。 */
29
- previewableName?: string;
30
- /**
31
- * React / Preact 的 `componentStack`,能指出**哪个组件**抛的错。
32
- * 其它框架可为空。
33
- */
34
- componentStack?: string | null;
35
- }
36
- /** 面板元素的标记属性:`runtime-bridge.walk()` 据此跳过。 */
37
- declare const ERROR_PANEL_ATTRIBUTE = "data-preview-error-panel";
23
+ declare const DEFAULT_LOG_LEVEL = "info";
38
24
  /**
39
- * 错误遮罩层的 id:整个预览页只存在一个。
25
+ * 解析生效的日志级别:环境变量优先,无效值回落到 {@link DEFAULT_LOG_LEVEL}。
40
26
  *
41
- * 固定在 `document.body` 下,**不放进 `#root`** —— `#root` 由框架的渲染器独占
42
- *(ReactDOM 清非托管子节点、Vue/Solid 同理),面板放进去会跟着一起被抹掉。
27
+ * 环境变量名沿用 `PREVIEWJS_LOG_LEVEL`(扩展侧 `startDaemon` 会把 `cfp.logLevel`
28
+ * 透传成它)。**统一在这里读**,避免各处重复实现出分歧 —— 旧代码里
29
+ * `loader` 用 `validLogLevels` 校验、`core` 直接透传不校验,就是分歧的开始。
43
30
  */
44
- declare const ERROR_PANEL_ID = "cfp-error-panel";
31
+ declare function resolveLogLevel(explicit?: string): string;
45
32
  /**
46
- * 把错误面板渲染成预览页的**独立覆盖层**。
47
- *
48
- * 返回一个清理函数,移除面板。重复调用会先移除旧面板(全页只留一个)。
49
- *
50
- * ## 为什么不再写进传进来的 container
51
- *
52
- * 旧实现 `container.appendChild(panel)` 把面板塞进 `#root`,实测症状(真实反馈):
53
- * 「错误页面闪现一下,然后被正常页面/白屏覆盖」。原因是双重的:
54
- * 1. `#root` 归框架渲染器管,它一重渲染就清掉非托管的子节点;
55
- * 2. `runNewRender` 的 catch 会 `root.innerHTML = rootHtml` 回滚快照。
56
- *
57
- * 所以面板必须活在**框架渲染器管不到的地方**。`container` 参数保留仅用于
58
- * 「遮罩要盖在哪个区域」—— 目前是整页,忽略该参数也符合语义,保留它是为了
59
- * 兼容 5 个插件现有的调用点。
33
+ * 创建一个写往 `process.stdout` 的运行时 logger(pino + pretty)。
60
34
  *
61
- * ## 遮罩(`options.dimBackdrop`,默认开)
35
+ * 所有运行时入口(loader 的全局 logger、worker、core 的默认 logger、插件的默认
36
+ * logger)都该用它,这样格式、级别口径、颜色设置只有一处定义。
62
37
  *
63
- * 保存后失败时,上一次成功的内容可能还在(`runNewRender` 会回填快照)。
64
- * 面板直接用半透明遮罩铺满并阻止穿透点击,避免成功画面干扰阅读错误信息。
38
+ * @param level - 指定级别;不传则读 `PREVIEWJS_LOG_LEVEL`,再不行用 `info`。
39
+ * @param source - 日志来源标签(如 `"loader"` / `"worker"`)。会作为 pino 的 `name`
40
+ * 出现在每一条日志里 —— daemon / loader / core / 插件的输出最终都汇进同一个
41
+ * channel,没有这个标签就分不清是谁打的。
65
42
  */
66
- declare function renderErrorPanel(_container: Element, options: RenderErrorPanelOptions & {
67
- dimBackdrop?: boolean;
68
- }): () => void;
43
+ declare function createPipelineLogger(level?: string, source?: string): Logger;
69
44
  /**
70
- * 移除全页的错误面板(幂等)。
45
+ * 与 {@link createPipelineLogger} 相同,但日志写往**自定义流**。
71
46
  *
72
- * `container` 参数保留只是为了兼容旧调用点 —— 面板现在挂在 `document.body` 下,
73
- * 已不依赖具体容器。
74
- */
75
- declare function clearErrorPanel(_container?: Element): void;
76
- /** 当前是否正显示错误面板(供宿主判断要不要保留旧画面)。 */
77
- declare function isErrorPanelVisible(): boolean;
78
- /**
79
- * 把任意被 throw 的值归一成 `{ message, stack }`。
47
+ * `loader/src/worker.ts` 需要把日志 `postMessage` 回 daemon 进程而不是写 stdout,
48
+ * 用一个带 `write()` 的对象即可。
80
49
  *
81
- * 项目里见过 `throw "字符串"`、`throw { message }` 这类非 Error 值,
82
- * 直接 `error.message` 会拿到 `undefined`。
50
+ * @param source - 日志来源标签,含义同 {@link createPipelineLogger}。
83
51
  */
84
- declare function describeError(error: unknown): {
85
- message: string;
86
- stack: string | undefined;
87
- };
52
+ declare function createPipelineLoggerWithStream(stream: {
53
+ write(message: string): void;
54
+ }, level?: string, source?: string): Logger;
88
55
  //#endregion
89
- //#region src/previewable-id.d.ts
90
- type PreviewableId = {
91
- filePath: string;
92
- name: string;
93
- };
56
+ //#region src/own-version.d.ts
94
57
  /**
95
- * 生成可预览 ID。
58
+ * 读「当前这个包」的版本号,供框架插件填 `info.version` 用。
96
59
  *
97
- * @param options - 包含文件路径和名称的选项对象。
98
- * @param options.filePath - 文件的路径。
99
- * @param options.name - 与文件相关的名称。
100
- * @returns 生成的可预览 ID,格式为 "文件路径:名称"。
101
- */
102
- declare function generatePreviewableId(options: {
103
- filePath: string;
104
- name: string;
105
- }): string;
106
- /**
107
- * 解码可预览 ID。
60
+ * 为什么需要它:插件的 `info.version` 参与**组件扫描缓存的目录名**(见
61
+ * `core/src/caching.ts` 的 `getScanCacheDir`)。缓存只按文件 mtime 判断要不要重新分析,
62
+ * 于是「插件分析能力变了、源码没改」时旧结果会被永久复用 —— 升级完还是扫不出组件,
63
+ * 用户只能手动删 `node_modules/.cfp`。带上版本号,升级即换目录。
64
+ *
65
+ * 版本号从**调用方模块的位置**向上找 `package.json`(`<pkg>/dist/index.mjs` → `<pkg>`),
66
+ * 不拼死相对路径,也不依赖 `exports` 是否开放 `./package.json` 子路径 ——
67
+ * 安装态是 pnpm 的软链结构,路径形状不可假设。
108
68
  *
109
- * @param id - 要解码的可预览 ID。
110
- * @returns 包含文件路径和名称的对象。
111
- * @throws 如果 ID 格式无效(不包含冒号),则抛出错误。
69
+ * @param moduleUrl - 调用方传 `import.meta.url`。
70
+ * @returns 版本号字符串;解析失败返回 `"unknown"`(不抛错 —— 它只影响缓存分区粒度)。
112
71
  */
113
- declare function decodePreviewableId(id: string): PreviewableId;
72
+ declare function readOwnVersion(moduleUrl: string): string;
114
73
  //#endregion
115
74
  //#region src/special-types.d.ts
116
75
  type SpecialTypes = Record<string, ValueType>;
@@ -139,4 +98,4 @@ type WrapperLanguage = "tsx" | "jsx" | "vue" | "svelte" | "ts" | "js";
139
98
  /** 默认 wrapper 路径:`__previewjs__/Wrapper.<language>`。 */
140
99
  declare function wrapperPathFor(language: WrapperLanguage): string;
141
100
  //#endregion
142
- export { Analyzer, AnalyzerFactory, AnalyzerOptions, BasePreviewable, BasicComponent, Component, ComponentAnalysis, ERROR_PANEL_ATTRIBUTE, ERROR_PANEL_ID, FileSourcePosition, PreviewableId, RenderErrorPanelOptions, SpecialTypes, Story, StoryAnalysis, StoryArgs, WrapperLanguage, clearErrorPanel, decodePreviewableId, defineSpecialTypes, describeError, generatePreviewableId, isErrorPanelVisible, mergeSpecialTypes, renderErrorPanel, wrapperPathFor };
101
+ export { Analyzer, AnalyzerFactory, AnalyzerOptions, BasePreviewable, BasicComponent, Component, ComponentAnalysis, DEFAULT_LOG_LEVEL, ERROR_PANEL_ATTRIBUTE, ERROR_PANEL_ID, FileSourcePosition, PreviewableId, RenderErrorPanelOptions, SpecialTypes, Story, StoryAnalysis, StoryArgs, WrapperLanguage, clearErrorPanel, createPipelineLogger, createPipelineLoggerWithStream, decodePreviewableId, defineSpecialTypes, describeError, generatePreviewableId, isErrorPanelVisible, mergeSpecialTypes, readOwnVersion, renderErrorPanel, resolveLogLevel, wrapperPathFor };
package/dist/index.mjs CHANGED
@@ -1,3 +1 @@
1
- const e=`data-preview-error-panel`,t=`cfp-error-panel`;function n(n,i){r();let{error:o,previewableName:c,componentStack:l}=i,{message:u,stack:d}=a(o),f=i.dimBackdrop!==!1,p=document.getElementById(`cfp-error-panel`)??document.createElement(`div`);p.id=t,p.setAttribute(e,``),p.style.cssText=[`position: fixed`,`inset: 0`,`z-index: 2147483647`,`box-sizing: border-box`,`margin: 0`,`padding: 24px`,`overflow: auto`,`display: flex`,`align-items: flex-start`,`justify-content: center`,f?`background: rgba(24, 24, 27, 0.55)`:`background: transparent`,f?`pointer-events: auto`:`pointer-events: none`].join(`;`);let m=document.createElement(`div`);m.setAttribute(e,``),m.style.cssText=[`position: relative`,`box-sizing: border-box`,`pointer-events: auto`,`width: 100%`,`max-width: 760px`,`margin: 0`,`padding: 20px 24px`,`font-family: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif`,`font-size: 13px`,`line-height: 1.6`,`color: #c0392b`,`background: #fff5f5`,`border: 1px solid #f5b7b1`,`border-radius: 8px`,`box-shadow: 0 8px 32px rgba(0, 0, 0, 0.28)`,`text-align: left`].join(`;`);let h=document.createElement(`div`);h.style.cssText=`font-size: 14px; font-weight: 600; margin-bottom: 8px`,h.textContent=c?`${c} 渲染失败`:`组件渲染失败`;let g=document.createElement(`pre`);if(g.style.cssText=[`margin: 0 0 12px`,`padding: 0`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 12px`,`line-height: 1.5`,`white-space: pre-wrap`,`word-break: break-word`,`color: #922b21`].join(`;`),g.textContent=u,m.appendChild(h),m.appendChild(g),l){let e=document.createElement(`pre`);e.style.cssText=[`margin: 0`,`padding: 10px 12px`,`background: rgba(192, 57, 43, 0.06)`,`border-radius: 6px`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 11px`,`line-height: 1.5`,`max-height: 240px`,`overflow: auto`,`white-space: pre-wrap`,`word-break: break-word`,`color: #7b241c`].join(`;`),e.textContent=s(l,12),m.appendChild(e)}if(!l&&d){let e=document.createElement(`pre`);e.style.cssText=[`margin: 0`,`padding: 10px 12px`,`background: rgba(192, 57, 43, 0.06)`,`border-radius: 6px`,`font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`,`font-size: 11px`,`line-height: 1.5`,`max-height: 200px`,`overflow: auto`,`white-space: pre-wrap`,`word-break: break-word`,`color: #7b241c`].join(`;`),e.textContent=s(d,6),m.appendChild(e)}return p.appendChild(m),p.isConnected||document.body.appendChild(p),()=>{p.remove()}}function r(n){document.getElementById(t)?.remove(),document.querySelectorAll(`[${e}]`).forEach(e=>e.remove())}function i(){return document.getElementById(t)!==null}function a(e){if(e instanceof Error)return{message:e.message||e.name,stack:e.stack};if(typeof e==`string`)return{message:e,stack:void 0};if(e&&typeof e==`object`){let t=e;return{message:typeof t.message==`string`?t.message:o(e),stack:typeof t.stack==`string`?t.stack:void 0}}return{message:String(e),stack:void 0}}function o(e){try{return JSON.stringify(e)}catch{return String(e)}}function s(e,t){let n=e.split(`
2
- `);return n.length>t?`${n.slice(0,t).join(`
3
- `)}\n…`:e}function c(e){return`${e.filePath.replace(/\\/g,`/`)}:${e.name}`}function l(e){if(e.lastIndexOf(`:`)===-1)throw Error(`无效的 ID: "${e}"`);let[t,n]=e.split(`:`);return{filePath:t,name:n}}function u(e){return e}function d(...e){let t={};for(let n of e)n&&Object.assign(t,n);return t}function f(e){return`__previewjs__/Wrapper.${e}`}export{e as ERROR_PANEL_ATTRIBUTE,t as ERROR_PANEL_ID,r as clearErrorPanel,l as decodePreviewableId,u as defineSpecialTypes,a as describeError,c as generatePreviewableId,i as isErrorPanelVisible,d as mergeSpecialTypes,n as renderErrorPanel,f as wrapperPathFor};
1
+ import{ERROR_PANEL_ATTRIBUTE as e,ERROR_PANEL_ID as t,clearErrorPanel as n,describeError as r,isErrorPanelVisible as i,renderErrorPanel as a}from"./error-panel.mjs";import{i as o,n as s,r as c,t as l}from"./logging-yGWzkaBD.mjs";import{decodePreviewableId as u,generatePreviewableId as d}from"./previewable-id.mjs";import f from"node:fs";import p from"node:path";import m from"node:url";function h(e){try{let t=p.dirname(m.fileURLToPath(e));for(let e=0;e<5;e++){let e=p.join(t,`package.json`);if(f.existsSync(e))return JSON.parse(f.readFileSync(e,`utf8`)).version??`unknown`;let n=p.dirname(t);if(n===t)break;t=n}return`unknown`}catch{return`unknown`}}function g(e){return e}function _(...e){let t={};for(let n of e)n&&Object.assign(t,n);return t}function v(e){return`__previewjs__/Wrapper.${e}`}export{l as DEFAULT_LOG_LEVEL,e as ERROR_PANEL_ATTRIBUTE,t as ERROR_PANEL_ID,n as clearErrorPanel,s as createPipelineLogger,c as createPipelineLoggerWithStream,u as decodePreviewableId,g as defineSpecialTypes,r as describeError,d as generatePreviewableId,i as isErrorPanelVisible,_ as mergeSpecialTypes,h as readOwnVersion,a as renderErrorPanel,o as resolveLogLevel,v as wrapperPathFor};
@@ -0,0 +1 @@
1
+ import e from"pino";import t from"pino-pretty";const{pino:n}=e,r=t,i=`info`,a=new Set([`fatal`,`error`,`warn`,`info`,`debug`,`trace`,`silent`]);function o(e){let t=(e??process.env.PREVIEWJS_LOG_LEVEL)?.toLowerCase();return t&&a.has(t)?t:i}function s(e,t){return n({level:o(e),...t?{name:t}:{}},r({colorize:!0}))}function c(e,t,r){return n({level:o(t),...r?{name:r}:{}},e)}export{o as i,s as n,c as r,i as t};
@@ -0,0 +1,27 @@
1
+ //#region src/previewable-id.d.ts
2
+ type PreviewableId = {
3
+ filePath: string;
4
+ name: string;
5
+ };
6
+ /**
7
+ * 生成可预览 ID。
8
+ *
9
+ * @param options - 包含文件路径和名称的选项对象。
10
+ * @param options.filePath - 文件的路径。
11
+ * @param options.name - 与文件相关的名称。
12
+ * @returns 生成的可预览 ID,格式为 "文件路径:名称"。
13
+ */
14
+ declare function generatePreviewableId(options: {
15
+ filePath: string;
16
+ name: string;
17
+ }): string;
18
+ /**
19
+ * 解码可预览 ID。
20
+ *
21
+ * @param id - 要解码的可预览 ID。
22
+ * @returns 包含文件路径和名称的对象。
23
+ * @throws 如果 ID 格式无效(不包含冒号),则抛出错误。
24
+ */
25
+ declare function decodePreviewableId(id: string): PreviewableId;
26
+ //#endregion
27
+ export { PreviewableId, decodePreviewableId, generatePreviewableId };
@@ -0,0 +1 @@
1
+ function e(e){return`${e.filePath.replace(/\\/g,`/`)}:${e.name}`}function t(e){if(e.lastIndexOf(`:`)===-1)throw Error(`无效的 ID: "${e}"`);let[t,n]=e.split(`:`);return{filePath:t,name:n}}export{t as decodePreviewableId,e as generatePreviewableId};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cfp-studio/analyzer-api",
3
- "version": "0.1.15",
3
+ "version": "0.1.16",
4
4
  "license": "MIT",
5
5
  "files": [
6
6
  "dist"
@@ -12,6 +12,14 @@
12
12
  "import": "./dist/index.mjs",
13
13
  "types": "./dist/index.d.mts"
14
14
  },
15
+ "./error-panel": {
16
+ "import": "./dist/error-panel.mjs",
17
+ "types": "./dist/error-panel.d.mts"
18
+ },
19
+ "./previewable-id": {
20
+ "import": "./dist/previewable-id.mjs",
21
+ "types": "./dist/previewable-id.d.mts"
22
+ },
15
23
  "./factory": {
16
24
  "import": "./dist/factory.mjs",
17
25
  "types": "./dist/factory.d.mts"
@@ -24,9 +32,10 @@
24
32
  "dependencies": {
25
33
  "pino": "9.11.0",
26
34
  "pino-pretty": "13.1.1",
35
+ "@cfp-studio/api": "16.1.1",
27
36
  "@cfp-studio/serializable-values": "9.0.8",
28
- "@cfp-studio/vfs": "2.1.8",
29
- "@cfp-studio/type-analyzer": "10.1.8"
37
+ "@cfp-studio/type-analyzer": "10.1.9",
38
+ "@cfp-studio/vfs": "2.1.8"
30
39
  },
31
40
  "devDependencies": {
32
41
  "typescript": "5.9.3",