API 참조 — 공개 표면

이 페이지는 제품 어셈블리에 있는 모든 공개 타입을 나열한다. 여기 나열되지 않은 것은 설계상 internal이다 — 공개 표면은 의도적으로 좁다.

• Core(SheetForge.Core + SheetForge.Core.Tooling): 공개 타입 137개(Core: 131개, Core.Tooling: 6개). Core.Tooling은 리포팅과 push 계획 같은 임포트 시점 서비스를 담은 에디터 전용 절반이다 — 플레이어 빌드에는 전혀 포함되지 않는다.
• Editor: 최상위 공개 타입 53개와 그 공개 중첩 타입들.
• Runtime: 타입 7개, 그리고 생성된 출력물.

이는 정확히 (InternalsVisibleTo가 없는) 소비자 시뮬레이션 테스트가 컴파일 대상으로 삼는 표면이다.

감지 계약(타입이 아님): 별도의 에셋은 Editor 어셈블리가 자체 등록하는 SHEETFORGE 스크립팅 define 심볼을 통해 컴파일 타임에도 SheetForge가 설치되어 있음을 감지할 수 있다. 이는 define이지 공개 타입이 아니므로 아래 표에는 나열되지 않는다 — 플러그인 작성 ▸ 다른 에셋에서 SheetForge 감지하기 참고. (SHEETFORGE_ADDRESSABLES와는 별개다 — 후자는 Addressables 패키지가 있는지만 표시하는 내부 버전 정의다.)

관례: 시그니처는 축약되어 있다(… = 소스 XML 문서 참고). "순수(pure)"는 UnityEngine 없음 / IO 없음을 의미한다.

Core 어셈블리 (SheetForge.Core) — 순수 C#

UnityEngine 없음, IO 없음, 네트워크 없음, 도메인 지식 없음. 컴파일러로 강제됨: Core는 아무것도 참조하지 않는다.

플러그인 등록 계약 (SheetForge.Core.Plugins)

구성과 호환성 (SheetForge.Core.Plugins)

발견은 호스트별이다 — 에디터에서는 Unity의 TypeCache, 웹에서는 브라우저의 업로드된 어셈블리 스캔. 그 이후의 모든 것(인스턴스화, 순서, 격리, 호환성 게이트)은 하나의 공유 Core 함수이며, 이것이 두 호스트가 슬롯 단위로 어긋나지 않게 지켜준다.

PluginComposition — 두 멤버:

• IReadOnlyList<Type> ContractTypes — 발견 필터. 그 순서는 고정되어 있다. 진단이 나타나는 순서를 결정하기 때문이다.
• PluginSet Compose(IReadOnlyList<Type> candidateTypes, string hostVersion, ErrorCollector errors, ICollection<string> failures, Func<string,bool> isProductKey = null) — 조립 호출 자체.

두 종류의 문제는 서로 분리되어 유지된다. 등록 충돌과 호환성 거부는 errors의 구조화된 진단이 되고, 구현 버그 — 생성 실패, throw하는 콜백 — 는 failures의 영어 문장이 되며, 그곳에 null을 넘기면 이들은 버려진다.

후행하는 isProductKey 조건은 문자열 오버레이의 "플러그인은 제품 키를 덮어쓸 수 없다" 규칙이 Core가 언어 테이블을 전혀 보지 않고도 강제되는 방법이다: 규칙은 여기에 살고, 호스트는 재료만 공급한다. 이 조건을 생략하면 그 한 가지 규칙만 건너뛰어진다.

레지스트리 (SheetForge.Core.Model / .Validation / .Edges)

EnumRegistry — 세 멤버 상세:

• EnumRegistry(EnumRegistry parent) — 부모를 관통해 읽고 자신에게만 등록하는 자식이다. 부모는 도메인 리로드 전체에 걸친 플러그인 등록 CLR enum을, 자식은 이번 임포트의 시트 정의 enum을 담으므로, 임포트가 공유 캐시를 변경하는 일은 없다. 부모가 이미 소유한 이름을 등록하면 가리는 대신 예외를 던진다.
• Contains(name) — 자신 다음 부모, Ordinal.
• SetClrTypeName(name, fullTypeName) — 문자열만으로 등록된 이후 CLR 이름을 채운다. 타입이 아직 존재하지 않으므로 어셈블리 이름은 비어 있는 채로 남는다.

