@granite-js/naver-map 1.0.0

package/dist/typescript/specs/GraniteNaverMapViewNativeComponent.d.ts

@@ -0,0 +1,92 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import type { DirectEventHandler, Double, Float, Int32, WithDefault } from 'react-native/Libraries/Types/CodegenTypes';
+export type OnCameraChangeEvent = Readonly<{
+    latitude: Double;
+    longitude: Double;
+    zoom: Double;
+}>;
+export type OnTouchEvent = Readonly<{
+    reason: Int32;
+    animated: boolean;
+}>;
+export type OnMapClickEvent = Readonly<{
+    x: Double;
+    y: Double;
+    latitude: Double;
+    longitude: Double;
+}>;
+export type OnMarkerClickEvent = Readonly<{
+    id: string;
+}>;
+export type OnInitializedEvent = Readonly<{}>;
+type CenterProp = Readonly<{
+    latitude: Double;
+    longitude: Double;
+    zoom?: Double;
+    tilt?: Double;
+    bearing?: Double;
+}>;
+type PaddingProp = Readonly<{
+    top?: Double;
+    left?: Double;
+    bottom?: Double;
+    right?: Double;
+}>;
+export interface NativeProps extends ViewProps {
+    center?: CenterProp;
+    showsMyLocationButton?: boolean;
+    compass?: boolean;
+    scaleBar?: boolean;
+    zoomControl?: boolean;
+    mapType?: WithDefault<Int32, 0>;
+    minZoomLevel?: WithDefault<Double, 0>;
+    maxZoomLevel?: WithDefault<Double, 21>;
+    buildingHeight?: WithDefault<Float, 1>;
+    nightMode?: boolean;
+    mapPadding?: PaddingProp;
+    locationTrackingMode?: WithDefault<Int32, 0>;
+    scrollGesturesEnabled?: WithDefault<boolean, true>;
+    zoomGesturesEnabled?: WithDefault<boolean, true>;
+    tiltGesturesEnabled?: WithDefault<boolean, true>;
+    rotateGesturesEnabled?: WithDefault<boolean, true>;
+    stopGesturesEnabled?: WithDefault<boolean, true>;
+    onInitialized?: DirectEventHandler<OnInitializedEvent>;
+    onCameraChange?: DirectEventHandler<OnCameraChangeEvent>;
+    onTouch?: DirectEventHandler<OnTouchEvent>;
+    onMapClick?: DirectEventHandler<OnMapClickEvent>;
+    onMarkerClick?: DirectEventHandler<OnMarkerClickEvent>;
+}
+type ComponentType = HostComponent<NativeProps>;
+interface NativeCommands {
+    animateToCoordinate: (viewRef: React.ElementRef<ComponentType>, latitude: Double, longitude: Double) => void;
+    animateToTwoCoordinates: (viewRef: React.ElementRef<ComponentType>, lat1: Double, lng1: Double, lat2: Double, lng2: Double) => void;
+    animateToRegion: (viewRef: React.ElementRef<ComponentType>, latitude: Double, longitude: Double, latitudeDelta: Double, longitudeDelta: Double) => void;
+    setLayerGroupEnabled: (viewRef: React.ElementRef<ComponentType>, group: string, enabled: boolean) => void;
+    addMarker: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, width: Int32, height: Int32, zIndex: Int32, rotation: Float, flat: boolean, alpha: Float, pinColor: Int32, image: string) => void;
+    updateMarker: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, width: Int32, height: Int32, zIndex: Int32, rotation: Float, flat: boolean, alpha: Float, pinColor: Int32, image: string) => void;
+    removeMarker: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addPolyline: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, strokeWidth: Float, strokeColor: Int32, zIndex: Int32, lineCap: Int32, lineJoin: Int32, patternJson: string) => void;
+    updatePolyline: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, strokeWidth: Float, strokeColor: Int32, zIndex: Int32, lineCap: Int32, lineJoin: Int32, patternJson: string) => void;
+    removePolyline: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addPolygon: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, holesJson: string, fillColor: Int32, strokeColor: Int32, strokeWidth: Float, zIndex: Int32) => void;
+    updatePolygon: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, holesJson: string, fillColor: Int32, strokeColor: Int32, strokeWidth: Float, zIndex: Int32) => void;
+    removePolygon: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addCircle: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, radius: Double, fillColor: Int32, strokeColor: Int32, strokeWidth: Float, zIndex: Int32) => void;
+    updateCircle: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, radius: Double, fillColor: Int32, strokeColor: Int32, strokeWidth: Float, zIndex: Int32) => void;
+    removeCircle: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addPath: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, width: Float, outlineWidth: Float, color: Int32, outlineColor: Int32, passedColor: Int32, passedOutlineColor: Int32, patternImage: string, patternInterval: Int32, progress: Float, zIndex: Int32) => void;
+    updatePath: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, width: Float, outlineWidth: Float, color: Int32, outlineColor: Int32, passedColor: Int32, passedOutlineColor: Int32, patternImage: string, patternInterval: Int32, progress: Float, zIndex: Int32) => void;
+    removePath: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addArrowheadPath: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, width: Float, outlineWidth: Float, color: Int32, outlineColor: Int32, headSizeRatio: Float, zIndex: Int32) => void;
+    updateArrowheadPath: (viewRef: React.ElementRef<ComponentType>, identifier: string, coordsJson: string, width: Float, outlineWidth: Float, color: Int32, outlineColor: Int32, headSizeRatio: Float, zIndex: Int32) => void;
+    removeArrowheadPath: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addGroundOverlay: (viewRef: React.ElementRef<ComponentType>, identifier: string, southWestLat: Double, southWestLng: Double, northEastLat: Double, northEastLng: Double, image: string, alpha: Float, zIndex: Int32) => void;
+    updateGroundOverlay: (viewRef: React.ElementRef<ComponentType>, identifier: string, southWestLat: Double, southWestLng: Double, northEastLat: Double, northEastLng: Double, image: string, alpha: Float, zIndex: Int32) => void;
+    removeGroundOverlay: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+    addInfoWindow: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, text: string, alpha: Float, zIndex: Int32, offsetX: Int32, offsetY: Int32) => void;
+    updateInfoWindow: (viewRef: React.ElementRef<ComponentType>, identifier: string, latitude: Double, longitude: Double, text: string, alpha: Float, zIndex: Int32, offsetX: Int32, offsetY: Int32) => void;
+    removeInfoWindow: (viewRef: React.ElementRef<ComponentType>, identifier: string) => void;
+}
+export declare const Commands: NativeCommands;
+declare const _default: ComponentType;
+export default _default;

