[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-mps-aspect-textgen":3,"mdc-fm4hgm-key":38,"related-repo-jetbrains-mps-aspect-textgen":1509,"related-org-jetbrains-mps-aspect-textgen":1584},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":33,"sourceUrl":36,"mdContent":37},"mps-aspect-textgen","serialize MPS concepts to text","Use when authoring or debugging MPS TextGen — concept-to-plain-text serialisation for languages whose final output is text (source files, config, scripts, DDL, XML, markdown). Covers `ConceptTextGenDeclaration` roots, `append` \u002F `indent buffer` \u002F `with indent` statements, text layout areas, context objects (e.g. imports sets), attributes, the base text gen component (`LanguageTextGenDeclaration`), binary `write`, `found error`, and the indentation-buffer model. Reach for this skill whenever the task involves editing `\u003Clang>\u002FlanguageModels\u002FtextGen.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"jetbrains","JetBrains","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fjetbrains.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Markdown","markdown","tag",{"name":17,"slug":18,"type":15},"XML","xml",{"name":20,"slug":21,"type":15},"Engineering","engineering",{"name":23,"slug":24,"type":15},"Code Analysis","code-analysis",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-13T06:45:12.55742",null,311,[31,32],"domain-specific-language","dsl",{"repoUrl":26,"stars":25,"forks":29,"topics":34,"description":35},[31,32],"JetBrains Meta programming System","https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS\u002Ftree\u002FHEAD\u002Fplugins\u002Fmcp-tools\u002Fresources\u002Fjetbrains\u002Fmps\u002Fagents\u002Fmcp\u002Fskills\u002Fmps-aspect-textgen","---\nname: mps-aspect-textgen\ndescription: Use when authoring or debugging MPS TextGen — concept-to-plain-text serialisation for languages whose final output is text (source files, config, scripts, DDL, XML, markdown). Covers `ConceptTextGenDeclaration` roots, `append` \u002F `indent buffer` \u002F `with indent` statements, text layout areas, context objects (e.g. imports sets), attributes, the base text gen component (`LanguageTextGenDeclaration`), binary `write`, `found error`, and the indentation-buffer model. Reach for this skill whenever the task involves editing `\u003Clang>\u002FlanguageModels\u002FtextGen.mps`.\ntype: reference\n---\n\n# MPS TextGen Aspect\n\n**TextGen** turns a model (usually the output of generation) into plain text files. It is how BaseLanguage becomes `.java` on disk, and how any text-targeting language serialises its models. Lives in `\u003Clang>\u002FlanguageModels\u002FtextGen.mps`, language `jetbrains.mps.lang.textGen`. Rule bodies are BaseLanguage + smodel + textgen-specific statements (`append`, `indent buffer`, `with indent`).\n\n**Prerequisite for any insert:** the textGen model must exist (`mps_mcp_create_model` with `modelName: \"\u003Clang>.textGen\"` — aspect ID `textGen`, case-sensitive, no `@` suffix; see [aspect-model-stereotypes.md](..\u002Fmps-mcp-workflow\u002Freferences\u002Faspect-model-stereotypes.md)) and must import `jetbrains.mps.lang.textGen`, `jetbrains.mps.baseLanguage`, and `jetbrains.mps.lang.smodel` as used languages **before** the first `mps_mcp_insert_root_node_from_json`. Missing any of these three causes node inserts to fail with unresolved-concept errors. See step 1 of the Common-Path Workflow.\n\n## Critical Directives\n\n- One `ConceptTextGenDeclaration` root per concept you want to serialise. Only the **file-generating root concept** needs `extension` \u002F `filename` \u002F `encoding`; structural concepts inside the file need only `textGenBlock`.\n- `extension` is a **function body returning a string**, not a literal property. It must `return` a string.\n- TextGen dispatch is **concept-exact, not polymorphic**. An extending concept that wants the parent's serialisation must declare its own `ConceptTextGenDeclaration` (even an empty one) — or its output will be silently missing. See `references\u002Fdispatch-and-base-component.md`.\n- The indentation buffer is a per-output-file depth counter. `with indent` \u002F `increase depth` \u002F `decrease depth` and the `withIndent` flag on `NodeAppendPart` only mutate the counter — **whitespace is emitted only when `indent buffer` is called**. Always pair `append \\n ;` with `indent buffer ;` on the next line that should be indented. See `references\u002Findentation-model.md`.\n- Prefer `with indent { ... }` over paired `increase depth ; … ; decrease depth ;` — the block form cannot leak depth on an early `return` or exception. Use the paired form only when the scope is not a block.\n- Use TextGen only when the final artifact is text. If your pipeline ends in a model-to-model transformation targeting another MPS language (e.g. BaseLanguage), you don't need TextGen — that language's own TextGen handles the final step.\n- `BinaryWriteOperation` (`write`) cannot be mixed with text `append`s in the same `ConceptTextGenDeclaration`. A rule emits either text or bytes, not both.\n- The older `$ref{node.reference\u003Ctarget>}` syntax is **deprecated**. Use a `NodeAppendPart` over a resolved node (or over `.name`).\n- Edit textGen models through MPS MCP tools (`mps_mcp_insert_root_node_from_json`, `mps_mcp_update_node`). Do not hand-edit `.mps` files.\n- After edits run `mps_mcp_check_root_node_problems` and rebuild the language; regenerate consumers.\n\n## Common-Path Workflow\n\n1. Create a `textGen` model (`mps_mcp_create_model` with `modelName: \"\u003Clang>.textGen\"`; aspect ID is `textGen` — case-sensitive, no `@` suffix) if absent, then **before any insert** add the three required used languages: `jetbrains.mps.lang.textGen` (for `ConceptTextGenDeclaration`, `AppendOperation`, parts, `NodeParameter`, etc.), `jetbrains.mps.baseLanguage` (for `StatementList`, `DotExpression`, control flow, returns), and `jetbrains.mps.lang.smodel` (for `SPropertyAccess`, `SLinkAccess`, `SLinkListAccess` used to read node data). Also add the structure language whose concepts you serialise (referenced by `conceptDeclaration` and inside smodel accesses), and `jetbrains.mps.baseLanguage.collections` if you use maps\u002Flists. Skipping any of the three core languages causes `mps_mcp_insert_root_node_from_json` to fail with unresolved-concept errors — don't add them piecemeal after a failure.\n2. For each concept to serialise, insert a `ConceptTextGenDeclaration` root via `mps_mcp_insert_root_node_from_json`. The file-generating concept also needs `extension`, optionally `encoding` \u002F `filename` \u002F `filePath` \u002F `layout` \u002F `contextObjects`.\n3. Fill the `textGenBlock` body — a `StatementList` of `append`s, `indent buffer`, `with indent { ... }`, and standard BaseLanguage control flow. See `references\u002Fstatements-and-appends.md` for the part vocabulary and `references\u002Fjson-blueprints.md` for AST shapes.\n4. Push formatting heuristics (\"should this go on a new line?\") into the behavior aspect and call them back from textgen (`node.hasNewLineAfter()` pattern). See `references\u002Fdelegating-to-behavior.md`.\n5. For large-file languages (imports area, headers, shared state), declare a `TextUnitLayout`, a `UnitContextDeclaration` in the base `LanguageTextGenDeclaration`, and per-concept `UnitContextObject`s. See `references\u002Flayout-and-context-objects.md`.\n6. Validate with `mps_mcp_check_root_node_problems`, rebuild the language module, regenerate any consumer, and inspect the produced text.\n\n## TextGen vs. Generator\n\n| Aspect | Role |\n|---|---|\n| Generator | Model → Model (typed AST transformation) |\n| TextGen | Model → Text (final serialisation) |\n\nA custom language usually has both: a generator rewrites into BaseLanguage + runtime API, and BaseLanguage's TextGen emits `.java`. Write your own TextGen only if you target text directly (as `jetbrains.mps.core.xml` does).\n\n## Related Skills\n\n- `mps-aspect-generator` — model-to-model step that usually precedes TextGen; emits the AST you serialise.\n- `mps-aspect-behavior` — host for layout-heuristic helper methods called from textgen bodies.\n- `mps-model-manipulation` — BaseLanguage + smodel + collections used inside textgen bodies (`StatementList`, `DotExpression`, `SLinkAccess`, `SLinkListAccess`, `StaticMethodCall`).\n- `mps-quotations` — anti-quotations may appear inside `Quotation`s used as `${...}` expression values.\n- `mps-aspect-structure-concepts` — when introducing the concepts a textgen will serialise.\n\n## Reference Index\n\n- Open `references\u002Fconcept-textgen-root.md` when adding or editing a `ConceptTextGenDeclaration` — slot purposes (`extension`, `encoding`, `filename`, `filePath`, `layout`, `contextObjects`, `textGenBlock`), the editor shorthand, and what each child holds.\n- Open `references\u002Fstatements-and-appends.md` when writing the body — `AppendOperation` and its part vocabulary (`ConstantStringAppendPart`, `NodeAppendPart`, `CollectionAppendPart`, `NewLineAppendPart`), the `$list{... with sep}` form, `BinaryWriteOperation` (`write`), `FoundErrorOperation` (`found error`), control flow, and the smodel\u002Fbehavior accessors usable inside a body.\n- Open `references\u002Findentation-model.md` when indentation is wrong — the depth-counter mental model, rules of thumb (always pair `\\n` with `indent buffer`, prefer `with indent { ... }`, use `withIndent` flag for one-shot dispatch), and worked examples from `IfStatement_TextGen`, `BlockStatement_TextGen`, and `ClassConcept_TextGen`.\n- Open `references\u002Flayout-and-context-objects.md` when emitting multi-region files (headers, imports, body) or threading per-generation state — `TextUnitLayout` with `append to AREA { ... }`, `LanguageTextGenDeclaration`, `UnitContextDeclaration` types, and per-concept `UnitContextObject` bindings (the imports-set pattern). Also covers attribute dispatch order (reverse containment) and `${attributed node}`.\n- Open `references\u002Fdispatch-and-base-component.md` for concept-exact dispatch — why an extending concept needs its own (possibly empty) `ConceptTextGenDeclaration`, and how the base `LanguageTextGenDeclaration` exposes reusable `OperationDeclaration`s \u002F `UtilityMethodDeclaration`s \u002F `UnitContextDeclaration`s; inheriting between language base components via `extends`.\n- Open `references\u002Fdelegating-to-behavior.md` when textgen bodies grow tangled with formatting heuristics — the xml pattern of moving `hasNewLineAfter` \u002F `isMultiline` \u002F `onNewLine` into behavior and calling them from textgen, plus utility classes (`XmlCharEscape`) for escaping\u002Fformatting.\n- Open `references\u002Fjson-blueprints.md` when inserting nodes via MCP — full validated AST shapes for each statement\u002Fpart (`AppendOperation` with literal\u002Fexpression\u002Flist parts, `WithIndentOperation`, `IncreaseDepthOperation`\u002F`DecreaseDepthOperation`, `NodeAppendPart` with `withIndent`), the minimal file-generating-concept skeleton, layout\u002Fcontext skeletons, and the full validated concept reference (FQNs, concept refs, child roles).\n- Open `references\u002Fcommon-failures.md` when output is missing, indentation is broken, file extension is wrong, special characters appear unescaped, subclasses emit nothing, imports leak inline, attributes are ignored, or `write` and `append` collide.\n",{"data":39,"body":41},{"name":4,"description":6,"type":40},"reference",{"type":42,"children":43},"root",[44,53,113,201,208,533,539,880,886,939,959,965,1070,1076],{"type":45,"tag":46,"props":47,"children":49},"element","h1",{"id":48},"mps-textgen-aspect",[50],{"type":51,"value":52},"text","MPS TextGen Aspect",{"type":45,"tag":54,"props":55,"children":56},"p",{},[57,63,65,72,74,80,82,88,90,96,98,104,105,111],{"type":45,"tag":58,"props":59,"children":60},"strong",{},[61],{"type":51,"value":62},"TextGen",{"type":51,"value":64}," turns a model (usually the output of generation) into plain text files. It is how BaseLanguage becomes ",{"type":45,"tag":66,"props":67,"children":69},"code",{"className":68},[],[70],{"type":51,"value":71},".java",{"type":51,"value":73}," on disk, and how any text-targeting language serialises its models. Lives in ",{"type":45,"tag":66,"props":75,"children":77},{"className":76},[],[78],{"type":51,"value":79},"\u003Clang>\u002FlanguageModels\u002FtextGen.mps",{"type":51,"value":81},", language ",{"type":45,"tag":66,"props":83,"children":85},{"className":84},[],[86],{"type":51,"value":87},"jetbrains.mps.lang.textGen",{"type":51,"value":89},". Rule bodies are BaseLanguage + smodel + textgen-specific statements (",{"type":45,"tag":66,"props":91,"children":93},{"className":92},[],[94],{"type":51,"value":95},"append",{"type":51,"value":97},", ",{"type":45,"tag":66,"props":99,"children":101},{"className":100},[],[102],{"type":51,"value":103},"indent buffer",{"type":51,"value":97},{"type":45,"tag":66,"props":106,"children":108},{"className":107},[],[109],{"type":51,"value":110},"with indent",{"type":51,"value":112},").",{"type":45,"tag":54,"props":114,"children":115},{},[116,121,123,129,131,137,139,145,147,153,155,162,164,169,170,176,178,184,186,191,193,199],{"type":45,"tag":58,"props":117,"children":118},{},[119],{"type":51,"value":120},"Prerequisite for any insert:",{"type":51,"value":122}," the textGen model must exist (",{"type":45,"tag":66,"props":124,"children":126},{"className":125},[],[127],{"type":51,"value":128},"mps_mcp_create_model",{"type":51,"value":130}," with ",{"type":45,"tag":66,"props":132,"children":134},{"className":133},[],[135],{"type":51,"value":136},"modelName: \"\u003Clang>.textGen\"",{"type":51,"value":138}," — aspect ID ",{"type":45,"tag":66,"props":140,"children":142},{"className":141},[],[143],{"type":51,"value":144},"textGen",{"type":51,"value":146},", case-sensitive, no ",{"type":45,"tag":66,"props":148,"children":150},{"className":149},[],[151],{"type":51,"value":152},"@",{"type":51,"value":154}," suffix; see ",{"type":45,"tag":156,"props":157,"children":159},"a",{"href":158},"..\u002Fmps-mcp-workflow\u002Freferences\u002Faspect-model-stereotypes.md",[160],{"type":51,"value":161},"aspect-model-stereotypes.md",{"type":51,"value":163},") and must import ",{"type":45,"tag":66,"props":165,"children":167},{"className":166},[],[168],{"type":51,"value":87},{"type":51,"value":97},{"type":45,"tag":66,"props":171,"children":173},{"className":172},[],[174],{"type":51,"value":175},"jetbrains.mps.baseLanguage",{"type":51,"value":177},", and ",{"type":45,"tag":66,"props":179,"children":181},{"className":180},[],[182],{"type":51,"value":183},"jetbrains.mps.lang.smodel",{"type":51,"value":185}," as used languages ",{"type":45,"tag":58,"props":187,"children":188},{},[189],{"type":51,"value":190},"before",{"type":51,"value":192}," the first ",{"type":45,"tag":66,"props":194,"children":196},{"className":195},[],[197],{"type":51,"value":198},"mps_mcp_insert_root_node_from_json",{"type":51,"value":200},". Missing any of these three causes node inserts to fail with unresolved-concept errors. See step 1 of the Common-Path Workflow.",{"type":45,"tag":202,"props":203,"children":205},"h2",{"id":204},"critical-directives",[206],{"type":51,"value":207},"Critical Directives",{"type":45,"tag":209,"props":210,"children":211},"ul",{},[212,264,289,315,393,421,426,459,493,520],{"type":45,"tag":213,"props":214,"children":215},"li",{},[216,218,224,226,231,233,239,241,247,248,254,256,262],{"type":51,"value":217},"One ",{"type":45,"tag":66,"props":219,"children":221},{"className":220},[],[222],{"type":51,"value":223},"ConceptTextGenDeclaration",{"type":51,"value":225}," root per concept you want to serialise. Only the ",{"type":45,"tag":58,"props":227,"children":228},{},[229],{"type":51,"value":230},"file-generating root concept",{"type":51,"value":232}," needs ",{"type":45,"tag":66,"props":234,"children":236},{"className":235},[],[237],{"type":51,"value":238},"extension",{"type":51,"value":240}," \u002F ",{"type":45,"tag":66,"props":242,"children":244},{"className":243},[],[245],{"type":51,"value":246},"filename",{"type":51,"value":240},{"type":45,"tag":66,"props":249,"children":251},{"className":250},[],[252],{"type":51,"value":253},"encoding",{"type":51,"value":255},"; structural concepts inside the file need only ",{"type":45,"tag":66,"props":257,"children":259},{"className":258},[],[260],{"type":51,"value":261},"textGenBlock",{"type":51,"value":263},".",{"type":45,"tag":213,"props":265,"children":266},{},[267,272,274,279,281,287],{"type":45,"tag":66,"props":268,"children":270},{"className":269},[],[271],{"type":51,"value":238},{"type":51,"value":273}," is a ",{"type":45,"tag":58,"props":275,"children":276},{},[277],{"type":51,"value":278},"function body returning a string",{"type":51,"value":280},", not a literal property. It must ",{"type":45,"tag":66,"props":282,"children":284},{"className":283},[],[285],{"type":51,"value":286},"return",{"type":51,"value":288}," a string.",{"type":45,"tag":213,"props":290,"children":291},{},[292,294,299,301,306,308,314],{"type":51,"value":293},"TextGen dispatch is ",{"type":45,"tag":58,"props":295,"children":296},{},[297],{"type":51,"value":298},"concept-exact, not polymorphic",{"type":51,"value":300},". An extending concept that wants the parent's serialisation must declare its own ",{"type":45,"tag":66,"props":302,"children":304},{"className":303},[],[305],{"type":51,"value":223},{"type":51,"value":307}," (even an empty one) — or its output will be silently missing. See ",{"type":45,"tag":66,"props":309,"children":311},{"className":310},[],[312],{"type":51,"value":313},"references\u002Fdispatch-and-base-component.md",{"type":51,"value":263},{"type":45,"tag":213,"props":316,"children":317},{},[318,320,325,326,332,333,339,341,347,349,355,357,369,371,377,378,384,386,392],{"type":51,"value":319},"The indentation buffer is a per-output-file depth counter. ",{"type":45,"tag":66,"props":321,"children":323},{"className":322},[],[324],{"type":51,"value":110},{"type":51,"value":240},{"type":45,"tag":66,"props":327,"children":329},{"className":328},[],[330],{"type":51,"value":331},"increase depth",{"type":51,"value":240},{"type":45,"tag":66,"props":334,"children":336},{"className":335},[],[337],{"type":51,"value":338},"decrease depth",{"type":51,"value":340}," and the ",{"type":45,"tag":66,"props":342,"children":344},{"className":343},[],[345],{"type":51,"value":346},"withIndent",{"type":51,"value":348}," flag on ",{"type":45,"tag":66,"props":350,"children":352},{"className":351},[],[353],{"type":51,"value":354},"NodeAppendPart",{"type":51,"value":356}," only mutate the counter — ",{"type":45,"tag":58,"props":358,"children":359},{},[360,362,367],{"type":51,"value":361},"whitespace is emitted only when ",{"type":45,"tag":66,"props":363,"children":365},{"className":364},[],[366],{"type":51,"value":103},{"type":51,"value":368}," is called",{"type":51,"value":370},". Always pair ",{"type":45,"tag":66,"props":372,"children":374},{"className":373},[],[375],{"type":51,"value":376},"append \\n ;",{"type":51,"value":130},{"type":45,"tag":66,"props":379,"children":381},{"className":380},[],[382],{"type":51,"value":383},"indent buffer ;",{"type":51,"value":385}," on the next line that should be indented. See ",{"type":45,"tag":66,"props":387,"children":389},{"className":388},[],[390],{"type":51,"value":391},"references\u002Findentation-model.md",{"type":51,"value":263},{"type":45,"tag":213,"props":394,"children":395},{},[396,398,404,406,412,414,419],{"type":51,"value":397},"Prefer ",{"type":45,"tag":66,"props":399,"children":401},{"className":400},[],[402],{"type":51,"value":403},"with indent { ... }",{"type":51,"value":405}," over paired ",{"type":45,"tag":66,"props":407,"children":409},{"className":408},[],[410],{"type":51,"value":411},"increase depth ; … ; decrease depth ;",{"type":51,"value":413}," — the block form cannot leak depth on an early ",{"type":45,"tag":66,"props":415,"children":417},{"className":416},[],[418],{"type":51,"value":286},{"type":51,"value":420}," or exception. Use the paired form only when the scope is not a block.",{"type":45,"tag":213,"props":422,"children":423},{},[424],{"type":51,"value":425},"Use TextGen only when the final artifact is text. If your pipeline ends in a model-to-model transformation targeting another MPS language (e.g. BaseLanguage), you don't need TextGen — that language's own TextGen handles the final step.",{"type":45,"tag":213,"props":427,"children":428},{},[429,435,437,443,445,450,452,457],{"type":45,"tag":66,"props":430,"children":432},{"className":431},[],[433],{"type":51,"value":434},"BinaryWriteOperation",{"type":51,"value":436}," (",{"type":45,"tag":66,"props":438,"children":440},{"className":439},[],[441],{"type":51,"value":442},"write",{"type":51,"value":444},") cannot be mixed with text ",{"type":45,"tag":66,"props":446,"children":448},{"className":447},[],[449],{"type":51,"value":95},{"type":51,"value":451},"s in the same ",{"type":45,"tag":66,"props":453,"children":455},{"className":454},[],[456],{"type":51,"value":223},{"type":51,"value":458},". A rule emits either text or bytes, not both.",{"type":45,"tag":213,"props":460,"children":461},{},[462,464,470,472,477,479,484,486,492],{"type":51,"value":463},"The older ",{"type":45,"tag":66,"props":465,"children":467},{"className":466},[],[468],{"type":51,"value":469},"$ref{node.reference\u003Ctarget>}",{"type":51,"value":471}," syntax is ",{"type":45,"tag":58,"props":473,"children":474},{},[475],{"type":51,"value":476},"deprecated",{"type":51,"value":478},". Use a ",{"type":45,"tag":66,"props":480,"children":482},{"className":481},[],[483],{"type":51,"value":354},{"type":51,"value":485}," over a resolved node (or over ",{"type":45,"tag":66,"props":487,"children":489},{"className":488},[],[490],{"type":51,"value":491},".name",{"type":51,"value":112},{"type":45,"tag":213,"props":494,"children":495},{},[496,498,503,504,510,512,518],{"type":51,"value":497},"Edit textGen models through MPS MCP tools (",{"type":45,"tag":66,"props":499,"children":501},{"className":500},[],[502],{"type":51,"value":198},{"type":51,"value":97},{"type":45,"tag":66,"props":505,"children":507},{"className":506},[],[508],{"type":51,"value":509},"mps_mcp_update_node",{"type":51,"value":511},"). Do not hand-edit ",{"type":45,"tag":66,"props":513,"children":515},{"className":514},[],[516],{"type":51,"value":517},".mps",{"type":51,"value":519}," files.",{"type":45,"tag":213,"props":521,"children":522},{},[523,525,531],{"type":51,"value":524},"After edits run ",{"type":45,"tag":66,"props":526,"children":528},{"className":527},[],[529],{"type":51,"value":530},"mps_mcp_check_root_node_problems",{"type":51,"value":532}," and rebuild the language; regenerate consumers.",{"type":45,"tag":202,"props":534,"children":536},{"id":535},"common-path-workflow",[537],{"type":51,"value":538},"Common-Path Workflow",{"type":45,"tag":540,"props":541,"children":542},"ol",{},[543,690,749,804,824,868],{"type":45,"tag":213,"props":544,"children":545},{},[546,548,553,555,560,561,566,568,573,575,580,582,587,589,594,596,601,602,608,610,616,618,623,624,630,631,637,639,644,645,651,652,658,659,665,667,673,675,681,683,688],{"type":51,"value":547},"Create a ",{"type":45,"tag":66,"props":549,"children":551},{"className":550},[],[552],{"type":51,"value":144},{"type":51,"value":554}," model (",{"type":45,"tag":66,"props":556,"children":558},{"className":557},[],[559],{"type":51,"value":128},{"type":51,"value":130},{"type":45,"tag":66,"props":562,"children":564},{"className":563},[],[565],{"type":51,"value":136},{"type":51,"value":567},"; aspect ID is ",{"type":45,"tag":66,"props":569,"children":571},{"className":570},[],[572],{"type":51,"value":144},{"type":51,"value":574}," — case-sensitive, no ",{"type":45,"tag":66,"props":576,"children":578},{"className":577},[],[579],{"type":51,"value":152},{"type":51,"value":581}," suffix) if absent, then ",{"type":45,"tag":58,"props":583,"children":584},{},[585],{"type":51,"value":586},"before any insert",{"type":51,"value":588}," add the three required used languages: ",{"type":45,"tag":66,"props":590,"children":592},{"className":591},[],[593],{"type":51,"value":87},{"type":51,"value":595}," (for ",{"type":45,"tag":66,"props":597,"children":599},{"className":598},[],[600],{"type":51,"value":223},{"type":51,"value":97},{"type":45,"tag":66,"props":603,"children":605},{"className":604},[],[606],{"type":51,"value":607},"AppendOperation",{"type":51,"value":609},", parts, ",{"type":45,"tag":66,"props":611,"children":613},{"className":612},[],[614],{"type":51,"value":615},"NodeParameter",{"type":51,"value":617},", etc.), ",{"type":45,"tag":66,"props":619,"children":621},{"className":620},[],[622],{"type":51,"value":175},{"type":51,"value":595},{"type":45,"tag":66,"props":625,"children":627},{"className":626},[],[628],{"type":51,"value":629},"StatementList",{"type":51,"value":97},{"type":45,"tag":66,"props":632,"children":634},{"className":633},[],[635],{"type":51,"value":636},"DotExpression",{"type":51,"value":638},", control flow, returns), and ",{"type":45,"tag":66,"props":640,"children":642},{"className":641},[],[643],{"type":51,"value":183},{"type":51,"value":595},{"type":45,"tag":66,"props":646,"children":648},{"className":647},[],[649],{"type":51,"value":650},"SPropertyAccess",{"type":51,"value":97},{"type":45,"tag":66,"props":653,"children":655},{"className":654},[],[656],{"type":51,"value":657},"SLinkAccess",{"type":51,"value":97},{"type":45,"tag":66,"props":660,"children":662},{"className":661},[],[663],{"type":51,"value":664},"SLinkListAccess",{"type":51,"value":666}," used to read node data). Also add the structure language whose concepts you serialise (referenced by ",{"type":45,"tag":66,"props":668,"children":670},{"className":669},[],[671],{"type":51,"value":672},"conceptDeclaration",{"type":51,"value":674}," and inside smodel accesses), and ",{"type":45,"tag":66,"props":676,"children":678},{"className":677},[],[679],{"type":51,"value":680},"jetbrains.mps.baseLanguage.collections",{"type":51,"value":682}," if you use maps\u002Flists. Skipping any of the three core languages causes ",{"type":45,"tag":66,"props":684,"children":686},{"className":685},[],[687],{"type":51,"value":198},{"type":51,"value":689}," to fail with unresolved-concept errors — don't add them piecemeal after a failure.",{"type":45,"tag":213,"props":691,"children":692},{},[693,695,700,702,707,709,714,716,721,722,727,728,734,735,741,742,748],{"type":51,"value":694},"For each concept to serialise, insert a ",{"type":45,"tag":66,"props":696,"children":698},{"className":697},[],[699],{"type":51,"value":223},{"type":51,"value":701}," root via ",{"type":45,"tag":66,"props":703,"children":705},{"className":704},[],[706],{"type":51,"value":198},{"type":51,"value":708},". The file-generating concept also needs ",{"type":45,"tag":66,"props":710,"children":712},{"className":711},[],[713],{"type":51,"value":238},{"type":51,"value":715},", optionally ",{"type":45,"tag":66,"props":717,"children":719},{"className":718},[],[720],{"type":51,"value":253},{"type":51,"value":240},{"type":45,"tag":66,"props":723,"children":725},{"className":724},[],[726],{"type":51,"value":246},{"type":51,"value":240},{"type":45,"tag":66,"props":729,"children":731},{"className":730},[],[732],{"type":51,"value":733},"filePath",{"type":51,"value":240},{"type":45,"tag":66,"props":736,"children":738},{"className":737},[],[739],{"type":51,"value":740},"layout",{"type":51,"value":240},{"type":45,"tag":66,"props":743,"children":745},{"className":744},[],[746],{"type":51,"value":747},"contextObjects",{"type":51,"value":263},{"type":45,"tag":213,"props":750,"children":751},{},[752,754,759,761,766,768,773,775,780,781,786,788,794,796,802],{"type":51,"value":753},"Fill the ",{"type":45,"tag":66,"props":755,"children":757},{"className":756},[],[758],{"type":51,"value":261},{"type":51,"value":760}," body — a ",{"type":45,"tag":66,"props":762,"children":764},{"className":763},[],[765],{"type":51,"value":629},{"type":51,"value":767}," of ",{"type":45,"tag":66,"props":769,"children":771},{"className":770},[],[772],{"type":51,"value":95},{"type":51,"value":774},"s, ",{"type":45,"tag":66,"props":776,"children":778},{"className":777},[],[779],{"type":51,"value":103},{"type":51,"value":97},{"type":45,"tag":66,"props":782,"children":784},{"className":783},[],[785],{"type":51,"value":403},{"type":51,"value":787},", and standard BaseLanguage control flow. See ",{"type":45,"tag":66,"props":789,"children":791},{"className":790},[],[792],{"type":51,"value":793},"references\u002Fstatements-and-appends.md",{"type":51,"value":795}," for the part vocabulary and ",{"type":45,"tag":66,"props":797,"children":799},{"className":798},[],[800],{"type":51,"value":801},"references\u002Fjson-blueprints.md",{"type":51,"value":803}," for AST shapes.",{"type":45,"tag":213,"props":805,"children":806},{},[807,809,815,817,823],{"type":51,"value":808},"Push formatting heuristics (\"should this go on a new line?\") into the behavior aspect and call them back from textgen (",{"type":45,"tag":66,"props":810,"children":812},{"className":811},[],[813],{"type":51,"value":814},"node.hasNewLineAfter()",{"type":51,"value":816}," pattern). See ",{"type":45,"tag":66,"props":818,"children":820},{"className":819},[],[821],{"type":51,"value":822},"references\u002Fdelegating-to-behavior.md",{"type":51,"value":263},{"type":45,"tag":213,"props":825,"children":826},{},[827,829,835,837,843,845,851,853,859,861,867],{"type":51,"value":828},"For large-file languages (imports area, headers, shared state), declare a ",{"type":45,"tag":66,"props":830,"children":832},{"className":831},[],[833],{"type":51,"value":834},"TextUnitLayout",{"type":51,"value":836},", a ",{"type":45,"tag":66,"props":838,"children":840},{"className":839},[],[841],{"type":51,"value":842},"UnitContextDeclaration",{"type":51,"value":844}," in the base ",{"type":45,"tag":66,"props":846,"children":848},{"className":847},[],[849],{"type":51,"value":850},"LanguageTextGenDeclaration",{"type":51,"value":852},", and per-concept ",{"type":45,"tag":66,"props":854,"children":856},{"className":855},[],[857],{"type":51,"value":858},"UnitContextObject",{"type":51,"value":860},"s. See ",{"type":45,"tag":66,"props":862,"children":864},{"className":863},[],[865],{"type":51,"value":866},"references\u002Flayout-and-context-objects.md",{"type":51,"value":263},{"type":45,"tag":213,"props":869,"children":870},{},[871,873,878],{"type":51,"value":872},"Validate with ",{"type":45,"tag":66,"props":874,"children":876},{"className":875},[],[877],{"type":51,"value":530},{"type":51,"value":879},", rebuild the language module, regenerate any consumer, and inspect the produced text.",{"type":45,"tag":202,"props":881,"children":883},{"id":882},"textgen-vs-generator",[884],{"type":51,"value":885},"TextGen vs. Generator",{"type":45,"tag":887,"props":888,"children":889},"table",{},[890,909],{"type":45,"tag":891,"props":892,"children":893},"thead",{},[894],{"type":45,"tag":895,"props":896,"children":897},"tr",{},[898,904],{"type":45,"tag":899,"props":900,"children":901},"th",{},[902],{"type":51,"value":903},"Aspect",{"type":45,"tag":899,"props":905,"children":906},{},[907],{"type":51,"value":908},"Role",{"type":45,"tag":910,"props":911,"children":912},"tbody",{},[913,927],{"type":45,"tag":895,"props":914,"children":915},{},[916,922],{"type":45,"tag":917,"props":918,"children":919},"td",{},[920],{"type":51,"value":921},"Generator",{"type":45,"tag":917,"props":923,"children":924},{},[925],{"type":51,"value":926},"Model → Model (typed AST transformation)",{"type":45,"tag":895,"props":928,"children":929},{},[930,934],{"type":45,"tag":917,"props":931,"children":932},{},[933],{"type":51,"value":62},{"type":45,"tag":917,"props":935,"children":936},{},[937],{"type":51,"value":938},"Model → Text (final serialisation)",{"type":45,"tag":54,"props":940,"children":941},{},[942,944,949,951,957],{"type":51,"value":943},"A custom language usually has both: a generator rewrites into BaseLanguage + runtime API, and BaseLanguage's TextGen emits ",{"type":45,"tag":66,"props":945,"children":947},{"className":946},[],[948],{"type":51,"value":71},{"type":51,"value":950},". Write your own TextGen only if you target text directly (as ",{"type":45,"tag":66,"props":952,"children":954},{"className":953},[],[955],{"type":51,"value":956},"jetbrains.mps.core.xml",{"type":51,"value":958}," does).",{"type":45,"tag":202,"props":960,"children":962},{"id":961},"related-skills",[963],{"type":51,"value":964},"Related Skills",{"type":45,"tag":209,"props":966,"children":967},{},[968,979,990,1032,1059],{"type":45,"tag":213,"props":969,"children":970},{},[971,977],{"type":45,"tag":66,"props":972,"children":974},{"className":973},[],[975],{"type":51,"value":976},"mps-aspect-generator",{"type":51,"value":978}," — model-to-model step that usually precedes TextGen; emits the AST you serialise.",{"type":45,"tag":213,"props":980,"children":981},{},[982,988],{"type":45,"tag":66,"props":983,"children":985},{"className":984},[],[986],{"type":51,"value":987},"mps-aspect-behavior",{"type":51,"value":989}," — host for layout-heuristic helper methods called from textgen bodies.",{"type":45,"tag":213,"props":991,"children":992},{},[993,999,1001,1006,1007,1012,1013,1018,1019,1024,1025,1031],{"type":45,"tag":66,"props":994,"children":996},{"className":995},[],[997],{"type":51,"value":998},"mps-model-manipulation",{"type":51,"value":1000}," — BaseLanguage + smodel + collections used inside textgen bodies (",{"type":45,"tag":66,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":51,"value":629},{"type":51,"value":97},{"type":45,"tag":66,"props":1008,"children":1010},{"className":1009},[],[1011],{"type":51,"value":636},{"type":51,"value":97},{"type":45,"tag":66,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":51,"value":657},{"type":51,"value":97},{"type":45,"tag":66,"props":1020,"children":1022},{"className":1021},[],[1023],{"type":51,"value":664},{"type":51,"value":97},{"type":45,"tag":66,"props":1026,"children":1028},{"className":1027},[],[1029],{"type":51,"value":1030},"StaticMethodCall",{"type":51,"value":112},{"type":45,"tag":213,"props":1033,"children":1034},{},[1035,1041,1043,1049,1051,1057],{"type":45,"tag":66,"props":1036,"children":1038},{"className":1037},[],[1039],{"type":51,"value":1040},"mps-quotations",{"type":51,"value":1042}," — anti-quotations may appear inside ",{"type":45,"tag":66,"props":1044,"children":1046},{"className":1045},[],[1047],{"type":51,"value":1048},"Quotation",{"type":51,"value":1050},"s used as ",{"type":45,"tag":66,"props":1052,"children":1054},{"className":1053},[],[1055],{"type":51,"value":1056},"${...}",{"type":51,"value":1058}," expression values.",{"type":45,"tag":213,"props":1060,"children":1061},{},[1062,1068],{"type":45,"tag":66,"props":1063,"children":1065},{"className":1064},[],[1066],{"type":51,"value":1067},"mps-aspect-structure-concepts",{"type":51,"value":1069}," — when introducing the concepts a textgen will serialise.",{"type":45,"tag":202,"props":1071,"children":1073},{"id":1072},"reference-index",[1074],{"type":51,"value":1075},"Reference Index",{"type":45,"tag":209,"props":1077,"children":1078},{},[1079,1142,1224,1284,1335,1389,1430,1483],{"type":45,"tag":213,"props":1080,"children":1081},{},[1082,1084,1090,1092,1097,1099,1104,1105,1110,1111,1116,1117,1122,1123,1128,1129,1134,1135,1140],{"type":51,"value":1083},"Open ",{"type":45,"tag":66,"props":1085,"children":1087},{"className":1086},[],[1088],{"type":51,"value":1089},"references\u002Fconcept-textgen-root.md",{"type":51,"value":1091}," when adding or editing a ",{"type":45,"tag":66,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":51,"value":223},{"type":51,"value":1098}," — slot purposes (",{"type":45,"tag":66,"props":1100,"children":1102},{"className":1101},[],[1103],{"type":51,"value":238},{"type":51,"value":97},{"type":45,"tag":66,"props":1106,"children":1108},{"className":1107},[],[1109],{"type":51,"value":253},{"type":51,"value":97},{"type":45,"tag":66,"props":1112,"children":1114},{"className":1113},[],[1115],{"type":51,"value":246},{"type":51,"value":97},{"type":45,"tag":66,"props":1118,"children":1120},{"className":1119},[],[1121],{"type":51,"value":733},{"type":51,"value":97},{"type":45,"tag":66,"props":1124,"children":1126},{"className":1125},[],[1127],{"type":51,"value":740},{"type":51,"value":97},{"type":45,"tag":66,"props":1130,"children":1132},{"className":1131},[],[1133],{"type":51,"value":747},{"type":51,"value":97},{"type":45,"tag":66,"props":1136,"children":1138},{"className":1137},[],[1139],{"type":51,"value":261},{"type":51,"value":1141},"), the editor shorthand, and what each child holds.",{"type":45,"tag":213,"props":1143,"children":1144},{},[1145,1146,1151,1153,1158,1160,1166,1167,1172,1173,1179,1180,1186,1188,1194,1196,1201,1202,1207,1209,1215,1216,1222],{"type":51,"value":1083},{"type":45,"tag":66,"props":1147,"children":1149},{"className":1148},[],[1150],{"type":51,"value":793},{"type":51,"value":1152}," when writing the body — ",{"type":45,"tag":66,"props":1154,"children":1156},{"className":1155},[],[1157],{"type":51,"value":607},{"type":51,"value":1159}," and its part vocabulary (",{"type":45,"tag":66,"props":1161,"children":1163},{"className":1162},[],[1164],{"type":51,"value":1165},"ConstantStringAppendPart",{"type":51,"value":97},{"type":45,"tag":66,"props":1168,"children":1170},{"className":1169},[],[1171],{"type":51,"value":354},{"type":51,"value":97},{"type":45,"tag":66,"props":1174,"children":1176},{"className":1175},[],[1177],{"type":51,"value":1178},"CollectionAppendPart",{"type":51,"value":97},{"type":45,"tag":66,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":51,"value":1185},"NewLineAppendPart",{"type":51,"value":1187},"), the ",{"type":45,"tag":66,"props":1189,"children":1191},{"className":1190},[],[1192],{"type":51,"value":1193},"$list{... with sep}",{"type":51,"value":1195}," form, ",{"type":45,"tag":66,"props":1197,"children":1199},{"className":1198},[],[1200],{"type":51,"value":434},{"type":51,"value":436},{"type":45,"tag":66,"props":1203,"children":1205},{"className":1204},[],[1206],{"type":51,"value":442},{"type":51,"value":1208},"), ",{"type":45,"tag":66,"props":1210,"children":1212},{"className":1211},[],[1213],{"type":51,"value":1214},"FoundErrorOperation",{"type":51,"value":436},{"type":45,"tag":66,"props":1217,"children":1219},{"className":1218},[],[1220],{"type":51,"value":1221},"found error",{"type":51,"value":1223},"), control flow, and the smodel\u002Fbehavior accessors usable inside a body.",{"type":45,"tag":213,"props":1225,"children":1226},{},[1227,1228,1233,1235,1241,1242,1247,1249,1254,1256,1261,1263,1269,1270,1276,1277,1283],{"type":51,"value":1083},{"type":45,"tag":66,"props":1229,"children":1231},{"className":1230},[],[1232],{"type":51,"value":391},{"type":51,"value":1234}," when indentation is wrong — the depth-counter mental model, rules of thumb (always pair ",{"type":45,"tag":66,"props":1236,"children":1238},{"className":1237},[],[1239],{"type":51,"value":1240},"\\n",{"type":51,"value":130},{"type":45,"tag":66,"props":1243,"children":1245},{"className":1244},[],[1246],{"type":51,"value":103},{"type":51,"value":1248},", prefer ",{"type":45,"tag":66,"props":1250,"children":1252},{"className":1251},[],[1253],{"type":51,"value":403},{"type":51,"value":1255},", use ",{"type":45,"tag":66,"props":1257,"children":1259},{"className":1258},[],[1260],{"type":51,"value":346},{"type":51,"value":1262}," flag for one-shot dispatch), and worked examples from ",{"type":45,"tag":66,"props":1264,"children":1266},{"className":1265},[],[1267],{"type":51,"value":1268},"IfStatement_TextGen",{"type":51,"value":97},{"type":45,"tag":66,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":51,"value":1275},"BlockStatement_TextGen",{"type":51,"value":177},{"type":45,"tag":66,"props":1278,"children":1280},{"className":1279},[],[1281],{"type":51,"value":1282},"ClassConcept_TextGen",{"type":51,"value":263},{"type":45,"tag":213,"props":1285,"children":1286},{},[1287,1288,1293,1295,1300,1301,1307,1308,1313,1314,1319,1321,1326,1328,1334],{"type":51,"value":1083},{"type":45,"tag":66,"props":1289,"children":1291},{"className":1290},[],[1292],{"type":51,"value":866},{"type":51,"value":1294}," when emitting multi-region files (headers, imports, body) or threading per-generation state — ",{"type":45,"tag":66,"props":1296,"children":1298},{"className":1297},[],[1299],{"type":51,"value":834},{"type":51,"value":130},{"type":45,"tag":66,"props":1302,"children":1304},{"className":1303},[],[1305],{"type":51,"value":1306},"append to AREA { ... }",{"type":51,"value":97},{"type":45,"tag":66,"props":1309,"children":1311},{"className":1310},[],[1312],{"type":51,"value":850},{"type":51,"value":97},{"type":45,"tag":66,"props":1315,"children":1317},{"className":1316},[],[1318],{"type":51,"value":842},{"type":51,"value":1320}," types, and per-concept ",{"type":45,"tag":66,"props":1322,"children":1324},{"className":1323},[],[1325],{"type":51,"value":858},{"type":51,"value":1327}," bindings (the imports-set pattern). Also covers attribute dispatch order (reverse containment) and ",{"type":45,"tag":66,"props":1329,"children":1331},{"className":1330},[],[1332],{"type":51,"value":1333},"${attributed node}",{"type":51,"value":263},{"type":45,"tag":213,"props":1336,"children":1337},{},[1338,1339,1344,1346,1351,1353,1358,1360,1366,1368,1374,1375,1380,1382,1388],{"type":51,"value":1083},{"type":45,"tag":66,"props":1340,"children":1342},{"className":1341},[],[1343],{"type":51,"value":313},{"type":51,"value":1345}," for concept-exact dispatch — why an extending concept needs its own (possibly empty) ",{"type":45,"tag":66,"props":1347,"children":1349},{"className":1348},[],[1350],{"type":51,"value":223},{"type":51,"value":1352},", and how the base ",{"type":45,"tag":66,"props":1354,"children":1356},{"className":1355},[],[1357],{"type":51,"value":850},{"type":51,"value":1359}," exposes reusable ",{"type":45,"tag":66,"props":1361,"children":1363},{"className":1362},[],[1364],{"type":51,"value":1365},"OperationDeclaration",{"type":51,"value":1367},"s \u002F ",{"type":45,"tag":66,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":51,"value":1373},"UtilityMethodDeclaration",{"type":51,"value":1367},{"type":45,"tag":66,"props":1376,"children":1378},{"className":1377},[],[1379],{"type":51,"value":842},{"type":51,"value":1381},"s; inheriting between language base components via ",{"type":45,"tag":66,"props":1383,"children":1385},{"className":1384},[],[1386],{"type":51,"value":1387},"extends",{"type":51,"value":263},{"type":45,"tag":213,"props":1390,"children":1391},{},[1392,1393,1398,1400,1406,1407,1413,1414,1420,1422,1428],{"type":51,"value":1083},{"type":45,"tag":66,"props":1394,"children":1396},{"className":1395},[],[1397],{"type":51,"value":822},{"type":51,"value":1399}," when textgen bodies grow tangled with formatting heuristics — the xml pattern of moving ",{"type":45,"tag":66,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":51,"value":1405},"hasNewLineAfter",{"type":51,"value":240},{"type":45,"tag":66,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":51,"value":1412},"isMultiline",{"type":51,"value":240},{"type":45,"tag":66,"props":1415,"children":1417},{"className":1416},[],[1418],{"type":51,"value":1419},"onNewLine",{"type":51,"value":1421}," into behavior and calling them from textgen, plus utility classes (",{"type":45,"tag":66,"props":1423,"children":1425},{"className":1424},[],[1426],{"type":51,"value":1427},"XmlCharEscape",{"type":51,"value":1429},") for escaping\u002Fformatting.",{"type":45,"tag":213,"props":1431,"children":1432},{},[1433,1434,1439,1441,1446,1448,1454,1455,1461,1463,1469,1470,1475,1476,1481],{"type":51,"value":1083},{"type":45,"tag":66,"props":1435,"children":1437},{"className":1436},[],[1438],{"type":51,"value":801},{"type":51,"value":1440}," when inserting nodes via MCP — full validated AST shapes for each statement\u002Fpart (",{"type":45,"tag":66,"props":1442,"children":1444},{"className":1443},[],[1445],{"type":51,"value":607},{"type":51,"value":1447}," with literal\u002Fexpression\u002Flist parts, ",{"type":45,"tag":66,"props":1449,"children":1451},{"className":1450},[],[1452],{"type":51,"value":1453},"WithIndentOperation",{"type":51,"value":97},{"type":45,"tag":66,"props":1456,"children":1458},{"className":1457},[],[1459],{"type":51,"value":1460},"IncreaseDepthOperation",{"type":51,"value":1462},"\u002F",{"type":45,"tag":66,"props":1464,"children":1466},{"className":1465},[],[1467],{"type":51,"value":1468},"DecreaseDepthOperation",{"type":51,"value":97},{"type":45,"tag":66,"props":1471,"children":1473},{"className":1472},[],[1474],{"type":51,"value":354},{"type":51,"value":130},{"type":45,"tag":66,"props":1477,"children":1479},{"className":1478},[],[1480],{"type":51,"value":346},{"type":51,"value":1482},"), the minimal file-generating-concept skeleton, layout\u002Fcontext skeletons, and the full validated concept reference (FQNs, concept refs, child roles).",{"type":45,"tag":213,"props":1484,"children":1485},{},[1486,1487,1493,1495,1500,1502,1507],{"type":51,"value":1083},{"type":45,"tag":66,"props":1488,"children":1490},{"className":1489},[],[1491],{"type":51,"value":1492},"references\u002Fcommon-failures.md",{"type":51,"value":1494}," when output is missing, indentation is broken, file extension is wrong, special characters appear unescaped, subclasses emit nothing, imports leak inline, attributes are ignored, or ",{"type":45,"tag":66,"props":1496,"children":1498},{"className":1497},[],[1499],{"type":51,"value":442},{"type":51,"value":1501}," and ",{"type":45,"tag":66,"props":1503,"children":1505},{"className":1504},[],[1506],{"type":51,"value":95},{"type":51,"value":1508}," collide.",{"items":1510,"total":1583},[1511,1525,1534,1542,1551,1561,1574],{"slug":1512,"name":1512,"fn":1513,"description":1514,"org":1515,"tags":1516,"stars":25,"repoUrl":26,"updatedAt":1524},"mps-aspect-accessories","configure JetBrains MPS module dependencies","Wire MPS module and model dependencies, used languages, used devkits, extended languages, runtime solutions, accessory models, and language\u002Fdependency versions. Use when adding\u002Fremoving module dependencies, importing languages or devkits into a model, declaring runtime solutions, or shipping accessory content visible to consumers without explicit import.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1517,1520,1523],{"name":1518,"slug":1519,"type":15},"Architecture","architecture",{"name":1521,"slug":1522,"type":15},"Configuration","configuration",{"name":20,"slug":21,"type":15},"2026-07-17T06:06:57.311661",{"slug":1526,"name":1526,"fn":1527,"description":1528,"org":1529,"tags":1530,"stars":25,"repoUrl":26,"updatedAt":1533},"mps-aspect-actions","define and edit MPS node factories","Use when defining or editing MPS node factories (the \"actions\" aspect) — `NodeFactories` roots, per-concept `NodeFactory` setup functions that initialize a freshly created node and optionally copy data from a replaced `sampleNode`, plus the actions aspect's `CopyPasteHandlers` and `PasteWrappers` roots. Reach for this skill when a substitution, side transform, completion replacement, or `add new initialized(...)` should preserve fields from the node it is replacing, or when defaults set in a constructor are not enough.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1531,1532],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:04:48.066901",{"slug":987,"name":987,"fn":1535,"description":1536,"org":1537,"tags":1538,"stars":25,"repoUrl":26,"updatedAt":1541},"define and edit MPS concept behavior","Use when defining or editing MPS `ConceptBehavior` — per-concept methods (non-virtual \u002F virtual \u002F abstract \u002F static \u002F virtual static), constructors, virtual dispatch (MRO), super and interface-default calls (`super\u003CInterface>.method`), overriding methods from `lang.core.behavior` interfaces such as `ScopeProvider.getScope` \u002F `INamedConcept.getName` \u002F `BaseConcept.getPresentation`, calling sibling methods (`LocalBehaviorMethodCall`) and behavior methods from other aspects via `node.method(...)`. Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fbehavior.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1539,1540],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:45:21.757084",{"slug":1543,"name":1543,"fn":1544,"description":1545,"org":1546,"tags":1547,"stars":25,"repoUrl":26,"updatedAt":1550},"mps-aspect-constraints","define JetBrains MPS language constraints","Use when defining or editing MPS language constraints — property validators \u002F setters \u002F getters, referent search scopes (imperative or inherited via `ScopeProvider.getScope`), `referentSetHandler` side effects, default-scope blocks, `canBeChild` \u002F `canBeParent` \u002F `canBeAncestor` \u002F `canBeRoot` placement rules, `defaultConcreteConcept` for abstract concepts, `set \u003Cread-only>` and `{name}` aliasing, and scope helpers (`SimpleRoleScope`, `ListScope`, `CompositeScope`, `HidingByNameScope`). Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fconstraints.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1548,1549],{"name":1518,"slug":1519,"type":15},{"name":23,"slug":24,"type":15},"2026-07-23T05:41:33.639365",{"slug":1552,"name":1552,"fn":1553,"description":1554,"org":1555,"tags":1556,"stars":25,"repoUrl":26,"updatedAt":1560},"mps-aspect-dataflow","define and debug MPS dataflow builders","Use when defining or debugging MPS dataflow builders for a concept — control\u002Fdata flow declarations that drive reachability analysis and variable-use checking. Covers DataFlowBuilderDeclaration, BuilderBlock, emit instructions (code for, jump, ifjump, label, read, write, ret, mayBeUnreachable), positions (AfterPosition, BeforePosition, LabelPosition), the jetbrains.mps.lang.dataFlow language, the NodeParameter implicit, BL+smodel usage inside builder bodies, and IBuilderMode for advanced analyses such as nullable\u002Fnon-null tracking.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1557],{"name":1558,"slug":1559,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":1562,"name":1562,"fn":1563,"description":1564,"org":1565,"tags":1566,"stars":25,"repoUrl":26,"updatedAt":1573},"mps-aspect-editor","define MPS editor layouts","Use when creating or changing MPS editor definitions — the overall workflow from scaffolding a `ConceptEditorDeclaration` through componentizing reusable `EditorComponentDeclaration`s, refining cell models and cell layouts, applying style sheets and indent-layout style items, wiring smart references, leveraging inheritance via super-concepts and interfaces, inspecting (`print_node_json`, `show_node_representation`) and validating (`check_root_node_problems`). Covers `jetbrains.mps.lang.editor` cell models (`CellModel_RefNode`\u002F`CellModel_RefNodeList`\u002F`CellModel_RefCell`\u002F`CellModel_Property`\u002F`CellModel_Constant`), layout choices, and JSON blueprints for common editor shapes. For the non-layout side (action maps, keymaps, transformation\u002Fsubstitute menus) use `mps-aspect-editor-menus-and-keymaps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1567,1570],{"name":1568,"slug":1569,"type":15},"Design","design",{"name":1571,"slug":1572,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":1575,"name":1575,"fn":1576,"description":1577,"org":1578,"tags":1579,"stars":25,"repoUrl":26,"updatedAt":1582},"mps-aspect-editor-menus-and-keymaps","author MPS editor menus and keymaps","Use when authoring the **non-layout** parts of the MPS editor aspect — what happens when the user types, presses a key, triggers completion, pastes, or invokes a context action. Covers action maps (`CellActionMapDeclaration`), cell keymaps (`CellKeyMapDeclaration`), transformation menus (`TransformationMenu_Default` \u002F `_Named` \u002F `_Contribution`), substitute menus (`SubstituteMenu_Default` \u002F `SubstituteMenu` \u002F contributions), side transforms (LEFT\u002FRIGHT), legacy cell menus, paste wrappers and copy-paste handlers (in the actions language), completion styling, reference presentation, two-step deletion, and the editor selection API. Trigger terms: `actionMap`, `keyMap`, `delete_action_id`, `transformationMenu`, `substituteMenu`, `Ctrl+Space`, `Ctrl+Alt+B`, side transform, paste wrapper, completion styling, `PasteWrappers`, `CopyPasteHandlers`. For the **layout** side (cells, layouts, style sheets) use `mps-aspect-editor` instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1580,1581],{"name":20,"slug":21,"type":15},{"name":1571,"slug":1572,"type":15},"2026-07-23T05:41:49.666535",31,{"items":1585,"total":1670},[1586,1592,1597,1602,1607,1611,1616,1621,1630,1639,1648,1661],{"slug":1512,"name":1512,"fn":1513,"description":1514,"org":1587,"tags":1588,"stars":25,"repoUrl":26,"updatedAt":1524},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1589,1590,1591],{"name":1518,"slug":1519,"type":15},{"name":1521,"slug":1522,"type":15},{"name":20,"slug":21,"type":15},{"slug":1526,"name":1526,"fn":1527,"description":1528,"org":1593,"tags":1594,"stars":25,"repoUrl":26,"updatedAt":1533},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1595,1596],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},{"slug":987,"name":987,"fn":1535,"description":1536,"org":1598,"tags":1599,"stars":25,"repoUrl":26,"updatedAt":1541},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1600,1601],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},{"slug":1543,"name":1543,"fn":1544,"description":1545,"org":1603,"tags":1604,"stars":25,"repoUrl":26,"updatedAt":1550},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1605,1606],{"name":1518,"slug":1519,"type":15},{"name":23,"slug":24,"type":15},{"slug":1552,"name":1552,"fn":1553,"description":1554,"org":1608,"tags":1609,"stars":25,"repoUrl":26,"updatedAt":1560},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1610],{"name":1558,"slug":1559,"type":15},{"slug":1562,"name":1562,"fn":1563,"description":1564,"org":1612,"tags":1613,"stars":25,"repoUrl":26,"updatedAt":1573},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1614,1615],{"name":1568,"slug":1569,"type":15},{"name":1571,"slug":1572,"type":15},{"slug":1575,"name":1575,"fn":1576,"description":1577,"org":1617,"tags":1618,"stars":25,"repoUrl":26,"updatedAt":1582},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1619,1620],{"name":20,"slug":21,"type":15},{"name":1571,"slug":1572,"type":15},{"slug":1622,"name":1622,"fn":1623,"description":1624,"org":1625,"tags":1626,"stars":25,"repoUrl":26,"updatedAt":1629},"mps-aspect-generation-plan","modify MPS generation plans","Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals\u002FConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing. Apply when working with @genplan models, the jetbrains.mps.lang.generator.plan language, attaching plans via DevKits or the Custom generation facet, or debugging cross-model mapping label resolution.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1627,1628],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:44:59.507855",{"slug":976,"name":976,"fn":1631,"description":1632,"org":1633,"tags":1634,"stars":25,"repoUrl":26,"updatedAt":1638},"define JetBrains MPS generator rules","Use when defining or modifying MPS generators — author a generator module, add or edit root\u002Freduction\u002Fweaving\u002Fpattern mapping rules, attach template macros ($COPY_SRC, $LOOP, $IF, $PROPERTY, $REF, $SWITCH, $MAP_SRC, $WEAVE, $INSERT, $LABEL, $TRACE, $VAR), wire mapping labels, build template switches, write pre\u002Fpost mapping scripts, navigate `genContext`, or debug \"rule didn't fire\", missing references, empty output, infinite reduction loops, and generated-Java compile failures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1635,1636,1637],{"name":1518,"slug":1519,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:06:58.042999",{"slug":1640,"name":1640,"fn":1641,"description":1642,"org":1643,"tags":1644,"stars":25,"repoUrl":26,"updatedAt":1647},"mps-aspect-intentions","define and edit MPS intentions","Use when defining or editing MPS intentions (the Alt+Enter context-action aspect) — adding `IntentionDeclaration` roots, parameterized or surround-with variants, description\u002FisApplicable\u002Fexecute blocks, child-filter functions, factory-initialized AST splicing, or debugging why an intention is not offered. Lives in the language's `intentions` model and uses `jetbrains.mps.lang.intentions`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1645,1646],{"name":1518,"slug":1519,"type":15},{"name":20,"slug":21,"type":15},"2026-07-23T05:41:48.692899",{"slug":1649,"name":1649,"fn":1650,"description":1651,"org":1652,"tags":1653,"stars":25,"repoUrl":26,"updatedAt":1660},"mps-aspect-migrations","author and debug MPS migration scripts","Use when authoring or debugging MPS migration scripts that upgrade user models after a language definition changes — covers jetbrains.mps.lang.migration (MigrationScript class-based, PureMigrationScript declarative, MoveConcept\u002FMoveContainmentLink\u002FMoveReferenceLink\u002FMoveProperty, ordering via OrderDependency, data exchange via putData\u002FgetData, RefactoringLog, ConceptMigrationReference) and jetbrains.mps.lang.script Enhancement Scripts (MigrationScript with MigrationScriptPart_Instance, ExtractInterfaceMigration, FactoryMigrationScriptPart, CommentMigrationScriptPart) — when a model needs version-gated upgrade, concept rename or removal, link or property rename, instance-level transformation, or composition of migration steps.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1654,1657],{"name":1655,"slug":1656,"type":15},"Debugging","debugging",{"name":1658,"slug":1659,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":1067,"name":1067,"fn":1662,"description":1663,"org":1664,"tags":1665,"stars":25,"repoUrl":26,"updatedAt":1669},"define concepts in MPS structure aspect","Define concepts, interface concepts, enumerations, and constrained data types in an MPS language's `structure` aspect. Covers smart-reference detection, alias rules, cardinality, INamedConcept usage, bulk creation, and the full `mps_mcp_alter_structure` \u002F `mps_mcp_query_structure` reference. Use when authoring or modifying a language's structure model.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1666],{"name":1667,"slug":1668,"type":15},"Data Modeling","data-modeling","2026-07-23T05:41:30.705975",188]