@hxa-rn/react-native-splash-view 0.0.21-beta.1

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/EventEmitters.h

@@ -0,0 +1,17 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateEventEmitterH.js
+ */
+#pragma once
+
+#include <react/renderer/components/view/ViewEventEmitter.h>
+
+
+namespace facebook::react {
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/Props.cpp

@@ -0,0 +1,19 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GeneratePropsCpp.js
+ */
+
+#include "Props.h"
+#include <react/renderer/core/PropsParserContext.h>
+#include <react/renderer/core/propsConversions.h>
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/Props.h

@@ -0,0 +1,18 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GeneratePropsH.js
+ */
+#pragma once
+
+
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/ShadowNodes.cpp

@@ -0,0 +1,17 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateShadowNodeCpp.js
+ */
+
+#include "ShadowNodes.h"
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/ShadowNodes.h

@@ -0,0 +1,23 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateShadowNodeH.js
+ */
+
+#pragma once
+
+#include "EventEmitters.h"
+#include "Props.h"
+#include "States.h"
+#include <react/renderer/components/view/ConcreteViewShadowNode.h>
+#include <jsi/jsi.h>
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/States.cpp

@@ -0,0 +1,16 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateStateCpp.js
+ */
+#include "States.h"
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/cpp/generated/react/renderer/components/splash_view/States.h

@@ -0,0 +1,19 @@
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateStateH.js
+ */
+#pragma once
+
+#ifdef ANDROID
+#include <folly/dynamic.h>
+#endif
+
+namespace facebook::react {
+
+
+
+} // namespace facebook::react

package/harmony/splash_view/src/main/ets/Logger.ts

@@ -0,0 +1,26 @@
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
+/**
+ * 统一日志封装（RNOH 规范：禁止 console.log，统一使用 hilog）。
+ * 所有模块关键路径（子窗口创建/隐藏、close 参数解析、异常）经此处输出。
+ */
+const DOMAIN: number = 0x0007;
+const TAG: string = 'SplashView';
+
+export class Logger {
+  static info(message: string): void {
+    hilog.info(DOMAIN, TAG, '%{public}s', message);
+  }
+
+  static debug(message: string): void {
+    hilog.debug(DOMAIN, TAG, '%{public}s', message);
+  }
+
+  static warn(message: string): void {
+    hilog.warn(DOMAIN, TAG, '%{public}s', message);
+  }
+
+  static error(message: string): void {
+    hilog.error(DOMAIN, TAG, '%{public}s', message);
+  }
+}

package/harmony/splash_view/src/main/ets/SplashViewContent.ets

@@ -0,0 +1,64 @@
+import { SplashViewTurboModule } from './SplashViewTurboModule';
+import { Logger } from './Logger';
+
+/**
+ * 启动页内容槽组件（宿主 SplashViewPage 中嵌入使用）。
+ *
+ * - 内容槽：@BuilderParam contentBuilder 接收宿主闪屏内容（品牌图/背景等），
+ *   对齐 Android launch_screen 布局 / iOS LaunchScreen.storyboard 的宿主资源职责。
+ * - 关闭动画：aboutToAppear 注册静态 close-delegate；hideSplash() 派发到此处后，
+ *   在本组件自身的 UIContext（子窗口）上执行 animateTo 属性动画：
+ *     0.1s 延时 + 0.3s 淡出（opacity 1→0，Curve.EaseInOut）
+ *   动画 onFinish 回调销毁子窗口（对齐 iOS hideSplash 的 dispatch_after(0.1) + animate 0.3s）。
+ * - aboutToDisappear 注销 delegate（CLAUDE.md 规则 6：监听/回调必须配对清理）。
+ */
+@Component
+export struct SplashViewContent {
+  @State splashOpacity: number = 1;
+  @BuilderParam contentBuilder: () => void = this.emptyContentBuilder;
+
+  @Builder
+  emptyContentBuilder() {
+  }
+
+  aboutToAppear(): void {
+    Logger.info('SplashViewContent aboutToAppear: register close delegate');
+    SplashViewTurboModule.registerCloseDelegate(() => {
+      this.runCloseAnimation();
+    });
+  }
+
+  aboutToDisappear(): void {
+    Logger.info('SplashViewContent aboutToDisappear: unregister close delegate');
+    SplashViewTurboModule.unregisterCloseDelegate();
+  }
+
+  /**
+   * 在启动页 UIContext 上执行关闭动画（对齐 iOS hideSplash 语义：0.1s 延时 + 0.3s 淡出）。
+   * delay/duration 为毫秒，animateTo 统一处理（delay 先延迟，再在 duration 内完成过渡，onFinish 后销毁窗口）。
+   */
+  private runCloseAnimation(): void {
+    Logger.info('runCloseAnimation: delay=100, duration=300');
+    this.getUIContext().animateTo({
+      delay: 100,
+      duration: 300,
+      curve: Curve.EaseInOut,
+      onFinish: () => {
+        Logger.info('close animation finished; destroy splash window');
+        SplashViewTurboModule.destroySplashWindow();
+      }
+    }, () => {
+      this.splashOpacity = 0;
+    });
+  }
+
+  build() {
+    Stack() {
+      this.contentBuilder()
+    }
+    .width('100%')
+    .height('100%')
+    .backgroundColor(SplashViewTurboModule.backgroundColor)
+    .opacity(this.splashOpacity)
+  }
+}

package/harmony/splash_view/src/main/ets/SplashViewTurboModule.ts

@@ -0,0 +1,156 @@
+import { window } from '@kit.ArkUI';
+import { UITurboModule, UITurboModuleContext } from '@rnoh/react-native-openharmony/ts';
+import { Logger } from './Logger';
+import { TM } from './generated/ts';
+
+/**
+ * SplashView TurboModule（模块名 'SplashView'，与 JS Spec 完全一致）。
+ *
+ * 职责：
+ *  - 静态 showSplashView(windowStage, pageUrl)：宿主 EntryAbility.onWindowStageCreate 中、
+ *    super 之前调用，存储 windowStage 并创建全屏子窗口加载宿主启动页（原生预展示，
+ *    对齐 Android MainActivity.onCreate 调 SplashView.showSplashView(activity) /
+ *    iOS AppDelegate 调 SplashView.sharedInstance showSplash 的集成方式）。
+ *  - 实例 showSplash()：JS 侧调用（无参 void），复用已存 windowStage 创建子窗口
+ *    （已在展示则安全忽略，对齐 Android 检测 splashDialog.isShowing）。
+ *  - 实例 hideSplash()：JS 侧调用（无参 void），经静态 close-delegate 派发到启动页，
+ *    在启动页 UIContext 上执行 0.1s 延时 + 0.3s 淡出动画（opacity 1→0），
+ *    onFinish 回调销毁子窗口（对齐 iOS hideSplash 的 dispatch_after(0.1) + animate 0.3s）。
+ *
+ * 架构参考：@hxa-rn/react-native-smart-splash-screen（同级已适配库）的子窗口方案 + RNOH
+ * UITurboModule 运行约定（方法在 UI 线程执行）。
+ */
+export class SplashViewTurboModule extends UITurboModule implements TM.SplashView.Spec {
+  /** 当前展示闪屏的子窗口（未展示/已关闭时为 null） */
+  public static splashWindow: window.Window | null = null;
+  /** 宿主 EntryAbility 存储的 windowStage（JS showSplash() 复用，鸿蒙无能力从 uiAbilityContext 反向获取） */
+  public static windowStage: window.WindowStage | null = null;
+  /** 宿主启动页路径（createSubWindow 的 setUIContent 加载，宿主 EntryAbility 传入） */
+  public static pageUrl: string = 'pages/SplashViewPage';
+  /** 闪屏兜底背景色（默认白色，避免启动闪屏瞬间黑屏） */
+  public static backgroundColor: string = '#FFFFFF';
+  /** 启动页注册的关闭 delegate（UI 线程执行淡出动画） */
+  public static closeDelegate: (() => void) | null = null;
+
+  constructor(ctx: UITurboModuleContext) {
+    super(ctx);
+    Logger.info('SplashViewTurboModule constructed');
+  }
+
+  /**
+   * 展示闪屏（宿主 EntryAbility.onWindowStageCreate 中、super 之前调用）。
+   * 存储 windowStage 与 pageUrl，并立即创建全屏子窗口加载启动页。
+   * 与 Android MainActivity.onCreate / iOS AppDelegate 的原生预展示语义对齐。
+   */
+  public static showSplashView(windowStage: window.WindowStage, pageUrl: string): void {
+    SplashViewTurboModule.windowStage = windowStage;
+    SplashViewTurboModule.pageUrl = pageUrl;
+    Logger.info(`showSplashView: pageUrl=${pageUrl}`);
+    SplashViewTurboModule.createSubWindow();
+  }
+
+  /**
+   * JS 侧调用 showSplash()：展示全屏闪屏。
+   *  - splashWindow 非 null（已在展示，含原生预展示）→ 安全忽略
+   *  - windowStage 为 null（宿主未集成 showSplashView）→ Logger.warn 并安全返回
+   *  - 否则复用已存 windowStage 创建子窗口
+   */
+  public showSplash(): void {
+    if (SplashViewTurboModule.splashWindow !== null) {
+      Logger.info('showSplash: splash window already shown, ignore');
+      return;
+    }
+    if (SplashViewTurboModule.windowStage === null) {
+      Logger.warn('showSplash: windowStage not stored; call SplashView.showSplashView(windowStage, pageUrl) in EntryAbility.onWindowStageCreate first');
+      return;
+    }
+    Logger.info('showSplash: creating splash window');
+    SplashViewTurboModule.createSubWindow();
+  }
+
+  /**
+   * JS 侧调用 hideSplash()：隐藏闪屏。
+   *  - splashWindow 为 null（未展示/已关闭）→ 安全返回（对齐 Android hideSplashView 检测 null）
+   *  - close-delegate 未注册（启动页尚未挂载，极早期调用）→ 退化为直接销毁子窗口，行为安全
+   *  - 否则派发到启动页，执行 0.1s 延时 + 0.3s 淡出动画，onFinish 后销毁子窗口
+   */
+  public hideSplash(): void {
+    SplashViewTurboModule.requestHide();
+  }
+
+  /**
+   * 关闭闪屏（JS hideSplash 与原生层均可调用）。
+   * 经 close-delegate 在启动页 UIContext 上执行淡出动画，delegate 未就绪时直接销毁子窗口。
+   */
+  public static requestHide(): void {
+    if (SplashViewTurboModule.splashWindow === null) {
+      Logger.info('requestHide: splash window not shown, safe return');
+      return;
+    }
+    const delegate: (() => void) | null = SplashViewTurboModule.closeDelegate;
+    if (delegate !== null) {
+      delegate();
+    } else {
+      Logger.warn('requestHide: close delegate not registered; destroy window directly');
+      SplashViewTurboModule.destroySplashWindow();
+    }
+  }
+
+  /** 启动页（SplashViewContent）在 aboutToAppear 时注册关闭 delegate */
+  public static registerCloseDelegate(delegate: () => void): void {
+    SplashViewTurboModule.closeDelegate = delegate;
+    Logger.info('close delegate registered');
+  }
+
+  /** 启动页（SplashViewContent）在 aboutToDisappear 时注销关闭 delegate */
+  public static unregisterCloseDelegate(): void {
+    SplashViewTurboModule.closeDelegate = null;
+    Logger.info('close delegate unregistered');
+  }
+
+  /** 销毁闪屏子窗口并清空静态引用（动画 onFinish / 兜底路径调用） */
+  public static destroySplashWindow(): void {
+    const win: window.Window | null = SplashViewTurboModule.splashWindow;
+    if (win === null) {
+      return;
+    }
+    SplashViewTurboModule.splashWindow = null;
+    try {
+      win.destroyWindow().then(() => {
+        Logger.info('destroySplashWindow done');
+      }).catch((err: Error) => {
+        Logger.error(`destroyWindow rejected: ${JSON.stringify(err)}`);
+      });
+    } catch (err) {
+      Logger.error(`destroyWindow threw: ${JSON.stringify(err)}`);
+    }
+  }
+
+  /**
+   * 创建全屏子窗口加载宿主启动页。
+   * 流程：windowStage.createSubWindow → setWindowLayoutFullScreen(true) →
+   * setWindowSystemBarEnable([]) → setUIContent(pageUrl) →
+   * setWindowBackgroundColor('#FFFFFF') → showWindow。
+   * 错误码 1300002 表示重复创建（本模块以 splashWindow 非 null 守卫避免）。
+   */
+  private static async createSubWindow(): Promise<void> {
+    const stage: window.WindowStage | null = SplashViewTurboModule.windowStage;
+    if (stage === null) {
+      Logger.warn('createSubWindow: windowStage is null');
+      return;
+    }
+    try {
+      const subWindow: window.Window = await stage.createSubWindow('SplashViewWindow');
+      await subWindow.setWindowLayoutFullScreen(true);
+      await subWindow.setWindowSystemBarEnable([]);
+      await subWindow.setUIContent(SplashViewTurboModule.pageUrl);
+      subWindow.setWindowBackgroundColor(SplashViewTurboModule.backgroundColor);
+      SplashViewTurboModule.splashWindow = subWindow;
+      await subWindow.showWindow();
+      Logger.info('splash window shown');
+    } catch (err) {
+      SplashViewTurboModule.splashWindow = null;
+      Logger.error(`createSubWindow failed: ${JSON.stringify(err)}`);
+    }
+  }
+}

package/harmony/splash_view/src/main/ets/SplashViewTurboModulesFactory.ets

@@ -0,0 +1,18 @@
+import { RNOHPackage } from '@rnoh/react-native-openharmony/ets';
+import type { UITurboModule, UITurboModuleContext } from '@rnoh/react-native-openharmony/ts';
+import { SplashViewTurboModule } from './SplashViewTurboModule';
+import { TM } from './generated/ts';
+
+export class SplashViewPackage extends RNOHPackage {
+  getUITurboModuleFactoryByNameMap(): Map<string, (ctx: UITurboModuleContext) => UITurboModule | null> {
+    const map = new Map<string, (ctx: UITurboModuleContext) => UITurboModule | null>();
+    map.set(TM.SplashView.NAME, (ctx: UITurboModuleContext) => new SplashViewTurboModule(ctx));
+    return map;
+  }
+
+  override async createEagerUITurboModuleByNameMap(ctx: UITurboModuleContext): Promise<Map<string, UITurboModule>> {
+    const module = new SplashViewTurboModule(ctx);
+    return new Map()
+      .set(TM.SplashView.NAME, module)
+  }
+}

package/harmony/splash_view/src/main/ets/generated/index.ets

@@ -0,0 +1,5 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+export * from './ts'

package/harmony/splash_view/src/main/ets/generated/ts.ts

@@ -0,0 +1,5 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+export * as TM from "./turboModules/ts"

package/harmony/splash_view/src/main/ets/generated/turboModules/SplashView.ts

@@ -0,0 +1,16 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+import { Tag } from "@rnoh/react-native-openharmony/ts"
+
+export namespace SplashView {
+  export const NAME = 'SplashView' as const
+
+  export interface Spec {
+    showSplash(): void;
+  
+    hideSplash(): void;
+  
+  }
+}

package/harmony/splash_view/src/main/ets/generated/turboModules/ts.ts

@@ -0,0 +1,5 @@
+/**
+ * This code was generated by "react-native codegen-lib-harmony"
+ */
+
+export * from "./SplashView"

package/harmony/splash_view/src/main/module.json5

@@ -0,0 +1,13 @@
+{
+  "module": {
+    "name": "splash_view",
+    "type": "har",
+    "deviceTypes": [
+      "default",
+      "tablet",
+      "2in1"
+    ],
+    "requestPermissions": [
+    ]
+  }
+}

package/harmony/splash_view/src/main/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "page_show",
+      "value": "page from npm package"
+    }
+  ]
+}

