Implement Lingo translation registry

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.

[zekageri]

Summary

• implement strongly typed translation domains where each feature key enum is isolated without RTTI
• allow multiple feature-specific tables per language while enforcing one table per {language, key enum type} pair
• add allocation-free get() / find() lookup with same-domain default-language fallback
• add bounded registry allocation with preferPsram = true by default, using PSRAM first and normal 8-bit heap as fallback
• keep translation tables and strings caller-owned/static so lookup performs no copies or allocations
• add atomic runtime default-language switching for concurrent read usage
• add ZekStack-style manifests, formatting config, changelog/release validation, README, focused docs, examples, and CI

PSRAM behavior

Lingo mirrors the PSRAM preference used by other ZekStack libraries such as Seal. During init() it allocates the bounded table registry with MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT when PSRAM is available and preferPsram is enabled. If that attempt fails, it falls back to MALLOC_CAP_8BIT. No lookup or table-registration operation allocates afterward.

Dedicated host tests compile the ESP32 allocation path against a heap-caps stub and verify:

• PSRAM is attempted first when available
• internal heap is not touched when the PSRAM allocation succeeds
• internal heap is used when PSRAM allocation fails
• internal heap is used when PSRAM is unavailable
• preferPsram = false bypasses PSRAM

API shape

The intended Core usage remains concise:

Lingo lingo;
LingoConfig config;
config.defaultLanguage = Language::Hu;
config.preferPsram = true;
lingo.init(config);
lingo.addTable(Language::Hu, SOFTWARE_HU);
lingo.addTable(Language::En, SOFTWARE_EN);
constchar *value = lingo.get(SoftwareKey::Install);

Different feature enums can reuse the same underlying numeric values without collisions.

Validation

Validated locally with:

• C++20 host behavior tests
• dedicated PSRAM-priority/fallback tests
• source-boundary audits matching CI
• ESP32-specific allocator-path compile smoke test
• syntax compilation of all Arduino examples using a minimal host stub
• release metadata/version validation
• JSON manifest validation
• whitespace diff checks

GitHub CI additionally builds every example across ESP32, ESP32-S3, ESP32-C3, and ESP32-P4 and enforces the shared ZekStack clang-format configuration.