wesl 0.6.0-pre10

package/dist/tools/packages/wesl/src/parse/WeslStream.d.ts

@@ -0,0 +1,44 @@
+import { Stream, TypedToken } from '../../../mini-parse/src';
+export type WeslTokenKind = "word" | "keyword" | "number" | "symbol";
+export type WeslToken<Kind extends WeslTokenKind = WeslTokenKind> = TypedToken<Kind>;
+/** Checks if a word is a valid WGSL ident, and not a keyword */
+export declare function isIdent(text: string): boolean;
+/** To mark parts of the grammar implementation that are WESL specific extensions */
+export declare function weslExtension<T>(combinator: T): T;
+export declare class WeslStream implements Stream<WeslToken> {
+    src: string;
+    private stream;
+    /** New line */
+    private eolPattern;
+    /** Block comments */
+    private blockCommentPattern;
+    constructor(src: string);
+    checkpoint(): number;
+    reset(position: number): void;
+    nextToken(): WeslToken | null;
+    private skipToEol;
+    private skipBlockComment;
+    /**
+     * Only matches the `<` token if it is a template
+     * Precondition: An ident was parsed right before this.
+     * Runs the [template list discovery algorithm](https://www.w3.org/TR/WGSL/#template-list-discovery).
+     */
+    nextTemplateStartToken(): (WeslToken & {
+        kind: "symbol";
+    }) | null;
+    nextTemplateEndToken(): (WeslToken & {
+        kind: "symbol";
+    }) | null;
+    isTemplateStart(afterToken: number): boolean;
+    /**
+     * Call this after consuming an opening bracket.
+     * Skips until a closing bracket. This also consumes the closing bracket.
+     */
+    skipBracketsTo(closingBracket: string): void;
+}
+export declare const templateOpen: import('../../../mini-parse/src').Parser<import('../../../mini-parse/src').ParserStream, WeslToken<WeslTokenKind> & {
+    kind: "symbol";
+}>;
+export declare const templateClose: import('../../../mini-parse/src').Parser<import('../../../mini-parse/src').ParserStream, WeslToken<WeslTokenKind> & {
+    kind: "symbol";
+}>;

package/dist/tools/packages/wesl/src/test/BindWESL.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ConditionLinking.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ConditionalTranslationCases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ErrorLogging.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/Expression.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/FlattenTreeImport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ImportCases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ImportSyntaxCases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/LinkGlob.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/LinkPackage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/Linker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/Mangling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ParseComments.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ParseConditions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ParseError.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ParseWESL.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/PathUtil.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/PrettyGrammar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/Reflection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/ScopeWESL.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/TestLink.d.ts

@@ -0,0 +1,21 @@
+import { RunnerTestSuite } from 'vitest';
+import { WgslTestSrc } from '../../../../../wesl-testsuite/src';
+import { ManglerFn } from '../Mangler.ts';
+/**
+ * Link wesl sources and compare the linked wgsl vs expectations.
+ * Ignores blank lines and initial blank columns.
+ *
+ * (for tests)
+ */
+export declare function testLink(weslSrc: Record<string, string>, rootModuleName: string, expectedWgsl: string, mangler?: ManglerFn): Promise<void>;
+type TestCaseMap = Map<string, WgslTestSrc>;
+/**
+ * Test link one test case from one a shared test suite
+ *  (ImportCases, ConditionalTranslationCases, etc.)
+ */
+export declare function testFromCase(name: string, cases: TestCaseMap): Promise<void>;
+/**
+ * for afterAll(), to verify that all cases are covered from one of the shared test suites
+ */
+export declare function verifyCaseCoverage(caseList: WgslTestSrc[]): (suite: RunnerTestSuite) => void;
+export {};

package/dist/tools/packages/wesl/src/test/TestSetup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/TestUtil.d.ts

@@ -0,0 +1,40 @@
+import { Parser, Stream } from '../../../mini-parse/src';
+import { TestParseResult } from '../../../mini-parse/src/test-util';
+import { BoundAndTransformed, ParsedRegistry } from '..';
+import { LinkParams } from '../Linker.js';
+import { WeslToken } from '../parse/WeslStream.js';
+import { WeslAST } from '../ParseWESL.js';
+export declare function testAppParse<T>(parser: Parser<Stream<WeslToken>, T>, src: string): TestParseResult<T, WeslAST>;
+/** Convenience wrapper to link wgsl for tests.
+ * The first module is named "./test.wesl",
+ * subsequent modules are named "./file1.wesl", "./file2.wesl", etc.
+ */
+export declare function linkTest(...rawWgsl: string[]): Promise<string>;
+export type LinkTestOpts = Pick<LinkParams, "conditions" | "libs" | "config" | "virtualLibs" | "constants" | "mangler">;
+export declare function linkTestOpts(opts: LinkTestOpts, ...rawWgsl: string[]): Promise<string>;
+/** Link wesl for tests, and return the console log as well */
+export declare function linkWithLog(...rawWgsl: string[]): Promise<{
+    log: string;
+    result: string;
+}>;
+/** Link wesl for tests, and return the console log as well.
+ * Quietly swallow any exceptions thrown */
+export declare function linkWithLogQuietly(...rawWgsl: string[]): Promise<{
+    log: string;
+    result: string;
+}>;
+/** parse wesl for testing, and return the AST */
+export declare function parseTest(src: string): WeslAST;
+/** test w/o any log collection, to not confuse debugging */
+export declare function parseTestRaw(src: string): WeslAST;
+interface BindTestResult {
+    bound: BoundAndTransformed;
+    registry: ParsedRegistry;
+}
+/**
+ * Test parsing and binding some wesl src.
+ * @return both the bound result and the internal registry.
+ * (since binding mutates the AST, it's useful for tests to review)
+ */
+export declare function bindTest(...rawWesl: string[]): BindTestResult;
+export {};

package/dist/tools/packages/wesl/src/test/Tokenizer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/TransformBindingStructs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/Util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/VirtualModules.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/test/WeslDevice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/packages/wesl/src/vlq/vlq.d.ts

@@ -0,0 +1,11 @@
+/*!
+Copyright (c) 2017-2021 [these people](https://github.com/Rich-Harris/vlq/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*/
+export declare function decodeVlq(string: string): number[];
+export declare function encodeVlq(value: number | number[]): string;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "wesl",
+  "version": "0.6.0-pre10",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "repository": "github:wgsl-tooling-wg/wesl-js",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/tools/packages/wesl/src/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./minified": {
+      "types": "./dist/tools/packages/wesl/src/index.d.ts",
+      "import": "./dist/minified.js"
+    }
+  },
+  "dependencies": {
+    "mini-parse": "0.6.0-pre10"
+  },
+  "devDependencies": {
+    "ncp": "^2.0.0",
+    "rollup-plugin-visualizer": "^5.14.0",
+    "terser": "^5.38.1",
+    "vite-plugin-dts": "^4.5.0",
+    "random_wgsl": "0.6.0-pre10"
+  },
+  "scripts": {
+    "echo": "echo",
+    "build": "run-s build:main build:minified",
+    "build:main": "vite build",
+    "build:minified": "vite build --config minified.vite.config.js",
+    "build:sizetest": "vite build --config sizetest.vite.config.js",
+    "build:brotli-size": "tsx ./scripts/brotli.ts dist/sized.cjs",
+    "build:size": "run-s build:sizetest build:brotli-size",
+    "typecheck": "tsc",
+    "format": "prettier . --write",
+    "lint": "eslint src",
+    "organize": "organize-imports-cli tsconfig.json",
+    "test": "vitest",
+    "test:once": "vitest run"
+  }
+}