@homebound/truss 2.0.0-next.7 → 2.0.0

package/build/runtime.d.ts

@@ -0,0 +1,18 @@
+import * as stylex from '@stylexjs/stylex';
+
+declare class TrussDebugInfo {
+    /** A compact `FileName.tsx:line` source label for a Truss CSS expression. */
+    readonly src: string;
+    constructor(src: string);
+}
+/** Call StyleX while stripping Truss debug sentinels from the style list. */
+declare function trussProps(stylexNs: typeof stylex, ...styles: unknown[]): Record<string, unknown>;
+declare function mergeProps(stylexNs: typeof stylex, explicitClassName: string, ...styles: unknown[]): Record<string, unknown>;
+/**
+ * Coerce maybe-array StyleX inputs into arrays, guarding against nullish/false and plain object values.
+ *
+ * I.e. `...asStyleArray(xss)` stays safe when destructured `xss` is `undefined`.
+ */
+declare function asStyleArray(styles: unknown): ReadonlyArray<unknown>;
+
+export { TrussDebugInfo, asStyleArray, mergeProps, trussProps };

package/build/runtime.js

@@ -0,0 +1,56 @@
+// src/runtime.ts
+var TrussDebugInfo = class {
+  /** A compact `FileName.tsx:line` source label for a Truss CSS expression. */
+  src;
+  constructor(src) {
+    this.src = src;
+  }
+};
+function trussProps(stylexNs, ...styles) {
+  const { debugSources, styleArgs } = splitDebugInfo(styles);
+  const sx = stylexNs.props(...styleArgs);
+  return applyDebugSources(sx, debugSources);
+}
+function mergeProps(stylexNs, explicitClassName, ...styles) {
+  const { debugSources, styleArgs } = splitDebugInfo(styles);
+  const sx = stylexNs.props(...styleArgs);
+  return {
+    ...applyDebugSources(sx, debugSources),
+    className: `${explicitClassName} ${sx.className ?? ""}`.trim()
+  };
+}
+function asStyleArray(styles) {
+  if (Array.isArray(styles)) {
+    return styles;
+  }
+  return styles ? [styles] : [];
+}
+function splitDebugInfo(styles) {
+  const debugSources = [];
+  const styleArgs = [];
+  for (const style of styles) {
+    if (style instanceof TrussDebugInfo) {
+      debugSources.push(style.src);
+    } else {
+      styleArgs.push(style);
+    }
+  }
+  return { debugSources, styleArgs };
+}
+function applyDebugSources(props, debugSources) {
+  if (debugSources.length === 0) {
+    return props;
+  }
+  const uniqueSources = Array.from(new Set(debugSources));
+  return {
+    ...props,
+    "data-truss-src": uniqueSources.join("; ")
+  };
+}
+export {
+  TrussDebugInfo,
+  asStyleArray,
+  mergeProps,
+  trussProps
+};
+//# sourceMappingURL=runtime.js.map

