jssm 5.147.10 → 5.148.1

package/jssm.es5.d.cts

@@ -1783,6 +1783,95 @@ declare namespace jssm_constants_d {
   };
 }
 
+/**
+ * Editor-agnostic data types for the FSL language service.
+ *
+ * These are the neutral contract every editor adapter (CodeMirror, VS Code, a
+ * future LSP server) converts to/from. Shapes are kept aligned with LSP types so
+ * an LSP wrapper is a near-mechanical mapping.
+ */
+/** A character-offset range in the FSL source. */
+interface Range {
+    from: number;
+    to: number;
+}
+/** Diagnostic severity, aligned with LSP severities. */
+declare type DiagnosticSeverity = 'error' | 'warning' | 'info' | 'hint';
+/** An editor-agnostic diagnostic (one parse/compile problem). */
+interface Diagnostic {
+    range: Range;
+    severity: DiagnosticSeverity;
+    message: string;
+}
+/** What a completion item suggests, so adapters can pick an icon. */
+declare type CompletionKind = 'key' | 'value-color' | 'value-shape' | 'value-enum';
+/** An editor-agnostic completion suggestion. */
+interface CompletionItem {
+    label: string;
+    kind: CompletionKind;
+    detail?: string;
+}
+/** Parser-derived semantic role of a source span. */
+declare type SemanticSpanKind = 'color' | 'state' | 'enum';
+/** An editor-agnostic semantic span (for decorations / semantic tokens). */
+interface SemanticSpan extends Range {
+    kind: SemanticSpanKind;
+    value?: string;
+}
+
+/**
+ * Editor-agnostic FSL diagnostics: parse then compile, reporting problems as
+ * neutral {@link Diagnostic}s. Adapters map these to CodeMirror lint diagnostics,
+ * VS Code markers, or LSP `Diagnostic`s.
+ *
+ * Parse errors (peg.js) carry `.location`; compile errors carry
+ * `.source_location` *when they reference a parsed node* — but machine-level
+ * compile errors (e.g. an empty machine, an unknown machine rule) have none, so
+ * the location is treated as optional and falls back to the whole document.
+ */
+
+/**
+ * Parse then compile `text`, returning a list of diagnostics — empty when the
+ * machine parses and compiles cleanly.
+ *
+ * @example
+ *   fslDiagnostics('a -> b;');            // => []
+ *   fslDiagnostics('a -> ;')[0].severity; // => 'error'
+ */
+declare function fslDiagnostics(text: string): Diagnostic[];
+
+/**
+ * Context-aware, editor-agnostic FSL completions. Value suggestions after a
+ * `key:`, key suggestions at a statement start (top-level vs inside a `{ }`
+ * block, by brace depth). Adapters convert {@link CompletionItem}s to their own
+ * completion type. Value vocab is jssm's own (`gviz_shapes`, `named_colors`,
+ * `FslDirections`), so it cannot drift from the renderer.
+ */
+
+/**
+ * Completions for the caret at `offset` in `text`.
+ *
+ * @example
+ *   fslCompletions('state x : { color: ', 19)[0].kind;  // => 'value-color'
+ */
+declare function fslCompletions(text: string, offset: number): CompletionItem[];
+
+/**
+ * Parser-derived semantic spans for FSL: color values (with resolved hex),
+ * state names, and shape-enum values. Returns `[]` if the document does not
+ * parse. Editor-agnostic — adapters map spans to decorations or semantic
+ * tokens. Logic is a verified port of the sketch's `semantic_overlay.mjs`.
+ */
+
+/**
+ * Collect color / state / shape-enum semantic spans from `text`.
+ *
+ * @example
+ *   fslSemanticSpans('state s : { color: crimson; };')
+ *     .find(s => s.kind === 'color')?.value;   // => '#dc143cff'
+ */
+declare function fslSemanticSpans(text: string): SemanticSpan[];
+
 /**
  *  The published semantic version of the jssm package this build was cut from.
  *  Mirrored from `package.json` by `src/buildjs/makever.cjs` at build time.
@@ -4566,4 +4655,4 @@ declare function compareVersions(v1: string, v2: string): number;
  */
 declare function deserialize<mDT>(machine_string: string, ser: JssmSerialization<mDT>): Machine<mDT>;
 
-export { FslDirections, Machine, abstract_everything_hook_step, abstract_hook_step, action_label_chars, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compareVersions, compile, jssm_constants_d as constants, deserialize, find_repeated, from, gen_splitmix32, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sleep, sm, state_name_chars, state_name_first_chars, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };
+export { FslDirections, Machine, abstract_everything_hook_step, abstract_hook_step, action_label_chars, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compareVersions, compile, jssm_constants_d as constants, deserialize, find_repeated, from, fslCompletions, fslDiagnostics, fslSemanticSpans, gen_splitmix32, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sleep, sm, state_name_chars, state_name_first_chars, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };

