API-Referenz — die öffentliche Oberfläche

Diese Seite listet jeden öffentlichen Typ in den Produkt-Assemblies auf. Alles, was hier nicht aufgeführt ist, ist bewusst internal; die öffentliche Oberfläche ist absichtlich schmal gehalten.

• Core (SheetForge.Core + SheetForge.Core.Tooling): 137 öffentliche Typen (Core: 131, Core.Tooling: 6). Core.Tooling ist die editor-only Hälfte mit Import-Zeit-Diensten wie Reporting und Push-Planung — nichts davon wird in Player-Builds ausgeliefert.
• Editor: 53 öffentliche Typen der obersten Ebene plus deren öffentliche verschachtelte Typen.
• Runtime: 7 Typen, plus generierte Ausgaben.

Das ist genau die Oberfläche, gegen die die Konsumenten-Simulationstests (ohne InternalsVisibleTo) kompilieren.

Erkennungsvertrag (kein Typ): Ein separates Asset kann außerdem zur Kompilierzeit erkennen, dass SheetForge installiert ist, über das SHEETFORGE-Scripting-Define-Symbol, das die Editor-Assembly selbst registriert. Es ist ein Define, kein öffentlicher Typ, daher ist es in den folgenden Tabellen nicht aufgeführt — siehe Plugin-Erstellung ▸ SheetForge aus einem anderen Asset erkennen. (Getrennt von SHEETFORGE_ADDRESSABLES, einem internen Version-Define, das lediglich markiert, ob das Addressables-Paket vorhanden ist.)

Konventionen: Signaturen sind abgekürzt (… = siehe XML-Dokumentation im Quellcode); „pure" bedeutet kein UnityEngine / keine IO.

Core-Assembly (SheetForge.Core) — reines C#

Kein UnityEngine, keine IO, kein Netzwerk, keine Domänenkenntnis. Compilererzwungen: Core referenziert nichts.

Plugin-Registrierungsverträge (SheetForge.Core.Plugins)

Zusammenstellung und Kompatibilität (SheetForge.Core.Plugins)

Die Entdeckung ist pro Host verschieden — Unitys TypeCache im Editor, der Scan der hochgeladenen Assembly im Browser. Alles danach (Instanziierung, Reihenfolge, Isolation und das Kompatibilitäts-Gate) ist eine einzige gemeinsame Core-Funktion, die verhindert, dass die beiden Hosts Slot für Slot auseinanderdriften.

PluginComposition — die zwei Member:

• IReadOnlyList<Type> ContractTypes — der Entdeckungsfilter. Seine Reihenfolge ist fest, weil sie bestimmt, in welcher Reihenfolge Diagnosen erscheinen.
• PluginSet Compose(IReadOnlyList<Type> candidateTypes, string hostVersion, ErrorCollector errors, ICollection<string> failures, Func<string,bool> isProductKey = null) — der Zusammenstellungsaufruf selbst.

Zwei Arten von Problemen werden auseinandergehalten. Registrierungskonflikte und Kompatibilitätsablehnungen werden zu strukturierten Diagnosen in errors; Implementierungsfehler — Konstruktionsfehler, ein werfender Callback — werden zu englischen Zeilen in failures, und null dort zu übergeben verwirft sie.

Das nachgestellte Prädikat isProductKey ist, wie die Regel „ein Plugin darf keinen Produktschlüssel überschreiben" des String-Overlays erzwungen wird, ohne dass Core je die Sprachtabellen sieht: Die Regel lebt hier, der Host liefert nur das Material. Lassen Sie das Prädikat weg, wird nur diese eine Regel übersprungen.

Registries (SheetForge.Core.Model / .Validation / .Edges)

EnumRegistry — die drei Member im Detail:

