@ubean/pages 0.4.5 → 0.4.6

package/dist/index.d.ts

@@ -70,28 +70,28 @@ interface PageRenderer {
   renderToStream?: PageStreamRenderFn;
   preambleScript?: string;
 }
-declare const PAGE_DATA_ID = "__UBEAN_PAGE_DATA__";
-declare const LOCALE_DATA_ID = "__UBEAN_LOCALE__";
-declare const STATE_DATA_ID = "__UBEAN_STATE__";
-declare const PAGE_REQUEST_HEADER = "x-ubeanpages";
-declare const SSR_CONTENT_MARKER = "<!--UBEAN_SSR_CONTENT-->";
+export declare const PAGE_DATA_ID = "__UBEAN_PAGE_DATA__";
+export declare const LOCALE_DATA_ID = "__UBEAN_LOCALE__";
+export declare const STATE_DATA_ID = "__UBEAN_STATE__";
+export declare const PAGE_REQUEST_HEADER = "x-ubeanpages";
+export declare const SSR_CONTENT_MARKER = "<!--UBEAN_SSR_CONTENT-->";
 /** Shell 中 state script 的占位符,render 后由 `insertStateContent` 替换为实际 JSON */
-declare const STATE_MARKER = "<!--UBEAN_STATE-->";
-declare function isPagesRequest(c: {
+export declare const STATE_MARKER = "<!--UBEAN_STATE-->";
+export declare function isPagesRequest(c: {
   req: {
     header: (k: string) => string | undefined;
   };
 }): boolean;
-declare function safeJsonStringify(value: unknown): string;
-declare function serializePageData(pageObj: PageObject): string;
-declare function pageJsonResponse(pageObj: PageObject, headers?: Record<string, string>): Response;
+export declare function safeJsonStringify(value: unknown): string;
+export declare function serializePageData(pageObj: PageObject): string;
+export declare function pageJsonResponse(pageObj: PageObject, headers?: Record<string, string>): Response;
 /**
  * 生成 favicon `<link>` 标签字符串。
  * 当 `favicon` 为空/未设置时返回空字符串。
  */
-declare function renderFaviconLink(favicon?: string): string;
-declare function buildPageShell(pageObj: PageObject, assetTags: PageAssetTags, preambleScript?: string, appId?: string, renderContext?: PageRenderContext): string;
-declare function insertSsrContent(shell: string, appHtml: string): string;
+export declare function renderFaviconLink(favicon?: string): string;
+export declare function buildPageShell(pageObj: PageObject, assetTags: PageAssetTags, preambleScript?: string, appId?: string, renderContext?: PageRenderContext): string;
+export declare function insertSsrContent(shell: string, appHtml: string): string;
 /**
  * 将序列化后的 state JSON 注入 shell 中的 `__UBEAN_STATE__` script 标签。
  *
@@ -101,9 +101,9 @@ declare function insertSsrContent(shell: string, appHtml: string): string;
  * 若 `stateJson` 为空字符串或 `null`,将占位符替换为空字符串(产出空 script 体,
  * 客户端 `getInitialState()` 会返回 `null`)。
  */
-declare function insertStateContent(shell: string, stateJson: string | null): string;
-declare function buildClientOnlyShell(pageObj: PageObject, assetTags: PageAssetTags, preambleScript?: string, appId?: string, renderContext?: PageRenderContext): string;
-declare function renderPage(pageObj: PageObject, assetTags: PageAssetTags, renderer: PageRenderer | null, appId?: string, renderContext?: PageRenderContext): Promise<string>;
+export declare function insertStateContent(shell: string, stateJson: string | null): string;
+export declare function buildClientOnlyShell(pageObj: PageObject, assetTags: PageAssetTags, preambleScript?: string, appId?: string, renderContext?: PageRenderContext): string;
+export declare function renderPage(pageObj: PageObject, assetTags: PageAssetTags, renderer: PageRenderer | null, appId?: string, renderContext?: PageRenderContext): Promise<string>;
 /**
  * 流式渲染页面:当 renderer 提供 `renderToStream` 时,返回一个
  * `ReadableStream<Uint8Array>`,将完整 HTML 文档分块流式输出。
@@ -114,7 +114,7 @@ declare function renderPage(pageObj: PageObject, assetTags: PageAssetTags, rende
  * 调用方应使用 `c.body(stream, { headers: { 'Content-Type': 'text/html; charset=utf-8' } })`
  * 将流作为 HTTP 响应返回。
  */
-declare function renderPageToStream(pageObj: PageObject, assetTags: PageAssetTags, renderer: PageRenderer | null, appId?: string, renderContext?: PageRenderContext): ReadableStream<Uint8Array>;
+export declare function renderPageToStream(pageObj: PageObject, assetTags: PageAssetTags, renderer: PageRenderer | null, appId?: string, renderContext?: PageRenderContext): ReadableStream<Uint8Array>;
 //#endregion
 //#region src/data.d.ts
 type DataKey = string | symbol;
@@ -126,7 +126,7 @@ interface DataCacheEntry<T = unknown> {
   tags?: string[];
 }
 type DataFetcher<T> = () => T | Promise<T>;
-declare function defineDataKey(key: string): symbol;
+export declare function defineDataKey(key: string): symbol;
 /**
  * `__UBEAN_DATA__` script 标签 ID — SSR 渲染时,useData 解析的数据以 JSON 形式
  * 注入到此标签中,客户端水合时读取,避免二次请求。
@@ -134,7 +134,7 @@ declare function defineDataKey(key: string): symbol;
  * 与 `__UBEAN_DEFERRED__`(非关键延迟数据)和 `__UBEAN_STATE__`(用户状态如 Pinia)
  * 分离,职责单一,便于 SSG payload 提取(roadmap Task 3)。
  */
-declare const DATA_PAYLOAD_ID = "__UBEAN_DATA__";
+export declare const DATA_PAYLOAD_ID = "__UBEAN_DATA__";
 /**
  * SSR payload 条目:记录 useData 解析结果,序列化到 `__UBEAN_DATA__`。
  * `error` 以字符串形式存储(可序列化),客户端水合时重建为 Error。
@@ -150,25 +150,25 @@ interface DataPayloadEntry {
  * 在 `useData` 的 SSR 分支中调用。每次渲染前应调用 `__clearDataPayload()`。
  * 仅 string key 可注册(symbol 无法序列化)。
  */
-declare function __registerDataPayload(key: string, entry: DataPayloadEntry): void;
+export declare function __registerDataPayload(key: string, entry: DataPayloadEntry): void;
 /**
  * SSR 内部:返回所有已注册的 payload 条目,用于序列化到 `__UBEAN_DATA__`。
  */
-declare function __resolveDataPayload(): Record<string, DataPayloadEntry>;
+export declare function __resolveDataPayload(): Record<string, DataPayloadEntry>;
 /**
  * SSR 内部:清空 payload 注册表 + 全局 inflight。每次渲染前调用,
  * 避免上一个请求的残留。
  */
-declare function __clearDataPayload(): void;
+export declare function __clearDataPayload(): void;
 /**
  * SSR 内部:将 data payload 序列化为 `<script>` 标签字符串。
  * 无数据时返回空字符串(不注入标签)。
  */
-declare function __serializeDataPayload(data: Record<string, DataPayloadEntry>): string;
+export declare function __serializeDataPayload(data: Record<string, DataPayloadEntry>): string;
 /**
  * 重置客户端 payload 缓存(测试用)。
  */
-declare function __resetDataPayloadCache(): void;
+export declare function __resetDataPayloadCache(): void;
 interface UseDataOptions<T> {
   key?: DataKey;
   tags?: string[];
@@ -199,7 +199,7 @@ interface DataResult<T> {
    */
   refresh: () => Promise<void>;
 }
-declare function useData<T>(options: UseDataOptions<T>, context?: object): Promise<DataResult<T>>;
+export declare function useData<T>(options: UseDataOptions<T>, context?: object): Promise<DataResult<T>>;
 /**
  * `useAsyncData` 选项:Nuxt 风格的 `useAsyncData(key, fn, options)` 第三参数。
  *
@@ -227,25 +227,25 @@ interface UseAsyncDataOptions {
  * );
  * ```
  */
-declare function useAsyncData<T>(key: string, fn: DataFetcher<T>, options?: UseAsyncDataOptions, context?: object): Promise<DataResult<T>>;
-declare function invalidateData(keyOrTag: DataKey | string, context?: object): number;
-declare function invalidateAll(context?: object): void;
-declare function clearPageData(context?: object): void;
-declare function hasData(key: DataKey, context?: object): boolean;
+export declare function useAsyncData<T>(key: string, fn: DataFetcher<T>, options?: UseAsyncDataOptions, context?: object): Promise<DataResult<T>>;
+export declare function invalidateData(keyOrTag: DataKey | string, context?: object): number;
+export declare function invalidateAll(context?: object): void;
+export declare function clearPageData(context?: object): void;
+export declare function hasData(key: DataKey, context?: object): boolean;
 interface DependencyDeclaration {
   keys: DataKey[];
   tags?: string[];
 }
-declare function declareDependencies(deps: DependencyDeclaration): DependencyDeclaration;
-declare function withDependencies<T>(fn: () => T | Promise<T>, _deps: DependencyDeclaration): () => Promise<T>;
-declare function getInvalidatedKeysForAction(actionName: string, invalidationMap: Record<string, Array<DataKey | string>>, context?: object): number;
+export declare function declareDependencies(deps: DependencyDeclaration): DependencyDeclaration;
+export declare function withDependencies<T>(fn: () => T | Promise<T>, _deps: DependencyDeclaration): () => Promise<T>;
+export declare function getInvalidatedKeysForAction(actionName: string, invalidationMap: Record<string, Array<DataKey | string>>, context?: object): number;
 interface InternalFetchOptions {
   baseURL?: string;
   headers?: Record<string, string>;
   credentials?: 'include' | 'omit' | 'same-origin';
   forwardHeaders?: string[];
 }
-declare function createInternalFetch(c: {
+export declare function createInternalFetch(c: {
   req: {
     raw?: Request;
     header?: (name: string) => string | undefined;
@@ -258,8 +258,8 @@ interface StreamHelper {
   error: (err: Error) => void;
   response: Response;
 }
-declare function createStreamResponse(init?: ResponseInit, onStart?: (stream: StreamHelper) => void | Promise<void>): Response;
-declare function createSseStream(onStart?: (stream: StreamHelper) => void | Promise<void>): Response;
+export declare function createStreamResponse(init?: ResponseInit, onStart?: (stream: StreamHelper) => void | Promise<void>): Response;
+export declare function createSseStream(onStart?: (stream: StreamHelper) => void | Promise<void>): Response;
 //#endregion
 //#region src/fetch.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -281,16 +281,16 @@ interface UseFetchOptions<T> extends UseAsyncDataOptions {
   request?: FetchClient;
   transform?: (data: T) => T;
 }
-declare function setDefaultFetch(request: FetchClient | undefined): void;
-declare function getDefaultFetch(): FetchClient | undefined;
-declare function useFetch<T>(key: string, url: string, options?: UseFetchOptions<T>, context?: object): Promise<DataResult<T>>;
+export declare function setDefaultFetch(request: FetchClient | undefined): void;
+export declare function getDefaultFetch(): FetchClient | undefined;
+export declare function useFetch<T>(key: string, url: string, options?: UseFetchOptions<T>, context?: object): Promise<DataResult<T>>;
 //#endregion
 //#region src/defer.d.ts
 /**
  * `__UBEAN_DEFERRED__` script 标签 ID — SSR 流式渲染完成后,延迟数据
  * 以 JSON 形式注入到此标签中,客户端水合时读取。
  */
-declare const DEFERRED_DATA_ID = "__UBEAN_DEFERRED__";
+export declare const DEFERRED_DATA_ID = "__UBEAN_DEFERRED__";
 /**
  * 延迟值:包装一个 factory 函数,标记为"非关键数据"。
  *
@@ -315,38 +315,38 @@ interface DeferredValue<T> {
  * const nonCritical = defer(() => fetchNonCritical());
  * ```
  */
-declare function defer<T>(factory: (() => Promise<T>) | Promise<T>): DeferredValue<T>;
+export declare function defer<T>(factory: (() => Promise<T>) | Promise<T>): DeferredValue<T>;
 /**
  * 判断值是否为 DeferredValue(类型守卫)。
  */
-declare function isDeferredValue<T>(value: unknown): value is DeferredValue<T>;
+export declare function isDeferredValue<T>(value: unknown): value is DeferredValue<T>;
 /**
  * SSR 内部:注册一个 deferred promise,在流式渲染后统一解析。
  *
  * 在 `useDeferredData` 的 SSR 分支中调用。每次渲染前应调用 `__clearDeferred()`。
  */
-declare function __registerDeferred(key: string, promise: Promise<unknown>): void;
+export declare function __registerDeferred(key: string, promise: Promise<unknown>): void;
 /**
  * SSR 内部:解析所有已注册的 deferred promise,返回 key → data 映射。
  *
  * 失败的 promise 以 `{ __deferredError: message }` 形式包含在结果中,
  * 不影响其他 promise 的解析。
  */
-declare function __resolveDeferred(): Promise<Record<string, unknown>>;
+export declare function __resolveDeferred(): Promise<Record<string, unknown>>;
 /**
  * SSR 内部:清空注册表。每次渲染前调用,避免上一个请求的残留。
  */
-declare function __clearDeferred(): void;
+export declare function __clearDeferred(): void;
 /**
  * SSR 内部:将 deferred 数据序列化为 `<script>` 标签字符串。
  *
  * 无数据时返回空字符串(不注入标签)。
  */
-declare function __serializeDeferred(data: Record<string, unknown>): string;
+export declare function __serializeDeferred(data: Record<string, unknown>): string;
 /**
  * 重置客户端缓存(测试用)。
  */
-declare function __resetDeferredCache(): void;
+export declare function __resetDeferredCache(): void;
 interface UseDeferredDataResult<T> {
   /** 延迟数据(初始为 undefined,解析后更新) */
   data: ShallowRef<T | undefined>;
@@ -381,6 +381,6 @@ interface UseDeferredDataResult<T> {
  * </template>
  * ```
  */
-declare function useDeferredData<T>(key: string, deferred: DeferredValue<T>): UseDeferredDataResult<T>;
+export declare function useDeferredData<T>(key: string, deferred: DeferredValue<T>): UseDeferredDataResult<T>;
 //#endregion
-export { DATA_PAYLOAD_ID, DEFERRED_DATA_ID, type DataCacheEntry, type DataKey, type DataPayloadEntry, type DataResult, type DataStatus, type DeferredValue, type DependencyDeclaration, type FetchClient, type InternalFetchOptions, LOCALE_DATA_ID, type LocaleMetaInfo, PAGE_DATA_ID, PAGE_REQUEST_HEADER, type PageAssetTags, type PageHead, type PageHeadMeta, type PageObject, type PageRenderContext, type PageRenderFn, type PageRenderResult, type PageRenderer, type PageStreamRenderFn, SSR_CONTENT_MARKER, STATE_DATA_ID, STATE_MARKER, type StreamHelper, type UseAsyncDataOptions, type UseDataOptions, type UseDeferredDataResult, type UseFetchOptions, __clearDataPayload, __clearDeferred, __registerDataPayload, __registerDeferred, __resetDataPayloadCache, __resetDeferredCache, __resolveDataPayload, __resolveDeferred, __serializeDataPayload, __serializeDeferred, buildClientOnlyShell, buildPageShell, clearPageData, createInternalFetch, createSseStream, createStreamResponse, declareDependencies, defer, defineDataKey, getDefaultFetch, getInvalidatedKeysForAction, hasData, insertSsrContent, insertStateContent, invalidateAll, invalidateData, isDeferredValue, isPagesRequest, pageJsonResponse, renderFaviconLink, renderPage, renderPageToStream, safeJsonStringify, serializePageData, setDefaultFetch, useAsyncData, useData, useDeferredData, useFetch, withDependencies };
+export type { DataCacheEntry, DataKey, DataPayloadEntry, DataResult, DataStatus, DeferredValue, DependencyDeclaration, FetchClient, InternalFetchOptions, LocaleMetaInfo, PageAssetTags, PageHead, PageHeadMeta, PageObject, PageRenderContext, PageRenderFn, PageRenderResult, PageRenderer, PageStreamRenderFn, StreamHelper, UseAsyncDataOptions, UseDataOptions, UseDeferredDataResult, UseFetchOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/pages",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Page data protocol and isomorphic data layer for ubean (PageObject, useData, invalidateData)",
   "files": [
     "dist"
@@ -16,12 +16,12 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.4.5"
+    "@ubean/shared": "0.4.6"
   },
   "devDependencies": {
     "@types/node": "^26.5.0",
-    "typescript": "7.0.2",
-    "vite-plus": "0.3.0"
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite-plus": "0.3.1"
   },
   "peerDependencies": {
     "vue": ">=3.4.0"