package/jssm.es6.d.ts

@@ -1783,6 +1783,95 @@ declare namespace jssm_constants_d {
   };
 }
 
+/**
+ * Editor-agnostic data types for the FSL language service.
+ *
+ * These are the neutral contract every editor adapter (CodeMirror, VS Code, a
+ * future LSP server) converts to/from. Shapes are kept aligned with LSP types so
+ * an LSP wrapper is a near-mechanical mapping.
+ */
+/** A character-offset range in the FSL source. */
+interface Range {
+    from: number;
+    to: number;
+}
+/** Diagnostic severity, aligned with LSP severities. */
+declare type DiagnosticSeverity = 'error' | 'warning' | 'info' | 'hint';
+/** An editor-agnostic diagnostic (one parse/compile problem). */
+interface Diagnostic {
+    range: Range;
+    severity: DiagnosticSeverity;
+    message: string;
+}
+/** What a completion item suggests, so adapters can pick an icon. */
+declare type CompletionKind = 'key' | 'value-color' | 'value-shape' | 'value-enum';
+/** An editor-agnostic completion suggestion. */
+interface CompletionItem {
+    label: string;
+    kind: CompletionKind;
+    detail?: string;
+}
+/** Parser-derived semantic role of a source span. */
+declare type SemanticSpanKind = 'color' | 'state' | 'enum';
+/** An editor-agnostic semantic span (for decorations / semantic tokens). */
+interface SemanticSpan extends Range {
+    kind: SemanticSpanKind;
+    value?: string;
+}
+
+/**
+ * Editor-agnostic FSL diagnostics: parse then compile, reporting problems as
+ * neutral {@link Diagnostic}s. Adapters map these to CodeMirror lint diagnostics,
+ * VS Code markers, or LSP `Diagnostic`s.
+ *
+ * Parse errors (peg.js) carry `.location`; compile errors carry
+ * `.source_location` *when they reference a parsed node* — but machine-level
+ * compile errors (e.g. an empty machine, an unknown machine rule) have none, so
+ * the location is treated as optional and falls back to the whole document.
+ */
+
+/**
+ * Parse then compile `text`, returning a list of diagnostics — empty when the
+ * machine parses and compiles cleanly.
+ *
+ * @example
+ *   fslDiagnostics('a -> b;');            // => []
+ *   fslDiagnostics('a -> ;')[0].severity; // => 'error'
+ */
+declare function fslDiagnostics(text: string): Diagnostic[];
+
+/**
+ * Context-aware, editor-agnostic FSL completions. Value suggestions after a
+ * `key:`, key suggestions at a statement start (top-level vs inside a `{ }`
+ * block, by brace depth). Adapters convert {@link CompletionItem}s to their own
+ * completion type. Value vocab is jssm's own (`gviz_shapes`, `named_colors`,
+ * `FslDirections`), so it cannot drift from the renderer.
+ */
+
+/**
+ * Completions for the caret at `offset` in `text`.
+ *
+ * @example
+ *   fslCompletions('state x : { color: ', 19)[0].kind;  // => 'value-color'
+ */
+declare function fslCompletions(text: string, offset: number): CompletionItem[];
+
+/**
+ * Parser-derived semantic spans for FSL: color values (with resolved hex),
+ * state names, and shape-enum values. Returns `[]` if the document does not
+ * parse. Editor-agnostic — adapters map spans to decorations or semantic
+ * tokens. Logic is a verified port of the sketch's `semantic_overlay.mjs`.
+ */
+
+/**
+ * Collect color / state / shape-enum semantic spans from `text`.
+ *
+ * @example
+ *   fslSemanticSpans('state s : { color: crimson; };')
+ *     .find(s => s.kind === 'color')?.value;   // => '#dc143cff'
+ */
+declare function fslSemanticSpans(text: string): SemanticSpan[];
+
 /**
  *  The published semantic version of the jssm package this build was cut from.
  *  Mirrored from `package.json` by `src/buildjs/makever.cjs` at build time.
@@ -4566,4 +4655,4 @@ declare function compareVersions(v1: string, v2: string): number;
  */
 declare function deserialize<mDT>(machine_string: string, ser: JssmSerialization<mDT>): Machine<mDT>;
 
-export { FslDirections, Machine, abstract_everything_hook_step, abstract_hook_step, action_label_chars, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compareVersions, compile, jssm_constants_d as constants, deserialize, find_repeated, from, gen_splitmix32, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sleep, sm, state_name_chars, state_name_first_chars, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };
+export { FslDirections, Machine, abstract_everything_hook_step, abstract_hook_step, action_label_chars, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compareVersions, compile, jssm_constants_d as constants, deserialize, find_repeated, from, fslCompletions, fslDiagnostics, fslSemanticSpans, gen_splitmix32, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sleep, sm, state_name_chars, state_name_first_chars, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jssm",
-  "version": "5.147.10",
+  "version": "5.148.1",
   "engines": {
     "node": ">=10.0.0"
   },
@@ -66,6 +66,22 @@
       "import": "./dist/wc/instance.define.js",
       "default": "./dist/wc/instance.define.js"
     },