• EnumRegistry(EnumRegistry parent) — ein Kind, das lesend auf ein Parent zugreift und nur bei sich selbst registriert. Das Parent hält die per Plugin registrierten CLR-Enums für den gesamten Domain-Reload, das Kind die tabellendefinierten dieses Imports, sodass ein Import den gemeinsamen Cache nie mutiert. Die Registrierung eines Namens, den das Parent bereits besitzt, wirft eine Exception, statt ihn zu überschatten.
• Contains(name) — erst eigene, dann Parent, ordinal.
• SetClrTypeName(name, fullTypeName) — trägt nach einer reinen String-Registrierung einen CLR-Namen nach. Der Assembly-Name bleibt leer, weil der Typ noch nicht existiert.

„Create sheet"-Vorlagen (SheetForge.Core.Model)

Benutzerdefinierte Zelltypen (SheetForge.Core.Model)

Sheet-Grammatik-Konstanten (SheetForge.Core.Model)

Ein Paket, das Zellentext liest oder schreibt, arbeitet mit derselben Grammatik wie der Import — eine Listenzelle aufteilen, einen @type-String zusammensetzen, prüfen, ob ein Name bereits vergeben ist.

Diese Konstanten sind die einzige Quelle der Wahrheit für diese Grammatik, sodass ein Paket nie ein eigenes Trennzeichen neu festlegt: Ein kopiertes Zeichen läuft an dem Tag auseinander, an dem sich die Grammatik ändert. Die Listen werden schreibgeschützt herausgegeben, sodass nichts, was ein Paket tut, die Grammatik selbst ändern kann. Die Notation, die sie ausbuchstabieren, ist vollständig auf der Seite Tabellensyntax dokumentiert — dies ist der programmatische Zugriff darauf.

Markierungen

