tagset-parser 0.0.0 → 1.0.0

package/lib/types/generated/TagSetListener.d.ts

@@ -5,7 +5,6 @@ import { SetDeclContext } from "./TagSetParser.js";
 import { LabelPartContext } from "./TagSetParser.js";
 import { ItemDeclContext } from "./TagSetParser.js";
 import { SugarDeclContext } from "./TagSetParser.js";
-import { PatternContext } from "./TagSetParser.js";
 import { ValueListContext } from "./TagSetParser.js";
 import { ValueItemContext } from "./TagSetParser.js";
 /**
@@ -73,16 +72,6 @@ export declare class TagSetListener implements ParseTreeListener {
      * @param ctx the parse tree
      */
     exitSugarDecl?: (ctx: SugarDeclContext) => void;
-    /**
-     * Enter a parse tree produced by `TagSetParser.pattern`.
-     * @param ctx the parse tree
-     */
-    enterPattern?: (ctx: PatternContext) => void;
-    /**
-     * Exit a parse tree produced by `TagSetParser.pattern`.
-     * @param ctx the parse tree
-     */
-    exitPattern?: (ctx: PatternContext) => void;
     /**
      * Enter a parse tree produced by `TagSetParser.valueList`.
      * @param ctx the parse tree

package/lib/types/generated/TagSetParser.d.ts

@@ -4,11 +4,11 @@ import { TagSetVisitor } from "./TagSetVisitor.js";
 export declare class TagSetParser extends antlr.Parser {
     static readonly SET = 1;
     static readonly ITEM = 2;
-    static readonly AMP = 3;
-    static readonly COMMA = 4;
-    static readonly COLON = 5;
-    static readonly QUOTED_STRING = 6;
-    static readonly WORD = 7;
+    static readonly COMMA = 3;
+    static readonly COLON = 4;
+    static readonly QUOTED_STRING = 5;
+    static readonly WORD = 6;
+    static readonly COMMENT = 7;
     static readonly NL = 8;
     static readonly WS = 9;
     static readonly RULE_program = 0;
@@ -17,9 +17,8 @@ export declare class TagSetParser extends antlr.Parser {
     static readonly RULE_labelPart = 3;
     static readonly RULE_itemDecl = 4;
     static readonly RULE_sugarDecl = 5;
-    static readonly RULE_pattern = 6;
-    static readonly RULE_valueList = 7;
-    static readonly RULE_valueItem = 8;
+    static readonly RULE_valueList = 6;
+    static readonly RULE_valueItem = 7;
     static readonly literalNames: (string | null)[];
     static readonly symbolicNames: (string | null)[];
     static readonly ruleNames: string[];
@@ -36,7 +35,6 @@ export declare class TagSetParser extends antlr.Parser {
     labelPart(): LabelPartContext;
     itemDecl(): ItemDeclContext;
     sugarDecl(): SugarDeclContext;
-    pattern(): PatternContext;
     valueList(): ValueListContext;
     valueItem(): ValueItemContext;
     static readonly _serializedATN: number[];
@@ -92,7 +90,7 @@ export declare class LabelPartContext extends antlr.ParserRuleContext {
 export declare class ItemDeclContext extends antlr.ParserRuleContext {
     constructor(parent: antlr.ParserRuleContext | null, invokingState: number);
     ITEM(): antlr.TerminalNode;
-    pattern(): PatternContext;
+    WORD(): antlr.TerminalNode;
     valueList(): ValueListContext;
     get ruleIndex(): number;
     enterRule(listener: TagSetListener): void;
@@ -112,17 +110,6 @@ export declare class SugarDeclContext extends antlr.ParserRuleContext {
     exitRule(listener: TagSetListener): void;
     accept<Result>(visitor: TagSetVisitor<Result>): Result | null;
 }
-export declare class PatternContext extends antlr.ParserRuleContext {
-    constructor(parent: antlr.ParserRuleContext | null, invokingState: number);
-    WORD(): antlr.TerminalNode[];
-    WORD(i: number): antlr.TerminalNode | null;
-    AMP(): antlr.TerminalNode[];
-    AMP(i: number): antlr.TerminalNode | null;
-    get ruleIndex(): number;
-    enterRule(listener: TagSetListener): void;
-    exitRule(listener: TagSetListener): void;
-    accept<Result>(visitor: TagSetVisitor<Result>): Result | null;
-}
 export declare class ValueListContext extends antlr.ParserRuleContext {
     constructor(parent: antlr.ParserRuleContext | null, invokingState: number);
     valueItem(): ValueItemContext[];

package/lib/types/generated/TagSetVisitor.d.ts

@@ -5,7 +5,6 @@ import { SetDeclContext } from "./TagSetParser.js";
 import { LabelPartContext } from "./TagSetParser.js";
 import { ItemDeclContext } from "./TagSetParser.js";
 import { SugarDeclContext } from "./TagSetParser.js";
-import { PatternContext } from "./TagSetParser.js";
 import { ValueListContext } from "./TagSetParser.js";
 import { ValueItemContext } from "./TagSetParser.js";
 /**
@@ -52,12 +51,6 @@ export declare class TagSetVisitor<Result> extends AbstractParseTreeVisitor<Resu
      * @return the visitor result
      */
     visitSugarDecl?: (ctx: SugarDeclContext) => Result;
