@stacksjs/stx-vscode 0.2.351

package/dist/assets/syntaxes/stx.tmLanguage.json

@@ -0,0 +1,441 @@
+{
+  "scopeName": "text.html.ts.stx",
+  "name": "stx",
+  "fileTypes": ["stx"],
+  "patterns": [
+    {
+      "include": "#stx"
+    },
+    {
+      "include": "text.html.derivative"
+    }
+  ],
+  "injections": {
+    "text.html.ts.stx - (meta.embedded | meta.tag | comment.block.stx), L:(text.html.ts.stx meta.tag - (comment.block.stx | meta.embedded.block.stx)), L:(source.js.embedded.html - (comment.block.stx | meta.embedded.block.stx))": {
+      "patterns": [
+        {
+          "include": "#stx"
+        }
+      ]
+    }
+  },
+  "repository": {
+    "stx": {
+      "patterns": [
+        {
+          "begin": "(<)(script)(?=[\\s>])",
+          "beginCaptures": {
+            "1": {
+              "name": "punctuation.definition.tag.begin.html"
+            },
+            "2": {
+              "name": "entity.name.tag.script.html"
+            }
+          },
+          "end": "(</)(script)(>)",
+          "endCaptures": {
+            "1": {
+              "name": "punctuation.definition.tag.begin.html"
+            },
+            "2": {
+              "name": "entity.name.tag.script.html"
+            },
+            "3": {
+              "name": "punctuation.definition.tag.end.html"
+            }
+          },
+          "name": "meta.tag.script.html",
+          "patterns": [
+            {
+              "begin": "(?<=>)(?!</)",
+              "end": "(?=</script)",
+              "name": "source.js.embedded.html",
+              "patterns": [
+                {
+                  "include": "#stx"
+                },
+                {
+                  "include": "source.js"
+                }
+              ]
+            },
+            {
+              "include": "text.html.derivative#tag-stuff"
+            }
+          ]
+        },
+        {
+          "begin": "(<)(style)(?=[\\s>])",
+          "beginCaptures": {
+            "1": {
+              "name": "punctuation.definition.tag.begin.html"
+            },
+            "2": {
+              "name": "entity.name.tag.style.html"
+            }
+          },
+          "end": "(</)(style)(>)",
+          "endCaptures": {
+            "1": {
+              "name": "punctuation.definition.tag.begin.html"
+            },
+            "2": {
+              "name": "entity.name.tag.style.html"
+            },
+            "3": {
+              "name": "punctuation.definition.tag.end.html"
+            }
+          },
+          "name": "meta.tag.style.html",
+          "patterns": [
+            {
+              "begin": "(?<=>)(?!</)",
+              "end": "(?=</style)",
+              "name": "source.css.embedded.html",
+              "patterns": [
+                {
+                  "include": "source.css"
+                }
+              ]
+            },
+            {
+              "include": "text.html.derivative#tag-stuff"
+            }
+          ]
+        },
+        {
+          "begin": "{{--",
+          "beginCaptures": {
+            "0": {
+              "name": "punctuation.definition.comment.begin.stx"
+            }
+          },
+          "end": "--}}",
+          "endCaptures": {
+            "0": {
+              "name": "punctuation.definition.comment.end.stx"
+            }
+          },
+          "name": "comment.block.stx"
+        },
+        {
+          "begin": "(?<!@){{{",
+          "beginCaptures": {
+            "0": {
+              "name": "support.function.construct.begin.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "}}}",
+          "endCaptures": {
+            "0": {
+              "name": "support.function.construct.end.stx"
+            }
+          },
+          "name": "meta.function.echo.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "begin": "(?<![@{]){{",
+          "beginCaptures": {
+            "0": {
+              "name": "support.function.construct.begin.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "}}",
+          "endCaptures": {
+            "0": {
+              "name": "support.function.construct.end.stx"
+            }
+          },
+          "name": "meta.function.echo.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "begin": "(?<!@){!!",
+          "beginCaptures": {
+            "0": {
+              "name": "support.function.construct.begin.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "!!}",
+          "endCaptures": {
+            "0": {
+              "name": "support.function.construct.end.stx"
+            }
+          },
+          "name": "meta.function.echo.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "begin": "(@){{",
+          "beginCaptures": {
+            "0": {
+              "name": "support.function.construct.begin.stx"
+            },
+            "1": {
+              "name": "variable.other.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "}}",
+          "endCaptures": {
+            "0": {
+              "name": "support.function.construct.end.stx"
+            }
+          },
+          "name": "meta.function.echo.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "begin": "(?x)(?<![A-Za-z0-9_@]) (@  (?i:\n    animationGroup\n    |auth\n    |break\n    |can\n    |canany\n    |cannot\n    |case\n    |checked\n    |choice\n    |component\n    |continue\n    |css\n    |csrf\n    |dd\n    |disabled\n    |dump\n    |each\n    |elsecan\n    |elsecanany\n    |elsecannot\n    |elseif\n    |empty\n    |env\n    |error\n    |extends\n    |for\n    |foreach\n    |forelse\n    |guest\n    |hassection\n    |if\n    |include\n    |includefirst\n    |includeif\n    |includeunless\n    |includewhen\n    |inject\n    |isset\n    |js\n    |json\n    |lang\n    |locale\n    |method\n    |motion\n    |once\n    |prepend\n    |prependOnce\n    |props\n    |push\n    |pushIf\n    |pushOnce\n    |readonly\n    |required\n    |scrollAnimate\n    |section\n    |sectionMissing\n    |selected\n    |slot\n    |stack\n    |style\n    |switch\n    |t\n    |translate\n    |transition\n    |unless\n    |unset\n    |use\n    |webcomponent\n    |while\n    |yield\n  )[\\t ]*\n)(\\() # Followed by opening parentheses\n",
+          "beginCaptures": {
+            "1": {
+              "name": "keyword.stx"
+            },
+            "2": {
+              "name": "begin.bracket.round.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "\\)",
+          "endCaptures": {
+            "0": {
+              "name": "end.bracket.round.stx"
+            }
+          },
+          "name": "meta.directive.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "match": "(?x)(?<![A-Za-z0-9_@]) @(?:  append\n  |break\n  |continue\n  |default\n  |each\n  |else\n  |overwrite\n  |parent\n  |sectionMissing\n  |show\n  |stack\n  |stop\n)\\b\n",
+          "name": "keyword.stx"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:ts)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:endts)\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ],
+          "contentName": "source.ts",
+          "name": "meta.embedded.block.ts"
+        },
+        {
+          "match": "(?x)(?<![A-Za-z0-9_@]) @(end)? (?i:  auth\n  |can\n  |canany\n  |cannot\n  |component\n  |css\n  |empty\n  |env\n  |error\n  |for\n  |foreach\n  |forelse\n  |guest\n  |if\n  |isset\n  |js\n  |lang\n  |markdown\n  |motion\n  |once\n  |prepend\n  |prependOnce\n  |push\n  |pushIf\n  |pushOnce\n  |raw\n  |script\n  |scrollAnimate\n  |section\n  |session\n  |slot\n  |switch\n  |transition\n  |unless\n  |verbatim\n  |webcomponent\n  |while\n)\\b\n",
+          "name": "keyword.stx"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:js)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:endjs)\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.js"
+            }
+          ],
+          "contentName": "source.js",
+          "name": "meta.embedded.block.js"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:script)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:endscript)\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ],
+          "contentName": "source.ts",
+          "name": "meta.embedded.block.script"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:css)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:endcss)\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.css"
+            }
+          ],
+          "contentName": "source.css",
+          "name": "meta.embedded.block.css"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:markdown)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:endmarkdown)\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "patterns": [
+            {
+              "include": "text.html.markdown"
+            }
+          ],
+          "contentName": "text.html.markdown",
+          "name": "meta.embedded.block.markdown"
+        },
+        {
+          "begin": "(?<![A-Za-z0-9_@])@(?i:raw|verbatim)\\b",
+          "beginCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "end": "(?<![A-Za-z0-9_@])@(?i:end(?:raw|verbatim))\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.directive.stx"
+            }
+          },
+          "contentName": "string.unquoted.raw",
+          "name": "meta.embedded.block.raw"
+        },
+        {
+          "begin": "(?x)(?<![A-Za-z0-9_@]) (@\\w+(?:::w+)?[\\t ]*) (\\() # Followed by opening parentheses",
+          "beginCaptures": {
+            "1": {
+              "name": "entity.name.function.stx"
+            },
+            "2": {
+              "name": "begin.bracket.round.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "end": "\\)",
+          "endCaptures": {
+            "0": {
+              "name": "end.bracket.round.stx"
+            }
+          },
+          "name": "meta.directive.custom.stx",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        },
+        {
+          "match": "(?x)(?<![A-Za-z0-9_@]) @\\w+(?:::w+)?\\b",
+          "name": "entity.name.function.stx"
+        },
+        {
+          "begin": "(:[a-z-]+)(=)(\")",
+          "beginCaptures": {
+            "0": {
+              "name": "meta.attribute.directive.stx"
+            },
+            "1": {
+              "name": "entity.other.attribute-name.stx"
+            },
+            "2": {
+              "name": "punctuation.separator.key-value.stx"
+            },
+            "3": {
+              "name": "string.quoted.double.stx"
+            }
+          },
+          "end": "(\")",
+          "endCaptures": {
+            "0": {
+              "name": "string.quoted.double.stx"
+            },
+            "1": {
+              "name": "punctuation.definition.string.end.stx"
+            }
+          },
+          "contentName": "source.ts",
+          "patterns": [
+            {
+              "include": "source.ts"
+            }
+          ]
+        }
+      ]
+    },
+    "balance_brackets": {
+      "patterns": [
+        {
+          "begin": "\\(",
+          "end": "\\)",
+          "patterns": [
+            {
+              "include": "#balance_brackets"
+            }
+          ]
+        },
+        {
+          "match": "[^()]+"
+        }
+      ]
+    }
+  },
+  "uuid": "stx-tmlanguage"
+}

