@weapp-tailwindcss/lynx 0.4.4 → 0.5.1

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/dist/index.d.ts

@@ -2,7 +2,76 @@ import { PatchRspackConfigOptions } from "weapp-tailwindcss/rspack";
 import { RsbuildPlugin } from "@lynx-js/rspeedy";
 import { WeappTailwindcssGeneratorOptions } from "weapp-tailwindcss/generator";
 import { UserDefinedOptions } from "weapp-tailwindcss/types";
-//#region src/index.d.ts
+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 适配配置。 */
@@ -11,6 +80,8 @@ export interface LynxTailwindcssOptions extends Omit<UserDefinedOptions, 'platfo
   rspack?: PatchRspackConfigOptions | undefined;
   /** Tailwind CSS v4 生成配置，目标固定为 Lynx 可消费的 web CSS。 */
   generator?: LynxGeneratorOptions | false | undefined;
+  /** Lynx encoder CSS 诊断；默认只报告，不改变构建成功与否。 */
+  diagnostics?: LynxDiagnosticsOptions | undefined;
 }
 /**
  * 为 ReactLynx + Rspeedy 注册 Tailwind CSS v4 构建链路。
@@ -18,5 +89,4 @@ export interface LynxTailwindcssOptions extends Omit<UserDefinedOptions, 'platfo
  * Lynx 原生支持 CSS class selector，因此不会改写 JSX `className` 或创建运行时样式表。
  */
 export declare function pluginLynxTailwindcss(options?: LynxTailwindcssOptions): RsbuildPlugin;
-//#endregion
-export { PLUGIN_NAME };
+export { type LynxCssDiagnostic, type LynxDiagnosticCategory, type LynxDiagnosticIgnore, type LynxDiagnosticStatus, type LynxDiagnosticsOptions, type LynxDiagnosticsReport, type LynxEncodingEvidence, PLUGIN_NAME };