@alloy-js/core 0.23.0-dev.11 → 0.23.0-dev.13

package/dist/dev/src/symbols/decl.js

@@ -0,0 +1,26 @@
+import { toRef } from "@vue/reactivity";
+import { createSymbol } from "../binder.js";
+import { useScope } from "../context/scope.js";
+import { createComponent } from "../runtime/component.js";
+import { BasicScope } from "./basic-scope.js";
+import { BasicSymbol } from "./basic-symbol.js";
+
+/**
+ * Create a declaration in the current scope with the given namekey. Only works
+ * with basic scopes. Import `decl` from a specific language library for
+ * declaring language-specific symbols.
+ */
+export function decl(namekey) {
+  return createComponent(() => {
+    const currentScope = useScope();
+    if (!(currentScope instanceof BasicScope)) {
+      throw new Error(`Cannot declare symbol in non-basic scope: ${currentScope.constructor.name}. Use a language-specific 'decl' function instead.`);
+    }
+    const binder = currentScope.binder;
+    const symbol = createSymbol(BasicSymbol, namekey, currentScope.symbols, {
+      binder
+    });
+    return toRef(symbol, "name");
+  }, {});
+}
+//# sourceMappingURL=decl.js.map

package/dist/dev/src/symbols/decl.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["toRef","createSymbol","useScope","createComponent","BasicScope","BasicSymbol","decl","namekey","currentScope","Error","constructor","name","binder","symbol","symbols"],"sources":["../../../../src/symbols/decl.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,KAAK,QAAQ,iBAAiB;AACvC,SAASC,YAAY,QAAQ,cAAc;AAC3C,SAASC,QAAQ,QAAQ,qBAAqB;AAE9C,SAASC,eAAe,QAAQ,yBAAyB;AACzD,SAASC,UAAU,QAAQ,kBAAkB;AAC7C,SAASC,WAAW,QAAQ,mBAAmB;;AAE/C;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAACC,OAAgB,EAAE;EACrC,OAAOJ,eAAe,CAAC,MAAM;IAC3B,MAAMK,YAAY,GAAGN,QAAQ,CAAC,CAAC;IAC/B,IAAI,EAAEM,YAAY,YAAYJ,UAAU,CAAC,EAAE;MACzC,MAAM,IAAIK,KAAK,CACb,6CAA6CD,YAAY,CAACE,WAAW,CAACC,IAAI,oDAC5E,CAAC;IACH;IACA,MAAMC,MAAM,GAAGJ,YAAY,CAACI,MAAM;IAClC,MAAMC,MAAM,GAAGZ,YAAY,CAACI,WAAW,EAAEE,OAAO,EAAEC,YAAY,CAACM,OAAO,EAAE;MACtEF;IACF,CAAC,CAAC;IAEF,OAAOZ,KAAK,CAACa,MAAM,EAAE,MAAM,CAAC;EAC9B,CAAC,EAAE,CAAC,CAAC,CAAC;AACR","ignoreList":[]}

package/dist/dev/src/symbols/index.js

@@ -0,0 +1,10 @@
+export * from "./basic-scope.js";
+export * from "./basic-symbol.js";
+export * from "./decl.js";
+export * from "./output-scope.js";
+export * from "./output-space.js";
+export * from "./output-symbol.js";
+export * from "./symbol-flow.js";
+export * from "./symbol-slot.js";
+export * from "./symbol-table.js";
+//# sourceMappingURL=index.js.map

package/dist/dev/src/symbols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../../src/symbols/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,kBAAkB;AAChC,cAAc,mBAAmB;AACjC,cAAc,WAAW;AACzB,cAAc,mBAAmB;AACjC,cAAc,mBAAmB;AACjC,cAAc,oBAAoB;AAClC,cAAc,kBAAkB;AAChC,cAAc,kBAAkB;AAChC,cAAc,mBAAmB","ignoreList":[]}

package/dist/dev/src/symbols/output-scope.js

