컴포넌트 추가방식 변경

This commit is contained in:
kjs
2025-09-11 18:38:28 +09:00
parent 77a6b50761
commit 134976ff9e
114 changed files with 11548 additions and 782 deletions

View File

@@ -0,0 +1,152 @@
"use client";
import React from "react";
import { ComponentRendererProps } from "@/types/component";
import { ImageDisplayConfig } from "./types";
export interface ImageDisplayComponentProps extends ComponentRendererProps {
config?: ImageDisplayConfig;
}
/**
* ImageDisplay 컴포넌트
* image-display 컴포넌트입니다
*/
export const ImageDisplayComponent: React.FC<ImageDisplayComponentProps> = ({
component,
isDesignMode = false,
isSelected = false,
onClick,
onDragStart,
onDragEnd,
config,
className,
style,
...props
}) => {
// 컴포넌트 설정
const componentConfig = {
...config,
...component.config,
} as ImageDisplayConfig;
// 스타일 계산 (위치는 RealtimePreviewDynamic에서 처리하므로 제외)
const componentStyle: React.CSSProperties = {
width: "100%",
height: "100%",
...component.style,
...style,
};
// 디자인 모드 스타일
if (isDesignMode) {
componentStyle.border = "1px dashed #cbd5e1";
componentStyle.borderColor = isSelected ? "#3b82f6" : "#cbd5e1";
}
// 이벤트 핸들러
const handleClick = (e: React.MouseEvent) => {
e.stopPropagation();
onClick?.();
};
// DOM에 전달하면 안 되는 React-specific props 필터링
const {
selectedScreen,
onZoneComponentDrop,
onZoneClick,
componentConfig: _componentConfig,
component: _component,
isSelected: _isSelected,
onClick: _onClick,
onDragStart: _onDragStart,
onDragEnd: _onDragEnd,
size: _size,
position: _position,
style: _style,
...domProps
} = props;
return (
<div style={componentStyle} className={className} {...domProps}>
{/* 라벨 렌더링 */}
{component.label && (
<label
style={{
position: "absolute",
top: "-25px",
left: "0px",
fontSize: component.style?.labelFontSize || "14px",
color: component.style?.labelColor || "#374151",
fontWeight: "500",
}}
>
{component.label}
{component.required && <span style={{ color: "#ef4444" }}>*</span>}
</label>
)}
<div
style={{
width: "100%",
height: "100%",
border: "1px solid #d1d5db",
borderRadius: "4px",
overflow: "hidden",
display: "flex",
alignItems: "center",
justifyContent: "center",
backgroundColor: "#f9fafb",
}}
onClick={handleClick}
onDragStart={onDragStart}
onDragEnd={onDragEnd}
>
{component.value || componentConfig.imageUrl ? (
<img
src={component.value || componentConfig.imageUrl}
alt={componentConfig.altText || "이미지"}
style={{
maxWidth: "100%",
maxHeight: "100%",
objectFit: componentConfig.objectFit || "contain",
}}
onError={(e) => {
(e.target as HTMLImageElement).style.display = "none";
if (e.target?.parentElement) {
e.target.parentElement.innerHTML = `
<div style="display: flex; flex-direction: column; align-items: center; gap: 8px; color: #6b7280; font-size: 14px;">
<div style="font-size: 24px;">🖼️</div>
<div>이미지 로드 실패</div>
</div>
`;
}
}}
/>
) : (
<div
style={{
display: "flex",
flexDirection: "column",
alignItems: "center",
gap: "8px",
color: "#6b7280",
fontSize: "14px",
}}
>
<div style={{ fontSize: "32px" }}>🖼</div>
<div> </div>
</div>
)}
</div>
</div>
);
};
/**
* ImageDisplay 래퍼 컴포넌트
* 추가적인 로직이나 상태 관리가 필요한 경우 사용
*/
export const ImageDisplayWrapper: React.FC<ImageDisplayComponentProps> = (props) => {
return <ImageDisplayComponent {...props} />;
};

View File

