coffeehaml 0.6.0 → 0.7.0

package/dist/prettier/options.js

@@ -0,0 +1,200 @@
+/**
+ * CoffeeHaml Prettier Plugin — Formatting Options
+ *
+ * Every formatting feature is independently deactivatable.
+ * 'preserve', false, or -1 means "leave as-is, no intervention."
+ */
+// ─── Category labels ───────────────────────────────────────
+const CAT = {
+    STRUCTURE: 'CoffeeHaml: Structure',
+    ATTRIBUTES: 'CoffeeHaml: Attributes',
+    COFFEESCRIPT: 'CoffeeHaml: CoffeeScript',
+    WHITESPACE: 'CoffeeHaml: Whitespace',
+    CONTROL_FLOW: 'CoffeeHaml: Control Flow',
+    COMMENTS: 'CoffeeHaml: Comments',
+};
+// ─── Option definitions ────────────────────────────────────
+/** Tag name case normalization. 'preserve' = leave as written. */
+const tagCase = {
+    category: CAT.STRUCTURE,
+    type: 'choice',
+    description: 'Normalize HTML tag casing. Component tags (%MyComponent) never affected.',
+    choices: [
+        { value: 'preserve', description: 'Leave tag case as written' },
+        { value: 'lowercase', description: '%DIV to %div (HTML tags only)' },
+    ],
+};
+/** Expand .class to %div.class. */
+const implicitDivExpansion = {
+    category: CAT.STRUCTURE,
+    type: 'boolean',
+    description: 'Expand .class to %div.class (anti-idiomatic in HAML).',
+};
+/** Max .class chain length before breaking into indented hierarchy. */
+const maxChainLength = {
+    category: CAT.STRUCTURE,
+    type: 'int',
+    description: 'Max .class chain length before breaking into indented hierarchy. 0 = always break.',
+};
+/** Threshold for single-line vs multi-line layout. */
+const inlineThreshold = {
+    category: CAT.STRUCTURE,
+    type: 'int',
+    description: 'Try single-line if estimated width <= this. -1 = never inline children.',
+};
+/** Self-closing style for void elements. */
+const voidElementStyle = {
+    category: CAT.STRUCTURE,
+    type: 'choice',
+    description: 'How void elements (%br, %img, etc.) are formatted.',
+    choices: [
+        { value: 'self-closing', description: 'Self-closing (no children)' },
+        { value: 'explicit', description: 'Preserve %br/ syntax, otherwise self-close' },
+    ],
+};
+/** Enforce a specific attribute syntax style. */
+const attributeStyle = {
+    category: CAT.ATTRIBUTES,
+    type: 'choice',
+    description: 'Enforce attribute syntax: {braces}, (parens), bare, or preserve.',
+    choices: [
+        { value: 'preserve', description: 'Keep as written' },
+        { value: 'braces', description: 'Convert to {CoffeeScript} style' },
+        { value: 'parens', description: 'Convert to HTML (parens) style' },
+        { value: 'bare', description: 'Convert to bare HAML style' },
+    ],
+};
+/** Number of attributes before forcing multiline layout. */
+const attributeMultilineThreshold = {
+    category: CAT.ATTRIBUTES,
+    type: 'int',
+    description: 'Break attributes across lines when count >= this. 0 = always multiline.',
+};
+/** Sort attribute keys. */
+const attributeSort = {
+    category: CAT.ATTRIBUTES,
+    type: 'choice',
+    description: 'Sort attribute keys (spread attributes always last).',
+    choices: [
+        { value: 'none', description: 'Preserve author order' },
+        { value: 'alphabetical', description: 'Sort A to Z' },
+        { value: 'idiomatic', description: 'id first, class second, rest A to Z' },
+    ],
+};
+/** Quote style for bare/HAML attributes. */
+const quoteStyle = {
+    category: CAT.ATTRIBUTES,
+    type: 'choice',
+    description: 'Quote style for bare/HAML attributes.',
+    choices: [
+        { value: 'preserve', description: 'Keep as written' },
+        { value: 'double', description: 'Force double quotes' },
+        { value: 'single', description: 'Force single quotes' },
+    ],
+};
+/** Format embedded CoffeeScript via Prettier's CS plugin. */
+const coffeeScriptFormat = {
+    category: CAT.COFFEESCRIPT,
+    type: 'boolean',
+    description: 'Format CoffeeScript expressions using prettier/plugins/coffeescript.',
+};
+/** Align chained method calls on newlines. */
+const methodChainAlign = {
+    category: CAT.COFFEESCRIPT,
+    type: 'boolean',
+    description: 'Align .method chains on newlines for = expressions.',
+};
+/** Blank line handling between sibling elements. */
+const blankLineHandling = {
+    category: CAT.WHITESPACE,
+    type: 'choice',
+    description: 'How blank lines between sibling elements are treated.',
+    choices: [
+        { value: 'preserve', description: 'Keep single; collapse multiples' },
+        { value: 'collapse', description: 'Remove all blank lines between siblings' },
+        { value: 'respect', description: 'Keep exactly as written' },
+    ],
+};
+/** Trailing whitespace handling. */
+const trailingWhitespace = {
+    category: CAT.WHITESPACE,
+    type: 'choice',
+    description: 'Handle trailing whitespace.',
+    choices: [
+        { value: 'remove', description: 'Strip trailing whitespace' },
+        { value: 'preserve', description: 'Leave as written' },
+    ],
+};
+/** Control flow \\ continuation style. */
+const continuationStyle = {
+    category: CAT.CONTROL_FLOW,
+    type: 'choice',
+    description: 'How \\ continuations are formatted.',
+    choices: [
+        { value: 'preserve', description: 'Keep as written' },
+        { value: 'indent', description: 'Always use indented continuation' },
+        { value: 'backslash', description: 'Always use \\ continuation' },
+    ],
+};
+/** Inline control flow with 'then'. */
+const controlFlowInline = {
+    category: CAT.CONTROL_FLOW,
+    type: 'boolean',
+    description: 'Allow - if x then .ok one-liners (anti-Prettier by default).',
+};
+/** Merge consecutive standalone - statements into indented block. */
+const statementMerging = {
+    category: CAT.CONTROL_FLOW,
+    type: 'choice',
+    description: 'Merge consecutive - lines into a single indented block. Only childless statements.',
+    choices: [
+        { value: 'preserve', description: 'Keep each - line separate' },
+        { value: 'merge', description: 'Merge consecutive childless statements into one indented block' },
+    ],
+};
+/** Reflow/format comment text. */
+const commentFormat = {
+    category: CAT.COMMENTS,
+    type: 'boolean',
+    description: 'Reflow/word-wrap comment text (experimental).',
+};
+// ─── Exports ────────────────────────────────────────────────
+export const options = {
+    tagCase,
+    implicitDivExpansion,
+    maxChainLength,
+    inlineThreshold,
+    voidElementStyle,
+    attributeStyle,
+    attributeMultilineThreshold,
+    attributeSort,
+    quoteStyle,
+    coffeeScriptFormat,
+    methodChainAlign,
+    blankLineHandling,
+    trailingWhitespace,
+    continuationStyle,
+    controlFlowInline,
+    statementMerging,
+    commentFormat,
+};
+export const defaultOptions = {
+    tagCase: 'preserve',
+    implicitDivExpansion: false,
+    maxChainLength: 4,
+    inlineThreshold: -1,
+    voidElementStyle: 'self-closing',
+    attributeStyle: 'preserve',
+    attributeMultilineThreshold: 1,
+    attributeSort: 'none',
+    quoteStyle: 'preserve',
+    coffeeScriptFormat: true,
+    methodChainAlign: true,
+    blankLineHandling: 'preserve',
+    trailingWhitespace: 'remove',
+    continuationStyle: 'indent',
+    controlFlowInline: false,
+    statementMerging: 'preserve',
+    commentFormat: false,
+};
+//# sourceMappingURL=options.js.map