@@ -0,0 +1,202 @@
+import { reactive, ReactiveFlags, track, TrackOpTypes, trigger, TriggerOpTypes } from "@vue/reactivity";
+import { useBinder } from "../context/binder.js";
+import { inspect } from "../inspect.js";
+import { effect, shallowReactive, untrack } from "../reactivity.js";
+import { OutputDeclarationSpace } from "./output-space.js";
+let scopeCount = 0;
+/**
+ * A container of symbols accessible within some scope in your output code.
+ *
+ * @remarks
+ *
+ * Scopes form a tree. All scopes except the global scope have a parent scope
+ * identified by `parent`. Scopes can have nested scopes which can be accessed
+ * using the `children` property. Whether a child scope can be accessed from
+ * the parent scope is determined by each language's scoping rules.
+ *
+ * This interface is the base implementation of scope. Generally, most languages
+ * will have subtypes of this interface that provide additional metadata about
+ * the scope. For example, TypeScript scopes need to track whether the scope
+ * represents a package, module, class, function, etc.
+ *
+ * Scopes are reactive values, which allows you to observe changes to the scope
+ * within a reactive context.
+ */
+export class OutputScope {
+  static declarationSpaces = [];
+  #name;
+  /**
+   * The name of the scope.
+   *
+   * @reactive
+   */
+  get name() {
+    track(this, TrackOpTypes.GET, "name");
+    return this.#name;
+  }
+  set name(name) {
+    const old = this.#name;
+    this.#name = name;
+    trigger(this, TriggerOpTypes.SET, "name", name, old);
+  }
+  #id;
+  /**
+   * The unique id of this scope.
+   *
+   * @readonly
+   */
+  get id() {
+    return this.#id;
+  }
+
+  // read only
+  #metadata;
+  /**
+   * Arbitrary metadata associated with this scope. This property is not
+   * reactive but the metadata object is a reactive object.
+   *
+   * @readonly
+   */
+  get metadata() {
+    return this.#metadata;
+  }
+  #parent;
+
+  /**
+   * The parent scope of this scope. Undefined if this is a root scope.
+   *
+   * @reactive
+   */
+  get parent() {
+    track(this, TrackOpTypes.GET, "parent");
+    return this.#parent;
+  }
+  set parent(scope) {
+    const old = this.#parent;
+    if (old) {
+      old.children.delete(this);
+    }
+    if (scope) {
+      scope.children.add(this);
+    }
+    trigger(this, TriggerOpTypes.SET, "parent", scope, old);
+    this.#parent = scope;
+  }
+  #spaces;
+
+  /**
+   * Get the declaration space for the given key.
+   */
+  spaceFor(key) {
+    return this.#spaces[key];
+  }
+  #children;
+  /**
+   * The scopes nested within this scope.
+   *
+   * @readonly
+   */
+  get children() {
+    return this.#children;
+  }
+  #binder;
+  /**
+   * The binder that created this scope.
+   *
+   * @readonly
+   */
+  get binder() {
+    return this.#binder;
+  }
+  [ReactiveFlags.SKIP] = true;
+  constructor(name, parentScope, options = {}) {
+    this.#name = name;
+    this.#id = scopeCount++;
+    this.#metadata = reactive(options.metadata ?? {});
+    this.#binder = options.binder ?? useBinder();
+    this.#children = shallowReactive(new Set());
+    this.#parent = parentScope;
+    effect(() => {
+      this.#setOwnerSymbol(options.ownerSymbol?.movedTo ?? options.ownerSymbol);
+    }, undefined, {
+      debug: {
+        name: "outputScope:ownerSymbol",
+        type: "symbol"
+      }
+    });
+    if (this.#parent) {
+      this.#parent.children.add(this);
+    }
+    const constructor = this.constructor;
+    this.#spaces = Object.fromEntries(constructor.declarationSpaces.map(spaceKey => [spaceKey, new OutputDeclarationSpace(this, spaceKey, this.#binder)]));
+
+    // Notify binder so resolution tracking works even without createScope
+    this.#binder?.notifyScopeCreated(this);
+  }
+
+  /**
+   * Get all the declaration spaces in this scope.
+   *
+   * @readonly
+   */
+  get spaces() {
+    return Object.values(this.#spaces);
+  }
+  #ownerSymbol;
+  /**
+   * The symbol whose members are in scope. When an owner symbol is present,
+   * this scope is considered a member scope, and does not provide its own
+   * declaration spaces.
+   *
+   * @readonly
+   * @reactive
+   */
+  get ownerSymbol() {
+    track(this, TrackOpTypes.GET, "ownerSymbol");
+    return this.#ownerSymbol;
+  }
+  get debugInfo() {
+    return {};
+  }
+  #setOwnerSymbol(value) {
+    const old = this.#ownerSymbol;
+    this.#ownerSymbol = value;
+    trigger(this, TriggerOpTypes.SET, "ownerSymbol", value, old);
+  }
+
+  /**
+   * Whether this scope is a transient scope. Transient scopes are used for
+   * temporary values that are to be combined with other non-transient symbols.
+   * Scopes are transient when their owner symbol is transient.
+   *
+   * @readonly
+   */
+  get isTransient() {
+    if (!this.ownerSymbol) {
+      return false;
+    }
+    return this.ownerSymbol.isTransient;
+  }
+  /**
+   * Check if this is scope is a member scope. Member scopes have no member
+   * spaces of their own, but instead put members of their owner symbol in
+   * scope.
+   *
+   * @readonly
+   * @reactive
+   */
+  get isMemberScope() {
+    return !!this.ownerSymbol;
+  }
+  [inspect.custom]() {
+    const ownerSymbol = this.ownerSymbol ? ` for ${inspect(this.ownerSymbol)}` : "";
+    return untrack(() => `${this.constructor.name} ${this.name}[${this.id}]${ownerSymbol}`);
+  }
+  toString() {
+    return untrack(() => {
+      const ownerSymbol = this.ownerSymbol ? ` for ${this.ownerSymbol}` : "";
+      return `${this.constructor.name} ${this.name}[${this.id}]${ownerSymbol}`;
+    });
+  }
+}
+//# sourceMappingURL=output-scope.js.map

