@lodado/sdui-template 1.0.0

package/dist/types/src/store/managers/LayoutStateRepository.d.ts

@@ -0,0 +1,110 @@
+/**
+ * LayoutStateRepository
+ *
+ * 레이아웃 상태 데이터를 저장하고 조회하는 Repository입니다.
+ * 상태 저장소의 단일 책임을 담당합니다.
+ */
+import type { SduiLayoutNode } from '../../schema';
+import type { SduiLayoutStoreState } from '../types';
+/**
+ * LayoutStateRepository
+ *
+ * 레이아웃 상태 데이터를 저장하고 조회합니다.
+ */
+export declare class LayoutStateRepository {
+    /** Store 상태 (일반 변수) */
+    private _state;
+    /**
+     * Store 상태를 반환합니다.
+     */
+    get state(): SduiLayoutStoreState;
+    /**
+     * 노드 엔티티를 반환합니다.
+     */
+    get nodes(): Record<string, SduiLayoutNode>;
+    /**
+     * ID로 노드를 조회합니다.
+     *
+     * @param nodeId - 조회할 노드 ID
+     * @returns 노드 또는 undefined
+     */
+    getNodeById(nodeId: string): SduiLayoutNode | undefined;
+    /**
+     * ID로 노드 타입을 조회합니다.
+     *
+     * @param nodeId - 조회할 노드 ID
+     * @returns 노드 타입 또는 undefined
+     */
+    getNodeTypeById(nodeId: string): string | undefined;
+    /**
+     * ID로 자식 노드 ID 목록을 조회합니다.
+     *
+     * @param nodeId - 조회할 노드 ID
+     * @returns 자식 노드 ID 배열 또는 빈 배열
+     */
+    getChildrenIdsById(nodeId: string): string[];
+    /**
+     * 루트 노드 ID를 반환합니다.
+     *
+     * @returns 루트 노드 ID 또는 undefined
+     */
+    getRootId(): string | undefined;
+    /**
+     * 초기 상태를 설정합니다.
+     *
+     * @param initialState - 초기 상태
+     */
+    initializeState(initialState?: Partial<SduiLayoutStoreState>): void;
+    /**
+     * 노드 엔티티를 업데이트합니다.
+     *
+     * @param nodes - 노드 엔티티 맵
+     */
+    updateNodes(nodes: Record<string, SduiLayoutNode>): void;
+    /**
+     * 특정 노드의 상태를 업데이트합니다.
+     *
+     * @param nodeId - 노드 ID
+     * @param state - 레이아웃 상태
+     */
+    updateNodeState(nodeId: string, state: Record<string, unknown>): void;
+    /**
+     * 특정 노드의 속성을 업데이트합니다.
+     *
+     * @param nodeId - 노드 ID
+     * @param attributes - 레이아웃 속성
+     */
+    updateNodeAttributes(nodeId: string, attributes: Record<string, unknown>): void;
+    /**
+     * 루트 노드 ID를 설정합니다.
+     *
+     * @param rootId - 루트 노드 ID
+     */
+    setRootId(rootId: string): void;
+    /**
+     * 선택된 노드 ID를 설정합니다.
+     *
+     * @param nodeId - 선택된 노드 ID
+     */
+    setSelectedNodeId(nodeId?: string): string | undefined;
+    /**
+     * 편집 상태를 설정합니다.
+     *
+     * @param isEdited - 편집 여부
+     */
+    setEdited(isEdited: boolean): void;
+    /**
+     * 변수를 업데이트합니다.
+     *
+     * @param variables - 변수 맵
+     */
+    updateVariables(variables: Record<string, unknown>): void;
+    /**
+     * version을 증가시킵니다.
+     */
+    incrementVersion(): void;
+    /**
+     * 상태를 초기화합니다.
+     */
+    reset(): void;
+}

package/dist/types/src/store/managers/SubscriptionManager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SubscriptionManager
+ *
+ * Observer Pattern을 구현하여 구독 시스템을 관리합니다.
+ * ID별 구독자와 version 구독자를 관리합니다.
+ */
+/**
+ * SubscriptionManager
+ *
+ * 구독 시스템을 독립적으로 관리하는 클래스입니다.
+ */
+export declare class SubscriptionManager {
+    /** ID별 구독자 관리 (layoutStates/layoutAttributes 변경 감지용) */
+    private _nodeListeners;
+    /** version 구독자 관리 (nodes, rootId, variables 변경 감지용) */
+    private _versionListeners;
+    /**
+     * 특정 노드 ID를 구독합니다.
+     *
+     * @param nodeId - 구독할 노드 ID
+     * @param callback - 변경 시 호출될 콜백 (forceRender)
+     * @returns 구독 해제 함수
+     */
+    subscribeNode(nodeId: string, callback: () => void): () => void;
+    /**
+     * version을 구독합니다. (nodes, rootId, variables 변경 감지용)
+     *
+     * @param callback - 변경 시 호출될 콜백 (forceRender)
+     * @returns 구독 해제 함수
+     */
+    subscribeVersion(callback: () => void): () => void;
+    /**
+     * 특정 노드의 구독자에게 변경을 알립니다.
+     *
+     * @param nodeId - 변경된 노드 ID
+     */
+    notifyNode(nodeId: string): void;
+    /**
+     * 여러 노드의 구독자에게 변경을 알립니다.
+     *
+     * @param nodeIds - 변경된 노드 ID 배열
+     */
+    notifyNodes(nodeIds: string[]): void;
+    /**
+     * version 구독자에게 변경을 알립니다.
+     */
+    notifyVersion(): void;
+}