package/dist/typescript/types/Coord.d.ts

@@ -0,0 +1,4 @@
+export interface Coord {
+    latitude: number;
+    longitude: number;
+}

package/dist/typescript/types/index.d.ts

@@ -0,0 +1,55 @@
+import type { NativeSyntheticEvent } from 'react-native';
+import type { OnCameraChangeEvent, OnTouchEvent, OnMapClickEvent, OnMarkerClickEvent } from '../specs/GraniteNaverMapViewNativeComponent';
+export * from './Coord';
+/**
+ * Camera change event data
+ */
+export interface CameraChangeEvent {
+    latitude: number;
+    longitude: number;
+    zoom: number;
+}
+/**
+ * Touch event data
+ */
+export interface TouchEvent {
+    reason: number;
+    animated: boolean;
+}
+/**
+ * Map click event data
+ */
+export interface MapClickEvent {
+    x: number;
+    y: number;
+    latitude: number;
+    longitude: number;
+}
+/**
+ * Marker click event data
+ */
+export interface MarkerClickEvent {
+    id: string;
+}
+export interface NaverMapViewProps {
+    /**
+     * Callback when map is initialized
+     */
+    onInitialized?: () => void;
+    /**
+     * Callback when camera changes
+     */
+    onCameraChange?: (event: NativeSyntheticEvent<OnCameraChangeEvent>) => void;
+    /**
+     * Callback when map is touched
+     */
+    onTouch?: (event: NativeSyntheticEvent<OnTouchEvent>) => void;
+    /**
+     * Callback when map is clicked
+     */
+    onMapClick?: (event: NativeSyntheticEvent<OnMapClickEvent>) => void;
+    /**
+     * Callback when marker is clicked
+     */
+    onMarkerClick?: (event: NativeSyntheticEvent<OnMarkerClickEvent>) => void;
+}

