@alloy-js/core 0.1.0

package/dist/src/binder.js

@@ -0,0 +1,444 @@
+import { memo } from "@alloy-js/core/jsx-runtime";
+import { computed, effect, reactive, shallowRef } from "@vue/reactivity";
+import { useMemberScope } from "./context/member-scope.js";
+import { useScope } from "./context/scope.js";
+import { refkey } from "./refkey.js";
+/**
+ * Flags that describe an output symbol.
+ */
+export let OutputSymbolFlags = /*#__PURE__*/function (OutputSymbolFlags) {
+  OutputSymbolFlags[OutputSymbolFlags["None"] = 0] = "None";
+  OutputSymbolFlags[OutputSymbolFlags["InstanceMemberContainer"] = 1] = "InstanceMemberContainer";
+  OutputSymbolFlags[OutputSymbolFlags["StaticMemberContainer"] = 2] = "StaticMemberContainer";
+  OutputSymbolFlags[OutputSymbolFlags["MemberContainer"] = 3] = "MemberContainer";
+  OutputSymbolFlags[OutputSymbolFlags["InstanceMember"] = 4] = "InstanceMember";
+  OutputSymbolFlags[OutputSymbolFlags["StaticMember"] = 8] = "StaticMember";
+  OutputSymbolFlags[OutputSymbolFlags["Member"] = 12] = "Member";
+  return OutputSymbolFlags;
+}({});
+
+/**
+ * An output symbol is a named entity that can be referenced in your output
+ * code. Referencing symbols is generally accomplished by using a
+ * {@link Refkey}.
+ *
+ * @remarks
+ *
+ * This interface is the base implementation of symbol. Generally, most
+ * languages will have subtypes of this interface that provide additional,
+ * language-specific metadata about declared symbols. For example, symbols in
+ * TypeScript need to track whether they are exported or what kind of symbol
+ * they are (e.g. type, value, parameter, etc.)
+ *
+ * Symbols are reactive values, which allows you to observe changes to the symbol
+ * information. For example, a symbol's name may change if it becomes conflicted
+ * with a symbol that is added later.
+ */
+
+/**
+ * Flags that describe an output scope.
+ */
+export let OutputScopeFlags = /*#__PURE__*/function (OutputScopeFlags) {
+  OutputScopeFlags[OutputScopeFlags["None"] = 0] = "None";
+  OutputScopeFlags[OutputScopeFlags["StaticMemberScope"] = 1] = "StaticMemberScope";
+  OutputScopeFlags[OutputScopeFlags["InstanceMemberScope"] = 2] = "InstanceMemberScope";
+  OutputScopeFlags[OutputScopeFlags["MemberScope"] = 3] = "MemberScope";
+  return OutputScopeFlags;
+}({});
+
+/**
+ * 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.
+ */
+
+/**
+ * The binder tracks all output scopes and symbols. Scopes are nested containers
+ * for symbols.
+ *
+ * @remarks
+ *
+ * Symbol information is reactive because in certain situations this data may
+ * change. For example, when a symbol becomes conflicted with another symbol,
+ * one of the symbol names may change. Ensure that you interact with binder
+ * values in a reactive context (i.e. within JSX/code template, or within
+ * memo/computed/etc).
+ *
+ */
+
+/**
+ * A successful resolution of a refkey.
+ *
+ * @example
+ *
+ * Let's say we have the following scopes and symbols:
+ *
+ * ```
+ * scope: global scope
+ * ├── scope: namespace scope 1
+ * │   └── symbol: foo
+ * │       └── static member scope
+ * │           └── symbol: bar
+ * └── scope: namespace scope 2
+ *    └── (resolve bar from here)
+ * ```
+ *
+ * When we resolve the refkey for `bar` from within `namespace scope 2`, we will get the following
+ * resolution result:
+ *
+ * * **targetDeclaration**: symbol bar, the symbol we resolved.
+ * * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference.
+ * * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope.
+ * * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration
+ * * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.
+ */
+
+export function createOutputBinder(options = {}) {
+  const binder = {
+    createScope,
+    createSymbol,
+    resolveDeclarationByKey,
+    addStaticMembersToSymbol,
+    addInstanceMembersToSymbol,
+    instantiateSymbolInto,
+    globalScope: undefined
+  };
+  const globalSymbols = reactive(new Set());
+  binder.globalScope = reactive({
+    kind: "global",
+    name: "<global>",
+    symbols: new Set(),
+    symbolsByRefkey: new Map(),
+    children: new Set(),
+    parent: undefined,
+    binder,
+    flags: OutputScopeFlags.None,
+    getSymbolNames: symbolNames(globalSymbols)
+  });
+  const knownDeclarations = new Map();
+  const waitingDeclarations = new Map();
+  return binder;
+  function createScope(args) {
+    const {
+      kind,
+      name,
+      parent,
+      owner,
+      flags = OutputScopeFlags.None,
+      ...rest
+    } = args;
+    if (flags & OutputScopeFlags.MemberScope) {
+      if (!owner) {
+        throw new Error("Member scopes must have an owner");
+      }
+    }
+
+    // member scopes don't have a parent regular scope. Perhaps in the future
+    // their parent would be something like a prototype object.
+    let parentScope;
+    if (parent) {
+      parentScope = parent;
+    } else if (flags & OutputScopeFlags.MemberScope) {
+      parentScope = undefined;
+    } else {
+      parentScope = useScope() ?? binder.globalScope;
+    }
+    const symbols = reactive(new Set());
+    const symbolsByRefkey = reactive(new Map());
+    const scope = reactive({
+      kind: kind,
+      name: name,
+      symbols,
+      symbolsByRefkey,
+      children: new Set(),
+      parent: parentScope,
+      flags,
+      owner,
+      binder,
+      ...rest,
+      getSymbolNames: symbolNames(symbols)
+    });
+    if (parentScope) {
+      parentScope.children.add(scope);
+    }
+    return scope;
+  }
+  function createSymbol(args) {
+    const {
+      name,
+      scope = useDefaultScope(args.flags),
+      refkey,
+      flags = OutputSymbolFlags.None,
+      ...rest
+    } = args;
+    if (!scope) {
+      throw new Error("No scope was provided and no scope could be found in context");
+    }
+    if (flags & OutputSymbolFlags.Member && (scope.flags & OutputScopeFlags.MemberScope) === 0) {
+      throw new Error("Member symbols must be stored in a member scope.");
+    }
+    if (scope.flags & OutputScopeFlags.StaticMemberScope) {
+      if (~flags & OutputSymbolFlags.InstanceMember && ~flags & OutputSymbolFlags.StaticMember) {
+        throw new Error("Symbols stored in a member scope must have either OutputSymbolFlags.InstanceMember or OutputSymbolFlags.StaticMember flags");
+      }
+    }
+    const symbol = reactive({
+      originalName: name,
+      name: name,
+      scope,
+      refkey,
+      binder,
+      flags,
+      ...rest
+    });
+    if (args.flags && args.flags & OutputSymbolFlags.InstanceMemberContainer) {
+      symbol.instanceMemberScope = createScope({
+        kind: "member",
+        name: "instance members",
+        parent: undefined,
+        owner: symbol,
+        flags: OutputScopeFlags.InstanceMemberScope
+      });
+    }
+    if (args.flags && args.flags & OutputSymbolFlags.StaticMemberContainer) {
+      symbol.staticMemberScope = createScope({
+        kind: "member",
+        name: "static members",
+        parent: undefined,
+        owner: symbol,
+        flags: OutputScopeFlags.StaticMemberScope
+      });
+    }
+    scope.symbols.add(symbol);
+    scope.symbolsByRefkey.set(symbol.refkey, symbol);
+    deconflict(symbol);
+    notifyRefkey(refkey, symbol);
+    return symbol;
+  }
+  function instantiateSymbolInto(source, target) {
+    if (~source.flags & OutputSymbolFlags.InstanceMemberContainer) {
+      throw new Error("Can only instantiate symbols with instance members");
+    }
+    addInstanceMembersToSymbol(target);
+    effect(() => {
+      for (const sym of source.instanceMemberScope.symbols) {
+        if (target.instanceMemberScope.symbols.has(sym)) {
+          continue;
+        }
+        createSymbol({
+          name: sym.name,
+          scope: target.instanceMemberScope,
+          refkey: refkey(target.refkey, sym.refkey),
+          flags: sym.flags | OutputSymbolFlags.InstanceMember
+        });
+      }
+    });
+  }
+  function addStaticMembersToSymbol(symbol) {
+    if (symbol.flags & OutputSymbolFlags.StaticMemberContainer) {
+      // nothing to do.
+      return;
+    }
+    symbol.flags |= OutputSymbolFlags.StaticMemberContainer;
+    symbol.staticMemberScope = createScope({
+      kind: "member",
+      name: "static members",
+      parent: undefined,
+      owner: symbol,
+      flags: OutputScopeFlags.StaticMemberScope
+    });
+  }
+  function addInstanceMembersToSymbol(symbol) {
+    if (symbol.flags & OutputSymbolFlags.InstanceMemberContainer) {
+      // nothing to do.
+      return;
+    }
+    symbol.flags |= OutputSymbolFlags.InstanceMemberContainer;
+    symbol.instanceMemberScope = createScope({
+      kind: "member",
+      name: "instance members",
+      parent: undefined,
+      owner: symbol,
+      flags: OutputScopeFlags.InstanceMemberScope
+    });
+  }
+  function resolveDeclarationByKey(currentScope, currentMemberScope, key) {
+    const targetDeclaration = knownDeclarations.get(key);
+    if (targetDeclaration) {
+      // this any cast hides a ridiculous error, fix it probably
+      return shallowRef(buildResult(currentScope, currentMemberScope, targetDeclaration));
+    } else {
+      return waitForRefkey(key, symbol => {
+        if (symbol) {
+          return buildResult(currentScope, currentMemberScope, symbol);
+        } else {
+          return undefined;
+        }
+      });
+    }
+  }
+  function buildResult(currentScope, currentMemberScope, targetDeclarationBase) {
+    if (targetDeclarationBase.flags & OutputSymbolFlags.InstanceMember) {
+      if (targetDeclarationBase.scope !== currentMemberScope) {
+        throw new Error("Cannot resolve member symbols from a different member scope");
+      }
+
+      // todo: handle referencing nested objects by refkey
+      return {
+        pathUp: [],
+        pathDown: [],
+        memberPath: [targetDeclarationBase],
+        commonScope: currentMemberScope,
+        targetDeclaration: targetDeclarationBase
+      };
+    }
+    const {
+      memberPath,
+      scopeChain: targetChain
+    } = scopeAndMemberChain(targetDeclarationBase);
+    const currentChain = scopeChain(currentScope);
+    let diffStart = 0;
+    while (targetChain[diffStart] && currentChain[diffStart] && targetChain[diffStart] === currentChain[diffStart]) {
+      diffStart++;
+    }
+    const pathUp = currentChain.slice(diffStart);
+    const pathDown = targetChain.slice(diffStart);
+    const commonScope = targetChain[diffStart - 1] ?? null;
+    return {
+      pathUp,
+      pathDown,
+      memberPath,
+      commonScope,
+      targetDeclaration: memberPath && memberPath.length > 0 ? memberPath.at(0) : targetDeclarationBase
+    };
+  }
+  function scopeAndMemberChain(symbol) {
+    const result = {
+      memberPath: [],
+      scopeChain: []
+    };
+    let currentSymbol = symbol;
+    while (currentSymbol.flags & OutputSymbolFlags.StaticMember) {
+      result.memberPath.unshift(currentSymbol);
+      currentSymbol = currentSymbol.scope.owner;
+    }
+    if (symbol.flags & OutputSymbolFlags.StaticMember) {
+      result.memberPath.unshift(currentSymbol);
+    }
+    const startScope = currentSymbol.scope;
+    result.scopeChain = scopeChain(startScope);
+    return result;
+  }
+  function scopeChain(scope) {
+    const chain = [];
+    while (scope) {
+      chain.unshift(scope);
+      scope = scope.parent;
+    }
+    return chain;
+  }
+  function deconflict(symbol) {
+    const scope = symbol.scope;
+    const existingNames = [...scope.symbols].filter(sym => sym.originalName === symbol.name);
+    if (existingNames.length < 2) {
+      return;
+    }
+    if (options.nameConflictResolver) {
+      options.nameConflictResolver(symbol.name, existingNames);
+    } else {
+      // default disambiguation is first-wins
+      for (let i = 1; i < existingNames.length; i++) {
+        existingNames[i].name = existingNames[i].originalName + "_" + (i + 1);
+      }
+    }
+  }
+  function waitForRefkey(refkey, cb) {
+    let declSignal;
+    if (waitingDeclarations.has(refkey)) {
+      declSignal = waitingDeclarations.get(refkey);
+    } else {
+      declSignal = shallowRef();
+      waitingDeclarations.set(refkey, declSignal);
+    }
+    return computed(() => cb(declSignal.value));
+  }
+  function notifyRefkey(refkey, symbol) {
+    if (!refkey) return;
+    knownDeclarations.set(refkey, symbol);
+    if (waitingDeclarations.has(refkey)) {
+      const signal = waitingDeclarations.get(refkey);
+      signal.value = symbol;
+    }
+  }
+}
+
+/**
+ * Resolve a refkey in the current scope. Returns a Ref for the resolution result.
+ * The value of the ref will be undefined if the identifier hasn't been resolved yet.
+ *
+ * @remarks
+ *
+ * This API may return a ref for undefined, but that does not mean that the symbol is
+ * not found. The symbol you're looking for may not have been declared yet. When the symbol
+ * is declared, the ref will be updated with the resolution result.
+ */
+export function resolve(refkey) {
+  const scope = useScope();
+  const memberScope = useMemberScope();
+  const binder = scope.binder;
+  return binder.resolveDeclarationByKey(scope, memberScope?.instanceMembers, refkey);
+}
+const createSymbolsSymbol = Symbol();
+export function getSymbolCreator(creator) {
+  return creator[createSymbolsSymbol];
+}
+export function getSymbolCreatorSymbol() {
+  return createSymbolsSymbol;
+}
+function symbolNames(symbols) {
+  return memo(() => {
+    const names = new Set();
+    for (const sym of symbols.values()) {
+      names.add(sym.name);
+    }
+    return names;
+  });
+}
+
+/**
+ * Use symbol flags to determine the scope in which a symbol with those flags
+ * should be declared given the current context.
+ *
+ * @param flags - The symbol flags to use to determine the default scope.
+ * @returns an {@link OutputScope} that is the default scope for the given
+ * flags.
+ */
+export function useDefaultScope(flags = OutputSymbolFlags.None) {
+  if ((flags & OutputSymbolFlags.Member) === 0) {
+    return useScope();
+  } else {
+    const memberScope = useMemberScope();
+    if (!memberScope) {
+      throw new Error("Cannot declare member symbols without a member scope");
+    }
+    if (flags & OutputSymbolFlags.InstanceMember) {
+      return memberScope.instanceMembers;
+    } else {
+      return memberScope.staticMembers;
+    }
+  }
+}
+//# sourceMappingURL=binder.js.map