-    /**
-     * Visit a parse tree produced by `TagSetParser.pattern`.
-     * @param ctx the parse tree
-     * @return the visitor result
-     */
-    visitPattern?: (ctx: PatternContext) => Result;
     /**
      * Visit a parse tree produced by `TagSetParser.valueList`.
      * @param ctx the parse tree

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tagset-parser",
-  "version": "0.0.0",
+  "version": "1.0.0",
   "description": "TagSet DSL parser",
   "author": "elzup",
   "license": "MIT",
@@ -28,6 +28,23 @@
   "engines": {
     "node": ">=18"
   },
+  "packageManager": "pnpm@9.15.4",
+  "scripts": {
+    "generate": "antlr-ng -Dlanguage=TypeScript --generate-visitor -o src/generated src/grammar/TagSet.g4",
+    "clean": "rimraf lib",
+    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc --module commonjs --outDir lib/cjs && echo '{\"type\": \"commonjs\"}' > lib/cjs/package.json",
+    "build:esm": "tsc --module esnext --outDir lib/esm --moduleResolution node --allowSyntheticDefaultImports",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir lib/types",
+    "format": "prettier --write .",
+    "lint": "oxlint --ignore-pattern src/generated/",
+    "lint:fix": "oxlint --fix --ignore-pattern src/generated/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:cov": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
   "files": [
     "lib/"
   ],
@@ -46,20 +63,5 @@
   },
   "dependencies": {
     "antlr4ng": "^3.0.16"
-  },
-  "scripts": {
-    "generate": "antlr-ng -Dlanguage=TypeScript --generate-visitor -o src/generated src/grammar/TagSet.g4",
-    "clean": "rimraf lib",
-    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types",
-    "build:cjs": "tsc --module commonjs --outDir lib/cjs && echo '{\"type\": \"commonjs\"}' > lib/cjs/package.json",
-    "build:esm": "tsc --module esnext --outDir lib/esm --moduleResolution node --allowSyntheticDefaultImports",
-    "build:types": "tsc --declaration --emitDeclarationOnly --outDir lib/types",
-    "format": "prettier --write .",
-    "lint": "oxlint --ignore-pattern src/generated/",
-    "lint:fix": "oxlint --fix --ignore-pattern src/generated/",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:cov": "vitest run --coverage"
   }
-}
+}

package/readme.md

@@ -8,36 +8,84 @@
 $ npm install tagset-parser
 ```
 
-## Usage
+## DSL Examples
 
-```ts
-import { parse } from 'tagset-parser'
+### Basic
 
-// Classic syntax
-const ast = parse(`set A 赤
+```
+set A 赤
 set B 青
-item A&B x,c`)
 
-// Sugar syntax (colon)
-const ast2 = parse(`A, B: x, y`)
+item A  apple, red
+item B  sky, ocean
+# colon syntax (both syntaxes can be mixed freely)
+A, B: purple, violet
+A, B, _: purple, violet
+```
+
+### Auto-Detect Sets
 
-// Auto-detect sets (no set declarations needed)
-const ast3 = parse(`item A&B x`)
-// ast3.sets → [{ id: 'A', label: 'A', index: 0 }, { id: 'B', label: 'B', index: 1 }]
+`set` declarations are optional. Sets are auto-detected from patterns.
+
+```
+A: apple
+B: sky
+A, B: purple
 ```
 
-## Syntax
+Explicit and auto-detected sets can coexist — `set A Red` gives A a label, while B is auto-detected as `{ id: 'B', label: 'B' }`.
+
+### Placeholder `_`
+
+`_` is ignored in patterns, useful for alignment.
 
 ```
-set <id> <label>        # Declare a set (optional)
-item <pattern> <values> # Declare an item with & pattern
-<ids>: <values>         # Sugar syntax (comma-separated IDs)
+A, _, C: a-and-c
+_, B, _: only-b
 ```
 
-- `set` declarations are optional; sets are auto-detected from patterns
-- Patterns use `&` between set IDs: `A&B`, `A&_&C`
-- `_` is a placeholder (ignored in bitmask)
-- Values are comma-separated: `x,y` or `x, y`
+### Quoted Strings
+
+```
+item A "hello world", "foo bar"
+```
+
+## Bitmask
+
+Each item gets a `bitmask` based on which sets appear in its pattern. Set index determines the bit position.
+
+```
+set A 赤    → index 0 → bit 1
+set B 青    → index 1 → bit 2
+set C 緑    → index 2 → bit 4
+
+A:       → bitmask: 1  (0b001)
+B:       → bitmask: 2  (0b010)
+A, C:    → bitmask: 5  (0b101)
+A, B, C: → bitmask: 7  (0b111)
+```
+
+## Usage
+
+```ts
+import { parse } from 'tagset-parser'
+
+const ast = parse(`
+set A 赤
+set B 青
+A, B: x, y
+A: solo
+`)
+
+ast.sets
+// [{ id: 'A', label: '赤', index: 0 }, { id: 'B', label: '青', index: 1 }]
+
+ast.items
+// [
+//   { pattern: 'A,B', bitmask: 3, values: ['x', 'y'] },
+//   { pattern: 'A',   bitmask: 1, values: ['solo'] },
+// ]
+```
 
 ## License