@@ -0,0 +1,72 @@
"use client";
import React from "react";
import { Input } from "@/components/ui/input";
import { Label } from "@/components/ui/label";
import { Checkbox } from "@/components/ui/checkbox";
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
import { ImageDisplayConfig } from "./types";
export interface ImageDisplayConfigPanelProps {
config: ImageDisplayConfig;
onChange: (config: Partial<ImageDisplayConfig>) => void;
}
/**
* ImageDisplay 설정 패널
* 컴포넌트의 설정값들을 편집할 수 있는 UI 제공
*/
export const ImageDisplayConfigPanel: React.FC<ImageDisplayConfigPanelProps> = ({
config,
onChange,
}) => {
const handleChange = (key: keyof ImageDisplayConfig, value: any) => {
onChange({ [key]: value });
};
return (
<div className="space-y-4">
<div className="text-sm font-medium">
image-display
</div>
{/* file 관련 설정 */}
<div className="space-y-2">
<Label htmlFor="placeholder"></Label>
<Input
id="placeholder"
value={config.placeholder || ""}
onChange={(e) => handleChange("placeholder", e.target.value)}
/>
</div>
{/* 공통 설정 */}
<div className="space-y-2">
<Label htmlFor="disabled"></Label>
<Checkbox
id="disabled"
checked={config.disabled || false}
onCheckedChange={(checked) => handleChange("disabled", checked)}
/>
</div>
<div className="space-y-2">
<Label htmlFor="required"> </Label>
<Checkbox
id="required"
checked={config.required || false}
onCheckedChange={(checked) => handleChange("required", checked)}
/>
</div>
<div className="space-y-2">
<Label htmlFor="readonly"> </Label>
<Checkbox
id="readonly"
checked={config.readonly || false}
onCheckedChange={(checked) => handleChange("readonly", checked)}
/>
</div>
</div>
);
};

View File

@@ -0,0 +1,56 @@
"use client";
import React from "react";
import { AutoRegisteringComponentRenderer } from "../../AutoRegisteringComponentRenderer";
import { ImageDisplayDefinition } from "./index";
import { ImageDisplayComponent } from "./ImageDisplayComponent";
/**
* ImageDisplay 렌더러
* 자동 등록 시스템을 사용하여 컴포넌트를 레지스트리에 등록
*/
export class ImageDisplayRenderer extends AutoRegisteringComponentRenderer {
static componentDefinition = ImageDisplayDefinition;
render(): React.ReactElement {
return <ImageDisplayComponent {...this.props} renderer={this} />;
}
/**
* 컴포넌트별 특화 메서드들
*/
// file 타입 특화 속성 처리
protected getImageDisplayProps() {
const baseProps = this.getWebTypeProps();
// file 타입에 특화된 추가 속성들
return {
...baseProps,
// 여기에 file 타입 특화 속성들 추가
};
}
// 값 변경 처리
protected handleValueChange = (value: any) => {
this.updateComponent({ value });
};
// 포커스 처리
protected handleFocus = () => {
// 포커스 로직
};
// 블러 처리
protected handleBlur = () => {
// 블러 로직
};
}
// 자동 등록 실행
ImageDisplayRenderer.registerSelf();
// Hot Reload 지원 (개발 모드)
if (process.env.NODE_ENV === "development") {
ImageDisplayRenderer.enableHotReload();
}

View File