package/dist/types/src/store/managers/VariablesManager.d.ts

@@ -0,0 +1,38 @@
+/**
+ * VariablesManager
+ *
+ * 전역 변수 관리를 담당합니다.
+ */
+import type { LayoutStateRepository } from './LayoutStateRepository';
+import type { SubscriptionManager } from './SubscriptionManager';
+/**
+ * VariablesManager
+ *
+ * 전역 변수 관리를 담당합니다.
+ */
+export declare class VariablesManager {
+    private repository;
+    private subscriptionManager;
+    constructor(repository: LayoutStateRepository, subscriptionManager: SubscriptionManager);
+    /**
+     * 전역 변수를 업데이트합니다.
+     * 깊은 복사로 새 객체를 생성하여 version을 증가시킵니다.
+     *
+     * @param variables - 새로운 전역 변수 객체
+     */
+    updateVariables(variables: Record<string, unknown>): void;
+    /**
+     * 개별 전역 변수를 업데이트합니다.
+     * 깊은 복사로 새 객체를 생성하여 version을 증가시킵니다.
+     *
+     * @param key - 변수 키
+     * @param value - 변수 값
+     */
+    updateVariable(key: string, value: unknown): void;
+    /**
+     * 전역 변수를 삭제합니다.
+     *
+     * @param key - 삭제할 변수 키
+     */
+    deleteVariable(key: string): void;
+}

package/dist/types/src/store/managers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Server-Driven UI - Store Managers
+ *
+ * Store를 구성하는 매니저 클래스들
+ */
+export * from "./DocumentManager";
+export * from "./LayoutStateRepository";
+export * from "./SubscriptionManager";
+export * from "./VariablesManager";

package/dist/types/src/store/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Server-Driven UI - Store Types
+ *
+ * Store 상태 및 옵션 타입 정의
+ */
+import type { ReactNode } from "react";
+import type { SduiLayoutNode } from "../schema";
+/**
+ * 자식 노드 렌더링 함수 타입 (Render Props)
+ *
+ * 상위에서 주입되어 자식 노드를 렌더링할 때 사용합니다.
+ */
+export type RenderNodeFn = (childId: string) => ReactNode;
+/**
+ * 컴포넌트 팩토리 타입
+ *
+ * id, renderNode를 받아서 컴포넌트를 렌더링합니다.
+ */
+export type ComponentFactory = (id: string, renderNode: RenderNodeFn) => ReactNode;
+/**
+ * Store 상태
+ *
+ * nodes, rootId, variables 등은 일반 변수로 관리하고
+ * version을 구독하여 변경을 감지합니다.
+ */
+export interface SduiLayoutStoreState {
+    /** 전체 리렌더 트리거용 버전 */
+    version: number;
+    /** 루트 노드 ID (트리 구조 변경 시 리렌더 필요) */
+    rootId?: string;
+    /** 노드 엔티티 (id → node) - 컴포넌트 구조 정의 */
+    nodes: Record<string, SduiLayoutNode>;
+    /** 선택된 노드 ID */
+    selectedNodeId?: string;
+    /** 레이아웃 편집 상태 */
+    isEdited?: boolean;
+    /** 전역 변수 (깊은 복사로 리렌더 트리거) */
+    variables: Record<string, unknown>;
+}
+/**
+ * SduiLayoutStore 생성 옵션
+ */
+export interface SduiLayoutStoreOptions {
+    /** 컴포넌트 오버라이드 맵 (ID 우선, 없으면 타입으로 조회) */
+    componentOverrides?: Record<string, ComponentFactory>;
+}

