sveast 0.6.0 → 0.8.0

package/index.d.ts

@@ -15,6 +15,174 @@ export declare function isValidType(text: string, options?: {
     inline?: boolean;
 }): boolean;
 
+/** A module specifier: the string after `from`, or after `import` in `import "a"`. */
+export interface LexedSource {
+    /** The string's value, with escapes decoded. */
+    value: string;
+    /** The offset of the opening quote. */
+    start: number;
+    /** The offset after the closing quote. */
+    end: number;
+}
+
+/** A name an `import` binds. */
+export interface LexedImportSpecifier {
+    /** `"default"` for `a` in `import a from`, `"namespace"` for `* as a`, `"named"` for a name in braces. */
+    kind: "default" | "namespace" | "named";
+    /** The name in the imported module: `"default"`, `"*"` for a namespace, or the name before `as`, with a string's value for `"a-b" as c`. */
+    imported: string;
+    /** The name it's bound to in this module. */
+    local: string;
+    /** Whether it's only a type: in `import type`, or with `type` before it. */
+    typeOnly: boolean;
+    /** The offset of the name, of `*`, or of `type` before the name. */
+    start: number;
+    /** The offset after the local name. */
+    end: number;
+}
+
+/** A name an `export … from` re-exports. */
+export interface LexedExportSpecifier {
+    /** `"all"` for `export *`, `"namespace"` for `export * as a`, `"named"` for a name in braces. */
+    kind: "all" | "namespace" | "named";
+    /** The name in the other module: `"*"` for `all` and `namespace`, or the name before `as`, with a string's value for `"a-b" as c`. */
+    local: string;
+    /** The name it's exported as, or `null` for `export *`. */
+    exported: string | null;
+    /** Whether it's only a type: in `export type`, or with `type` before it. */
+    typeOnly: boolean;
+    /** The offset of the name, of `*`, or of `type` before the name. */
+    start: number;
+    /** The offset after the exported name, or after `*` for `export *`. */
+    end: number;
+}
+
+interface LexedStatementBase {
+    /** The offset of `import` or `export`. */
+    start: number;
+    /** The offset after the statement's `;`, or its last token without one. */
+    end: number;
+    /** The module it imports from, or `null` for a statement the lexer doesn't recognize. */
+    source: LexedSource | null;
+    /** Whether it's `import type` or `export type`. */
+    typeOnly: boolean;
+}
+
+/** An `import` statement. */
+export interface LexedImport extends LexedStatementBase {
+    kind: "import";
+    specifiers: LexedImportSpecifier[];
+}
+
+/** An `export … from` statement. */
+export interface LexedExport extends LexedStatementBase {
+    kind: "export";
+    specifiers: LexedExportSpecifier[];
+}
+
+export type LexedStatement = LexedImport | LexedExport;
+
+/**
+ * A module's top-level `import` statements and `export … from`
+ * re-exports, read without a parser: each statement's offsets, its
+ * source and the names it imports or re-exports. It finds statements as
+ * {@link parseImportsExports} does with `localExports: false`, and on
+ * every statement that accepts, gives the same offsets, sources and names,
+ * but it doesn't check syntax and never throws. A statement it can't read,
+ * including TypeScript's `import a = require("a")`, is returned with
+ * `source: null` and no specifiers, ending where it stopped reading.
+ * TypeScript's `type` forms are always read.
+ */
+export declare function lexImportsExports(source: string): LexedStatement[];
+
+/** An attribute of a top-level `<script>`, `<style>` or `<svelte:options>`. */
+export interface LexedAttribute {
+    name: string;
+    /**
+     * The value as written, without its quotes: character references
+     * aren't decoded, and an expression keeps its braces, as in `"{true}"`
+     * for `runes={true}`. `true` for an attribute without a value.
+     */
+    value: string | true;
+    /** The offset of the name. */
+    start: number;
+    /** The offset after the value, or after the name without one. */
+    end: number;
+}
+
+/** The text between a top-level element's tags. */
+export interface LexedContent {
+    start: number;
+    end: number;
+}
+
+/** A top-level `<script>`. */
+export interface LexedScript {
+    /** The offset of `<script`. */
+    start: number;
+    /** The offset after `</script>`. */
+    end: number;
+    /** `"module"` for `<script module>` or `<script context="module">`. */
+    context: "default" | "module";
+    attributes: LexedAttribute[];
+    content: LexedContent;
+}
+
+/** The top-level `<style>`. */
+export interface LexedStyle {
+    /** The offset of `<style`. */
+    start: number;
+    /** The offset after `</style>`. */
+    end: number;
+    attributes: LexedAttribute[];
+    content: LexedContent;
+}
+
+/** `<svelte:options>`. */
+export interface LexedOptions {
+    /** The offset of `<svelte:options`. */
+    start: number;
+    /** The offset after `/>` or `</svelte:options>`. */
+    end: number;
+    attributes: LexedAttribute[];
+}
+
+/** A component's top-level sections, as {@link lexComponent} finds them. */
+export interface LexedComponent {
+    /**
+     * Whether `parse` reads the component as TypeScript, which needs the
+     * TypeScript plugin: svelte decides it from the first `<script>` with a
+     * `lang`, so this is `true` when that one has `lang="ts"`.
+     */
+    typescript: boolean;
+    /** The `<script>` without `module`, as `parse`'s `instance`. */
+    instance: LexedScript | null;
+    /** The `<script module>`, as `parse`'s `module`. */
+    module: LexedScript | null;
+    /** The `<style>`, as `parse`'s `css`. */
+    css: LexedStyle | null;
+    /** `<svelte:options>`, as `parse`'s `options`. */
+    options: LexedOptions | null;
+}
+
+/**
+ * A component's top-level `<script>`, `<script module>`, `<style>` and
+ * `<svelte:options>`, with their attributes and the offsets of their tags
+ * and content, read without a parser: e.g. to find a component's
+ * language or imports, or to rewrite its scripts, without parsing the
+ * markup. The offsets are `parse`'s, so they're into the source without
+ * a leading byte order mark.
+ *
+ * The markup is skipped by tracking only tags, attribute values, blocks
+ * and the brackets, strings, comments and templates of each `{…}`
+ * expression, so a `<script>` inside an element, a block, a string or a
+ * comment isn't one. It stops after the last `<script`, `<style` or
+ * `<svelte:options`. Where `parse` accepts the component, the sections
+ * are the same as its `instance`, `module`, `css` and `options`; it
+ * doesn't check syntax and never throws.
+ */
+export declare function lexComponent(input: string): LexedComponent;
+
 /**
  * Options for {@link parse}. The defaults give svelte's own output, minus
  * `loc` and `name_loc`.
@@ -1776,6 +1944,56 @@ interface Location {
     character: number;
 }
 
+/**
+ * A function from an offset in `text` to its line, from 1, and column,
+ * from 0, in UTF-16 code units: what `loc: true` gives the node that
+ * starts there, without parsing with `loc`. Lines end at `\n`, as in
+ * svelte's markup `loc` and in `ParseError`; acorn's `loc` in
+ * scripts and modules also ends them at a `\r` not followed by `\n`, at
+ * U+2028 and at U+2029. `parse` drops a leading byte order mark, so pass
+ * the text without it. Lines are found on the first call; lookups in
+ * source order are fastest.
+ *
+ * ```ts
+ * import { createLocator, parse, walk } from "sveast";
+ *
+ * const locate = createLocator(source);
+ * walk(parse(source), {
+ *   enter(node) {
+ *     if (node.type === "Component") console.log(node.name, locate(node.start).line);
+ *   },
+ * });
+ * ```
+ */
+export declare function createLocator(text: string): (offset: number) => Position;
+
+/**
+ * Parses a component's top-level `<script>`s, `<style>` and
+ * `<svelte:options>` as {@link parse} does, and skips the markup between
+ * them as `lexComponent` skips it: `fragment` has no nodes, `comments`
+ * only the scripts' comments, and errors in the markup aren't reported.
+ * The rest is `parse`'s, offsets included. For a pass that only reads the
+ * scripts, such as a component's props or its module script's exports.
+ *
+ * Throws a {@link ParseError} on a syntax error in a section.
+ */
+export declare function parseSections(source: string, options?: ParseOptions): AST.Root;
+
+/**
+ * Whether svelte compiles the component in runes mode, as
+ * `compile(source).metadata.runes` says: `<svelte:options runes>` if it
+ * has one, otherwise whether it uses a rune, such as `$state` or
+ * `$props`, or `await` outside a function in its instance script or
+ * markup. A `$state` that subscribes to a store named `state` isn't a
+ * rune, as in svelte.
+ *
+ * It reads `<svelte:options>` without parsing, and a component that has
+ * no rune's name and no `await` isn't parsed either. Otherwise it parses
+ * the scripts, and the markup only if one of them is in it, and throws a
+ * `ParseError` on a syntax error there.
+ */
+export declare function isRunesMode(source: string): boolean;
+
 /**
  * The fields of each node type that hold child nodes, in source order.
  * Typed against the AST, so a node type without an entry, or a key that
@@ -1982,6 +2200,58 @@ export declare const visitorKeys: {
     readonly TSInstantiationExpression: readonly ["expression", "typeArguments"];
 };
 
+/** A table of the fields of each node type that {@link walk} visits, such as {@link visitorKeys} or {@link markupVisitorKeys}. */
+export type VisitorKeys = Readonly<Partial<Record<string, readonly string[]>>>;
+
+/**
+ * The fields of the markup's nodes that hold other markup nodes, for a
+ * {@link walk} that never enters the scripts, the styles or the
+ * expressions: `Root` holds only its `fragment`, an `ExpressionTag` or a
+ * directive has no children, and a block holds only its fragments.
+ */
+export declare const markupVisitorKeys: {
+    readonly Root: readonly ["fragment"];
+    readonly Fragment: readonly ["nodes"];
+    readonly Text: readonly [];
+    readonly Comment: readonly [];
+    readonly ExpressionTag: readonly [];
+    readonly HtmlTag: readonly [];
+    readonly ConstTag: readonly [];
+    readonly DeclarationTag: readonly [];
+    readonly DebugTag: readonly [];
+    readonly RenderTag: readonly [];
+    readonly AttachTag: readonly [];
+    readonly Attribute: readonly ["value"];
+    readonly SpreadAttribute: readonly [];
+    readonly AnimateDirective: readonly [];
+    readonly BindDirective: readonly [];
+    readonly ClassDirective: readonly [];
+    readonly LetDirective: readonly [];
+    readonly OnDirective: readonly [];
+    readonly StyleDirective: readonly ["value"];
+    readonly TransitionDirective: readonly [];
+    readonly UseDirective: readonly [];
+    readonly Component: readonly ["attributes", "fragment"];
+    readonly TitleElement: readonly ["attributes", "fragment"];
+    readonly SlotElement: readonly ["attributes", "fragment"];
+    readonly RegularElement: readonly ["attributes", "fragment"];
+    readonly SvelteBody: readonly ["attributes", "fragment"];
+    readonly SvelteBoundary: readonly ["attributes", "fragment"];
+    readonly SvelteComponent: readonly ["attributes", "fragment"];
+    readonly SvelteDocument: readonly ["attributes", "fragment"];
+    readonly SvelteElement: readonly ["attributes", "fragment"];
+    readonly SvelteFragment: readonly ["attributes", "fragment"];
+    readonly SvelteHead: readonly ["attributes", "fragment"];
+    readonly SvelteOptions: readonly ["attributes", "fragment"];
+    readonly SvelteSelf: readonly ["attributes", "fragment"];
+    readonly SvelteWindow: readonly ["attributes", "fragment"];
+    readonly IfBlock: readonly ["consequent", "alternate"];
+    readonly EachBlock: readonly ["body", "fallback"];
+    readonly AwaitBlock: readonly ["pending", "then", "catch"];
+    readonly KeyBlock: readonly ["fragment"];
+    readonly SnippetBlock: readonly ["body"];
+};
+
 /**
  * Return it from `enter` or `leave` to end the walk: no further `enter` or
  * `leave` calls, including `leave` on the node's ancestors.
@@ -2014,9 +2284,12 @@ export interface Visitor {
  * Visits `node` and its descendants depth-first, in source order, calling
  * `visitor.enter` before a node's children and `visitor.leave` after them.
  * `parent[key]` is the node, or `parent[key][index]` when the field is an
- * array; all three are `null` for `node` itself.
+ * array; all three are `null` for `node` itself. `keys` says which fields
+ * of each node type to visit, {@link visitorKeys} by default; with
+ * {@link markupVisitorKeys}, only the markup is visited. A node whose
+ * type it has no entry for throws.
  */
