@lite31/invoice-vat 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @lite31/invoice-vat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`invoice_vat.js` is `jco` 1.40.0 instantiation-mode output for a `componentize-py` 0.25.1 component built with `--stub-wasi`. Its URL-loading fallback was removed, so callers must pass `getCoreModule` and supply every `invoice_vat.core*.wasm` module compiled ahead of time. The component imports nothing and exports `calculate(net: string, rate: string) -> string`.
+
+This package exists only to test an Executor worker. It has no support or compatibility promise.

package/interfaces/exports.d.ts

@@ -0,0 +1,100 @@
+/** @module Interface exports **/
+export function init(appName: string, symbols: Symbols, stubWasi: boolean): void;
+export interface Function {
+  protocol: string,
+  name: string,
+}
+export interface Constructor {
+  module: string,
+  protocol: string,
+}
+export interface Static {
+  module: string,
+  protocol: string,
+  name: string,
+}
+export type FunctionExportKind = FunctionExportKindFreestanding | FunctionExportKindConstructor | FunctionExportKindMethod | FunctionExportKindStatic;
+export interface FunctionExportKindFreestanding {
+  tag: 'freestanding',
+  val: Function,
+}
+export interface FunctionExportKindConstructor {
+  tag: 'constructor',
+  val: Constructor,
+}
+export interface FunctionExportKindMethod {
+  tag: 'method',
+  val: string,
+}
+export interface FunctionExportKindStatic {
+  tag: 'static',
+  val: Static,
+}
+export type ReturnStyle = ReturnStyleNone | ReturnStyleNormal | ReturnStyleResult;
+export interface ReturnStyleNone {
+  tag: 'none',
+}
+export interface ReturnStyleNormal {
+  tag: 'normal',
+}
+export interface ReturnStyleResult {
+  tag: 'result',
+}
+export interface FunctionExport {
+  kind: FunctionExportKind,
+  returnStyle: ReturnStyle,
+}
+export interface Resource {
+  "package": string,
+  name: string,
+}
+export interface Record {
+  "package": string,
+  name: string,
+  fields: Array<string>,
+}
+export interface Flags {
+  "package": string,
+  name: string,
+  u32Count: number,
+}
+export interface Tuple {
+  count: number,
+}
+export interface Case {
+  name: string,
+  hasPayload: boolean,
+}
+export interface Variant {
+  "package": string,
+  name: string,
+  cases: Array<Case>,
+}
+export interface Enum {
+  "package": string,
+  name: string,
+  count: number,
+}
+/**
+ * # Variants
+ * 
+ * ## `"non-nesting"`
+ * 
+ * ## `"nesting"`
+ */
+export type OptionKind = "non-nesting" | "nesting";
+export interface ResultRecord {
+  hasOk: boolean,
+  hasErr: boolean,
+}
+export interface Symbols {
+  exports: Array<FunctionExport>,
+  resources: Array<Resource>,
+  records: Array<Record>,
+  flags: Array<Flags>,
+  tuples: Array<Tuple>,
+  variants: Array<Variant>,
+  enums: Array<Enum>,
+  options: Array<OptionKind>,
+  results: Array<ResultRecord>,
+}

package/invoice_vat.d.ts

@@ -0,0 +1,63 @@
+// world root:component/root
+import type * as Exports from './interfaces/exports.js'; // exports
+export interface ImportObject {
+}
+export interface Root {
+  exports: typeof Exports,
+  calculate(net: string, rate: string): string,
+}
+
+/**
+* Options accepted by `instantiate`.
+*/
+export interface InstantiateOptions {
+  /** Runtime overrides for this instance. */
+  shim?: {
+    /** Platform globals used instead of those on `globalThis`. */
+    globals?: {
+      /**
+      * The WebAssembly implementation used by this instance,
+      * including by the default `instantiateCore`. Defaults to
+      * `globalThis.WebAssembly`.
+      */
+      WebAssembly?: typeof WebAssembly;
+    };
+  };
+}
+
+
+/**
+* Instantiates this component with the provided imports and
+* returns a map of all the exports of the component.
+*
+* This function is intended to be similar to the
+* `WebAssembly.Instantiate` constructor. The second `imports`
+* argument is the "import object" for wasm, except here it
+* uses component-model-layer types instead of core wasm
+* integers/numbers/etc.
+*
+* The first argument to this function, `getCoreModule`, is
+* used to compile core wasm modules within the component.
+* Components are composed of core wasm modules and this callback
+* will be invoked per core wasm module. The caller of this
+* function is responsible for reading the core wasm module
+* identified by `path` and returning its compiled
+* `WebAssembly.Module` object. This would use the
+* `WebAssembly.Module` constructor on the web, for example.
+*
+* The optional `options` argument configures instantiation; see
+* `InstantiateOptions`.
+*/
+export function instantiate(
+getCoreModule: (path: string) => WebAssembly.Module,
+imports: ImportObject,
+instantiateCore?: (module: WebAssembly.Module, imports: Record<string, any>) => WebAssembly.Instance,
+options?: InstantiateOptions
+): Root;
+export function instantiate(
+getCoreModule: (path: string) => WebAssembly.Module | Promise<WebAssembly.Module>,
+imports: ImportObject,
+instantiateCore?: (module: WebAssembly.Module, imports: Record<string, any>) => WebAssembly.Instance | Promise<WebAssembly.Instance>,
+options?: InstantiateOptions
+): Root | Promise<Root>;
+