package/ios/GraniteNaverMap-Bridging-Header.h

@@ -0,0 +1,20 @@
+//
+//  GraniteNaverMap-Bridging-Header.h
+//  granite-naver-map
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>
+#import <React/RCTEventEmitter.h>
+#import <React/RCTConvert.h>
+#import <React/RCTLog.h>
+#import <React/RCTUIManager.h>
+
+// NMapsMap-specific imports (only when default provider is enabled)
+#ifdef GRANITE_NAVER_MAP_DEFAULT_PROVIDER
+#import "RCTConvert+NMFMapView.h"
+#endif
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <React/RCTViewComponentView.h>
+#endif

package/ios/GraniteNaverMapProvider.swift

@@ -0,0 +1,312 @@
+//
+//  GraniteNaverMapProvider.swift
+//  granite-naver-map
+//
+//  Pluggable Provider protocol for NaverMap
+//
+
+import UIKit
+
+// MARK: - Provider Enums
+
+@objc public enum GraniteNaverMapType: Int {
+    case basic = 0
+    case navi = 1
+    case satellite = 2
+    case hybrid = 3
+    case terrain = 4
+    case none = 5
+}
+
+@objc public enum GraniteNaverMapLocationTrackingMode: Int {
+    case none = 0
+    case noFollow = 1
+    case follow = 2
+    case face = 3
+}
+
+// MARK: - Data Types
+
+@objc public class GraniteNaverMapCoordinate: NSObject {
+    @objc public let latitude: Double
+    @objc public let longitude: Double
+
+    @objc public init(latitude: Double, longitude: Double) {
+        self.latitude = latitude
+        self.longitude = longitude
+    }
+}
+
+@objc public class GraniteNaverMapCameraPosition: NSObject {
+    @objc public let target: GraniteNaverMapCoordinate
+    @objc public let zoom: Double
+    @objc public let tilt: Double
+    @objc public let bearing: Double
+
+    @objc public init(target: GraniteNaverMapCoordinate, zoom: Double, tilt: Double = 0, bearing: Double = 0) {
+        self.target = target
+        self.zoom = zoom
+        self.tilt = tilt
+        self.bearing = bearing
+    }
+}
+
+@objc public class GraniteNaverMapBounds: NSObject {
+    @objc public let southWest: GraniteNaverMapCoordinate
+    @objc public let northEast: GraniteNaverMapCoordinate
+
+    @objc public init(southWest: GraniteNaverMapCoordinate, northEast: GraniteNaverMapCoordinate) {
+        self.southWest = southWest
+        self.northEast = northEast
+    }
+}
+
+// MARK: - Marker Data
+
+@objc public class ProviderMarkerData: NSObject {
+    @objc public let identifier: String
+    @objc public let coordinate: GraniteNaverMapCoordinate
+    @objc public let width: Int
+    @objc public let height: Int
+    @objc public let zIndex: Int
+    @objc public let rotation: Float
+    @objc public let flat: Bool
+    @objc public let alpha: Float
+    @objc public let pinColor: Int
+    @objc public let image: String
+
+    @objc public init(
+        identifier: String,
+        coordinate: GraniteNaverMapCoordinate,
+        width: Int,
+        height: Int,
+        zIndex: Int,
+        rotation: Float,
+        flat: Bool,
+        alpha: Float,
+        pinColor: Int,
+        image: String
+    ) {
+        self.identifier = identifier
+        self.coordinate = coordinate
+        self.width = width
+        self.height = height
+        self.zIndex = zIndex
+        self.rotation = rotation
+        self.flat = flat
+        self.alpha = alpha
+        self.pinColor = pinColor
+        self.image = image
+    }
+}
+
+// MARK: - Overlay Data
+
+@objc public class ProviderPolylineData: NSObject {
+    @objc public let identifier: String
+    @objc public let coordinates: [GraniteNaverMapCoordinate]
+    @objc public let strokeWidth: Float
+    @objc public let strokeColor: Int
+    @objc public let zIndex: Int
+    @objc public let lineCap: Int
+    @objc public let lineJoin: Int
+    @objc public let pattern: [Int]
+
+    @objc public init(
+        identifier: String,
+        coordinates: [GraniteNaverMapCoordinate],
+        strokeWidth: Float,
+        strokeColor: Int,
+        zIndex: Int,
+        lineCap: Int,
+        lineJoin: Int,
+        pattern: [Int]
+    ) {
+        self.identifier = identifier
+        self.coordinates = coordinates
+        self.strokeWidth = strokeWidth
+        self.strokeColor = strokeColor
+        self.zIndex = zIndex
+        self.lineCap = lineCap
+        self.lineJoin = lineJoin
+        self.pattern = pattern
+    }
+}
+
+@objc public class ProviderPolygonData: NSObject {
+    @objc public let identifier: String
+    @objc public let coordinates: [GraniteNaverMapCoordinate]
+    @objc public let holes: [[GraniteNaverMapCoordinate]]
+    @objc public let fillColor: Int
+    @objc public let strokeColor: Int
+    @objc public let strokeWidth: Float
+    @objc public let zIndex: Int
+
+    @objc public init(
+        identifier: String,
+        coordinates: [GraniteNaverMapCoordinate],
+        holes: [[GraniteNaverMapCoordinate]],
+        fillColor: Int,
+        strokeColor: Int,
+        strokeWidth: Float,
+        zIndex: Int
+    ) {
+        self.identifier = identifier
+        self.coordinates = coordinates
+        self.holes = holes
+        self.fillColor = fillColor
+        self.strokeColor = strokeColor
+        self.strokeWidth = strokeWidth
+        self.zIndex = zIndex
+    }
+}
+
+@objc public class ProviderCircleData: NSObject {
+    @objc public let identifier: String
+    @objc public let center: GraniteNaverMapCoordinate
+    @objc public let radius: Double
+    @objc public let fillColor: Int
+    @objc public let strokeColor: Int
+    @objc public let strokeWidth: Float
+    @objc public let zIndex: Int
+
+    @objc public init(
+        identifier: String,
+        center: GraniteNaverMapCoordinate,
+        radius: Double,
+        fillColor: Int,
+        strokeColor: Int,
+        strokeWidth: Float,
+        zIndex: Int
+    ) {
+        self.identifier = identifier
+        self.center = center
+        self.radius = radius
+        self.fillColor = fillColor
+        self.strokeColor = strokeColor
+        self.strokeWidth = strokeWidth
+        self.zIndex = zIndex
+    }
+}
+
+@objc public class ProviderPathData: NSObject {
+    @objc public let identifier: String
+    @objc public let coordinates: [GraniteNaverMapCoordinate]
+    @objc public let width: Float
+    @objc public let outlineWidth: Float
+    @objc public let color: Int
+    @objc public let outlineColor: Int
+    @objc public let passedColor: Int
+    @objc public let passedOutlineColor: Int
+    @objc public let patternImage: String
+    @objc public let patternInterval: Int
+    @objc public let progress: Float
+    @objc public let zIndex: Int
+
+    @objc public init(
+        identifier: String,
+        coordinates: [GraniteNaverMapCoordinate],
+        width: Float,
+        outlineWidth: Float,
+        color: Int,
+        outlineColor: Int,
+        passedColor: Int,
+        passedOutlineColor: Int,
+        patternImage: String,
+        patternInterval: Int,
+        progress: Float,
+        zIndex: Int
+    ) {
+        self.identifier = identifier
+        self.coordinates = coordinates
+        self.width = width
+        self.outlineWidth = outlineWidth
+        self.color = color
+        self.outlineColor = outlineColor
+        self.passedColor = passedColor
+        self.passedOutlineColor = passedOutlineColor
+        self.patternImage = patternImage
+        self.patternInterval = patternInterval
+        self.progress = progress
+        self.zIndex = zIndex
+    }
+}
+
+// MARK: - Provider Delegate
+
+@objc public protocol GraniteNaverMapProviderDelegate: NSObjectProtocol {
+    @objc func mapViewDidInitialize()
+    @objc func mapViewDidChangeCamera(position: GraniteNaverMapCameraPosition)
+    @objc func mapViewDidTouch(reason: Int, animated: Bool)
+    @objc func mapViewDidClick(x: Double, y: Double, latitude: Double, longitude: Double)
+    @objc func mapViewDidClickMarker(id: String)
+}
+
+// MARK: - Provider Factory Protocol
+
+/// Factory protocol for creating NaverMap providers.
+/// Each call to createProvider() should return a new instance.
+@objc public protocol GraniteNaverMapProviderFactory: NSObjectProtocol {
+    /// Create a new provider instance.
+    /// This should be called for each NaverMap view.
+    @objc func createProvider() -> GraniteNaverMapProvidable
+}
+
+// MARK: - Provider Protocol
+
+@objc public protocol GraniteNaverMapProvidable: NSObjectProtocol {
+    /// Create the map view
+    @objc func createMapView(frame: CGRect) -> UIView
+
+    /// Set the delegate for map events
+    @objc func setDelegate(_ delegate: GraniteNaverMapProviderDelegate?)
+
+    // MARK: - Camera
+    @objc func moveCamera(to position: GraniteNaverMapCameraPosition, animated: Bool)
+    @objc func animateToCoordinate(_ coordinate: GraniteNaverMapCoordinate)
+    @objc func animateToBounds(_ bounds: GraniteNaverMapBounds, padding: CGFloat)
+
+    // MARK: - Map Properties
+    @objc func setMapType(_ type: GraniteNaverMapType)
+    @objc func setMapPadding(_ padding: UIEdgeInsets)
+    @objc func setCompassEnabled(_ enabled: Bool)
+    @objc func setScaleBarEnabled(_ enabled: Bool)
+    @objc func setZoomControlEnabled(_ enabled: Bool)
+    @objc func setLocationButtonEnabled(_ enabled: Bool)
+    @objc func setBuildingHeight(_ height: Float)
+    @objc func setNightModeEnabled(_ enabled: Bool)
+    @objc func setMinZoomLevel(_ level: Double)
+    @objc func setMaxZoomLevel(_ level: Double)
+    @objc func setScrollGesturesEnabled(_ enabled: Bool)
+    @objc func setZoomGesturesEnabled(_ enabled: Bool)
+    @objc func setTiltGesturesEnabled(_ enabled: Bool)
+    @objc func setRotateGesturesEnabled(_ enabled: Bool)
+    @objc func setStopGesturesEnabled(_ enabled: Bool)
+    @objc func setLocationTrackingMode(_ mode: GraniteNaverMapLocationTrackingMode)
+    @objc func setLayerGroupEnabled(group: String, enabled: Bool)
+
+    // MARK: - Markers
+    @objc func addMarker(_ data: ProviderMarkerData)
+    @objc func updateMarker(_ data: ProviderMarkerData)
+    @objc func removeMarker(identifier: String)
+
+    // MARK: - Polylines
+    @objc func addPolyline(_ data: ProviderPolylineData)
+    @objc func updatePolyline(_ data: ProviderPolylineData)
+    @objc func removePolyline(identifier: String)
+
+    // MARK: - Polygons
+    @objc func addPolygon(_ data: ProviderPolygonData)
+    @objc func updatePolygon(_ data: ProviderPolygonData)
+    @objc func removePolygon(identifier: String)
+
+    // MARK: - Circles
+    @objc func addCircle(_ data: ProviderCircleData)
+    @objc func updateCircle(_ data: ProviderCircleData)
+    @objc func removeCircle(identifier: String)
+
+    // MARK: - Paths
+    @objc func addPath(_ data: ProviderPathData)
+    @objc func updatePath(_ data: ProviderPathData)
+    @objc func removePath(identifier: String)
+}