• CommentPrefix (#) · MarkerPrefix (@).
• Eine Konstante pro eingebauter Markierungszeile: NameMarker · TypeMarker · DescMarker · OverlapMarker · StyleMarker · EnumMarker · LocMarker.
• RequiredMarkers — die drei, die jede Tabelle tragen muss.
• ReservedMarkers — jeder eingebaute Name. Sehen Sie hier nach, bevor Sie eine eigene Markierung benennen: Eine Kollision wird bei der Registrierung abgelehnt.

Trennzeichen

• ListSeparator (;) — zwischen Listenelementen.
• EntrySeparator (,), FieldSeparator (:), SectionSeparator (|), KeyTimeSeparator (@) — die Ebenen innerhalb eines einzelnen Werts, weshalb ; niemals im eigenen Text eines Werts auftaucht.
• StyleKeyValueSeparator (=) — innerhalb einer @style-Zelle.

@type-Notation

• OptionalSuffix (?) · DefaultSeparator (=) · TargetSeparator (@, wie in RecordId@Tab).
• ListTypeName · ListOpen (List<) · ListClose (>).

Typnamen

• Eine Konstante pro eingebautem Namen: IntTypeName · FloatTypeName · BoolTypeName · StringTypeName · RecordIdTypeName · IntIdTypeName · AssetRefTypeName · LocRefTypeName · ColorTypeName · AnimationCurveTypeName · GradientTypeName · EnumTypeName.
• BuiltinScalarTypes und IsBuiltinScalarTypeName(name) — beantworten „Ist dieser Name bereits eingebaut?", bevor ein Parser unter diesem Namen registriert wird.
• StyleKeyNames (title, color) · LocReservedColumns (smart, comment).

Werte

• TrueCanonical / FalseCanonical — der kanonische bool-Text.
• NumberCellStyles — die NumberStyles, mit denen jede numerische Zelle gelesen wird. Tausendertrennzeichen sind ausgeschlossen, und die Culture ist immer invariant, sodass ein lokales Dezimalkomma laut fehlschlägt, statt eine Zahl still zu verändern.

Domänen-Validierung (SheetForge.Core.Validation)

Kanten-Nahtstelle (SheetForge.Core.Validation / .Edges)

ReferenceScanner — die zwei Referenz-Prädikate:

• GetReferencedTab(TypeToken) — das eine Prädikat, das jeder Konsument fragt: „ist das eine Referenz, und wohin". Es beantwortet dies für RecordId@Tab, für IntId@Tab (den Integer-Schlüsselraum), für das Innere eines Wrappers und für einen mit IsCustomReference markierten benutzerdefinierten Typ. Deshalb aktiviert ein einziges Opt-in — und, für IntId@Tab, eine Erweiterung dieses Prädikats — alle auf einmal.
• GetReferenceKind(TypeToken) → RefKeyKind — ob die Referenz gegen den String- oder den Integer-Schlüsselraum abgleicht, sodass Umbenennungs-Propagierung, Dropdown und Picker korrekt verzweigen.
• GetReferenceKind(TypeToken, tables) — die tabellenbewusste Überladung.

Eine Core-Referenz nennt ihren eigenen Raum (RecordId / IntId). Ein referenzierender benutzerdefinierter Typ hat keine Notation, um ihn zu benennen — MyType@Tab ist die einzige Schreibweise —, daher wird sein Raum aus der Identität des Ziel-Tabs abgeleitet: Ein RecordId-Eigenschlüssel bedeutet String-Raum, allein IntId bedeutet Integer-Raum, und ein unbekannter Tab oder null-Tabellen fallen auf String-Raum zurück — dieselbe Antwort, die die reine Token-Überladung gibt. Diese Ableitung ist es, die einer bestehenden IReferencingCellType-Implementierung erlaubt, auf einen IntId-Schlüssel-Tab zu zielen, ohne eine einzige Zeile zu ändern.

Referenzgraph-Index (SheetForge.Core.Edges)

Ein unveränderlicher Schnappschuss, der core-gescannte Referenzen und Contributor-Kanten zu einem Modell zusammenführt, in beide Richtungen indiziert. Anzeigematerial — er erzeugt nie Diagnosen (die Diagnostics der Projektion bleiben die einzige Quelle der Wahrheit für Probleme).

Record-Canvas des Data Studio (SheetForge.Core.Graphing)

Die Canvas entscheidet selbst, was sie zeichnet: Sie durchläuft den Referenz-Index ausgehend vom geöffneten Datensatz (der Terminus) und legt das Ergebnis deterministisch an. Ein Plugin ersetzt dieses Bild nicht — es ergänzt es. Durchgehend reine Daten: Spalten sind Grid-Zellen, keine Pixel, und Farben sind ein freier Category-String, den das Fenster auf eine Palette abbildet.

CanvasAugmentBuilder — die Schreiboberfläche. Nur vier Dinge:

• AddNode(tab, recordId, title = null, category = null) / AddNode(tab, recordId, title, category, CellCoordinate address) — ein virtueller Node für eine Identität, die kein Sheet-Datensatz ist (ein Event-Schlüssel, ein Code-Atom); der Tab darf leer sein.
• AddEdge(fromTab, fromRecordId, toTab, toRecordId, label = null, fieldName = null, fieldOnTarget = false, isCyclic = false, cyclicNote = null) — eine zusätzliche Kante, die der Core-Scanner nicht sehen kann. Die Benennung von fieldName sagt, in welche Zelle der Link geschrieben ist, fieldOnTarget sagt, dass diese Zelle beim Ziel statt beim Ausgang sitzt, und das Zyklus-Paar markiert eine Schleife zur Anzeige mit der Notiz, die nur die Domäne kennt.
• SetLayer(tab, recordId, layer) — ein absoluter Layer-Hinweis (0 = ganz links, negativ = weiter links, alles andere verschiebt sich zum Ausgleich nach rechts). SetLayerRelative(tab, recordId, offset) — dasselbe vom Terminus aus gezählt (−1 = eine Spalte links davon), aufgelöst gegen die Terminus-Spalte, bevor irgendein Hinweis sie verschoben hat.
• SetSubtitle(tab, recordId, subtitle) — ein Anzeige-Hinweis, das Einzige, was auch für bereits existierende Datensätze und für nicht auf dem Bildschirm befindliche Datensätze gilt (der Connect-Picker liest diese).

Einträge mit leerem Schlüssel werden ignoriert; was gesammelt wurde, ist internal, weil die Zusammenführungsregeln an einer Stelle leben. Jede Erweiterung ist nachgestellt, sodass ein gegen eine frühere Oberfläche geschriebener Override weiterhin kompiliert.

IAuthorableGraphShape — die zwei Vorgaben ohne sie:

• Die Liste erstellbarer Tabs, die diese Capability ersetzt — die Achse, die auch entscheidet, ob eine Canvas überhaupt öffnet und wie weit der Sweep ausstehender Zeilen reicht — deckt jeden Tab ab, der vom Fokus-Tab aus transitiv entlang des Schemas erreichbar ist.
• Die Verlinkungs-Kaskade, die der Nutzer tatsächlich sieht, beginnt bei den Tabs, auf die die gerade gezeichneten Ports zielen.

Beide lassen Code-Registry-Tabs und Tabs ohne Schlüsselspalte aus. Ein von hier zurückgegebener Tab, den kein gezeichneter Port akzeptiert, bleibt mit angehängtem Grund in der Verlinkungs-Kaskade gelistet, und die eigenen Schranken des Fensters gelten weiterhin zusätzlich.

Farb-Presets (SheetForge.Core.Theming)

Ein Preset überschreibt nur die Slots, die es benennt; jeder andere Slot behält die Produktvorgabe, sodass ein Preset gültig bleibt, während Slots hinzukommen. Das Registrieren wendet ein Preset nie an — der Nutzer wählt eines unter Preferences ▸ SheetForge ▸ Theme.

Deklarative Authoring-Oberflächen (SheetForge.Core.Studio)

Ein Plugin beschreibt, was gezeigt werden soll — die Hülle als Daten, Prädikat und Effekt als Delegaten —, und jeder Host zeichnet es mit seinen eigenen Widgets: UIToolkit im Editor, React im Browser. Nirgends erscheinen Layout-Zahlen. Was gesagt wird, gehört dem Plugin, wie es platziert wird, dem Renderer.

Jedes Enum hier ist nur anfügbar, sodass eine Registrierung ihre Bedeutung behält, während das Vokabular wächst.

StudioUiNode — Fabriken, Reads und die URL-Regel:

• Fabriken: Row · Label · Chip · Badge · Button · Rule · Heading · KeyValue · Table(headerRow, rows) · List · Progress · Input · Link, plus WithTooltip(text), das einen neuen Node zurückgibt statt diesen zu ändern.
• Reads: Kind · Text · Tooltip · ThemeColorSlot? Tone (nie eine fest codierte Farbe, folgt also dem Theme) · ActionId · Detail · Ratio · Url · Children.
• static bool IsAllowedUrl(url) — nur http/https. Ein Prädikat, das beide Hosts befragen, sodass sie nie uneinig darüber sein können, was sicher zu öffnen ist.

Plugin-UI-Strings (SheetForge.Core.Model)

StringOverlayRegistry — Abgleich und Ablehnungen. language ist ein IETF-Code ("en", "ko", "zh-Hans", "pt-BR", …), Groß-/Kleinschreibung wird ignoriert. Der Lookup fällt zurück angeforderte Sprache → Englisch → Fehltreffer, und der Fallback lebt hier, damit beide Hosts identisch antworten.

Vier Registrierungen werden abgelehnt, jede mit einem für Entwickler bestimmten protokollierten Grund statt eines stillen Fehlschlags:

• ein eingebauter Produktschlüssel — ein Overlay darf Schlüssel hinzufügen, nie die eigenen Sätze oder Menüpfade des Produkts überschreiben;
• ein Schlüssel+Sprache-Paar, das ein anderes Paket bereits registriert hat — die zuerst gefundene gewinnt, weil sonst die Installationsreihenfolge über den Bildschirm entscheiden würde;
• ein leerer Schlüssel oder Wert;
• ein Sprachcode, den das Produkt nicht kennt, der nie nach Englisch gefaltet wird.

Pipeline-Beobachtung (SheetForge.Core.Plugins / .Model)

Code-Registries (SheetForge.Core.Graphing)

Referenzziele, die im Code leben und der Authoring-Oberfläche als gesperrte virtuelle Tabs zugänglich gemacht werden. Wird vom Data Studio konsumiert (Seitenleiste / Graph / Inspector), nicht vom Import-Validator.

Das IR-Lesemodell (SheetForge.Core.Model)

Typisierte Asset-Referenzen (SheetForge.Core.Model)

Der <Type> in AssetRef@Group<Type> wird vom Host aufgelöst — der Core kennt weder die Engine noch die Assemblies des Projekts — und der Core beurteilt nur das Ergebnis. Alles hier ist reine Daten.

Codegen liest das aufgelöste Dictionary, das die Pipeline erzeugt, und gibt für einen aufgelösten Namen AssetReferenceT<global::FullName> aus; ein Name, den es in diesem Dictionary nicht findet, wird nie wortgetreu ausgegeben — das Feld fällt auf AssetReference zurück, und eine AssetTypeUnresolvedFallback-Warnung wird gesammelt. Der aufgelöste vollständige Name fließt außerdem in den Schema-Fingerabdruck ein.

Visuelle Werttypen (SheetForge.Core.Model)

Engine-freie Wertmodelle für die drei eingebauten visuellen Typen. Jeder ist unveränderlich, IEquatable, und besitzt seine eigene Textform (TryParse / Render) — dieselbe Notation, die die Seite Tabellensyntax dokumentiert —, sodass ein Plugin-Typ, der eine Farbe, eine Kurve oder einen Verlauf speichert, sie wiederverwenden kann, statt eine zweite Notation zu erfinden. Der Editor bakt sie in UnityEngine.Color / AnimationCurve / Gradient und liest sie zurück; der Browser sampelt sie über die Evaluatoren unten, statt die Mathematik neu zu implementieren.

Fehler und Ergebnisse (SheetForge.Core.Model / .Reporting)

ImportErrorCode — die Familien, die er abdeckt:

• Markierungen, Schema, Typen, Zellen, Schlüssel/Referenzen und Asset-Schlüssel;
• Quellen/Dateien, csv/xlsx, Codegen-Bezeichner, Addressables, Baseline/Export, Google/Auth/Push und Vorlagen;
• Plugins — PluginRegistrationConflict, plus PluginIncompatible, wenn die Kompatibilitätsdeklaration einer Assembly außerhalb dessen liegt, was dieser Host liest;
• IntId — DuplicateIntId, und für IntId@Tab-Referenzen UnresolvedIntId · TargetTabHasNoIntId;
• @overlap und DomainRuleViolation;
• Enum-Definitionstabellen — EnumSheetMarkerConflict · DuplicateEnumName · EnumSheetEmptyColumn · InvalidEnumIdentifier · InvalidEnumUnderlyingType · InvalidEnumMemberValue;
• DropdownNotSupportedByFormat, eine Warnung statt eines Fehlers;
• typisierte Asset-Referenzen — UnknownAssetType · AmbiguousAssetType · AssetTypeNotReferenceable (einmal pro Spalte, auf der @type-Zeile), AssetTypeMismatch pro Zelle, sowie die Codegen-Warnung AssetTypeUnresolvedFallback.

Indizes und Hilfsprogramme (SheetForge.Core.Validation / .Model / .Parsing / .Unparse)

Push-Plan (SheetForge.Core.Unparse)

Öffentlich, weil IPushApprover.Approve(PushPlan) sie offenlegt; reine Daten.

Editor-Assembly (SheetForge.Editor)

Settings, Lokalisierung, Komposition (SheetForge.Editor.Pipeline / .Localization)

PluginRegistry — das Bündel und die Slot-Isolation. Das verschachtelte PluginBundle legt das zusammengestellte PluginSet Set offen — die zwölf-Slot-Einheitswahrheit, wodurch ein neu gewachsener Slot gelesen werden kann, ohne das Bündel zu erweitern —, plus neun bequeme Fenster darauf: Enums · Parsers · Validators · EdgeContributors · Markers · Templates · GraphShapes · CodeRegistries · Themes. Die früheren Sechs- und Acht-Argument-Konstruktoren bleiben als Overloads erhalten, die die späteren Registries auf leer setzen, und verhalten sich identisch wie die Versionen vor diesen Verträgen.

Isolation gehört Core, nicht diesem Typ: Ein Plugin, das beim Registrieren wirft, wird namentlich gemeldet und übersprungen, und jeder andere Slot und jedes andere Plugin registriert sich weiterhin.

SheetForgeActions — Abschluss-Semantik. RunImport/RunPush sind Fire-and-Forget. Ihre Bodies sind async void, weil der Editor-Hauptthread bei Netzwerk-IO nicht blockieren kann, daher ist die Rückkehr keine Fertigstellung — abonnieren Sie dafür ImportEvents.ImportCompleted. RunExport/RunHealthCheck/RunLocalizationSync schließen synchron ab — RunLocalizationSync durchläuft den Weg Sheet → StringTable, den auch ein Import-Abschluss durchläuft, und ohne das Unity-Localization-Paket zeigt es den Installationshinweis und ändert nichts.

Source-Provider-Nahtstelle (SheetForge.Editor.Sources)

Data-Studio-Erweiterungspunkte (SheetForge.Editor.Studio)

Editor-seitig, weil sie UIElements zurückgeben oder Fensterzustand berühren — dieselbe gerechtfertigte Asymmetrie wie bei ISheetSourceProvider. Alle vier Verträge werden per TypeCache entdeckt (parameterloser Konstruktor; kein Registrierungsaufruf), und alle werden innerhalb von try/catch aufgerufen. Das Fenster selbst (DataStudioWindow) ist internal.

Alles, was sich als Daten ausdrücken lässt, gehört stattdessen in das Core-Vokabular ISheetForgeStudioPlugin, das auch im Browser rendert. Dies sind die deckenlosen Ausweichmöglichkeiten für das, was Beschreibung nicht sagen kann.

Die letzten vier Einträge sind keine Verträge, sondern Werkzeuge, die ein eingebundenes Widget nutzen kann:

• die eigenen schreibgeschützten Skin-Werte des Fensters, damit es aussieht, als gehöre es dazu;
• das Schlüssel-Dropdown, damit ein Cell-Widget Schlüssel auf dieselbe Weise wählt wie die eingebaute Zelle;
• und das Zurücksetzen des Entdeckungs-Caches, damit Ihre eigenen Tests eine Sonde neu entdecken können.

StudioInspectorContext — die zwei Staging-Delegates:

• StageCell nimmt Tab, RecordId, Feld und kanonischen Rohtext entgegen. Das Fenster registriert den Undo-Schritt, erhöht die Projektionsgeneration und merkt die logische Adresse vor.
• StageCells macht dasselbe für mehrere Zellen, die gemeinsam geändert werden müssen: ein nativer Undo-Schritt, alles-oder-nichts. Kann auch nur eine nicht vorgemerkt werden, bleibt die Session vollständig unangetastet.

Ein Fehlschlag bleibt auf dem Bildschirm so oder so still, wobei nur das Gate sich selbst erklärt. Eine schreibgeschützte Quelle, eine bereits laufende Pipeline oder ein Arbeitsmappen-gestützter Tab schreiben ihren Grund in die Konsole. Eine leere Liste, ein Schreibvorgang ohne Tab oder Feld und ein Datensatz-Schlüssel, der zu keiner Zeile aufgelöst wird, tun nichts und sagen nichts.

StudioPalette — die Member:

• 33 Farb-Slots: 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.
• Abstände: SectionSpace · RowSpace · RuleHeight · ButtonHeight · PrimaryButtonHeight · GlyphWidth.
• Schriftgrößen: HeadingFontSize · SectionFontSize · CaptionFontSize.
• FromRgb(uint) · ToHex(uint).

Push-Bestätigung (SheetForge.Editor.Push)

Authoring-Engine (SheetForge.Editor.Structure / .Pipeline / .Export)

Staging-Werttypen (SheetForge.Editor.Structure; StagedCellEdit/StagedNewRow liegen in SheetForge.Editor.Windows)

Authoring-Hilfsprogramme (SheetForge.Editor.Windows / .Structure)

Runtime-Assembly (SheetForge.Runtime)

autoReferenced — aus Spielcode ohne asmdef-Referenz verwendbar.

Generierte Typen (Muster — pro Projekt, keine ausgelieferte API)

Für jeden Tab Foo erzeugt Codegen in Ihren 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
}

