Files
aego/script/langsvc/service.go
T
sanspie 69d19e501f Stage 7: documentation, help, playground; templates, aego new/bootstrap/icons, launcher
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)
2026-10-13 01:08:56 +03:00

103 lines
2.0 KiB
Go

package langsvc
import (
"sync"
"sync/atomic"
"aego/script/abi"
"aego/script/bind/manifest"
"aego/script/diag"
"aego/script/source"
"aego/script/workspace"
)
type Jobs interface {
Submit(fn func())
OnMain(fn func())
}
type Result struct {
Snap *workspace.Snapshot
Diagnostics []diag.Diagnostic
Tokens []Token
}
type Service struct {
ws *workspace.Workspace
jobs Jobs
gen atomic.Uint64
mu sync.Mutex
last *workspace.Snapshot
smu sync.Mutex
stubTab *abi.Table
stubDocs *manifest.Manifest
stubs map[string]*Stub
native string
}
func New(w *workspace.Workspace, jobs Jobs) *Service {
return &Service{ws: w, jobs: jobs}
}
func (s *Service) Workspace() *workspace.Workspace {
return s.ws
}
func (s *Service) Current() uint64 {
return s.gen.Load()
}
func (s *Service) Invalidate() uint64 {
return s.gen.Add(1)
}
func (s *Service) Refresh() *workspace.Snapshot {
snap := s.ws.Snapshot()
s.mu.Lock()
if s.last == nil || snap.Gen >= s.last.Gen {
s.last = snap
}
s.mu.Unlock()
return snap
}
func (s *Service) Latest() *workspace.Snapshot {
s.mu.Lock()
defer s.mu.Unlock()
return s.last
}
func (s *Service) deliver(gen uint64, fn func()) {
s.jobs.OnMain(func() {
if s.Current() == gen {
fn()
}
})
}
func (s *Service) Analyze(gen uint64, file source.FileID, fn func(Result)) {
s.jobs.Submit(func() {
snap := s.Refresh()
r := Result{Snap: snap, Diagnostics: snap.Diagnostics, Tokens: semanticTokens(snap, file)}
s.deliver(gen, func() { fn(r) })
})
}
func (s *Service) Diagnostics(gen uint64, fn func([]diag.Diagnostic)) {
s.jobs.Submit(func() {
ds := s.Refresh().Diagnostics
s.deliver(gen, func() { fn(ds) })
})
}
func (s *Service) Complete(gen uint64, file source.FileID, off uint32, fn func(Completion)) {
s.jobs.Submit(func() {
c := s.complete(s.Refresh(), file, off)
s.deliver(gen, func() { fn(c) })
})
}
func (s *Service) CompleteNow(file source.FileID, off uint32) Completion {
return s.complete(s.Refresh(), file, off)
}