xbintsc 0.3.16 → 0.3.25

package/dist/tests/public-api.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import * as api from "../src/index.js";
+describe("public API surface", () => {
+    it("re-exports the compiler pipeline", () => {
+        expect(typeof api.Scanner).toBe("function");
+        expect(typeof api.Parser).toBe("function");
+        expect(typeof api.bind).toBe("function");
+        expect(typeof api.generate).toBe("function");
+        expect(typeof api.hashText).toBe("function");
+        expect(api.TokenKind).toBeDefined();
+        expect(api.SymbolKind).toBeDefined();
+        expect(api.XT_UNDEFINED).toBeDefined();
+        expect(typeof api.numberLiteral).toBe("function");
+        expect(typeof api.booleanLiteral).toBe("function");
+    });
+    it("re-exports the extension system and driver", () => {
+        expect(typeof api.ExtensionRegistry).toBe("function");
+        expect(typeof api.createDefaultRegistry).toBe("function");
+        expect(api.coreExtension.name).toBe("core");
+        expect(api.nodeExtension.name).toBe("node");
+        expect(typeof api.bundledExtensions).toBe("function");
+        expect(api.bundledExtensions().length).toBeGreaterThan(0);
+        expect(typeof api.build).toBe("function");
+        expect(typeof api.compileString).toBe("function");
+        expect(typeof api.BuildCache).toBe("function");
+        expect(typeof api.findRuntimeDir).toBe("function");
+        expect(typeof api.findRuntimeLibrary).toBe("function");
+        expect(typeof api.resolveToolchain).toBe("function");
+    });
+});
+//# sourceMappingURL=public-api.test.js.map

package/dist/tests/public-api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.test.js","sourceRoot":"","sources":["../../tests/public-api.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAEvC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xbintsc",
-  "version": "0.3.16",
+  "version": "0.3.25",
   "description": "xbintsc - a TypeScript binary compiler (TypeScript -> LLVM IR -> native binary)",
   "type": "module",
   "license": "MIT",

package/runtime/ext_gui/document.cpp