package/dist/prettier/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/prettier/options.ts"],"names":[],"mappings":"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"}

package/dist/prettier/printer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CoffeeHaml Prettier Printer — AST to Prettier Doc IR.
+ *
+ * Uses Prettier's `print` callback for recursive descent via path.map.
+ * Each formatting decision gated by options for independent deactivation.
+ *
+ * Note: uses `any` for Path types because the abstract Node base class
+ * doesn't declare `children`, so Prettier's typed AstPath.map can't
+ * resolve property access chains on our AST nodes.
+ */
+import type { Doc } from 'prettier';
+export interface CoffeeHamlFormatOptions {
+    tagCase: 'preserve' | 'lowercase';
+    implicitDivExpansion: boolean;
+    maxChainLength: number;
+    inlineThreshold: number;
+    voidElementStyle: 'self-closing' | 'explicit';
+    attributeStyle: 'preserve' | 'braces' | 'parens' | 'bare';
+    attributeMultilineThreshold: number;
+    attributeSort: 'none' | 'alphabetical' | 'idiomatic';
+    quoteStyle: 'preserve' | 'double' | 'single';
+    coffeeScriptFormat: boolean;
+    methodChainAlign: boolean;
+    blankLineHandling: 'preserve' | 'collapse' | 'respect';
+    trailingWhitespace: 'remove' | 'preserve';
+    continuationStyle: 'preserve' | 'indent' | 'backslash';
+    controlFlowInline: boolean;
+    statementMerging: 'preserve' | 'merge';
+    commentFormat: boolean;
+    tabWidth: number;
+    useTabs: boolean;
+    printWidth: number;
+    originalText?: string;
+}
+type Path = any;
+type PrintFn = (selector?: any, args?: unknown) => Doc;
+export declare function print(path: Path, options: CoffeeHamlFormatOptions, printFn: PrintFn): Doc;
+/**
+ * Prettier embed function — formats full CoffeeScript blocks
+ * (Statement bodies, CoffeeScript filters) via the async textToDoc
+ * mechanism. Inline expressions are handled synchronously via formatCS.
+ */
+export declare function embedCoffeeScript(path: any, _printFn: any): Doc | undefined;
+export {};
+//# sourceMappingURL=printer.d.ts.map

package/dist/prettier/printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../src/prettier/printer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAapC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,GAAG,WAAW,CAAC;IAClC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,cAAc,GAAG,UAAU,CAAC;IAC9C,cAAc,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1D,2BAA2B,EAAE,MAAM,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,CAAC;IACrD,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACvD,kBAAkB,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC1C,iBAAiB,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,IAAI,GAAG,GAAG,CAAC;AAChB,KAAK,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,GAAG,CAAC;AA4HvD,wBAAgB,KAAK,CACnB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,OAAO,GACf,GAAG,CASL;AAigBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,GAAG,GACZ,GAAG,GAAG,SAAS,CAqCjB"}