@lumiose/prettier-plugin 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Javi Aguilar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { type Plugin } from "prettier";
+/** The parsed file: already formatted, since the work happens in the (async) parser. */
+interface StsxDocument {
+    type: "stsx";
+    formatted: string;
+}
+export declare const languages: Plugin["languages"];
+export declare const parsers: Plugin<StsxDocument>["parsers"];
+export declare const printers: Plugin<StsxDocument>["printers"];
+declare const plugin: Plugin<StsxDocument>;
+export default plugin;

package/dist/index.js

@@ -0,0 +1,74 @@
+// `@lumiose/prettier-plugin` (TASK-41): Prettier formats `.stsx` files the way `lumiose fmt` does, with
+// Prettier's own printers. `lumiose fmt`'s algorithm (@lumiose/cli/tooling `formatStsx`) does the work:
+// the TSX with every style block replaced by a placeholder goes through Prettier's TypeScript
+// printer, each block's CSS through its CSS printer (`$` references protected), and the blocks are
+// re-indented at their placement. Files with scanner or syntax errors are reported, not changed.
+//
+//   // .prettierrc.json
+//   { "plugins": ["@lumiose/prettier-plugin"] }
+//
+// oxfmt (which `lumiose fmt` uses) has no plugin API, so this is the way to keep Prettier for `.stsx`.
+import { formatStsx } from "@lumiose/cli/tooling";
+import { format } from "prettier";
+/** The Prettier options that shape TSX and CSS output, passed on to both printers. */
+const FORMAT_OPTIONS = [
+    "printWidth",
+    "tabWidth",
+    "useTabs",
+    "semi",
+    "singleQuote",
+    "jsxSingleQuote",
+    "quoteProps",
+    "trailingComma",
+    "bracketSpacing",
+    "bracketSameLine",
+    "objectWrap",
+    "arrowParens",
+    "singleAttributePerLine",
+    "endOfLine",
+];
+/** Formats TSX or CSS with Prettier, in the shape `formatStsx` expects from oxfmt. */
+const prettierFormatter = async (fileName, source, options) => {
+    try {
+        const parser = fileName.endsWith(".css") ? "css" : "typescript";
+        return { code: await format(source, { ...options, parser }), errors: [] };
+    }
+    catch (error) {
+        return { code: source, errors: [{ message: error.message }] };
+    }
+};
+export const languages = [
+    {
+        name: "Lumiose STSX",
+        parsers: ["stsx"],
+        extensions: [".stsx"],
+        vscodeLanguageIds: ["stsx"],
+    },
+];
+export const parsers = {
+    stsx: {
+        astFormat: "lumiose-stsx",
+        async parse(text, options) {
+            const config = {};
+            for (const key of FORMAT_OPTIONS) {
+                const value = options[key];
+                if (value !== undefined)
+                    config[key] = value;
+            }
+            const file = typeof options.filepath === "string" ? options.filepath : "component.stsx";
+            const result = await formatStsx(text, file, prettierFormatter, config);
+            if (!result.ok)
+                throw new SyntaxError(`${file}: ${result.error}`);
+            return { type: "stsx", formatted: result.code };
+        },
+        locStart: () => 0,
+        locEnd: (node) => node.formatted.length,
+    },
+};
+export const printers = {
+    "lumiose-stsx": {
+        print: (path) => path.node.formatted,
+    },
+};
+const plugin = { languages, parsers, printers };
+export default plugin;

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@lumiose/prettier-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Prettier support for Lumiose .stsx files: the TSX with Prettier's TypeScript printer, each <style> block with its CSS printer, re-indented at its placement (like lumiose fmt).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsjavi/lumiose.git",
+    "directory": "packages/prettier-plugin"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@lumiose/cli": "0.2.0",
+    "lumiose": "0.2.0"
+  },
+  "devDependencies": {
+    "@lumiose/compiler": "0.2.0",
+    "prettier": "^3.9.9"
+  },
+  "peerDependencies": {
+    "prettier": "^3.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "build": "node ../../scripts/build-package.ts"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.