package/harmony/splash_view/src/main/resources/en_US/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "page_show",
+      "value": "page from npm package"
+    }
+  ]
+}

package/harmony/splash_view/src/main/resources/zh_CN/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "page_show",
+      "value": "page from npm package"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@hxa-rn/react-native-splash-view",
+  "displayName": "@hxa-rn/react-native-splash-view",
+  "version": "0.0.21-beta.1",
+  "description": "A lightweight splash screen library for React Native.",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/module/index.js",
+  "react-native": "./dist/module/index.js",
+  "types": "./dist/typescript/index.d.ts",
+  "license": "MIT",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jagnesh/react-native-splash-view.git"
+  },
+  "keywords": [
+    "react-native",
+    "harmony",
+    "harmonyos"
+  ],
+  "homepage": "https://github.com/jagnesh/react-native-splash-view#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "README.md",
+    "LICENSE",
+    "harmony/"
+  ],
+  "scripts": {
+    "prepare": "tsc --noEmit && bob build",
+    "codegen-lib": "react-native codegen-lib-harmony --no-safety-check --npm-package-name splash_view --cpp-output-path ./harmony/splash_view/src/main/cpp/generated --ets-output-path ./harmony/splash_view/src/main/ets/generated --turbo-modules-spec-paths ./src/specs/v1/NativeSplashView.ts"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.72",
+    "react": "*"
+  },
+  "devDependencies": {
+    "typescript": "5.0.4",
+    "@react-native/typescript-config": "0.79.5",
+    "react": "18.2.0",
+    "@types/react": "18.2.79",
+    "react-native": "0.72.5",
+    "jest": "^29.6.3",
+    "react-native-builder-bob": "^0.18.0",
+    "@react-native-oh/react-native-harmony-cli": "^0.77.50",
+    "metro": "^0.81.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "harmony": {
+    "alias": "react-native-splash-view",
+    "autolinking": {
+      "cmakeLibraryTargetName": "splash_view",
+      "ohPackageName": "@hxa-rn/react-native-splash-view",
+      "etsPackageClassName": "SplashViewPackage",
+      "cppPackageClassName": "SplashViewPackage"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "dist",
+    "targets": [
+      "commonjs",
+      "module",
+      "typescript"
+    ]
+  }
+}

package/src/index.tsx

@@ -0,0 +1,8 @@
+import SplashView from './specs/v1/NativeSplashView';
+
+export function showSplash(): void {
+  return SplashView.showSplash();
+}
+export function hideSplash(): void {
+  return SplashView.hideSplash();
+}

package/src/specs/v1/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the directory is tracked by Git even if other files are removed

package/src/specs/v1/NativeSplashView.ts

@@ -0,0 +1,9 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  showSplash(): void;
+  hideSplash(): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('SplashView');

package/src/specs/v2/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the directory is tracked by Git