package/dist/dev/src/symbols/output-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["reactive","ReactiveFlags","track","TrackOpTypes","trigger","TriggerOpTypes","useBinder","inspect","effect","shallowReactive","untrack","OutputDeclarationSpace","scopeCount","OutputScope","declarationSpaces","name","GET","old","SET","id","metadata","parent","scope","children","delete","add","spaces","spaceFor","key","binder","SKIP","constructor","parentScope","options","Set","setOwnerSymbol","ownerSymbol","movedTo","undefined","debug","type","Object","fromEntries","map","spaceKey","notifyScopeCreated","values","debugInfo","#setOwnerSymbol","value","isTransient","isMemberScope","custom","toString"],"sources":["../../../../src/symbols/output-scope.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/symbols/output-space.js

@@ -0,0 +1,36 @@
+import { inspect } from "../inspect.js";
+import { untrack } from "../reactivity.js";
+import { SymbolTable } from "./symbol-table.js";
+export class OutputDeclarationSpace extends SymbolTable {
+  constructor(scope, key, binder) {
+    super(key, binder);
+    this.#scope = scope;
+  }
+  #scope;
+  /**
+   * The scope this declaration space belongs to.
+   */
+  get scope() {
+    return this.#scope;
+  }
+  [inspect.custom]() {
+    return untrack(() => `OutputDeclarationSpace for scope ${inspect(this.#scope)}`);
+  }
+}
+export class OutputMemberSpace extends SymbolTable {
+  constructor(symbol, key, binder) {
+    super(key, binder);
+    this.#symbol = symbol;
+  }
+  #symbol;
+  /**
+   * The symbol this member space belongs to.
+   */
+  get symbol() {
+    return this.#symbol;
+  }
+  [inspect.custom]() {
+    return untrack(() => `OutputMemberSpace for symbol ${inspect(this.#symbol)}`);
+  }
+}
+//# sourceMappingURL=output-space.js.map

package/dist/dev/src/symbols/output-space.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["inspect","untrack","SymbolTable","OutputDeclarationSpace","constructor","scope","key","binder","custom","OutputMemberSpace","symbol"],"sources":["../../../../src/symbols/output-space.ts"],"sourcesContent":[null],"mappings":"AACA,SAASA,OAAO,QAAQ,eAAe;AACvC,SAASC,OAAO,QAAQ,kBAAkB;AAG1C,SAASC,WAAW,QAAQ,mBAAmB;AAG/C,OAAO,MAAMC,sBAAsB,SAASD,WAAW,CAAC;EACtDE,WAAWA,CAACC,KAAkB,EAAEC,GAAW,EAAEC,MAAe,EAAE;IAC5D,KAAK,CAACD,GAAG,EAAEC,MAAM,CAAC;IAClB,IAAI,CAAC,CAACF,KAAK,GAAGA,KAAK;EACrB;EAEA,CAACA,KAAK;EACN;AACF;AACA;EACE,IAAIA,KAAKA,CAAA,EAAG;IACV,OAAO,IAAI,CAAC,CAACA,KAAK;EACpB;EAEA,CAACL,OAAO,CAACQ,MAAM,IAAI;IACjB,OAAOP,OAAO,CACZ,MAAM,oCAAoCD,OAAO,CAAC,IAAI,CAAC,CAACK,KAAK,CAAC,EAChE,CAAC;EACH;AACF;AAEA,OAAO,MAAMI,iBAAiB,SAASP,WAAW,CAAC;EACjDE,WAAWA,CAACM,MAAoB,EAAEJ,GAAW,EAAEC,MAAe,EAAE;IAC9D,KAAK,CAACD,GAAG,EAAEC,MAAM,CAAC;IAClB,IAAI,CAAC,CAACG,MAAM,GAAGA,MAAM;EACvB;EAEA,CAACA,MAAM;EACP;AACF;AACA;EACE,IAAIA,MAAMA,CAAA,EAAG;IACX,OAAO,IAAI,CAAC,CAACA,MAAM;EACrB;EAEA,CAACV,OAAO,CAACQ,MAAM,IAAI;IACjB,OAAOP,OAAO,CACZ,MAAM,gCAAgCD,OAAO,CAAC,IAAI,CAAC,CAACU,MAAM,CAAC,EAC7D,CAAC;EACH;AACF","ignoreList":[]}