"시트 생성" 템플릿 (SheetForge.Core.Model)

커스텀 셀 타입 (SheetForge.Core.Model)

시트 문법 상수 (SheetForge.Core.Model)

셀 텍스트를 읽거나 쓰는 팩은 임포터와 동일한 문법으로 동작한다 — 리스트 셀을 나누고, @type 문자열을 조립하고, 이름이 이미 사용 중인지 확인하는 일들이다.

이 상수들이 그 문법의 단일 진실이므로, 팩은 결코 자신만의 구분자를 다시 적지 않는다: 문자를 복사해 두면 문법이 바뀌는 날 어긋난다. 목록들은 읽기 전용으로 제공되므로, 팩이 무엇을 하든 문법 자체를 바꿀 수는 없다. 이들이 나타내는 표기법은 시트 문법 페이지에 전부 문서화되어 있다 — 이것은 그 문법에 대한 프로그래밍적 접근 수단이다.

마커

• CommentPrefix (#) · MarkerPrefix (@).
• 내장 마커 행마다 상수 하나씩: NameMarker · TypeMarker · DescMarker · OverlapMarker · StyleMarker · EnumMarker · LocMarker.
• RequiredMarkers — 모든 시트가 반드시 지녀야 하는 세 개.
• ReservedMarkers — 모든 내장 이름. 커스텀 마커에 이름을 붙이기 전에 이것을 확인한다: 충돌은 등록 시점에 거부된다.

구분자

• ListSeparator (;) — 리스트 원소 사이.
• EntrySeparator (,), FieldSeparator (:), SectionSeparator (|), KeyTimeSeparator (@) — 값 하나 안쪽의 층위들이며, 그래서 ;는 값 자신의 텍스트 안에는 결코 나타나지 않는다.
• StyleKeyValueSeparator (=) — @style 셀 내부.

@type 표기법

• OptionalSuffix (?) · DefaultSeparator (=) · TargetSeparator (@, RecordId@Tab에서처럼).
• ListTypeName · ListOpen (List<) · ListClose (>).

타입 이름

• 내장 이름마다 상수 하나씩: IntTypeName · FloatTypeName · BoolTypeName · StringTypeName · RecordIdTypeName · IntIdTypeName · AssetRefTypeName · LocRefTypeName · ColorTypeName · AnimationCurveTypeName · GradientTypeName · EnumTypeName.
• BuiltinScalarTypes와 IsBuiltinScalarTypeName(name) — "이 이름이 이미 내장 타입인가?"를 파서가 그 이름으로 등록되기 전에 답해 준다.
• StyleKeyNames (title, color) · LocReservedColumns (smart, comment).

값

• TrueCanonical / FalseCanonical — 정본 bool 텍스트.
• NumberCellStyles — 모든 숫자 셀을 읽을 때 쓰는 NumberStyles. 천 단위 구분자는 제외되고 컬처는 항상 고정(invariant)이므로, 로케일의 소수점 쉼표는 숫자를 조용히 바꾸는 대신 요란하게 실패한다.

도메인 검증 (SheetForge.Core.Validation)

엣지 이음매 (SheetForge.Core.Validation / .Edges)

ReferenceScanner — 두 개의 참조 판정자:

• GetReferencedTab(TypeToken) — 모든 소비자가 묻는 단일 판정자, "이것은 참조인가, 그렇다면 어디를 향하는가". RecordId@Tab에 대해, IntId@Tab(정수 키 공간)에 대해, 래퍼 내부에 대해, 그리고 IsCustomReference로 표시된 커스텀 타입에 대해 답한다. 옵트인 하나 — 그리고 IntId@Tab의 경우 이 판정자의 확장 하나 — 가 이들을 한 번에 모두 켜는 이유다.
• GetReferenceKind(TypeToken) → RefKeyKind — 그 참조가 문자열 키 공간과 정수 키 공간 중 어느 쪽과 비교되는지를 알려주므로, 이름 변경 전파·드롭다운·피커가 올바르게 분기한다.
• GetReferenceKind(TypeToken, tables) — 테이블을 인지하는 오버로드.

코어 참조는 자신의 공간(RecordId / IntId)을 스스로 명시한다. 참조형 커스텀 타입에는 이를 말할 표기법이 없다 — MyType@Tab이 유일한 표기이므로 — 그래서 그 공간은 대상 탭의 아이덴티티로부터 유도된다: RecordId 자기 키는 문자열 공간을, IntId만 있으면 정수 공간을 뜻하며, 알 수 없는 탭이나 null 테이블은 토큰만 있는 오버로드와 동일한 답인 문자열 공간으로 대체된다. 그 유도 방식 덕분에 기존 IReferencingCellType 구현이 코드 한 줄도 바꾸지 않고 IntId 키 탭을 겨냥할 수 있다.

참조 그래프 인덱스 (SheetForge.Core.Edges)

코어가 스캔한 참조와 기여자 엣지를 하나의 모델로 병합해 양방향으로 색인하는 불변 스냅샷이다. 표시 소재다 — 결코 진단 정보를 생성하지 않는다(문제에 대한 유일한 진실 공급원은 계속 프로젝션의 Diagnostics다).

데이터 스튜디오 레코드 캔버스 (SheetForge.Core.Graphing)

캔버스는 무엇을 그릴지 스스로 결정한다: 열어본 레코드(종착점)로부터 참조 인덱스를 바깥으로 따라가며 결과를 결정적으로 배치한다. 플러그인은 그 그림을 대체하지 않는다 — 그저 더할 뿐이다. 전체가 순수한 데이터다: 컬럼은 픽셀이 아니라 그리드 셀이며, 색상은 창이 팔레트로 매핑하는 자유 형식 Category 문자열이다.

CanvasAugmentBuilder — 쓰기 표면. 오직 네 가지뿐이다:

• AddNode(tab, recordId, title = null, category = null) / AddNode(tab, recordId, title, category, CellCoordinate address) — 시트 레코드가 아닌 아이덴티티(이벤트 키, 코드 원자)를 위한 가상 노드다. 탭은 비어 있을 수 있다.
• AddEdge(fromTab, fromRecordId, toTab, toRecordId, label = null, fieldName = null, fieldOnTarget = false, isCyclic = false, cyclicNote = null) — 코어 스캐너가 볼 수 없는 추가 엣지다. fieldName을 명명하면 링크가 어느 셀에 쓰이는지를 말하고, fieldOnTarget은 그 셀이 출발이 아니라 도착에 있다고 말하며, 순환 한 쌍은 도메인만 아는 note와 함께 루프를 표시용으로 표시한다.
• SetLayer(tab, recordId, layer) — 절대적 레이어 힌트(0 = 가장 왼쪽, 음수 = 더 왼쪽, 나머지는 이를 보정하기 위해 오른쪽으로 이동한다). SetLayerRelative(tab, recordId, offset) — 동일하지만 종착점으로부터 센다(−1 = 그 왼쪽 한 칸), 어떤 힌트가 이동시키기 전의 종착점 컬럼을 기준으로 해석된다.
• SetSubtitle(tab, recordId, subtitle) — 표시 힌트로, 이미 존재하는 레코드와 화면에 없는 레코드 모두에 적용되는 유일한 것이다(연결 피커가 그것들을 읽는다).

키가 빈 항목은 무시된다. 무엇이 수집되었는지는 internal이다 — 병합 규칙이 한 곳에 살기 때문이다. 모든 확장은 후행이므로, 더 이른 표면을 대상으로 작성된 오버라이드도 여전히 컴파일된다.

IAuthorableGraphShape — 이것이 없을 때의 두 기본값:

• 이 capability가 대체하는 생성 가능 탭 목록 — 캔버스가 애초에 열리는지, 대기 행 스윕이 얼마나 도달하는지도 결정하는 축 — 은 스키마를 전이적으로 따라가며 포커스 탭에서 도달 가능한 모든 탭을 포함한다.
• 사용자가 실제로 보게 되는 연결 계단식 목록은 현재 그려진 포트들이 가리키는 탭에서 시작한다.

둘 다 코드 레지스트리 탭과 키 컬럼이 없는 탭을 제외한다. 이것이 반환하는, 그려진 어떤 포트도 받아들이지 않는 탭은 사유가 붙은 채로 연결 계단식 목록에 남으며, 창 자신의 게이트가 여전히 그 위에 적용된다.

컬러 프리셋 (SheetForge.Core.Theming)

프리셋은 자신이 이름 붙인 슬롯만 오버라이드한다. 그 외의 모든 슬롯은 제품 기본값을 유지하므로, 슬롯이 추가되어도 프리셋은 계속 유효하다. 등록이 곧 프리셋 적용은 아니다 — 사용자가 Preferences ▸ SheetForge ▸ Theme에서 하나를 선택한다.

선언적 작성 표면 (SheetForge.Core.Studio)

플러그인은 무엇을 보여줄지를 서술한다 — 껍데기는 데이터로, 조건과 효과는 델리게이트로 — 그러면 각 호스트는 자신의 위젯으로 이를 그린다: 에디터에서는 UIToolkit, 브라우저에서는 React. 레이아웃 수치는 어디에도 나타나지 않는다. 무엇을 말할지는 플러그인의 것이고, 어떻게 배치할지는 렌더러의 것이다.

여기 있는 모든 enum은 추가 전용이므로, 어휘가 자라나도 등록은 그 의미를 유지한다.

StudioUiNode — 팩토리, 읽기용 속성, URL 규칙:

• 팩토리: Row · Label · Chip · Badge · Button · Rule · Heading · KeyValue · Table(headerRow, rows) · List · Progress · Input · Link, 그리고 이 노드를 바꾸는 대신 새 노드를 반환하는 WithTooltip(text).
• 읽기용 속성: Kind · Text · Tooltip · ThemeColorSlot? Tone(결코 하드코딩된 색상이 아니므로 테마를 따른다) · ActionId · Detail · Ratio · Url · Children.
• static bool IsAllowedUrl(url) — http/https만. 두 호스트 모두가 묻는 하나의 조건이므로, 무엇이 열기에 안전한지에 대해 서로 다르게 판단할 수 없다.

플러그인 UI 문자열 (SheetForge.Core.Model)

StringOverlayRegistry — 매칭과 거부. language는 IETF 코드다("en", "ko", "zh-Hans", "pt-BR" 등), 대소문자 구분 없이 매칭된다. 조회는 요청 언어 → 영어 → 실패 순으로 대체되며, 그 대체 로직이 여기 살기 때문에 두 호스트가 동일하게 답한다.

네 가지 등록이 거부되며, 각각 조용히 실패하는 대신 개발자용 사유를 기록한다:

• 제품 내장 키 — 오버레이는 키를 추가할 수 있을 뿐, 제품 자신의 문장이나 메뉴 경로를 결코 덮어쓸 수 없다;
• 다른 팩이 이미 등록한 키+언어 조합 — 먼저 발견된 것이 이긴다. 그렇지 않으면 설치 순서가 화면을 결정할 것이다;
• 빈 키 또는 빈 값;
• 제품이 알지 못하는 언어 코드 — 결코 영어로 접혀 들어가지 않는다.

파이프라인 관찰 (SheetForge.Core.Plugins / .Model)

코드 레지스트리 (SheetForge.Core.Graphing)

코드 안에 존재하는 참조 대상으로, 작성 표면에 잠긴 가상 탭으로 노출된다. 임포트 검증기가 아니라 데이터 스튜디오(사이드바 / 그래프 / 인스펙터)가 소비한다.

IR 읽기 모델 (SheetForge.Core.Model)

타입 지정 에셋 참조 (SheetForge.Core.Model)

AssetRef@Group<Type>의 <Type>은 호스트가 해석한다 — Core는 엔진도, 프로젝트의 어셈블리도 모른다 — 그리고 Core는 그 결과만 판정한다. 여기 있는 모든 것은 순수 데이터다.

코드젠은 파이프라인이 만든 해석 딕셔너리를 읽어, 해석된 이름에는 AssetReferenceT<global::FullName>을 내보낸다; 그 딕셔너리에서 찾을 수 없는 이름은 결코 그대로 내보내지지 않는다 — 필드는 AssetReference로 폴백하고 AssetTypeUnresolvedFallback 경고가 수집된다. 해석된 전체 이름은 스키마 핑거프린트에도 섞여 들어간다.

시각적 값 타입 (SheetForge.Core.Model)

세 가지 내장 시각적 타입을 위한, 엔진에 의존하지 않는 값 모델이다. 각각은 불변이고 IEquatable이며, 자신만의 텍스트 형태(TryParse / Render)를 스스로 소유한다 — 시트 문법 페이지가 문서화하는 것과 같은 표기법이다 — 그래서 색상, 커브, 그라디언트를 저장하는 플러그인 타입은 두 번째 표기법을 만드는 대신 이들을 재사용할 수 있다. Editor는 이들을 UnityEngine.Color / AnimationCurve / Gradient로 베이크하고 다시 읽어들인다; 브라우저는 수학을 다시 구현하는 대신 아래의 평가기(evaluator)를 통해 이들을 샘플링한다.

에러와 결과 (SheetForge.Core.Model / .Reporting)

ImportErrorCode — 이를 구성하는 계열:

• 마커, 스키마, 타입, 셀, 키/참조, 에셋 키;
• 소스/파일, csv/xlsx, 코드젠 식별자, addressables, baseline/export, Google/인증/Push, 템플릿;
• 플러그인 — PluginRegistrationConflict, 그리고 어셈블리의 호환성 선언이 이 호스트가 읽는 범위를 벗어날 때의 PluginIncompatible;
• IntId — DuplicateIntId, 그리고 IntId@Tab 참조에 대해서는 UnresolvedIntId · TargetTabHasNoIntId;
• @overlap과 DomainRuleViolation;
• enum 정의 시트 — EnumSheetMarkerConflict · DuplicateEnumName · EnumSheetEmptyColumn · InvalidEnumIdentifier · InvalidEnumUnderlyingType · InvalidEnumMemberValue;
• 에러가 아니라 경고인 DropdownNotSupportedByFormat;
• 타입 지정 에셋 참조 — UnknownAssetType · AmbiguousAssetType · AssetTypeNotReferenceable(컬럼당 한 번, @type 행에서), 셀마다 AssetTypeMismatch, 그리고 코드젠 경고 AssetTypeUnresolvedFallback.

인덱스와 유틸리티 (SheetForge.Core.Validation / .Model / .Parsing / .Unparse)

Push 계획 (SheetForge.Core.Unparse)

IPushApprover.Approve(PushPlan)가 이들을 노출하기 때문에 공개되어 있다. 순수 데이터다.

Editor 어셈블리 (SheetForge.Editor)

설정, 현지화, 구성 (SheetForge.Editor.Pipeline / .Localization)

PluginRegistry — 묶음과 슬롯 격리. 중첩된 PluginBundle은 조립된 PluginSet Set(열두 슬롯짜리 단일 진실 — 새로 자란 슬롯을 묶음을 넓히지 않고도 읽는 방법이다)을 노출하고, 그 위에 아홉 개의 편의용 창을 제공한다: Enums · Parsers · Validators · EdgeContributors · Markers · Templates · GraphShapes · CodeRegistries · Themes. 이전의 여섯 개·여덟 개 인자 생성자는 이후 레지스트리를 빈 값으로 기본 설정하는 오버로드로 남아 있으며, 그 계약들이 존재하기 전의 버전과 동일하게 동작한다.

격리는 이 타입이 아니라 Core의 것이다: 등록 중 예외를 던지는 플러그인은 이름과 함께 보고되고 건너뛰어지며, 다른 모든 슬롯과 플러그인은 계속 등록된다.

SheetForgeActions — 완료 시맨틱스. RunImport/RunPush는 던지고 잊는 방식이다 — 에디터 메인 스레드가 네트워크 IO에 블록될 수 없으므로 본문이 async void다. 그래서 반환은 완료를 의미하지 않는다: 이를 위해서는 ImportEvents.ImportCompleted를 구독하라. RunExport/RunHealthCheck/RunLocalizationSync는 동기적으로 완료된다 — RunLocalizationSync는 임포트 완료가 실행하는 시트 → StringTable 경로를 실행하며, Unity Localization 패키지가 없으면 설치 안내를 보여줄 뿐 아무것도 바꾸지 않는다.

소스 프로바이더 이음매 (SheetForge.Editor.Sources)

데이터 스튜디오 확장 지점 (SheetForge.Editor.Studio)

UIElements를 반환하거나 창 상태를 다루므로 Editor 측이다 — ISheetSourceProvider와 동일하게 정당화된 비대칭이다. 네 계약 모두 TypeCache로 발견되며(매개변수 없는 생성자, 등록 호출 없음), 모두 try/catch 안에서 호출된다. 창 자신(DataStudioWindow)은 internal이다.

데이터로 표현 가능한 것은 대신 Core의 ISheetForgeStudioPlugin 어휘에 속하며, 이는 브라우저에서도 렌더링된다. 이들은 서술이 말할 수 없는 것을 위한, 한계 없는 탈출구다.

마지막 네 항목은 계약이 아니라 마운트된 위젯이 사용할 수 있는 도구다:

• 창 자신의 읽기 전용 스킨 값 — 그래서 자신이 속한 것처럼 보일 수 있다;
• 키 드롭다운 — 그래서 셀 위젯이 내장 셀과 동일한 방식으로 키를 고른다;
• 그리고 발견 캐시 재설정 — 그래서 사용자 자신의 테스트가 프로브를 다시 발견할 수 있다.

StudioInspectorContext — 두 스테이징 델리게이트:

• StageCell은 탭, recordId, 필드, 정본 원문 텍스트를 받는다. 창이 Undo 단계를 등록하고, 프로젝션 세대를 올리고, 논리적 주소를 스테이징한다.
• StageCells는 함께 바뀌어야 하는 여러 셀에 대해 동일한 일을 한다: 하나의 네이티브 Undo 단계, 전부 아니면 전무다. 하나라도 스테이징할 수 없으면 세션은 전혀 건드려지지 않는다.

어느 쪽이든 화면상으로는 조용한 실패이며, 오직 게이트만 스스로를 설명한다. 읽기 전용 소스, 이미 실행 중인 파이프라인, 또는 워크북 기반 탭은 콘솔에 그 사유를 기록한다. 빈 목록, 탭이나 필드가 없는 쓰기, 그리고 어떤 행으로도 해석되지 않는 레코드 키는 아무 일도 하지 않고 아무 말도 하지 않는다.

StudioPalette — 멤버:

• 33개의 색상 슬롯: Canvas · Panel · Band · Chrome · Surface · Chip · Selection · PendingCell · Line · LineSoft · GridLine · LineHover · Text · TextMuted · TextFaint · RefText · OnAccent · Accent · AccentDim · Warning · Danger · Ok · SheetTone · CodeTone · EditedCell · NewRowCell · NewRowLine · DangerChip · DangerPanel · Scrim · Wire · WireDot · GridDot.
• IsDark.
• 간격: SectionSpace · RowSpace · RuleHeight · ButtonHeight · PrimaryButtonHeight · GlyphWidth.
• 타입 크기: HeadingFontSize · SectionFontSize · CaptionFontSize.
• FromRgb(uint) · ToHex(uint).

Push 승인 (SheetForge.Editor.Push)

작성 엔진 (SheetForge.Editor.Structure / .Pipeline / .Export)

스테이징 값 타입 (SheetForge.Editor.Structure; StagedCellEdit/StagedNewRow는 SheetForge.Editor.Windows에 있음)

작성 헬퍼 (SheetForge.Editor.Windows / .Structure)

Runtime 어셈블리 (SheetForge.Runtime)

autoReferenced — asmdef 참조 없이 게임 코드에서 사용 가능하다.

생성된 타입 (패턴 — 프로젝트별, 출시되는 API 아님)

탭 Foo마다, 코드젠은 사용자의 generatedNamespace에 다음을 생성한다:

public sealed partial class FooDefinition    // one strongly-typed field per column; @desc → doc/tooltip
public sealed partial class FooDatabase : DefinitionDatabase
{
    // TabName, Count, SchemaFingerprint, Records, RecordsUntyped override,
    // lazy _byId/_byIntId lookups, InvalidateIndex override
}

SheetForgeDatabases.LoadAsync<FooDatabase>("Foo")로 로드한다.

두 클래스 모두 partial로 생성되므로, 파생 멤버(계산된 프로퍼티, 인터페이스 구현, 연산자)를 생성된 파일 옆의 자신만의 파일에 추가할 수 있으며, 재임포트가 이를 덮어쓰지 않는다.

한 가지 경계: 사용자의 부분에는 직렬화된 필드를 추가하지 마라. 베이크된 ScriptableObject는 매 임포트마다 시트로부터 재구축되므로, 사용자의 부분만 직렬화하는 것은 기본값으로 돌아온다 — 값이 데이터에 속한다면, 그것은 컬럼에 속한다.

(partial 키워드는 스키마만으로 계산되는 SchemaFingerprint를 건드리지 않으므로, 클래스를 partial로 만든 것이 기존 베이크를 단 하나도 무효화하지 않았다.)

그 밖의 어셈블리

• SheetForge.Setup — 의존성 없는 Addressables 부재 부트스트랩. 공개 API 없음(모두 internal, 안내 창을 보여주기 위해서만 존재).

• SheetForge.PluginDemo(병합된 asmdef 하나 + Demo.Editor asmdef 하나; 콘텐츠 네임스페이스는 SheetForge.Skills로 유지) — 참조 샘플 패키지이며 제품 API가 아니다. 다음을 담고 있다:

  • SkillsPlugin(일곱 개의 플러그인 인터페이스 — 기본, 검증기, 엣지, 템플릿, 그래프, 코드 레지스트리, 테마);
  • Modifier + ModifierCellParser(커스텀 셀 타입), ModifierStatEdgeContributor(엣지 기여자);
  • ExamplePipelineAugmenter / ExampleReactiveAugmenter(캔버스 오버라이드), ExampleCodeAtoms(_Refs 코드 레지스트리);
  • ExampleStudioUi(선언적 액션, 패널, 컬럼 배지, 셀 에디터 힌트), ExampleImportObserver(파이프라인 관찰자);
  • ExampleStageStripWidget / ExampleInspectorAction / ExampleStudioPanel(공개 팔레트로 그려지는 데이터 스튜디오 Editor 확장 지점), ExampleLocStrings(그 라벨들을 두 언어로 등록 — 메인 어셈블리에 있어, 브라우저도 이를 보여준다);
  • 어셈블리 수준 SheetForgePluginCompat 선언;
  • SkillRunner(런타임 소비), 기본 SheetForge.Generated 네임스페이스에 생성된 Example* 타입(격리는 별도의 네임스페이스가 아니라 Example* 접두사로 이루어진다).

  플러그인이 없는 SheetForge.CoreDemo 샘플은 asmdef가 전혀 없이(Assembly-CSharp으로 컴파일되어) 제공된다.

관련 페이지

• 플러그인 작성 — 사용 중인 계약과 전체 예시
• 작성 커널 — 맥락 속 엔진 타입
• 기능 및 제한 — 이 API들의 동작 경계