Laden Sie mit SheetForgeDatabases.LoadAsync<FooDatabase>("Foo").

Beide Klassen werden partial erzeugt, sodass Sie abgeleitete Member — eine berechnete Eigenschaft, eine Interface-Implementierung, einen Operator — in Ihrer eigenen Datei neben der generierten hinzufügen können, und ein erneuter Import überschreibt sie nicht. Eine Grenze: Fügen Sie in Ihrem Teil keine serialisierten Felder hinzu. Das per Bake erzeugte ScriptableObject wird bei jedem Import aus der Tabelle neu aufgebaut, daher kommt alles, was nur Ihr Teil serialisiert, auf seinen Standardwert zurück — gehört ein Wert zu den Daten, gehört er in eine Spalte. (Das Schlüsselwort partial rührt SchemaFingerprint nicht an, das allein aus dem Schema berechnet wird, daher hat das Partial-Machen der Klassen keinen einzigen bestehenden Bake ungültig gemacht.)

Weitere Assemblies

• SheetForge.Setup — der abhängigkeitsfreie Bootstrap für den Fall fehlender Addressables. Keine öffentliche API (alles internal; er existiert, um ein Hinweisfenster zu zeigen).

• SheetForge.PluginDemo (eine zusammengeführte asmdef + eine Demo.Editor-asmdef; der Inhalts-Namespace bleibt SheetForge.Skills) — das Referenzbeispielpaket, keine Produkt-API. Es enthält:

  • SkillsPlugin (sieben Plugin-Interfaces — Basis, Validator, Edge, Vorlage, Graph, Code-Registry, Theme);
  • Modifier + ModifierCellParser (benutzerdefinierter Zelltyp), ModifierStatEdgeContributor (Kanten-Contributor);
  • ExamplePipelineAugmenter / ExampleReactiveAugmenter (Canvas-Overrides), ExampleCodeAtoms (die Code-Registry _Refs);
  • ExampleStudioUi (deklarative Aktionen, Panel, Spalten-Badge und Cell-Editor-Hint), ExampleImportObserver (Pipeline-Beobachter);
  • ExampleStageStripWidget / ExampleInspectorAction / ExampleStudioPanel (Data-Studio-Editor-Erweiterungspunkte, aus der öffentlichen Palette bemalt), ExampleLocStrings (registriert diese Labels in zwei Sprachen — in der Haupt-Assembly, sodass der Browser sie ebenfalls zeigt);
  • eine Assembly-Level-Deklaration SheetForgePluginCompat;
  • SkillRunner (konsumierende Runtime), generierte Example*-Typen im Standard-Namespace SheetForge.Generated (die Isolation erfolgt über das Präfix Example*, nicht über einen eigenen Namespace).

  Das pluginfreie Beispiel SheetForge.CoreDemo wird mit null asmdefs ausgeliefert (kompiliert in Assembly-CSharp).

Verwandte Seiten

• Plugin-Erstellung – die verwendeten Verträge, mit vollständigen Beispielen
• Authoring-Kernel – die Engine-Typen im Kontext
• Möglichkeiten & Grenzen – Verhaltensgrenzen dieser APIs