@@ -24,6 +24,8 @@ void XtDocument::collectStyleText(const Node *node, std::string *out) const {
 
 void XtDocument::load(const std::string &html, float viewportWidth, float viewportHeight) {
   root_ = xt_html_parse(html);
+  detached_.clear();
+  dirty_ = false;
   hover_ = nullptr;
   focus_ = nullptr;
   styles_.clear();
@@ -261,4 +263,92 @@ std::string XtDocument::toDebugString() const {
   return root_ == nullptr ? std::string() : xt_dom_to_string(root_.get());
 }
 
+/* -- DOM mutation --------------------------------------------------------- */
+
+Node *XtDocument::createElement(const std::string &tag) {
+  auto node = std::make_unique<Node>(NodeType::Element);
+  node->tag = tag;
+  Node *raw = node.get();
+  detached_[raw] = std::move(node);
+  return raw;
+}
+
+Node *XtDocument::createTextNode(const std::string &text) {
+  auto node = std::make_unique<Node>(NodeType::Text);
+  node->text = text;
+  Node *raw = node.get();
+  detached_[raw] = std::move(node);
+  return raw;
+}
+
+namespace {
+
+/** Take ownership of a node that is either attached or sitting in the pool. */
+std::unique_ptr<Node> takeNode(
+    Node *node, std::unordered_map<const Node *, std::unique_ptr<Node>> &pool) {
+  if (node->parent != nullptr) return node->parent->detachChild(node);
+  auto it = pool.find(node);
+  if (it == pool.end()) return nullptr;
+  std::unique_ptr<Node> owned = std::move(it->second);
+  pool.erase(it);
+  return owned;
+}
+
+}  // namespace
+
+Node *XtDocument::appendChild(Node *parent, Node *child) {
+  if (parent == nullptr || child == nullptr) return nullptr;
+  if (!parent->isElement() || child->isDocument() || child == root_.get()) return nullptr;
+  if (child->contains(parent)) return nullptr; /* reject cycles */
+  std::unique_ptr<Node> owned = takeNode(child, detached_);
+  if (owned == nullptr) return nullptr;
+  invalidate();
+  return parent->append(std::move(owned));
+}
+
+Node *XtDocument::insertBefore(Node *parent, Node *child, Node *reference) {
+  if (reference == nullptr) return appendChild(parent, child);
+  if (parent == nullptr || child == nullptr || child == reference) return child;
+  if (!parent->isElement() || child->isDocument() || child == root_.get()) return nullptr;
+  if (child->contains(parent)) return nullptr; /* reject cycles */
+  bool reference_is_child = false;
+  for (const std::unique_ptr<Node> &entry : parent->children) {
+    if (entry.get() == reference) {
+      reference_is_child = true;
+      break;
+    }
+  }
+  if (!reference_is_child) return nullptr;
+  std::unique_ptr<Node> owned = takeNode(child, detached_);
+  if (owned == nullptr) return nullptr;
+  invalidate();
+  return parent->insertChild(std::move(owned), reference);
+}
+
+bool XtDocument::removeChild(Node *parent, Node *child) {
+  if (parent == nullptr || child == nullptr || child->parent != parent) return false;
+  std::unique_ptr<Node> owned = parent->detachChild(child);
+  if (owned == nullptr) return false;
+  detached_[child] = std::move(owned);
+  invalidate();
+  return true;
+}
+
+Node *XtDocument::replaceChild(Node *parent, Node *newChild, Node *oldChild) {
+  if (parent == nullptr || oldChild == nullptr || oldChild->parent != parent) return nullptr;
+  if (newChild == oldChild) return newChild;
+  if (newChild != nullptr && !insertBefore(parent, newChild, oldChild)) return nullptr;
+  removeChild(parent, oldChild);
+  return newChild;
+}
+
+void XtDocument::detach(Node *node) {
+  if (node == nullptr || node == root_.get()) return;
+  if (node->parent != nullptr) {
+    std::unique_ptr<Node> owned = node->parent->detachChild(node);
+    if (owned != nullptr) detached_[node] = std::move(owned);
+  }
+  invalidate();
+}
+
 }  // namespace xtgui

package/runtime/ext_gui/document.h

@@ -63,6 +63,26 @@ class XtDocument {
   const Node *querySelector(const std::string &selectorText) const;
   /** Elements matching a CSS selector, in document order. */
   std::vector<const Node *> querySelectorAll(const std::string &selectorText) const;
+
+  /* -- DOM mutation (element handles) ------------------------------------ */
+  /** Create a detached element/text node owned by the document. */
+  Node *createElement(const std::string &tag);
+  Node *createTextNode(const std::string &text);
+  /** Move `child` under `parent` (from its current parent or the detached pool). */
+  Node *appendChild(Node *parent, Node *child);
+  Node *insertBefore(Node *parent, Node *child, Node *reference);
+  bool removeChild(Node *parent, Node *child);
+  Node *replaceChild(Node *parent, Node *newChild, Node *oldChild);
+  /** Release a node from the document entirely (still owned, detached). */
+  void detach(Node *node);
+
+  /** Mark the document as needing a restyle/relayout before the next paint. */
+  void invalidate() { dirty_ = true; }
+  bool takeDirty() {
+    bool was = dirty_;
+    dirty_ = false;
+    return was;
+  }
   /** Serialized DOM, for diagnostics. */
   std::string toDebugString() const;
 
@@ -72,6 +92,9 @@ class XtDocument {
   void updateDisplay();
 
   std::unique_ptr<Node> root_;
+  /** Detached nodes (created or removed) stay alive here so handles remain valid. */
+  std::unordered_map<const Node *, std::unique_ptr<Node>> detached_;
+  bool dirty_ = false;
   StyleSheet sheet_;
   std::unordered_map<const Node *, XtStyle> styles_;   // target (cascade)
   std::unordered_map<const Node *, XtStyle> display_;  // after transitions

package/runtime/ext_gui/dom.cpp

@@ -37,6 +37,42 @@ Node *Node::append(std::unique_ptr<Node> child) {
   return raw;
 }
 
+std::unique_ptr<Node> Node::detachChild(Node *child) {
+  for (auto it = children.begin(); it != children.end(); ++it) {
+    if (it->get() == child) {
+      std::unique_ptr<Node> owned = std::move(*it);
+      children.erase(it);
+      owned->parent = nullptr;
+      return owned;
+    }
+  }
+  return nullptr;
+}
+
+Node *Node::insertChild(std::unique_ptr<Node> child, Node *reference) {
+  child->parent = this;
+  Node *raw = child.get();
+  if (reference == nullptr) {
+    children.push_back(std::move(child));
+    return raw;
+  }
+  for (auto it = children.begin(); it != children.end(); ++it) {
+    if (it->get() == reference) {
+      children.insert(it, std::move(child));
+      return raw;
+    }
+  }
+  children.push_back(std::move(child));
+  return raw;
+}
+
+bool Node::contains(const Node *node) const {
+  for (const Node *current = node; current != nullptr; current = current->parent) {
+    if (current == this) return true;
+  }
+  return false;
+}
+
 Node *Node::addElement(const std::string &tagName) {
   auto node = std::make_unique<Node>(NodeType::Element);
   node->tag = tagName;

package/runtime/ext_gui/dom.h

@@ -49,6 +49,13 @@ struct Node {
   Node *addText(const std::string &data);
   Node *append(std::unique_ptr<Node> child);
 
+  /** Detach a direct child, transferring ownership to the caller. */
+  std::unique_ptr<Node> detachChild(Node *child);
+  /** Insert `child` before `reference` (append when `reference` is nullptr). */
+  Node *insertChild(std::unique_ptr<Node> child, Node *reference);
+  /** True when `node` is this node or a descendant of it. */
+  bool contains(const Node *node) const;
+
   /** First element child (skips text), or NULL. */
   Node *firstElementChild() const;
   /** Total number of element children with the same tag, and this node's index. */