-export declare function walk(node: AST.SvelteNode, visitor: Visitor): void;
+export declare function walk(node: AST.SvelteNode, visitor: Visitor, keys?: VisitorKeys): void;
 
 /**
  * The `Identifier` nodes a pattern binds, in source order: `a`, `c`, `d`,

package/index.js

@@ -1 +1 @@
-import{isValidType as t}from"./is-valid-type.js";import{parse as p}from"./parse.js";import{parseImportsExports as i}from"./parse-imports-exports.js";import{ParseError as a,parseModule as f}from"./parse-module.js";import{extractIdentifiers as y,isReference as l,SKIP as n,STOP as P,visitorKeys as d,walk as I}from"./walk.js";export{a as ParseError,n as SKIP,P as STOP,y as extractIdentifiers,l as isReference,t as isValidType,p as parse,i as parseImportsExports,f as parseModule,d as visitorKeys,I as walk};
+import{isValidType as t}from"./is-valid-type.js";import{lexComponent as p,lexImportsExports as s}from"./lexer.js";import{parse as i}from"./parse.js";import{parseImportsExports as f}from"./parse-imports-exports.js";import{ParseError as d,parseModule as n}from"./parse-module.js";import{parseSections as L}from"./parse-sections.js";import{isRunesMode as l}from"./runes.js";import{createLocator as I,extractIdentifiers as u,isReference as E,markupVisitorKeys as P,SKIP as O,STOP as K,visitorKeys as V,walk as k}from"./walk.js";export{d as ParseError,O as SKIP,K as STOP,I as createLocator,u as extractIdentifiers,E as isReference,l as isRunesMode,t as isValidType,p as lexComponent,s as lexImportsExports,P as markupVisitorKeys,i as parse,f as parseImportsExports,n as parseModule,L as parseSections,V as visitorKeys,k as walk};

package/is-valid-type.js

@@ -1 +1 @@
-import{t}from"./shared-f8ty80r9.js";import{g}from"./shared-c4vs4cam.js";var a=new Set("abstract accessor arguments as asserts async await break case catch class const continue debugger declare default delete do else enum eval export extends false finally for function get global if implements import in infer instanceof interface intrinsic is keyof let module namespace new null of out override package private protected public readonly return satisfies set static super switch this throw true try type typeof unique var void while with yield".split(" ")),c=new Set("any bigint boolean false never null number object string symbol true undefined unknown void".split(" ")),d=new Set("get set new readonly static public private protected".split(" "));function u(e){return e>=97&&e<=122||e>=65&&e<=90||e===95||e===36}function o(e){return e>=48&&e<=57}function h(e){return u(e)||o(e)}class l{text;pos=0;constructor(e){this.text=e}readAll(){if(!this.type())return!1;return this.peek(),this.pos===this.text.length}peek(){let e=this.text,s=this.pos,r=e.charCodeAt(s);while(r===32||r===9)r=e.charCodeAt(++s);return this.pos=s,r}eat(e){if(this.peek()!==e.charCodeAt(0))return!1;return this.pos++,!0}word(){if(!u(this.peek()))return;let e=this.pos,s=e+1;while(h(this.text.charCodeAt(s)))s++;return this.pos=s,this.text.slice(e,s)}name(){let e=this.word();return e!==void 0&&!a.has(e)}string(){let e=this.peek();if(e!==34&&e!==39)return!1;let s=this.text;for(let r=this.pos+1;r<s.length;r++){let i=s.charCodeAt(r);if(i===e)return this.pos=r+1,!0;if(i===92||i===10||i===13||i===8232||i===8233)return!1}return!1}number(){let e=this.text,s=this.pos;if(e.charCodeAt(s)===45)s++;let r=s;while(o(e.charCodeAt(s)))s++;if(s===r||s-r>1&&e.charCodeAt(r)===48)return!1;if(e.charCodeAt(s)===46){let n=++s;while(o(e.charCodeAt(s)))s++;if(s===n)return!1}let i=e.charCodeAt(s);if(h(i)||i===46)return!1;return this.pos=s,!0}type(){if(this.peek()===40){let e=this.pos;if(this.functionType())return!0;this.pos=e}do do if(!this.operatorType())return!1;while(this.eat("&"));while(this.eat("|"));return!0}operatorType(){let e=this.pos;if(this.word()==="keyof")return this.operatorType();if(this.pos=e,!this.primaryType())return!1;while(this.eat("[")){if(this.eat("]"))continue;if(!this.type()||!this.eat("]"))return!1}return!0}primaryType(){let e=this.peek();if(e===40)return this.pos++,this.type()&&this.eat(")");if(e===123)return this.objectType();if(e===91)return this.tupleType();if(e===34||e===39)return this.string();if(e===45||o(e))return this.number();let s=this.word();if(s===void 0)return!1;if(s==="typeof")return this.typeQuery();if(s==="import")return this.importType(!0);if(c.has(s)){let r=this.peek();return r!==46&&r!==60}if(a.has(s))return!1;while(this.eat("."))if(this.word()===void 0)return!1;return!this.eat("<")||this.typeArguments()}typeArguments(){do if(!this.type())return!1;while(this.eat(","));return this.eat(">")}typeQuery(){let e=this.pos;if(this.word()==="import")return this.importType(!1);this.pos=e;do if(!this.name())return!1;while(this.eat("."));return!0}importType(e){if(!this.eat("(")||!this.string()||!this.eat(")"))return!1;while(this.eat("."))if(!this.name())return!1;return!e||!this.eat("<")||this.typeArguments()}objectType(){this.pos++;while(!this.eat("}")){if(!this.typeMember())return!1;if(!this.eat(";")&&!this.eat(",")&&this.peek()!==125)return!1}return!0}typeMember(){let e=this.peek();if(this.eat("[")){let s=this.peek();if(s===34||s===39){if(!this.string()||!this.eat("]"))return!1}else return this.name()&&this.eat(":")&&this.type()&&this.eat("]")&&this.eat(":")&&this.type()}else if(e===34||e===39){if(!this.string())return!1}else{let s=this.word();if(s===void 0||d.has(s))return!1}return this.eat("?"),this.eat(":")&&this.type()}tupleType(){if(this.pos++,this.eat("]"))return!0;do if(!this.type())return!1;while(this.eat(","));return this.eat("]")}functionType(){if(this.pos++,!this.eat(")")){let e=new Set;for(;;){this.peek();let s=this.text.startsWith("...",this.pos);if(s)this.pos+=3;let r=this.word();if(r===void 0||a.has(r)||e.has(r))return!1;if(e.add(r),!s)this.eat("?");if(!this.eat(":")||!this.type())return!1;if(s||!this.eat(","))break}if(!this.eat(")"))return!1}if(this.peek(),!this.text.startsWith("=>",this.pos))return!1;return this.pos+=2,this.type()}}function f(e){return new l(e).readAll()}var y=t.extend(g);function S(e,s={}){return f(e)||m(e,s.inline??!1)}function m(e,s){let r=!1,i=new y(s?{ecmaVersion:16,sourceType:"module",onComment:(n,b,T,p)=>{if(!n&&p===e.length)r=!0}}:{ecmaVersion:16,sourceType:"module"},e);try{return i.parseWholeType(),!r}catch(n){if(n instanceof SyntaxError)return!1;throw n}}export{S as isValidType,m as parsesAsType};
+import{t}from"./shared-e8rqjefv.js";import{R}from"./shared-qc7kjfqj.js";var a=new Set("abstract accessor arguments as asserts async await break case catch class const continue debugger declare default delete do else enum eval export extends false finally for function get global if implements import in infer instanceof interface intrinsic is keyof let module namespace new null of out override package private protected public readonly return satisfies set static super switch this throw true try type typeof unique var void while with yield".split(" ")),c=new Set("any bigint boolean false never null number object string symbol true undefined unknown void".split(" ")),d=new Set("get set new readonly static public private protected".split(" "));function u(e){return e>=97&&e<=122||e>=65&&e<=90||e===95||e===36}function o(e){return e>=48&&e<=57}function h(e){return u(e)||o(e)}class l{text;pos=0;constructor(e){this.text=e}readAll(){if(!this.type())return!1;return this.peek(),this.pos===this.text.length}peek(){let e=this.text,s=this.pos,r=e.charCodeAt(s);while(r===32||r===9)r=e.charCodeAt(++s);return this.pos=s,r}eat(e){if(this.peek()!==e.charCodeAt(0))return!1;return this.pos++,!0}word(){if(!u(this.peek()))return;let e=this.pos,s=e+1;while(h(this.text.charCodeAt(s)))s++;return this.pos=s,this.text.slice(e,s)}name(){let e=this.word();return e!==void 0&&!a.has(e)}string(){let e=this.peek();if(e!==34&&e!==39)return!1;let s=this.text;for(let r=this.pos+1;r<s.length;r++){let i=s.charCodeAt(r);if(i===e)return this.pos=r+1,!0;if(i===92||i===10||i===13||i===8232||i===8233)return!1}return!1}number(){let e=this.text,s=this.pos;if(e.charCodeAt(s)===45)s++;let r=s;while(o(e.charCodeAt(s)))s++;if(s===r||s-r>1&&e.charCodeAt(r)===48)return!1;if(e.charCodeAt(s)===46){let n=++s;while(o(e.charCodeAt(s)))s++;if(s===n)return!1}let i=e.charCodeAt(s);if(h(i)||i===46)return!1;return this.pos=s,!0}type(){if(this.peek()===40){let e=this.pos;if(this.functionType())return!0;this.pos=e}do do if(!this.operatorType())return!1;while(this.eat("&"));while(this.eat("|"));return!0}operatorType(){let e=this.pos;if(this.word()==="keyof")return this.operatorType();if(this.pos=e,!this.primaryType())return!1;while(this.eat("[")){if(this.eat("]"))continue;if(!this.type()||!this.eat("]"))return!1}return!0}primaryType(){let e=this.peek();if(e===40)return this.pos++,this.type()&&this.eat(")");if(e===123)return this.objectType();if(e===91)return this.tupleType();if(e===34||e===39)return this.string();if(e===45||o(e))return this.number();let s=this.word();if(s===void 0)return!1;if(s==="typeof")return this.typeQuery();if(s==="import")return this.importType(!0);if(c.has(s)){let r=this.peek();return r!==46&&r!==60}if(a.has(s))return!1;while(this.eat("."))if(this.word()===void 0)return!1;return!this.eat("<")||this.typeArguments()}typeArguments(){do if(!this.type())return!1;while(this.eat(","));return this.eat(">")}typeQuery(){let e=this.pos;if(this.word()==="import")return this.importType(!1);this.pos=e;do if(!this.name())return!1;while(this.eat("."));return!0}importType(e){if(!this.eat("(")||!this.string()||!this.eat(")"))return!1;while(this.eat("."))if(!this.name())return!1;return!e||!this.eat("<")||this.typeArguments()}objectType(){this.pos++;while(!this.eat("}")){if(!this.typeMember())return!1;if(!this.eat(";")&&!this.eat(",")&&this.peek()!==125)return!1}return!0}typeMember(){let e=this.peek();if(this.eat("[")){let s=this.peek();if(s===34||s===39){if(!this.string()||!this.eat("]"))return!1}else return this.name()&&this.eat(":")&&this.type()&&this.eat("]")&&this.eat(":")&&this.type()}else if(e===34||e===39){if(!this.string())return!1}else{let s=this.word();if(s===void 0||d.has(s))return!1}return this.eat("?"),this.eat(":")&&this.type()}tupleType(){if(this.pos++,this.eat("]"))return!0;do if(!this.type())return!1;while(this.eat(","));return this.eat("]")}functionType(){if(this.pos++,!this.eat(")")){let e=new Set;for(;;){this.peek();let s=this.text.startsWith("...",this.pos);if(s)this.pos+=3;let r=this.word();if(r===void 0||a.has(r)||e.has(r))return!1;if(e.add(r),!s)this.eat("?");if(!this.eat(":")||!this.type())return!1;if(s||!this.eat(","))break}if(!this.eat(")"))return!1}if(this.peek(),!this.text.startsWith("=>",this.pos))return!1;return this.pos+=2,this.type()}}function f(e){return new l(e).readAll()}var y=t.extend(R);function C(e,s={}){return f(e)||m(e,s.inline??!1)}function m(e,s){let r=!1,i=new y(s?{ecmaVersion:16,sourceType:"module",onComment:(n,b,T,p)=>{if(!n&&p===e.length)r=!0}}:{ecmaVersion:16,sourceType:"module"},e);try{return i.parseWholeType(),!r}catch(n){if(n instanceof SyntaxError)return!1;throw n}}export{C as isValidType,m as parsesAsType};

package/lexer.d.ts

@@ -0,0 +1,167 @@
+/** A module specifier: the string after `from`, or after `import` in `import "a"`. */
+export interface LexedSource {
+    /** The string's value, with escapes decoded. */
+    value: string;
+    /** The offset of the opening quote. */
+    start: number;
+    /** The offset after the closing quote. */
+    end: number;
+}
+
+/** A name an `import` binds. */
+export interface LexedImportSpecifier {
+    /** `"default"` for `a` in `import a from`, `"namespace"` for `* as a`, `"named"` for a name in braces. */
+    kind: "default" | "namespace" | "named";
+    /** The name in the imported module: `"default"`, `"*"` for a namespace, or the name before `as`, with a string's value for `"a-b" as c`. */
+    imported: string;
+    /** The name it's bound to in this module. */
+    local: string;
+    /** Whether it's only a type: in `import type`, or with `type` before it. */
+    typeOnly: boolean;
+    /** The offset of the name, of `*`, or of `type` before the name. */
+    start: number;
+    /** The offset after the local name. */
+    end: number;
+}
+
+/** A name an `export … from` re-exports. */
+export interface LexedExportSpecifier {
+    /** `"all"` for `export *`, `"namespace"` for `export * as a`, `"named"` for a name in braces. */
+    kind: "all" | "namespace" | "named";
+    /** The name in the other module: `"*"` for `all` and `namespace`, or the name before `as`, with a string's value for `"a-b" as c`. */
+    local: string;
+    /** The name it's exported as, or `null` for `export *`. */
+    exported: string | null;
+    /** Whether it's only a type: in `export type`, or with `type` before it. */
+    typeOnly: boolean;
+    /** The offset of the name, of `*`, or of `type` before the name. */
+    start: number;
+    /** The offset after the exported name, or after `*` for `export *`. */
+    end: number;
+}
+
+interface LexedStatementBase {
+    /** The offset of `import` or `export`. */
+    start: number;
+    /** The offset after the statement's `;`, or its last token without one. */
+    end: number;
+    /** The module it imports from, or `null` for a statement the lexer doesn't recognize. */
+    source: LexedSource | null;
+    /** Whether it's `import type` or `export type`. */
+    typeOnly: boolean;
+}
+
+/** An `import` statement. */
+export interface LexedImport extends LexedStatementBase {
+    kind: "import";
+    specifiers: LexedImportSpecifier[];
+}
+
+/** An `export … from` statement. */
+export interface LexedExport extends LexedStatementBase {
+    kind: "export";
+    specifiers: LexedExportSpecifier[];
+}
+
+export type LexedStatement = LexedImport | LexedExport;
+
+/**
+ * A module's top-level `import` statements and `export … from`
+ * re-exports, read without a parser: each statement's offsets, its
+ * source and the names it imports or re-exports. It finds statements as
+ * {@link parseImportsExports} does with `localExports: false`, and on
+ * every statement that accepts, gives the same offsets, sources and names,
+ * but it doesn't check syntax and never throws. A statement it can't read,
+ * including TypeScript's `import a = require("a")`, is returned with
+ * `source: null` and no specifiers, ending where it stopped reading.
+ * TypeScript's `type` forms are always read.
+ */
+export declare function lexImportsExports(source: string): LexedStatement[];
+
+/** An attribute of a top-level `<script>`, `<style>` or `<svelte:options>`. */
+export interface LexedAttribute {
+    name: string;
+    /**
+     * The value as written, without its quotes: character references
+     * aren't decoded, and an expression keeps its braces, as in `"{true}"`
+     * for `runes={true}`. `true` for an attribute without a value.
+     */
+    value: string | true;
+    /** The offset of the name. */
+    start: number;
+    /** The offset after the value, or after the name without one. */
+    end: number;
+}
+
+/** The text between a top-level element's tags. */
+export interface LexedContent {
+    start: number;
+    end: number;
+}
+
+/** A top-level `<script>`. */
+export interface LexedScript {
+    /** The offset of `<script`. */
+    start: number;
+    /** The offset after `</script>`. */
+    end: number;
+    /** `"module"` for `<script module>` or `<script context="module">`. */
+    context: "default" | "module";
+    attributes: LexedAttribute[];
+    content: LexedContent;
+}
+
+/** The top-level `<style>`. */
+export interface LexedStyle {
+    /** The offset of `<style`. */
+    start: number;
+    /** The offset after `</style>`. */
+    end: number;
+    attributes: LexedAttribute[];
+    content: LexedContent;
+}
+
+/** `<svelte:options>`. */
+export interface LexedOptions {
+    /** The offset of `<svelte:options`. */
+    start: number;
+    /** The offset after `/>` or `</svelte:options>`. */
+    end: number;
+    attributes: LexedAttribute[];
+}
+
+/** A component's top-level sections, as {@link lexComponent} finds them. */
+export interface LexedComponent {
+    /**
+     * Whether `parse` reads the component as TypeScript, which needs the
+     * TypeScript plugin: svelte decides it from the first `<script>` with a
+     * `lang`, so this is `true` when that one has `lang="ts"`.
+     */
+    typescript: boolean;
+    /** The `<script>` without `module`, as `parse`'s `instance`. */
+    instance: LexedScript | null;
+    /** The `<script module>`, as `parse`'s `module`. */
+    module: LexedScript | null;
+    /** The `<style>`, as `parse`'s `css`. */
+    css: LexedStyle | null;
+    /** `<svelte:options>`, as `parse`'s `options`. */
+    options: LexedOptions | null;
+}
+
+/**
+ * A component's top-level `<script>`, `<script module>`, `<style>` and
+ * `<svelte:options>`, with their attributes and the offsets of their tags
+ * and content, read without a parser: e.g. to find a component's
+ * language or imports, or to rewrite its scripts, without parsing the
+ * markup. The offsets are `parse`'s, so they're into the source without
+ * a leading byte order mark.
+ *
+ * The markup is skipped by tracking only tags, attribute values, blocks
+ * and the brackets, strings, comments and templates of each `{…}`
+ * expression, so a `<script>` inside an element, a block, a string or a
+ * comment isn't one. It stops after the last `<script`, `<style` or
+ * `<svelte:options`. Where `parse` accepts the component, the sections
+ * are the same as its `instance`, `module`, `css` and `options`; it
+ * doesn't check syntax and never throws.
+ */
+export declare function lexComponent(input: string): LexedComponent;