package/dist/src/binder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binder.js","names":["memo","computed","effect","reactive","shallowRef","useMemberScope","useScope","refkey","OutputSymbolFlags","OutputScopeFlags","createOutputBinder","options","binder","createScope","createSymbol","resolveDeclarationByKey","addStaticMembersToSymbol","addInstanceMembersToSymbol","instantiateSymbolInto","globalScope","undefined","globalSymbols","Set","kind","name","symbols","symbolsByRefkey","Map","children","parent","flags","None","getSymbolNames","symbolNames","knownDeclarations","waitingDeclarations","args","owner","rest","MemberScope","Error","parentScope","scope","add","useDefaultScope","Member","StaticMemberScope","InstanceMember","StaticMember","symbol","originalName","InstanceMemberContainer","instanceMemberScope","InstanceMemberScope","StaticMemberContainer","staticMemberScope","set","deconflict","notifyRefkey","source","target","sym","has","currentScope","currentMemberScope","key","targetDeclaration","get","buildResult","waitForRefkey","targetDeclarationBase","pathUp","pathDown","memberPath","commonScope","scopeChain","targetChain","scopeAndMemberChain","currentChain","diffStart","slice","length","at","result","currentSymbol","unshift","startScope","chain","existingNames","filter","nameConflictResolver","i","cb","declSignal","value","signal","resolve","memberScope","instanceMembers","createSymbolsSymbol","Symbol","getSymbolCreator","creator","getSymbolCreatorSymbol","names","values","staticMembers"],"sources":["../../src/binder.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/code.d.ts

