283 lines
11 KiB
Markdown
283 lines
11 KiB
Markdown
# Graph Report - ESPDocs (2026-08-24)
|
|
|
|
## Corpus Check
|
|
- 58 files · ~674,255 words
|
|
- Verdict: corpus is large enough that graph structure adds value.
|
|
|
|
## Summary
|
|
- 824 nodes · 1491 edges · 82 communities (58 shown, 24 thin omitted)
|
|
- Extraction: 99% EXTRACTED · 1% INFERRED · 0% AMBIGUOUS · INFERRED: 20 edges (avg confidence: 0.53)
|
|
- Token cost: 0 input · 0 output
|
|
|
|
## Graph Freshness
|
|
- Built from commit: `d5303561`
|
|
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
|
|
- Run `graphify update .` after code changes (no API cost).
|
|
|
|
## Community Hubs (Navigation)
|
|
- paged.polyfill.js
|
|
- Layout
|
|
- AtPage
|
|
- Page
|
|
- .push
|
|
- dependencies
|
|
- .replace
|
|
- .indexOf
|
|
- Sheet
|
|
- peek
|
|
- Breaks
|
|
- Queue
|
|
- allocateCursor
|
|
- ESPDocs - Documentação ESP32 em Português
|
|
- isNameStart
|
|
- Diretrizes de tema: claro e escuro
|
|
- internalMatch
|
|
- Previewer
|
|
- auditar-temas.mjs
|
|
- layout.jsx
|
|
- buildGroupMatchGraph
|
|
- getCharCode
|
|
- PinRestrictions.jsx
|
|
- eslint.config.mjs
|
|
- compilerOptions
|
|
- requireKeys
|
|
- outOfRange
|
|
- testNode
|
|
- page.jsx
|
|
- page.jsx
|
|
- esp-matter.c
|
|
- seo.js
|
|
- consumeB$1
|
|
- processStructure
|
|
- generate$2
|
|
- getVendorPrefix
|
|
- layout.jsx
|
|
- layout.jsx
|
|
- page.jsx
|
|
- page.jsx
|
|
- layout.jsx
|
|
- layout.jsx
|
|
- page.jsx
|
|
- esp-nn.c
|
|
- matchSyntax
|
|
- consumeNumber$5
|
|
- strcmp
|
|
- readSequence
|
|
- patchAtrules
|
|
- CLAUDE.md
|
|
- next.config.mjs
|
|
- postcss.config.mjs
|
|
- consumeDeclaration
|
|
- consumeRaw$4
|
|
- createParseContext
|
|
- dumpAtruleMapSyntax
|
|
- isProtoString
|
|
- getWalkersFromStructure
|
|
- isDelim
|
|
- isSelectorValid
|
|
- OverflowContentError
|
|
- RenderResult
|
|
|
|
## God Nodes (most connected - your core abstractions)
|
|
1. `AtPage` - 39 edges
|
|
2. `walk()` - 27 edges
|
|
3. `Layout` - 21 edges
|
|
4. `Page` - 18 edges
|
|
5. `Footnotes` - 18 edges
|
|
6. `Chunker` - 17 edges
|
|
7. `Counters` - 17 edges
|
|
8. `Sheet` - 16 edges
|
|
9. `createItem()` - 14 edges
|
|
10. `join()` - 14 edges
|
|
|
|
## Surprising Connections (you probably didn't know these)
|
|
- `nodeAfter()` --calls--> `nextSignificantNode()` [EXTRACTED]
|
|
public/formacoes/assets/paged.polyfill.js → public/formacoes/assets/paged.polyfill.js _Bridges community 1 → community 10_
|
|
- `sourceFragment()` --calls--> `join()` [EXTRACTED]
|
|
public/formacoes/assets/paged.polyfill.js → public/formacoes/assets/paged.polyfill.js _Bridges community 6 → community 4_
|
|
- `generateSequence()` --calls--> `join()` [EXTRACTED]
|
|
public/formacoes/assets/paged.polyfill.js → public/formacoes/assets/paged.polyfill.js _Bridges community 36 → community 4_
|
|
- `number()` --calls--> `isPostfixIeHack()` [EXTRACTED]
|
|
public/formacoes/assets/paged.polyfill.js → public/formacoes/assets/paged.polyfill.js _Bridges community 27 → community 4_
|
|
- `peek()` --calls--> `scanString()` [EXTRACTED]
|
|
public/formacoes/assets/paged.polyfill.js → public/formacoes/assets/paged.polyfill.js _Bridges community 7 → community 9_
|
|
|
|
## Import Cycles
|
|
- None detected.
|
|
|
|
## Communities (82 total, 24 thin omitted)
|
|
|
|
### Community 0 - "paged.polyfill.js"
|
|
Cohesion: 0.02
|
|
Nodes (21): NOTE: The order of the mappings is NOT guaranteed., TODO: should consume block content as Raw?, TODO: fall back to mutation observer?, TODO: not sure we should support this hack, TODO: check value is an ident, TODO: produce a node with Delim node type, NOTE: Don't check more than a first argument is an ident, rest checks are for le, TODO: this isn't working right, needs to check what is in the prelude (+13 more)
|
|
|
|
### Community 1 - "Layout"
|
|
Cohesion: 0.06
|
|
Nodes (27): breakInsideAvoidParentNode(), BreakToken, cloneNode(), elementAfter(), findElement(), findRef(), Footnotes, getBoundingClientRect() (+19 more)
|
|
|
|
### Community 2 - "AtPage"
|
|
Cohesion: 0.08
|
|
Nodes (6): append(), AtPage, createItem(), CSSValueToString(), validate(), walk()
|
|
|
|
### Community 3 - "Page"
|
|
Cohesion: 0.06
|
|
Nodes (10): CodeExample(), ConnectionsDiagram(), FILTER_CATEGORIES, type_colors, Chunker, dump(), forEachToken(), Page (+2 more)
|
|
|
|
### Community 4 - ".push"
|
|
Cohesion: 0.06
|
|
Nodes (16): collectWarning(), computeSourceURL(), Counters, isAbsolute(), join(), normalize(), number(), PageCounterIncrement (+8 more)
|
|
|
|
### Community 5 - "dependencies"
|
|
Cohesion: 0.05
|
|
Nodes (43): @emotion/react, @emotion/styled, eslint, eslint-config-next, @eslint/eslintrc, framer-motion, googleapis, lucide-react (+35 more)
|
|
|
|
### Community 6 - ".replace"
|
|
Cohesion: 0.07
|
|
Nodes (19): attr(), calc(), child(), cleanPseudoContent(), consumeFunction(), customIdent(), defer(), eqStr() (+11 more)
|
|
|
|
### Community 7 - ".indexOf"
|
|
Cohesion: 0.09
|
|
Nodes (12): ArraySet$1(), calculateSpecificity(), cleanSelector(), compareByGeneratedPositionsInflated(), generatedPositionAfter(), getArg(), MappingList$1(), relative() (+4 more)
|
|
|
|
### Community 8 - "Sheet"
|
|
Cohesion: 0.10
|
|
Nodes (6): ContentParser, Handler, Hook, invokeForType(), Lists, Sheet
|
|
|
|
### Community 9 - "peek"
|
|
Cohesion: 0.13
|
|
Nodes (20): charCode(), customPropertyName(), idSelector(), maybeMultiplied(), maybeToken(), parse$2(), peek(), readGroup() (+12 more)
|
|
|
|
### Community 10 - "Breaks"
|
|
Cohesion: 0.10
|
|
Nodes (14): Breaks, CommentsFilter, displayedElementAfter(), displayedElementBefore(), elementBefore(), filterTree(), getNodeWithNamedPage(), isAllWhitespace() (+6 more)
|
|
|
|
### Community 11 - "Queue"
|
|
Cohesion: 0.12
|
|
Nodes (10): Queue, requireEs6Symbol(), requireIsArguments(), requireIsFunction(), requireIsImplemented(), requireIsString(), requireIsSymbol(), requirePolyfill() (+2 more)
|
|
|
|
### Community 12 - "allocateCursor"
|
|
Cohesion: 0.21
|
|
Nodes (9): allocateCursor(), appendOrAssign(), appendOrAssignOrNull(), copy(), createTypeIterator(), deepAssign(), isObject$2(), mix$1() (+1 more)
|
|
|
|
### Community 13 - "ESPDocs - Documentação ESP32 em Português"
|
|
Cohesion: 0.13
|
|
Nodes (14): 👤 Autor, Configuração do Marketplace (Opcional), 🤝 Contribuindo, 🚀 Deploy on Vercel, ⚠️ Disclaimer, ESPDocs - Documentação ESP32 em Português, 📁 Estrutura do Projeto, Executar em Desenvolvimento (+6 more)
|
|
|
|
### Community 14 - "isNameStart"
|
|
Cohesion: 0.15
|
|
Nodes (13): isDigit$5(), isHexDigit$4(), isIdentifierStart$2(), isLetter(), isLowercaseLetter(), isName$2(), isNameStart(), isNewline$1() (+5 more)
|
|
|
|
### Community 15 - "Diretrizes de tema: claro e escuro"
|
|
Cohesion: 0.17
|
|
Nodes (11): 1. Só existem os tons declarados, 2. A regra da simetria, 3. Pares canônicos por papel, 4.1. Botão nunca inverte preto ↔ branco, 4.2. Painel de destaque acompanha o tema, 4.3. Separação de superfície no tema claro, 4. Exceção: superfícies escuras nos dois temas, 5. Cor de série vem do dado, não da classe (+3 more)
|
|
|
|
### Community 16 - "internalMatch"
|
|
Cohesion: 0.20
|
|
Nodes (11): areStringsEqualCaseInsensitive(), buildLoc(), fromLoc(), internalMatch(), isCommaContextEnd(), isCommaContextStart(), isContextEdgeDelim(), locateMismatch() (+3 more)
|
|
|
|
### Community 18 - "auditar-temas.mjs"
|
|
Cohesion: 0.48
|
|
Nodes (6): arquivos(), contraste(), coresFixasInline(), ESCALA, luminancia(), main()
|
|
|
|
### Community 19 - "layout.jsx"
|
|
Cohesion: 0.33
|
|
Nodes (4): inter, metadata, outfit, viewport
|
|
|
|
### Community 20 - "buildGroupMatchGraph"
|
|
Cohesion: 0.53
|
|
Nodes (6): buildGroupMatchGraph(), buildMatchGraph$1(), buildMultiplierMatchGraph(), createCondition(), isEnumCapatible(), isFunctionType()
|
|
|
|
### Community 21 - "getCharCode"
|
|
Cohesion: 0.53
|
|
Nodes (6): consumeBadUrlRemnants$1(), consumeEscaped$1(), consumeName$1(), getCharCode(), getNewlineLength$1(), tokenize$3()
|
|
|
|
### Community 23 - "PinRestrictions.jsx"
|
|
Cohesion: 0.60
|
|
Nodes (4): derivarGrupos(), GRUPOS, PinRestrictions(), rotuloDoPino()
|
|
|
|
### Community 24 - "eslint.config.mjs"
|
|
Cohesion: 0.40
|
|
Nodes (4): compat, __dirname, eslintConfig, __filename
|
|
|
|
### Community 25 - "compilerOptions"
|
|
Cohesion: 0.40
|
|
Nodes (4): compilerOptions, paths, @/*, ./*
|
|
|
|
### Community 26 - "requireKeys"
|
|
Cohesion: 0.40
|
|
Nodes (5): assign(), requireIsImplemented$1(), requireKeys(), requireShim$4(), requireShim$5()
|
|
|
|
### Community 27 - "outOfRange"
|
|
Cohesion: 0.40
|
|
Nodes (5): dimension(), integer(), isPostfixIeHack(), outOfRange(), percentage()
|
|
|
|
### Community 28 - "testNode"
|
|
Cohesion: 0.40
|
|
Nodes (4): isKeyword(), isProperty(), isType(), testNode()
|
|
|
|
### Community 29 - "page.jsx"
|
|
Cohesion: 0.67
|
|
Nodes (3): categoryIcons, Comparacao(), valorDe()
|
|
|
|
### Community 31 - "page.jsx"
|
|
Cohesion: 0.67
|
|
Nodes (3): getOptionIcon(), iconMap, Seletor()
|
|
|
|
### Community 34 - "consumeB$1"
|
|
Cohesion: 0.50
|
|
Nodes (4): checkInteger$1(), consumeB$1(), isDelim$1(), skipSC()
|
|
|
|
### Community 35 - "processStructure"
|
|
Cohesion: 0.50
|
|
Nodes (4): createNodeStructureChecker(), isValidLocation(), isValidNumber(), processStructure()
|
|
|
|
### Community 36 - "generate$2"
|
|
Cohesion: 0.50
|
|
Nodes (4): generate$2(), generateMultiplier(), generateSequence(), generateTypeOpts()
|
|
|
|
### Community 37 - "getVendorPrefix"
|
|
Cohesion: 0.67
|
|
Nodes (4): getKeywordDescriptor(), getPropertyDescriptor(), getVendorPrefix(), isCustomProperty$1()
|
|
|
|
### Community 49 - "matchSyntax"
|
|
Cohesion: 0.67
|
|
Nodes (3): buildMatchResult(), matchSyntax(), valueHasVar()
|
|
|
|
### Community 50 - "consumeNumber$5"
|
|
Cohesion: 0.67
|
|
Nodes (3): cmpChar$5(), consumeNumber$5(), findDecimalNumberEnd()
|
|
|
|
### Community 51 - "strcmp"
|
|
Cohesion: 0.67
|
|
Nodes (3): compareByGeneratedPositionsDeflated(), compareByOriginalPositions(), strcmp()
|
|
|
|
### Community 52 - "readSequence"
|
|
Cohesion: 0.67
|
|
Nodes (3): consumeRaw(), parentheses(), readSequence()
|
|
|
|
### Community 53 - "patchAtrules"
|
|
Cohesion: 0.67
|
|
Nodes (3): patchAtrules(), patchDictionary(), unpackSyntaxes()
|
|
|
|
## Knowledge Gaps
|
|
- **71 isolated node(s):** `metadata`, `metadata`, `categoryIcons`, `metadata`, `metadata` (+66 more)
|
|
These have ≤1 connection - possible missing edges or undocumented components.
|
|
- **24 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
|
|
|
|
## Suggested Questions
|
|
_Questions this graph is uniquely positioned to answer:_
|
|
|
|
- **Why does `AtPage` connect `AtPage` to `paged.polyfill.js`, `Page`?**
|
|
_High betweenness centrality (0.045) - this node is a cross-community bridge._
|
|
- **Why does `Page` connect `Page` to `paged.polyfill.js`, `.replace`?**
|
|
_High betweenness centrality (0.030) - this node is a cross-community bridge._
|
|
- **Why does `Chunker` connect `Page` to `paged.polyfill.js`?**
|
|
_High betweenness centrality (0.023) - this node is a cross-community bridge._
|
|
- **What connects `metadata`, `metadata`, `categoryIcons` to the rest of the system?**
|
|
_71 weakly-connected nodes found - possible documentation gaps or missing edges._
|
|
- **Should `paged.polyfill.js` be split into smaller, more focused modules?**
|
|
_Cohesion score 0.022727272727272728 - nodes in this community are weakly interconnected._
|
|
- **Should `Layout` be split into smaller, more focused modules?**
|
|
_Cohesion score 0.05575065847234416 - nodes in this community are weakly interconnected._
|
|
- **Should `AtPage` be split into smaller, more focused modules?**
|
|
_Cohesion score 0.08240794856808883 - nodes in this community are weakly interconnected._ |