package/lexer.js

@@ -0,0 +1,2 @@
+import{r,M,h,d,N}from"./shared-j60qxzy3.js";import"./shared-2ahdjk78.js";import{G}from"./shared-a5mpxvcm.js";function g(e){let t=new m(e),n=[];return M(e,!1,(i,s)=>{let o=t.statement(s);return n.push(o),o.end}),n}class m{source;pos=0;end=0;escapeEnd=0;constructor(e){this.source=e}statement(e){this.pos=this.end=e+6;let t=this.source.charCodeAt(e)===105?{kind:"import",start:e,end:0,source:null,typeOnly:!1,specifiers:[]}:{kind:"export",start:e,end:0,source:null,typeOnly:!1,specifiers:[]};if(!(t.kind==="import"?this.import(t):this.export(t)))t.source=null,t.specifiers=[];return t.end=this.end,t}import(e){let t=this.string();if(t!==null)return e.source=t,this.finish();if(this.isWord("type")){let o=this.peek(4);if(o===123||o===42||c(o)&&!this.isWordAfter(4,"from"))e.typeOnly=!0,this.advance(4)}let{specifiers:n,typeOnly:i}=e,s=this.at();if(s!==123&&s!==42){let o=this.pos,a=this.name();if(a===null)return!1;if(this.at()===61)return this.importEquals();if(n.push({kind:"default",imported:"default",local:a,typeOnly:i,start:o,end:this.end}),!this.eat(44))return this.from(e);s=this.at()}if(s===42){let o=this.pos;if(this.advance(1),!this.eatWord("as"))return!1;let a=this.name();if(a===null)return!1;return n.push({kind:"namespace",imported:"*",local:a,typeOnly:i,start:o,end:this.end}),this.from(e)}if(!this.eat(123))return!1;while(!this.eat(125)){let o=this.skip(),a=this.typeModifier()||i,u=this.name(),f=u??this.string()?.value;if(f===void 0)return!1;let l=u;if(this.eatWord("as"))l=this.name();if(l===null)return!1;if(n.push({kind:"named",imported:f,local:l,typeOnly:a,start:o,end:this.end}),!this.eat(44)&&this.at()!==125)return!1}return this.from(e)}export(e){if(this.eatWord("import")){if(this.isWord("type")&&c(this.peek(4))&&!this.isWordAfter(4,"from"))e.typeOnly=!0,this.advance(4);return this.name()!==null&&this.at()===61&&this.importEquals()}if(this.isWord("type")){let i=this.peek(4);if(i===123||i===42)e.typeOnly=!0,this.advance(4)}let{specifiers:t,typeOnly:n}=e;if(this.at()===42){let i=this.pos;this.advance(1);let s=null;if(this.eatWord("as")){if(s=this.moduleExportName(),s===null)return!1}return t.push({kind:s===null?"all":"namespace",local:"*",exported:s,typeOnly:n,start:i,end:this.end}),this.from(e)}if(!this.eat(123))return!1;while(!this.eat(125)){let i=this.skip(),s=this.typeModifier()||n,o=this.moduleExportName();if(o===null)return!1;let a=o;if(this.eatWord("as"))a=this.moduleExportName();if(a===null)return!1;if(t.push({kind:"named",local:o,exported:a,typeOnly:s,start:i,end:this.end}),!this.eat(44)&&this.at()!==125)return!1}return this.from(e)}typeModifier(){if(!this.isWord("type"))return!1;let e=this.peek(4);if(e===34||e===39||c(e)&&!this.isWordAfter(4,"as"))return this.advance(4),!0;return!1}importEquals(){if(this.advance(1),this.isWord("require")&&this.peek(7)===40){if(this.advance(7),this.eat(40),this.string()===null||!this.eat(41))return!1}else do if(this.name()===null)return!1;while(this.eat(46));return this.eat(59),!0}from(e){if(!this.eatWord("from"))return!1;return e.source=this.string(),e.source!==null&&this.finish()}finish(){let e=this.isWord("with")?4:0;if(this.isWord("assert")&&!x(this.source,this.end,this.pos))e=6;if(e!==0&&this.peek(e)===123){this.advance(e),this.eat(123);while(!this.eat(125))if(this.string()===null&&this.name()===null&&!this.eat(58)&&!this.eat(44))return!1}return this.eat(59),!0}skip(){return this.pos=d(this.source,this.pos),this.pos}at(){return this.source.charCodeAt(this.skip())}advance(e){this.pos+=e,this.end=this.pos}peek(e){return this.source.charCodeAt(d(this.source,this.pos+e))}isWordAfter(e,t){return N(this.source,d(this.source,this.pos+e),t)}eat(e){if(this.at()!==e)return!1;return this.advance(1),!0}isWord(e){return N(this.source,this.skip(),e)}eatWord(e){if(!this.isWord(e))return!1;return this.advance(e.length),!0}moduleExportName(){return this.name()??this.string()?.value??null}name(){let e=this.source,t=this.skip();if(!r(e.charCodeAt(t))||h(e.charCodeAt(t)))return null;let n="",i=t,s=t;while(s<e.length){let o=e.charCodeAt(s);if(o===92){if(e.charCodeAt(s+1)!==117)return null;let a=this.unicodeEscape(s+2);if(a===null)return null;n+=e.slice(i,s)+a,s=i=this.escapeEnd}else if(r(o))s++;else break}return this.advance(s-t),n+e.slice(i,s)}string(){let e=this.source,t=this.skip(),n=e.charCodeAt(t);if(n!==34&&n!==39)return null;let i="",s=t+1;for(let o=s;o<e.length;){let a=e.charCodeAt(o);if(a===n)return this.advance(o+1-t),{value:i+e.slice(s,o),start:t,end:o+1};if(a===10||a===13)return null;if(a===92){let u=this.escape(o+1);if(u===null)return null;i+=e.slice(s,o)+u,o=s=this.escapeEnd}else o++}return null}escape(e){let t=this.source.charCodeAt(e);switch(this.escapeEnd=e+1,t){case 110:return`
+`;case 114:return"\r";case 116:return"\t";case 98:return"\b";case 118:return"\v";case 102:return"\f";case 48:return h(this.source.charCodeAt(e+1))?null:"\x00";case 120:return this.hexEscape(e+1,2);case 117:return this.unicodeEscape(e+1);case 13:if(this.source.charCodeAt(e+1)===10)this.escapeEnd++;return"";case 10:case 8232:case 8233:return"";default:return h(t)||e>=this.source.length?null:String.fromCharCode(t)}}unicodeEscape(e){if(this.source.charCodeAt(e)!==123)return this.hexEscape(e,4);let t=0,n=e+1;for(;this.source.charCodeAt(n)!==125;n++){let i=p(this.source.charCodeAt(n));if(i===-1)return null;if(t=t*16+i,t>1114111)return null}if(n===e+1)return null;return this.escapeEnd=n+1,String.fromCodePoint(t)}hexEscape(e,t){let n=0;for(let i=e;i<e+t;i++){let s=p(this.source.charCodeAt(i));if(s===-1)return null;n=n*16+s}return this.escapeEnd=e+t,String.fromCharCode(n)}}function c(e){return e!==92&&r(e)&&!h(e)}function p(e){if(h(e))return e-48;let t=e|32;return t>=97&&t<=102?t-87:-1}function x(e,t,n){for(let i=t;i<n;i++){let s=e.charCodeAt(i);if(s===10||s===13||s===8232||s===8233)return!0}return!1}export{G as lexComponent,g as lexImportsExports};