+    "./wc/editor": {
+      "import": "./dist/wc/editor.js",
+      "default": "./dist/wc/editor.js"
+    },
+    "./wc/editor/define": {
+      "import": "./dist/wc/editor.define.js",
+      "default": "./dist/wc/editor.define.js"
+    },
+    "./wc/widgets": {
+      "import": "./dist/wc/widgets.js",
+      "default": "./dist/wc/widgets.js"
+    },
+    "./wc/widgets/define": {
+      "import": "./dist/wc/widgets.define.js",
+      "default": "./dist/wc/widgets.define.js"
+    },
     "./cm6": {
       "types": "./dist/es6/cm6/fsl_language.d.ts",
       "import": "./dist/cm6/fsl_language.js",
@@ -103,6 +119,10 @@
     "dist/wc/viz.define.js",
     "dist/wc/instance.js",
     "dist/wc/instance.define.js",
+    "dist/wc/editor.js",
+    "dist/wc/editor.define.js",
+    "dist/wc/widgets.js",
+    "dist/wc/widgets.define.js",
     "dist/cm6/fsl_language.js",
     "dist/es6/cm6/fsl_language.d.ts",
     "dist/cdn/viz.js",
@@ -165,13 +185,15 @@
     "make_wc_viz_cdn": "rollup -c rollup.config.wc.viz.cdn.js",
     "make_wc_instance_es6": "rollup -c rollup.config.wc.instance.es6.js",
     "make_wc_instance_cdn": "rollup -c rollup.config.wc.instance.cdn.js",
+    "make_wc_editor_es6": "rollup -c rollup.config.wc.editor.es6.js",
+    "make_wc_widgets_es6": "rollup -c rollup.config.wc.widgets.es6.js",
     "make_cm6": "rollup -c rollup.config.cm6.es6.js",
     "typescript": "tsc --build tsconfig.json",
     "makever": "node src/buildjs/makever.cjs",
     "make_doctests": "node src/buildjs/extract_examples.cjs",
     "prep": "npm run makever && npm run peg",
     "make": "node src/buildjs/run_build.cjs --profile=fast",
-    "make_ci": "npm run clean && npm run makever && npm run peg && npm run build:cem && npm run typescript && npm run make_doctests && npm run make_wc_viz_es6 && npm run make_wc_viz_cdn && npm run make_wc_instance_es6 && npm run make_wc_instance_cdn && npm run make_cm6 && npm run typecheck_cli && npm run make_cli",
+    "make_ci": "npm run clean && npm run makever && npm run peg && npm run build:cem && npm run typescript && npm run make_doctests && npm run make_wc_viz_es6 && npm run make_wc_viz_cdn && npm run make_wc_instance_es6 && npm run make_wc_instance_cdn && npm run make_wc_editor_es6 && npm run make_wc_widgets_es6 && npm run make_cm6 && npm run typecheck_cli && npm run make_cli",
     "eslint": "eslint --color src/ts/jssm.ts src/ts/jssm_types.ts src/ts/tests/*.ts",
     "audit": "text_audit -r -t major MAJOR wasteful WASTEFUL any mixed fixme FIXME checkme CHECKME testme TESTME stochable STOCHABLE todo TODO comeback COMEBACK whargarbl WHARGARBL -g ./src/ts/**/*.{js,ts}",
     "vet": "npm run eslint && npm run audit",
@@ -250,8 +272,12 @@
   },
   "homepage": "https://stonecypher.github.io/jssm/",
   "devDependencies": {
+    "@codemirror/autocomplete": "^6.20.3",
+    "@codemirror/commands": "^6.10.4",
     "@codemirror/language": "^6.12.3",
+    "@codemirror/lint": "^6.9.7",
     "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.43.2",
     "@custom-elements-manifest/analyzer": "^0.10.4",
     "@knodes/typedoc-plugin-pages": "^0.22.5",
     "@lezer/highlight": "^1.2.3",
@@ -304,10 +330,10 @@
     "reduce-to-639-1": "^1.1.0"
   },
   "peerDependencies": {
-    "lit": ">=3",
     "@codemirror/language": ">=6",
     "@codemirror/state": ">=6",
-    "@lezer/highlight": ">=1"
+    "@lezer/highlight": ">=1",
+    "lit": ">=3"
   },
   "peerDependenciesMeta": {
     "lit": {