package/dist/contributes.json

@@ -0,0 +1,168 @@
+{
+  "languages": [
+    {
+      "id": "stx",
+      "aliases": [
+        "stx",
+        "STX"
+      ],
+      "extensions": [
+        ".stx"
+      ],
+      "configuration": "./languages/stx.configuration.json"
+    }
+  ],
+  "grammars": [
+    {
+      "language": "stx",
+      "scopeName": "text.html.ts.stx",
+      "path": "./syntaxes/stx.tmLanguage.json",
+      "embeddedLanguages": {
+        "source.css": "css",
+        "source.js": "javascript",
+        "source.ts": "typescript",
+        "meta.embedded.block.typescript": "typescript",
+        "meta.embedded.block.javascript": "javascript",
+        "meta.embedded.line.typescript": "typescript",
+        "meta.component.parameters.stx": "typescript"
+      }
+    }
+  ],
+  "snippets": [
+    {
+      "language": "stx",
+      "path": "./snippets/stx.json"
+    }
+  ],
+  "commands": [
+    {
+      "command": "stx.sortClasses",
+      "title": "Sort Utility Classes",
+      "category": "stx"
+    },
+    {
+      "command": "css.reload",
+      "title": "Css: Reload Configuration"
+    }
+  ],
+  "configuration": {
+    "title": "stx",
+    "properties": {
+      "stxTypescriptPlugin.enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable TypeScript language features in stx files"
+      },
+      "stx.diagnostics.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable diagnostics (errors and warnings) for stx files"
+      },
+      "stx.diagnostics.validateUnclosedDirectives": {
+        "type": "boolean",
+        "default": true,
+        "description": "Validate unclosed directives like @if without @endif"
+      },
+      "stx.diagnostics.validateMismatchedDirectives": {
+        "type": "boolean",
+        "default": true,
+        "description": "Validate mismatched directives like @if closed with @endforeach"
+      },
+      "stx.diagnostics.validateTemplatePaths": {
+        "type": "boolean",
+        "default": true,
+        "description": "Validate that template paths in @include and @component directives exist"
+      },
+      "stx.completion.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable auto-completion for stx directives"
+      },
+      "stx.completion.showSnippets": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show snippet completions with placeholders for directive parameters"
+      },
+      "stx.hover.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable hover documentation for stx directives"
+      },
+      "stx.hover.showExamples": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show code examples in hover documentation"
+      },
+      "stx.codeActions.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable quick fixes and code actions"
+      },
+      "stx.folding.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable code folding for directive blocks"
+      },
+      "stx.semanticHighlighting.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable semantic syntax highlighting for directives"
+      },
+      "stx.utilityClasses.enable": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable utility class features (tooltips, color previews, sorting)"
+      },
+      "stx.utilityClasses.framework": {
+        "type": "string",
+        "enum": [
+          "tailwind",
+          "unocss",
+          "auto"
+        ],
+        "default": "auto",
+        "markdownDescription": "Utility CSS framework to use. `auto` will detect from config files"
+      },
+      "stx.utilityClasses.colorPreview": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show inline color decorations for color utility classes"
+      },
+      "stx.utilityClasses.hoverPreview": {
+        "type": "boolean",
+        "default": true,
+        "description": "Show CSS output when hovering over utility classes"
+      },
+      "stx.utilityClasses.underline": {
+        "type": "boolean",
+        "default": true,
+        "description": "Underline matched utility classes"
+      },
+      "stx.utilityClasses.sortOnSave": {
+        "type": "boolean",
+        "default": false,
+        "description": "Automatically sort utility classes on file save"
+      },
+      "stx.utilityClasses.colorPreviewRadius": {
+        "type": "string",
+        "default": "0",
+        "description": "Border radius for color preview blocks ('0' for square like Tailwind, '50%' for circle)"
+      },
+      "stx.utilityClasses.selectionStyle": {
+        "type": "boolean",
+        "default": false,
+        "description": "Show CSS preview for selected utility classes"
+      },
+      "stx.utilityClasses.autocomplete": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable autocomplete for utility classes"
+      },
+      "css.remToPxRatio": {
+        "type": "number",
+        "default": 16,
+        "description": "Rem to px conversion ratio for hover previews"
+      }
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The embedding API of `@stacksjs/stx-vscode`.
+ *
+ * Written by hand rather than generated: the implementation (packages/vscode/src)
+ * is typed against `@types/vscode`, and generating from it would make every
+ * consumer install those types to read four functions.
+ */
+
+/** The marketplace ID of the standalone stx extension. */
+export declare const STX_EXTENSION_ID: 'Stacks.vscode-stx'
+
+/** The marketplace ID of the Stacks framework extension, which embeds this package. */
+export declare const STACKS_EXTENSION_ID: 'Stacks.vscode-stacks'
+
+/** The part of `vscode.ExtensionContext` stx support uses. */
+export interface StxExtensionContext {
+  subscriptions: Array<{ dispose: () => unknown }>
+}
+
+export interface StxLanguageOptions {
+  /**
+   * The directory holding the `snippets/`, `syntaxes/` and `languages/`
+   * assets: this package's `dist/assets`, copied into the embedding extension.
+   */
+  assetsPath: string
+  /**
+   * Offer the stx snippets as completions. Leave it off when the snippets are
+   * in your manifest, or when the stx extension is installed and contributes
+   * them already.
+   */
+  snippets?: boolean
+}
+
+/**
+ * Register all of stx's runtime language support: hovers, completions,
+ * diagnostics, go to definition, document links, folding, semantic tokens,
+ * code actions, utility-class previews, and the `stx.sortClasses` and
+ * `css.reload` commands. Everything is added to `context.subscriptions`.
+ *
+ * Call it at most once per window. The stx extension stands down only for
+ * `Stacks.vscode-stacks`, and only once that extension's `activate` resolves
+ * to `{ stx: { active: true } }`, so return that from `activate` after this
+ * resolves. Any other embedding extension would register everything twice
+ * next to the stx extension.
+ */
+export declare function activateStxLanguage(context: StxExtensionContext, options: StxLanguageOptions): Promise<void>
+
+export declare function deactivateStxLanguage(): void