@@ -0,0 +1,3 @@
+import { Child } from "@alloy-js/core";
+export declare function code(template: TemplateStringsArray, ...substitutions: Child[]): Child[];
+//# sourceMappingURL=code.d.ts.map

package/dist/src/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/code.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAU,MAAM,gBAAgB,CAAC;AAO/C,wBAAgB,IAAI,CAClB,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,aAAa,EAAE,KAAK,EAAE,WA6E1B"}

package/dist/src/code.js

@@ -0,0 +1,156 @@
+// this code is split into a tokenizer and a parser of sorts because I feel like
+// it should be psosible to share logic between this and the babel transform, but
+// this is an exercise for the future.
+import { Indent } from "@alloy-js/core";
+export function code(template, ...substitutions) {
+  const indentNodes = [{
+    kind: "indent",
+    children: [],
+    pendingLines: []
+  }];
+  for (const child of childTokens(template, substitutions)) {
+    if (child.indentationLevel > indentNodes.length - 1) {
+      // indentation level increased (can only ever increase by 1)
+      pushIndent();
+    } else if (child.indentationLevel < indentNodes.length - 1) {
+      popIndent(child);
+    }
+    const currentIndent = indentNodes.at(-1);
+    if (child.kind === "line") {
+      currentIndent.pendingLines.push(child.line);
+    } else {
+      flushLines();
+      currentIndent.children.push(child.value);
+    }
+  }
+  popIndent();
+  flushLines();
+  function childNodesFor(indentNode) {
+    return indentNode.children.map(child => {
+      if (typeof child === "object" && child !== null && child.kind === "indent") {
+        return () => Indent({
+          children: childNodesFor(child)
+        });
+      } else {
+        return child;
+      }
+    });
+  }
+  return childNodesFor(indentNodes[0]);
+  function pushIndent() {
+    flushLines();
+    const newIndent = {
+      kind: "indent",
+      children: [],
+      pendingLines: [""]
+    };
+    indentNodes.at(-1).children.push(newIndent);
+    indentNodes.push(newIndent);
+  }
+  function popIndent(child) {
+    // indentation level decreased (can decrease by many)
+    const times = child ? indentNodes.length - child.indentationLevel - 1 : indentNodes.length - 1;
+    for (let i = 0; i < times; i++) {
+      flushLines();
+      indentNodes.pop();
+    }
+    if (child) {
+      // need a linebreak after dedenting
+      indentNodes.at(-1).pendingLines.push("");
+    }
+  }
+  function flushLines() {
+    const currentIndent = indentNodes.at(-1);
+    currentIndent.children.push(currentIndent.pendingLines.join("\n"));
+    currentIndent.pendingLines = [];
+  }
+}
+function* childTokens(template, substitutions) {
+  let newline = false;
+  const indentStack = [{
+    level: -1,
+    literalIndent: ""
+  }];
+  yield* processLiteralString(template[0], substitutions.length === 0 ? "only" : "first");
+  newline = false;
+  for (let i = 0; i < substitutions.length; i++) {
+    const indentationLevel = currentIndent().level;
+    yield {
+      kind: "other",
+      value: substitutions[i],
+      indentationLevel: indentationLevel < 0 ? 0 : indentationLevel,
+      newline
+    };
+    yield* processLiteralString(template[i + 1], i === substitutions.length - 1 ? "last" : undefined);
+    newline = false;
+  }
+  function processLiteralString(child, pos) {
+    const lines = child.split("\n");
+    const lineTokens = [];
+    if ((pos === "first" || pos === "only") && lines[0].match(/^\s*$/)) {
+      // remove leading whitespace.
+      lines.shift();
+      newline = true;
+    }
+    if ((pos === "last" || pos === "only") && lines[lines.length - 1].match(/^\s*$/)) {
+      // remove trailing whitespace
+      lines.pop();
+      if (lines.length === 1 && lines[0].trimStart() === "") {
+        // an empty line following a component most likely
+        return [];
+      }
+    }
+
+    // eslint-disable-next-line prefer-const
+    for (let [lineNum, line] of lines.entries()) {
+      if (lineNum > 0) {
+        newline = true;
+      }
+      if (newline) {
+        if (line === "" && currentIndent().level > -1) {
+          // for empty lines we want to just continue with the current indentation
+          lineTokens.push({
+            kind: "line",
+            line: "",
+            indentationLevel: currentIndent().level,
+            newline
+          });
+          continue;
+        }
+        const lineIndent = line.match(/^\s+/)?.[0] ?? "";
+        const startIndent = currentIndent();
+        if (lineIndent.length > startIndent.literalIndent.length) {
+          indentStack.push({
+            level: startIndent.level + 1,
+            literalIndent: lineIndent
+          });
+        } else {
+          while (currentIndent().literalIndent.length > lineIndent.length) {
+            indentStack.pop();
+          }
+        }
+        line = line.trimStart();
+        const indentationLevel = currentIndent().level;
+        lineTokens.push({
+          kind: "line",
+          line,
+          indentationLevel: indentationLevel < 0 ? 0 : indentationLevel,
+          newline
+        });
+      } else {
+        const indentationLevel = currentIndent().level;
+        lineTokens.push({
+          kind: "line",
+          line,
+          indentationLevel: indentationLevel < 0 ? 0 : indentationLevel,
+          newline
+        });
+      }
+    }
+    return lineTokens;
+  }
+  function currentIndent() {
+    return indentStack.at(-1);
+  }
+}
+//# sourceMappingURL=code.js.map

