@weapp-tailwindcss/lynx 0.5.0 → 0.5.1

package/dist/decoder.d.cts

@@ -0,0 +1,25 @@
+interface DecodeResult {
+  status: number;
+  result: string;
+}
+interface DecoderModule {
+  HEAPU8: Uint8Array;
+  _malloc: (size: number) => number;
+  _free: (pointer: number) => void;
+  _decode: (pointer: number, size: number) => DecodeResult;
+}
+type DecoderFactory = () => Promise<DecoderModule>;
+export interface DecodedLynxBundle {
+  'engine-version': string;
+  'page-config': string;
+  'css': {
+    text: string;
+  };
+}
+/** 身份覆盖构建来源、补丁、工具链和产物；修改其中任一项都会使历史报告过期。 */
+export declare function lynxDecoderIdentity(directory?: string): string;
+/** 仅加载固定来源的便携 WASM；缺失、篡改或解码失败均不得回退 serializer 或系统原生库。 */
+export declare function loadVerifiedDecoderFactory(directory?: string): Promise<DecoderFactory>;
+/** 每次解码使用独立实例，输入只接受实际 bundle 字节，保留 decoder 的原始 CSS 展示文本。 */
+export declare function decodeLynxBundle(source: Uint8Array, directory?: string): Promise<DecodedLynxBundle>;
+export {};

package/dist/index.d.cts

@@ -0,0 +1,92 @@
+import { RsbuildPlugin } from "@lynx-js/rspeedy";
+import { WeappTailwindcssGeneratorOptions } from "weapp-tailwindcss/generator";
+import { PatchRspackConfigOptions } from "weapp-tailwindcss/rspack";
+import { UserDefinedOptions } from "weapp-tailwindcss/types";
+type LynxDiagnosticCategory = 'preflight' | 'tailwind-default' | 'business' | 'unknown';
+type LynxDiagnosticStatus = 'encoder-rejected' | 'bundled' | 'unknown';
+interface LynxDiagnosticIgnore {
+  selector?: string | undefined;
+  property?: string | undefined;
+  reason?: string | undefined;
+}
+interface LynxCssDiagnostic {
+  origin: 'encoder-log' | 'bundle-comparison';
+  raw?: unknown;
+  ignored?: {
+    reason: string;
+    rule: LynxDiagnosticIgnore;
+  } | undefined;
+  status: LynxDiagnosticStatus;
+  category: LynxDiagnosticCategory;
+  message: string;
+  selector?: string | undefined;
+  utility?: string | undefined;
+  property?: string | undefined;
+  value?: string | undefined;
+  reason?: string | undefined;
+  suggestion?: string | undefined;
+  source?: {
+    module?: string | undefined;
+    file?: string | undefined;
+    line?: number | undefined;
+    column?: number | undefined;
+    generated?: {
+      line?: number | undefined;
+      column?: number | undefined;
+    } | undefined;
+  } | undefined;
+}
+interface LynxDiagnosticsReport {
+  schemaVersion: 1;
+  counts: {
+    generated: number;
+    encoderRejected: number;
+    unknown: number;
+  };
+  evidence?: LynxEncodingEvidence | undefined;
+  diagnostics: LynxCssDiagnostic[];
+  versionEvidence: {
+    encoder: string;
+    engine: string;
+  };
+  versions: {
+    encoder: string;
+    engine: string;
+    targetSdk?: string | undefined;
+  } | undefined;
+}
+interface LynxDiagnosticsOptions {
+  /** 是否把确证的业务样式编码删除提升为构建错误。 */
+  strict?: boolean | undefined;
+  /** 忽略匹配到的业务失败；诊断和忽略条件仍保留供报告消费方审计。 */
+  ignore?: LynxDiagnosticIgnore[] | undefined;
+  /** 构建完成一个模板时接收结构化报告。 */
+  onReport?: ((report: LynxDiagnosticsReport) => void) | undefined;
+}
+interface LynxEncodingEvidence {
+  inputCssSha256?: string | undefined;
+  outputName?: string | undefined;
+  bundleSha256?: string | undefined;
+  decoderIdentity?: string | undefined;
+  decodedCssSha256?: string | undefined;
+  cssText?: string | undefined;
+  error?: string | undefined;
+}
+declare const PLUGIN_NAME = "weapp-tailwindcss:lynx";
+interface LynxGeneratorOptions extends Omit<WeappTailwindcssGeneratorOptions, 'target'> {}
+/** ReactLynx Rspeedy 适配配置。 */
+export interface LynxTailwindcssOptions extends Omit<UserDefinedOptions, 'platform' | 'generator'> {
+  /** 透传给 Rspack CSS 规则补丁的配置。 */
+  rspack?: PatchRspackConfigOptions | undefined;
+  /** Tailwind CSS v4 生成配置，目标固定为 Lynx 可消费的 web CSS。 */
+  generator?: LynxGeneratorOptions | false | undefined;
+  /** Lynx encoder CSS 诊断；默认只报告，不改变构建成功与否。 */
+  diagnostics?: LynxDiagnosticsOptions | undefined;
+}
+/**
+ * 为 ReactLynx + Rspeedy 注册 Tailwind CSS v4 构建链路。
+ *
+ * Lynx 原生支持 CSS class selector，因此不会改写 JSX `className` 或创建运行时样式表。
+ */
+export declare function pluginLynxTailwindcss(options?: LynxTailwindcssOptions): RsbuildPlugin;
+export { type LynxCssDiagnostic, type LynxDiagnosticCategory, type LynxDiagnosticIgnore, type LynxDiagnosticStatus, type LynxDiagnosticsOptions, type LynxDiagnosticsReport, type LynxEncodingEvidence, PLUGIN_NAME };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-tailwindcss/lynx",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Tailwind CSS integration for ReactLynx and Rspeedy cross-platform builds. 面向 ReactLynx 与 Rspeedy 跨端构建的 Tailwind CSS 集成。",
   "license": "MIT",
   "homepage": "https://tw.weapp.dev/docs/quick-start/frameworks/lynx",
@@ -13,15 +13,25 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./package.json": "./package.json",
     "./decoder": {
-      "types": "./dist/decoder.d.ts",
-      "import": "./dist/decoder.js",
-      "require": "./dist/decoder.cjs"
+      "import": {
+        "types": "./dist/decoder.d.ts",
+        "default": "./dist/decoder.js"
+      },
+      "require": {
+        "types": "./dist/decoder.d.cts",
+        "default": "./dist/decoder.cjs"
+      }
     }
   },
   "main": "./dist/index.cjs",
@@ -54,7 +64,7 @@
   },
   "dependencies": {
     "@jridgewell/trace-mapping": "^0.3.31",
-    "weapp-tailwindcss": "5.7.0"
+    "weapp-tailwindcss": "5.7.1"
   },
   "devDependencies": {
     "@lynx-js/rspeedy": "^0.18.4",