package/ios/GraniteNaverMapRegistry.swift

@@ -0,0 +1,91 @@
+//
+//  GraniteNaverMapRegistry.swift
+//  granite-naver-map
+//
+//  Registry singleton for NaverMap provider factories
+//
+
+import Foundation
+
+/// Type alias for provider creation closure
+public typealias GraniteNaverMapProviderCreator = () -> GraniteNaverMapProvidable
+
+/// Internal wrapper to adapt closure to factory protocol (for Obj-C compatibility)
+private class ClosureProviderFactory: NSObject, GraniteNaverMapProviderFactory {
+    private let creator: GraniteNaverMapProviderCreator
+
+    init(creator: @escaping GraniteNaverMapProviderCreator) {
+        self.creator = creator
+        super.init()
+    }
+
+    func createProvider() -> GraniteNaverMapProvidable {
+        return creator()
+    }
+}
+
+@objc public class GraniteNaverMapRegistry: NSObject {
+    @objc public static let shared = GraniteNaverMapRegistry()
+
+    @objc public private(set) var factory: GraniteNaverMapProviderFactory?
+
+    private override init() {
+        super.init()
+    }
+
+    /// Register a provider using a closure. Call this at app startup before using NaverMap.
+    /// This is the preferred Swift API.
+    ///
+    /// Usage:
+    /// ```swift
+    /// GraniteNaverMapRegistry.shared.register {
+    ///     return MyNaverMapProvider()
+    /// }
+    /// ```
+    public func register(creator: @escaping GraniteNaverMapProviderCreator) {
+        self.factory = ClosureProviderFactory(creator: creator)
+    }
+
+    /// Register a custom provider factory. Call this at app startup before using NaverMap.
+    /// This API is provided for Obj-C compatibility.
+    @objc public func register(factory: GraniteNaverMapProviderFactory) {
+        self.factory = factory
+    }
+
+    /// Create a new provider instance for a NaverMap view.
+    /// Each view should call this to get its own provider instance.
+    @objc public func createProvider() -> GraniteNaverMapProvidable? {
+        // Use registered factory if available
+        if let factory = factory {
+            return factory.createProvider()
+        }
+
+        #if GRANITE_NAVER_MAP_DEFAULT_PROVIDER
+        // Use built-in factory
+        let builtInFactory = BuiltInNaverMapProviderFactory()
+        return builtInFactory.createProvider()
+        #else
+        // No default provider available - user must register a custom factory
+        return nil
+        #endif
+    }
+
+    /// Check if a custom factory has been registered
+    @objc public var hasCustomFactory: Bool {
+        return factory != nil
+    }
+
+    /// Check if a default provider is available
+    @objc public var hasDefaultProvider: Bool {
+        #if GRANITE_NAVER_MAP_DEFAULT_PROVIDER
+        return true
+        #else
+        return false
+        #endif
+    }
+
+    /// Reset the factory (useful for testing)
+    @objc public func reset() {
+        factory = nil
+    }
+}

package/ios/GraniteNaverMapView.h

@@ -0,0 +1,15 @@
+#import <UIKit/UIKit.h>
+
+#ifndef GraniteNaverMapViewNativeComponent_h
+#define GraniteNaverMapViewNativeComponent_h
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Forward declare to avoid pulling in C++ headers
+// RCTViewComponentView import is in the .mm file
+@interface GraniteNaverMapView : UIView
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* GraniteNaverMapViewNativeComponent_h */