Documentation: engine/docs assembles one registry from the script
bindings, the schema, module docs and module-owned script paths; problems
are reported as warnings at build time. Module registries record doc
sources and script module owners; diag.Codes lists every diagnostic code.
Project bootstrap: project.defaultSpace ("2d"/"3d"), EnsureDirs creates
the default folders when the editor opens a project (reported in the
console), prefabs/ is a pipeline root. Native builds drop -trimpath so
binding locations resolve inside native/.
Editor files: create scene/prefab/script from menus, move/rename/duplicate
/delete with undo, script package retargeting on move, open scenes and
script panels follow renames, Save As / Rename Scene prompts, scene
picker, startup scene. Scoped shortcuts fall back to the global command
when disabled; Save As is Ctrl+Shift+S, Save All Ctrl+Alt+S.
Script editor: Go to Implementation (stub → native/ source), host
definitions always resolve to stubs, bracket match/mismatch states,
rainbow brackets (persisted), mono code font (ui-mono atlases, per-command
fonts in draw.List, PushFont/PopFont restored by Mark/Restore).
Tests: langsvc definition/implementation, bracket states, dispatch
fallback, script renames, font stack, editor file-op integration, golden
mono glyph and bracket references; depcheck rule for engine/docs.
Docs pipeline: engine, render2d and script/engine ship their own res/docs;
keyword hover text comes from the registry through manifest.Keywords;
project script symbols join the registry; aego docs export|check|build|
serve, --tool docs in native binaries, aego check --explain; app/docstool
and the tools/gendocs module (goldmark) build the static site.
Playground: app/playground + cmd/aego-playground (js/wasm, 3.3 MB gzip)
compile, highlight and run scripts in the browser; run blocks in the
language docs become examples. engine/builtin/headless is the module set
without render3d; workspace.Config.FS; StubFor/StubPaths; backends and the
script importer drop out of js builds.
VM: one frame pointer in the interpreter loop, direct host calls, panic
recovery once per run instead of per host call (Update2k -19%,
Schedule10k -24% against the previous head). bench-build/compare/profile
run pre-built, pinned, interleaved binaries.
Editor: structural bracket levels and current-block highlight, indent
guides, occurrence highlighting with write marks, multi-format clipboard
(copy/cut/paste assets, paste images as sprites or textures). gl33 probes
a renderable depth format and reports framebuffer failures by stage.
7 E:
- project templates empty/2d/2.5d/3d, app/projects as the single creation path (D148)
- launcher and recent projects (D149)
- orthographic Camera3D and Scene View (D150)
- reference states in the Inspector, ids.Short (D151)
- sceneio remaps node references when loading without KeepIDs (D152)
- exported ComponentRef<T> (D153)
- aego icons via module.Audit (D146)
64 lines
1.5 KiB
Go
64 lines
1.5 KiB
Go
package langsvc
|
|
|
|
import (
|
|
"sort"
|
|
"unicode"
|
|
"unicode/utf8"
|
|
|
|
"aego/script/source"
|
|
"aego/script/workspace"
|
|
)
|
|
|
|
type DocSymbol struct {
|
|
Package string
|
|
Container string
|
|
Name string
|
|
Kind string
|
|
Signature string
|
|
Doc string
|
|
Path string
|
|
Line int
|
|
}
|
|
|
|
func exported(name string) bool {
|
|
r, _ := utf8.DecodeRuneInString(name)
|
|
return unicode.IsUpper(r)
|
|
}
|
|
|
|
func (s *Service) ScriptDocs(snap *workspace.Snapshot) []DocSymbol {
|
|
files := make([]source.FileID, 0, len(snap.Files))
|
|
for id := range snap.Files {
|
|
files = append(files, id)
|
|
}
|
|
sort.Slice(files, func(a, b int) bool { return snap.Sources.Path(files[a]) < snap.Sources.Path(files[b]) })
|
|
var out []DocSymbol
|
|
for _, id := range files {
|
|
path := snap.Sources.Path(id)
|
|
if workspace.IsTest(path) {
|
|
continue
|
|
}
|
|
pkg := snap.Packages[id]
|
|
var walk func(list []Symbol, container string)
|
|
walk = func(list []Symbol, container string) {
|
|
for _, sym := range list {
|
|
if !exported(sym.Name) {
|
|
continue
|
|
}
|
|
d := DocSymbol{Package: pkg, Container: container, Name: sym.Name, Kind: sym.Kind.String(), Path: path}
|
|
d.Line, _ = snap.Sources.LineCol(id, sym.Selection.Start)
|
|
if h, ok := s.HoverIn(snap, id, sym.Selection.Start); ok {
|
|
d.Signature, d.Doc = h.Signature, h.Doc
|
|
}
|
|
out = append(out, d)
|
|
next := sym.Name
|
|
if container != "" {
|
|
next = container + "." + sym.Name
|
|
}
|
|
walk(sym.Children, next)
|
|
}
|
|
}
|
|
walk(s.SymbolsIn(snap, id), "")
|
|
}
|
|
return out
|
|
}
|