package/dist/types/src/utils/normalize/denormalize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SDUI Layout Denormalize
+ *
+ * Normalized entities에서 문서를 복원합니다.
+ */
+import type { SduiLayoutDocument, SduiLayoutNode } from '../../schema';
+import type { NormalizedSduiEntities } from './types';
+/**
+ * Normalized entities에서 노드를 denormalize
+ *
+ * @param nodeId - 복원할 노드 ID
+ * @param entities - normalize된 entities
+ * @returns 복원된 노드
+ */
+export declare function denormalizeSduiNode(nodeId: string, entities: NormalizedSduiEntities): SduiLayoutNode | null;
+/**
+ * Normalized entities에서 전체 문서를 denormalize
+ *
+ * @param rootId - 루트 노드 ID
+ * @param entities - normalize된 entities
+ * @param metadata - 문서 메타데이터 (선택적)
+ * @returns 복원된 문서
+ */
+export declare function denormalizeSduiLayout(rootId: string, entities: NormalizedSduiEntities, metadata?: SduiLayoutDocument['metadata']): SduiLayoutDocument | null;

package/dist/types/src/utils/normalize/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Server-Driven UI - Normalization Utilities
+ *
+ * Document normalization and denormalization functions
+ */
+export * from "./denormalize";
+export * from "./normalize";
+export * from "./types";

package/dist/types/src/utils/normalize/normalize.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SDUI Layout Normalize
+ *
+ * normalizr를 사용하여 SduiLayoutDocument를 normalize하고
+ * id를 통해 조회 가능한 entities로 변환합니다.
+ */
+import type { SduiLayoutDocument, SduiLayoutNode } from '../../schema';
+import type { NormalizedSduiEntities } from './types';
+/**
+ * SduiLayoutNode를 normalize하여 entities로 변환
+ *
+ * @param node - normalize할 노드
+ * @returns normalize된 결과 (entities와 result)
+ */
+export declare function normalizeSduiNode(node: SduiLayoutNode): {
+    result: string;
+    entities: NormalizedSduiEntities;
+};
+/**
+ * SduiLayoutDocument를 normalize
+ *
+ * @param document - normalize할 문서
+ * @returns normalize된 결과
+ */
+export declare function normalizeSduiLayout(document: SduiLayoutDocument): {
+    result: string;
+    entities: NormalizedSduiEntities;
+};

package/dist/types/src/utils/normalize/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Server-Driven UI - Normalized Entities Types
+ *
+ * Normalize된 엔티티 구조 정의
+ */
+import type { SduiLayoutNode } from '../../schema';
+/**
+ * Normalize된 엔티티 구조
+ *
+ * id를 키로 사용하여 조회 가능한 형태로 변환됩니다.
+ */
+export interface NormalizedSduiEntities {
+    /** 노드 엔티티 (id → SduiLayoutNode, state와 attributes 포함) */
+    nodes?: Record<string, SduiLayoutNode>;
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "author": "lodado",
+  "version": "1.0.0",
+  "bugs": {
+    "url": "https://github.com/lodado/sdui-template/issues"
+  },
+  "contributors": [],
+  "dependencies": {
+    "lodash-es": "^4.17.21",
+    "normalizr": "^3.6.2",
+    "zod": "^3.23.8"
+  },
+  "description": "SDUI (Server-Driven UI) template library for React. A flexible and powerful template system for building server-driven user interfaces with dynamic layouts and components.",
+  "peerDependencies": {
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.1.5",
+    "@testing-library/react": "^14.1.2",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^20.12.7",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
+    "babel-jest": "29.5.0",
+    "eslint": "^8.57.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "ts-jest": "29.0.5",
+    "jest-config": "0.0.0",
+    "tsconfig": "0.0.0",
+    "eslint-config-sdui-template": "0.0.0",
+    "rollup-config": "0.0.1"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "default": "./dist/es/client/index.mjs",
+        "types": "./dist/types/index.d.ts"
+      },
+      "require": {
+        "default": "./dist/cjs/client/index.cjs",
+        "types": "./dist/types/index.d.ts"
+      }
+    }
+  },
+  "files": [
+    "dist/**",
+    "README.md"
+  ],
+  "homepage": "https://github.com/lodado/sdui-template",
+  "keywords": [
+    "react",
+    "sdui",
+    "server-driven-ui",
+    "template",
+    "layout",
+    "dynamic",
+    "components",
+    "ui"
+  ],
+  "license": "MIT",
+  "main": "./dist/cjs/client/index.cjs",
+  "module": "./dist/es/client/index.mjs",
+  "name": "@lodado/sdui-template",
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    },
+    "@types/react-dom": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "source": "./src/index.ts"
+  },
+  "sideEffects": false,
+  "source": "./src/index.ts",
+  "types": "./dist/types/index.d.ts",
+  "scripts": {
+    "build": "rollup -c && tsc --emitDeclarationOnly --declarationMap false --declaration --declarationDir dist/types",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "lint": "eslint \"src/**/*.ts*\"",
+    "manual-release": "pnpm run build && pnpm publish --no-git-checks",
+    "test": "jest --passWithNoTests"
+  }
+}