Merge pull request #13 from customerio/html-mso-properties

Author: avigoldman

.changeset/tasty-snakes-bet.md

@@ -0,0 +1,5 @@
+---
+'@ciolabs/html-mso-properties': patch
+---
+
+initial release

packages/html-mod/package.json

@@ -40,7 +40,6 @@
     "magic-string": "^0.30.0"
   },
   "devDependencies": {
-    "@types/escape-html": "^1.0.0",
-    "@types/node": "^20.0.0"
+    "@types/escape-html": "^1.0.0"
   }
 }

packages/html-mso-properties/README.md

@@ -0,0 +1,67 @@
+# @ciolabs/html-mso-properties
+
+> Microsoft Office CSS properties
+
+A comprehensive TypeScript package containing all Microsoft Office (MSO) CSS properties, their valid values, defaults, and inheritance behavior.
+
+## Install
+
+```bash
+npm install @ciolabs/html-mso-properties
+```
+
+## Usage
+
+### Import the data
+
+```typescript
+import msoProperties from '@ciolabs/html-mso-properties';
+
+// Get all MSO properties
+console.log(msoProperties.length); // 1000+ properties
+
+// Find a specific property
+const borderAlt = msoProperties.find(prop => prop.property === 'mso-border-alt');
+console.log(borderAlt);
+// {
+//   property: 'mso-border-alt',
+//   values: ['apples', 'arched-scallops', 'auto', ...],
+//   default: null,
+//   inherits: false
+// }
+```
+
+### Import the types
+
+```typescript
+import { MsoProperty } from '@ciolabs/html-mso-properties';
+
+function processProperty(prop: MsoProperty) {
+  console.log(`Property: ${prop.property}`);
+  console.log(`Valid values: ${prop.values.join(', ')}`);
+  console.log(`Default: ${prop.default}`);
+  console.log(`Inherits: ${prop.inherits}`);
+}
+```
+
+## Data Structure
+
+The package exports an array of `MsoProperty` objects. Each object contains:
+
+- **`property`** (`string`) - Name of the CSS property (e.g., `'mso-border-alt'`)
+- **`values`** (`string[]`) - Array of valid values for the property
+- **`default`** (`string | number | null`) - The default value, or `null` if no default
+- **`inherits`** (`boolean`) - Whether the property value is inherited from parent elements
+
+## TypeScript Support
+
+This package includes full TypeScript support with exported interfaces:
+
+```typescript
+export interface MsoProperty {
+  property: string;
+  values: string[];
+  default: string | number | null;
+  inherits: boolean;
+}
+```

packages/html-mso-properties/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@ciolabs/html-mso-properties",
+  "version": "0.0.0",
+  "description": "Microsoft Office CSS properties",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "Customer.io <win@customer.io>",
+  "license": "Apache-2.0 WITH Commons-Clause",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/customerio/ciolabs.git",
+    "directory": "packages/html-mso-properties"
+  },
+  "homepage": "https://github.com/customerio/ciolabs/tree/main/packages/html-mso-properties#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}

packages/html-mso-properties/src/index.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, test } from 'vitest';
+
+import msoProperties from './index';
+
+describe('@ciolabs/html-mso-properties', () => {
+  test('should export an array of MSO properties', () => {
+    expect(Array.isArray(msoProperties)).toBe(true);
+  });
+
+  test('should have more than 400 properties', () => {
+    expect(msoProperties.length).toBeGreaterThan(400);
+  });
+
+  test('should have font-color as the first property', () => {
+    expect(msoProperties[0].property).toBe('font-color');
+  });
+});