@@ -0,0 +1,91 @@
# ImageDisplay 컴포넌트
image-display 컴포넌트입니다
## 개요
- **ID**: `image-display`
- **카테고리**: display
- **웹타입**: file
- **작성자**: Developer
- **버전**: 1.0.0
## 특징
- ✅ 자동 등록 시스템
- ✅ 타입 안전성
- ✅ Hot Reload 지원
- ✅ 설정 패널 제공
- ✅ 반응형 디자인
## 사용법
### 기본 사용법
```tsx
import { ImageDisplayComponent } from "@/lib/registry/components/image-display";
<ImageDisplayComponent
component={{
id: "my-image-display",
type: "widget",
webType: "file",
position: { x: 100, y: 100, z: 1 },
size: { width: 200, height: 36 },
config: {
// 설정값들
}
}}
isDesignMode={false}
/>
```
### 설정 옵션
| 속성 | 타입 | 기본값 | 설명 |
|------|------|--------|------|
| placeholder | string | "" | 플레이스홀더 텍스트 |
| disabled | boolean | false | 비활성화 여부 |
| required | boolean | false | 필수 입력 여부 |
| readonly | boolean | false | 읽기 전용 여부 |
## 이벤트
- `onChange`: 값 변경 시
- `onFocus`: 포커스 시
- `onBlur`: 포커스 해제 시
- `onClick`: 클릭 시
## 스타일링
컴포넌트는 다음과 같은 스타일 옵션을 제공합니다:
- `variant`: "default" | "outlined" | "filled"
- `size`: "sm" | "md" | "lg"
## 예시
```tsx
// 기본 예시
<ImageDisplayComponent
component={{
id: "sample-image-display",
config: {
placeholder: "입력하세요",
required: true,
variant: "outlined"
}
}}
/>
```
## 개발자 정보
- **생성일**: 2025-09-11
- **CLI 명령어**: `node scripts/create-component.js image-display --category=display --webType=file`
- **경로**: `lib/registry/components/image-display/`
## 관련 문서
- [컴포넌트 시스템 가이드](../../docs/컴포넌트_시스템_가이드.md)
- [개발자 문서](https://docs.example.com/components/image-display)

View File

@@ -0,0 +1,40 @@
"use client";
import { ImageDisplayConfig } from "./types";
/**
* ImageDisplay 컴포넌트 기본 설정
*/
export const ImageDisplayDefaultConfig: ImageDisplayConfig = {
placeholder: "입력하세요",
// 공통 기본값
disabled: false,
required: false,
readonly: false,
variant: "default",
size: "md",
};
/**
* ImageDisplay 컴포넌트 설정 스키마
* 유효성 검사 및 타입 체크에 사용
*/
export const ImageDisplayConfigSchema = {
placeholder: { type: "string", default: "" },
// 공통 스키마
disabled: { type: "boolean", default: false },
required: { type: "boolean", default: false },
readonly: { type: "boolean", default: false },
variant: {
type: "enum",
values: ["default", "outlined", "filled"],
default: "default"
},
size: {
type: "enum",
values: ["sm", "md", "lg"],
default: "md"
},
};

View File

@@ -0,0 +1,40 @@
"use client";
import React from "react";
import { createComponentDefinition } from "../../utils/createComponentDefinition";
import { ComponentCategory } from "@/types/component";
import type { WebType } from "@/types/screen";
import { ImageDisplayWrapper } from "./ImageDisplayComponent";
import { ImageDisplayConfigPanel } from "./ImageDisplayConfigPanel";
import { ImageDisplayConfig } from "./types";
/**
* ImageDisplay 컴포넌트 정의
* image-display 컴포넌트입니다
*/
export const ImageDisplayDefinition = createComponentDefinition({
id: "image-display",
name: "이미지 표시",
nameEng: "ImageDisplay Component",
description: "이미지 표시를 위한 이미지 컴포넌트",
category: ComponentCategory.DISPLAY,
webType: "file",
component: ImageDisplayWrapper,
defaultConfig: {
placeholder: "입력하세요",
},
defaultSize: { width: 200, height: 36 },
configPanel: ImageDisplayConfigPanel,
icon: "Eye",
tags: [],
version: "1.0.0",
author: "Developer",
documentation: "https://docs.example.com/components/image-display",
});
// 타입 내보내기
export type { ImageDisplayConfig } from "./types";
// 컴포넌트 내보내기
export { ImageDisplayComponent } from "./ImageDisplayComponent";
export { ImageDisplayRenderer } from "./ImageDisplayRenderer";

View File

@@ -0,0 +1,46 @@
"use client";
import { ComponentConfig } from "@/types/component";
/**
* ImageDisplay 컴포넌트 설정 타입
*/
export interface ImageDisplayConfig extends ComponentConfig {
// file 관련 설정
placeholder?: string;
// 공통 설정
disabled?: boolean;
required?: boolean;
readonly?: boolean;
placeholder?: string;
helperText?: string;
// 스타일 관련
variant?: "default" | "outlined" | "filled";
size?: "sm" | "md" | "lg";
// 이벤트 관련
onChange?: (value: any) => void;
onFocus?: () => void;
onBlur?: () => void;
onClick?: () => void;
}
/**
* ImageDisplay 컴포넌트 Props 타입
*/
export interface ImageDisplayProps {
id?: string;
name?: string;
value?: any;
config?: ImageDisplayConfig;
className?: string;
style?: React.CSSProperties;
// 이벤트 핸들러
onChange?: (value: any) => void;
onFocus?: () => void;
onBlur?: () => void;
onClick?: () => void;
}