ZOA Localization Authoring

LocalizationWorkbenchModule

class

The Workbench module itself, registered as "localization" in the workflow.environment lane. Builds a capability strip over table definitions, the string browser, the coverage report, source extraction, and an architecture overview.

• string Id => "localization"
• string Title => "Localization"
• string Subtitle => "Manage translations, preview localized content, and validate coverage"
• int Order => 51
• VisualElement Build(ZOAWorkbenchContext context)

LocalizationTableWizard

component

The three-step guided table creator. Each step carries a validator feeding the issue tray, and completion emits a LocalizationTableAsset from the captured draft.

• static void ShowWindow()
• LocalizationTableDraft CaptureDraft()

LocalizationKeyInventoryBuilder

class

Owned by the base package and consumed here. Builds the project-wide inventory that both the string browser and the coverage report render.

• static LocalizationKeyInventory BuildFromProject()
• static LocalizationKeyInventory BuildFromAssets(IEnumerable<LocalizationTableAsset> assets)

LocalizationKeyInventory

class

The inventory the Workbench views read: every row, the distinct locales and keys, and the two questions the coverage report asks per locale.

• IReadOnlyList<LocalizationKeyInventoryRow> Rows { get; }
• IReadOnlyList<LocaleId> Locales { get; } IReadOnlyList<LocalizationKey> Keys { get; }
• IReadOnlyList<LocalizationKeyInventoryRow> MissingRows(LocaleId referenceLocale, LocaleId targetLocale)
• float Coverage(LocaleId referenceLocale, LocaleId targetLocale)

LocalizationKeyInventoryRow

class

One key in one locale, with everything the browser and report need: the value, its table and asset path, the translator metadata, the review status, and the placeholder and duplicate flags.

• LocalizationKey Key { get; } LocaleId Locale { get; } string Value { get; }
• string TableName { get; } string AssetPath { get; }
• LocalizationReviewStatus ReviewStatus { get; }
• bool IsPlaceholder { get; } bool IsDuplicate { get; }

LocalizationHardcodedStringExtractor

class

The scanner behind the source extraction capability, owned by the base package. Returns candidates with a proposed key, the literal, and the file and line; a ZOA_LOCALIZATION_IGNORE token suppresses a literal.

• LocalizationExtractionReport ExtractFromFiles(IEnumerable<string> paths)

LocalizationExtractionCandidate

class

One extraction finding: the proposed key, the source text, the file path and line, a context string, and the name of the detector that matched.

• LocalizationKey Key { get; } string SourceText { get; }
• string SourcePath { get; } int Line { get; }
• string Context { get; } string Detector { get; }

LocalizationTableAssetEmitter

class

Writes the wizard's draft to disk, defaulting to Assets/ZOA/Generated/Localization. Also the path an imported translator document takes back into the project.

• const string DefaultSaveFolder = "Assets/ZOA/Generated/Localization"
• static LocalizationTableAsset EmitFromDraft(LocalizationTableDraft draft, string savePath)
• static LocalizationTableAsset EmitFromDocument(...)

LocalizationTableDraft

class

The in-flight shape the wizard captures before emission: a locale code, a table name, and the draft entries with their values and metadata.

• string LocaleCode; string TableName;
• List<LocalizationTableDraftEntry> Entries;
• static LocalizationTableDraft FromPairs(...)