package/dist/src/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","names":["Indent","code","template","substitutions","indentNodes","kind","children","pendingLines","child","childTokens","indentationLevel","length","pushIndent","popIndent","currentIndent","at","push","line","flushLines","value","childNodesFor","indentNode","map","newIndent","times","i","pop","join","newline","indentStack","level","literalIndent","processLiteralString","undefined","pos","lines","split","lineTokens","match","shift","trimStart","lineNum","entries","lineIndent","startIndent"],"sources":["../../src/code.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/components/Declaration.d.ts

@@ -0,0 +1,29 @@
+import { Children } from "@alloy-js/core/jsx-runtime";
+import { OutputSymbol } from "../binder.js";
+import { Refkey } from "../refkey.js";
+export interface DeclarationProps {
+    name?: string;
+    refkey?: Refkey;
+    symbol?: OutputSymbol;
+    children?: Children;
+}
+/**
+ * Declares a symbol in the current scope for this component's children.
+ *
+ * @remarks
+ *
+ * This component must be called in one of two ways: with a name and an optional
+ * refkey, or else passing in the symbol. When called with a name and refkey, a
+ * symbol will be created in the current scope (provided by
+ * {@link ScopeContext}) with that name and refkey. If a refkey is not provided,
+ * `refkey(props.name)` is used.
+ *
+ * When called with a symbol, that symbol is merely exposed via
+ * {@link DeclarationContext }. It is assumed that the caller of this component
+ * has created the symbol with the `createSymbol` API on the
+ * {@link BinderContext }.
+ *
+ * @see {@link BinderContext}
+ */
+export declare function Declaration(props: DeclarationProps): any;
+//# sourceMappingURL=Declaration.d.ts.map

package/dist/src/components/Declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Declaration.d.ts","sourceRoot":"","sources":["../../../src/components/Declaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,MAAM,EAAU,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,OAoBlD"}