@jesscss/less-parser 2.0.0-alpha.8 → 2.0.0-alpha.9

package/README.md

@@ -1,8 +1,11 @@
 # @jesscss/less-parser
 
-The Less grammar, layered on the CSS base parser — the parser behind the language Jess ships today.
+The Less grammar, layered on the CSS base parser, with core-free CST entry points.
 
-> **Status: alpha.** Part of [Jess](https://github.com/jesscss/jess), which *is* Less.js v5. Rendering `.less` is the one surface shipping today; everything else is roadmap. Expect gaps and [report bugs](https://github.com/jesscss/jess/issues). Docs live at [jesscss.github.io](https://jesscss.github.io/).
+> **Status: alpha.** Part of [Jess](https://github.com/jesscss/jess). The broader
+> language/tooling picture is still early. Expect gaps and
+> [report bugs](https://github.com/jesscss/jess/issues). Docs live at
+> [jesscss.github.io](https://jesscss.github.io/).
 
 ## What it is
 
@@ -17,10 +20,10 @@ general-purpose JavaScript parser** in its
 Jess uses when it compiles `.less` — the "Now" tier of the language roadmap, and
 the one dialect shipping in the alpha.
 
-Two ways to use it:
-
-- **As part of Jess** — the default `.` entry is wired into `@jesscss/core` and produces the core AST the Jess compiler evaluates (this is what runs when Jess compiles Less). This is the internal, core-coupled path.
-- **As a standalone CST parser** — the `./cst` entry has **no dependency on `@jesscss/core`**. Install just this package and parse Less source text into a concrete syntax tree (CST). You can also plug your own builders onto the grammar to produce your own AST instead of the default CST.
+The default `parse()` operation constructs canonical AST v2 `Stylesheet` directly
+through parser-local Parseman reductions. Use the explicit `./cst` entry when a
+language-service or document consumer needs a CST. The package has no
+core-owned parser driver or AST construction host.
 
 ## Install
 
@@ -28,7 +31,20 @@ Two ways to use it:
 npm install @jesscss/less-parser
 ```
 
-`@jesscss/core` is an **optional** peer dependency — needed only for the core-coupled `.` entry, not for `./cst` or `./grammar`.
+`@jesscss/core` is an optional peer for consumers using the default AST v2
+`parse()` result. The explicit CST and grammar subpaths remain core-free.
+Those explicit entries expose Parseman types and grammar values, so consumers
+of them must also provide the package's `parseman` peer.
+
+## Canonical AST parsing
+
+```js
+import { parse } from '@jesscss/less-parser'
+
+const stylesheet = parse('@c: red;\n.foo { color: @c; }')
+
+stylesheet.type // 'Stylesheet'
+```
 
 ## Standalone usage (core-free)
 
@@ -58,8 +74,7 @@ Pass a different `startRule` (any capitalized grammar rule, e.g. `'SelectorList'
 | `@jesscss/less-parser/cst` | `parseLessCst` | Core-free parse of a Less string to a CST. |
 | `@jesscss/less-parser/cst` | `LessCstNode`, `LessCstLeaf`, `LessCstError`, `LessCstChild`, `LessCstParseResult`, `LessCstType` (types) | CST type definitions (aliases of the shared `@jesscss/css-parser/cst` types). |
 | `@jesscss/less-parser/grammar` | `lessGrammar` | The compiled Less grammar (a rule map). Extend it with `compose()` or drive it directly with parseman's `run`. |
-| `@jesscss/less-parser` (`.`) | `LessParser` (also `Parser`), `parseLessFn`, `lessGrammar`, tokens, … | The Jess-internal barrel. **Core-coupled** (the functional parser builds the core AST). Prefer `./cst` if you don't need `@jesscss/core`. |
-| `@jesscss/less-parser/jess` | `LessParser`, `LessGrammar`, `parseLessFn`, … | Internal Jess-facing surface. |
+| `@jesscss/less-parser` (`.`) | `parse` | Parse Less directly to canonical AST v2 `Stylesheet`. It does not load the CST grammar. |
 
 ## Default CST shape
 
@@ -146,4 +161,6 @@ type BuildHost = (
 
 ## Part of Jess
 
-This package is developed as part of [Jess](https://github.com/jesscss/jess), the Less.js v5 rewrite. Jess translates a Less string into the core Jess AST, which the compiler then evaluates and renders to CSS. Licensed MIT.
+This package is developed as part of [Jess](https://github.com/jesscss/jess).
+Jess translates a Less string into the core Jess AST, which the compiler then
+evaluates and renders to CSS. Licensed MIT.

package/lib/ast/grammar.d.ts

@@ -0,0 +1,2 @@
+export declare const lessAstGrammar: Record<string, import("parseman").FusedRule>;
+//# sourceMappingURL=grammar.d.ts.map

package/lib/ast/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../../src/ast/grammar.ts"],"names":[],"mappings":"AA49CA,eAAO,MAAM,cAAc,8CAuhGvB,CAAC"}