-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathllms.txt
More file actions
63 lines (42 loc) · 5.95 KB
/
llms.txt
File metadata and controls
63 lines (42 loc) · 5.95 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# TMI Translation Bundle (tmi/translation-bundle)
> Make any Doctrine entity translatable by adding a single trait and interface. Translations are stored in the same table as the source entity, eliminating expensive joins and delivering the same query performance as non-translated entities. Built for Symfony developers building multilingual applications.
## Getting Started
- [README](https://github.com/CreativeNative/translation-bundle/blob/master/README.md): Installation, configuration, and quick start guide
- [Developer & AI Guide](https://github.com/CreativeNative/translation-bundle/blob/master/llms.md): Comprehensive glossary, handler chain decision tree, troubleshooting guide, and minimal working example
- [Upgrade Guide](https://github.com/CreativeNative/translation-bundle/blob/master/UPGRADING.md): Migration guide from v1.x to v2.0 with before/after code examples
## AI Skills
- [Entity Translation Setup](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/entity-translation-setup/SKILL.md): Make any Doctrine entity translatable with guided workflow
- [Translation Debugger](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/translation-debugger/SKILL.md): Diagnose and fix translation configuration issues
- [Custom Handler Creator](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/custom-handler-creator/SKILL.md): Build custom handlers for specialized field types
## Core Interfaces
- [TranslatableInterface](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Model/TranslatableInterface.php): Entity translation contract that entities must implement
- [TranslatableTrait](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Model/TranslatableTrait.php): Default implementation providing locale and tuuid management
- [EntityTranslatorInterface](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/EntityTranslatorInterface.php): Translation orchestrator service contract
- [TranslationHandlerInterface](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/TranslationHandlerInterface.php): Handler chain protocol for field translation
## Attributes
- [SharedAmongstTranslations](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Attribute/SharedAmongstTranslations.php): Mark fields to be synchronized across all translations
- [EmptyOnTranslate](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Attribute/EmptyOnTranslate.php): Mark fields to be cleared when creating new translations
## Handler Reference
- [PrimaryKeyHandler](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/PrimaryKeyHandler.php): Handles ID field generation for new translations
- [ScalarHandler](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/ScalarHandler.php): Handles primitive types (string, int, float, bool)
- [TranslatableEntityHandler](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/TranslatableEntityHandler.php): Handles nested translatable entities
- [DoctrineObjectHandler](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/DoctrineObjectHandler.php): Handles non-translatable Doctrine entity references
- [EmbeddedHandler](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Handlers/EmbeddedHandler.php): Handles Doctrine embeddables
- [Handler Priority Guide](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/custom-handler-creator/references/handler-priority.md): Priority decision matrix for handler ordering
## Value Objects
- [Tuuid](https://github.com/CreativeNative/translation-bundle/blob/master/src/ValueObject/Tuuid.php): Translation UUID linking related translations
- [TuuidType](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Type/TuuidType.php): Doctrine DBAL type for Tuuid persistence
## Events and Filters
- [TranslateEvent](https://github.com/CreativeNative/translation-bundle/blob/master/src/Event/TranslateEvent.php): Pre/post translation event for customization hooks
- [LocaleFilter](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Filter/LocaleFilter.php): Automatic query filtering by current locale
## v2.0 Services
- [TranslationCacheInterface](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/Cache/TranslationCacheInterface.php): Translation cache abstraction for custom implementations (Redis, PSR-6, etc.)
- [Translatable](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Attribute/Translatable.php): Entity-level attribute for per-entity copy_source control
- [TypeDefaultResolver](https://github.com/CreativeNative/translation-bundle/blob/master/src/Translation/TypeDefaultResolver.php): Type-safe default value resolution for EmptyOnTranslate
## v2.1 Locale Variant DX
- [TranslatableRepositoryTrait](https://github.com/CreativeNative/translation-bundle/blob/master/src/Doctrine/Repository/TranslatableRepositoryTrait.php): Repository trait providing `findAllLocaleVariants()` and `findAllLocaleVariantsBatch()` for batch locale variant queries
- EntityTranslatorInterface: New methods `translateAndPersist()` (translate + persist in one call) and `getOrTranslate()` (find existing or create + persist)
- TranslatableEntityHandler: Auto-resets generated IDs (`#[ORM\Id]` + `#[ORM\GeneratedValue]`) on cloned translations
## Optional
- [Diagnostics Reference](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/translation-debugger/references/diagnostics.md): Detailed diagnostic procedures
- [Handler Examples](https://github.com/CreativeNative/translation-bundle/blob/master/.agents/skills/custom-handler-creator/references/examples.md): Real-world custom handler implementations