package/build/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts"],"sourcesContent":["import type * as stylex from \"@stylexjs/stylex\";\n\nexport class TrussDebugInfo {\n  /** A compact `FileName.tsx:line` source label for a Truss CSS expression. */\n  readonly src: string;\n\n  constructor(src: string) {\n    this.src = src;\n  }\n}\n\ntype StylexPropArg = Parameters<typeof stylex.props>[number];\n\n/** Call StyleX while stripping Truss debug sentinels from the style list. */\nexport function trussProps(stylexNs: typeof stylex, ...styles: unknown[]): Record<string, unknown> {\n  const { debugSources, styleArgs } = splitDebugInfo(styles);\n  const sx = stylexNs.props(...styleArgs);\n  return applyDebugSources(sx, debugSources);\n}\n\nexport function mergeProps(\n  stylexNs: typeof stylex,\n  explicitClassName: string,\n  ...styles: unknown[]\n): Record<string, unknown> {\n  const { debugSources, styleArgs } = splitDebugInfo(styles);\n  const sx = stylexNs.props(...styleArgs);\n  return {\n    ...applyDebugSources(sx, debugSources),\n    className: `${explicitClassName} ${sx.className ?? \"\"}`.trim(),\n  };\n}\n\n/**\n * Coerce maybe-array StyleX inputs into arrays, guarding against nullish/false and plain object values.\n *\n * I.e. `...asStyleArray(xss)` stays safe when destructured `xss` is `undefined`.\n */\nexport function asStyleArray(styles: unknown): ReadonlyArray<unknown> {\n  if (Array.isArray(styles)) {\n    return styles;\n  }\n  // I.e. a single style object/ref like `xss={{ ...Css.blue.$ }}` becomes `[xss]`\n  return styles ? [styles] : [];\n}\n\n/** Collect Truss debug info while preserving the original StyleX argument order. */\nfunction splitDebugInfo(styles: ReadonlyArray<unknown>): {\n  debugSources: string[];\n  styleArgs: StylexPropArg[];\n} {\n  const debugSources: string[] = [];\n  const styleArgs: StylexPropArg[] = [];\n\n  for (const style of styles) {\n    if (style instanceof TrussDebugInfo) {\n      debugSources.push(style.src);\n    } else {\n      styleArgs.push(style as StylexPropArg);\n    }\n  }\n\n  return { debugSources, styleArgs };\n}\n\n/** Deduplicate and attach compact Truss source labels to emitted props. */\nfunction applyDebugSources(\n  props: Record<string, unknown>,\n  debugSources: ReadonlyArray<string>,\n): Record<string, unknown> {\n  if (debugSources.length === 0) {\n    return props;\n  }\n\n  const uniqueSources = Array.from(new Set(debugSources));\n  return {\n    ...props,\n    \"data-truss-src\": uniqueSources.join(\"; \"),\n  };\n}\n"],"mappings":";AAEO,IAAM,iBAAN,MAAqB;AAAA;AAAA,EAEjB;AAAA,EAET,YAAY,KAAa;AACvB,SAAK,MAAM;AAAA,EACb;AACF;AAKO,SAAS,WAAW,aAA4B,QAA4C;AACjG,QAAM,EAAE,cAAc,UAAU,IAAI,eAAe,MAAM;AACzD,QAAM,KAAK,SAAS,MAAM,GAAG,SAAS;AACtC,SAAO,kBAAkB,IAAI,YAAY;AAC3C;AAEO,SAAS,WACd,UACA,sBACG,QACsB;AACzB,QAAM,EAAE,cAAc,UAAU,IAAI,eAAe,MAAM;AACzD,QAAM,KAAK,SAAS,MAAM,GAAG,SAAS;AACtC,SAAO;AAAA,IACL,GAAG,kBAAkB,IAAI,YAAY;AAAA,IACrC,WAAW,GAAG,iBAAiB,IAAI,GAAG,aAAa,EAAE,GAAG,KAAK;AAAA,EAC/D;AACF;AAOO,SAAS,aAAa,QAAyC;AACpE,MAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,SAAO,SAAS,CAAC,MAAM,IAAI,CAAC;AAC9B;AAGA,SAAS,eAAe,QAGtB;AACA,QAAM,eAAyB,CAAC;AAChC,QAAM,YAA6B,CAAC;AAEpC,aAAW,SAAS,QAAQ;AAC1B,QAAI,iBAAiB,gBAAgB;AACnC,mBAAa,KAAK,MAAM,GAAG;AAAA,IAC7B,OAAO;AACL,gBAAU,KAAK,KAAsB;AAAA,IACvC;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,UAAU;AACnC;AAGA,SAAS,kBACP,OACA,cACyB;AACzB,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,MAAM,KAAK,IAAI,IAAI,YAAY,CAAC;AACtD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,kBAAkB,cAAc,KAAK,IAAI;AAAA,EAC3C;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebound/truss",
-  "version": "2.0.0-next.7",
+  "version": "2.0.0",
   "type": "module",
   "main": "build/index.js",
   "bin": "cli.js",
@@ -14,6 +14,11 @@
       "types": "./build/plugin/index.d.ts",
       "import": "./build/plugin/index.js",
       "default": "./build/plugin/index.js"
+    },
+    "./runtime": {
+      "types": "./build/runtime.d.ts",
+      "import": "./build/runtime.js",
+      "default": "./build/runtime.js"
     }
   },
   "scripts": {
@@ -35,6 +40,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
-  },
-  "stableVersion": "1.137.5"
+  }
 }

package/tsup.config.ts

@@ -4,6 +4,7 @@ export default defineConfig({
   entry: {
     index: "src/index.ts",
     "plugin/index": "src/plugin/index.ts",
+    runtime: "src/runtime.ts",
   },
   format: ["esm"],
   dts: true,