@pie-qti/element-schemas 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+$ tsc && bun run copy-schemas
+$ mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @pie-qti/element-schemas
+
+## 0.1.1
+
+### Patch Changes
+
+- 2243643: Publish the initial public release of all publishable PIE-QTI packages.

package/README.md

@@ -0,0 +1,107 @@
+# @pie-qti/element-schemas
+
+JSON schemas for PIE element validation. This package contains schemas extracted from PIE element packages for use in validation without requiring the full element packages as dependencies.
+
+## Usage
+
+```typescript
+import { loadSchema, loadAllSchemas } from '@pie-qti/element-schemas';
+
+// Load a specific schema
+const mcSchema = await loadSchema('multiple-choice');
+
+// Load all schemas
+const allSchemas = await loadAllSchemas();
+// Returns Map: '@pie-element/multiple-choice' => schema object
+```
+
+## Available Schemas
+
+- `multiple-choice` - Multiple choice questions
+- `extended-text-entry` - Extended text entry questions
+
+## Keeping Schemas Up-to-Date
+
+Schemas are synced from the [pie-elements](https://github.com/pie-framework/pie-elements) repository.
+
+### Prerequisites
+
+Ensure `pie-elements` is checked out as a sibling directory:
+
+```bash
+cd /path/to/projects
+git clone https://github.com/pie-framework/pie-elements.git
+```
+
+### Sync Schemas
+
+To update schemas from pie-elements:
+
+```bash
+bun --filter @pie-qti/element-schemas sync
+```
+
+This will:
+1. Read schemas from `pie-elements/packages/*/docs/pie-schema.json`
+2. Copy them to `src/schemas/`
+3. Update `schema-versions.json` with version metadata
+4. Skip schemas that haven't changed (based on content hash)
+
+### Check for Updates
+
+To check if local schemas are up-to-date:
+
+```bash
+bun --filter @pie-qti/element-schemas check-updates
+```
+
+This is useful in CI to detect schema drift.
+
+## Schema Versions
+
+The `schema-versions.json` file tracks:
+- Source package version
+- Content hash (SHA-256)
+- Sync timestamp
+- Source file path
+
+Example:
+```json
+{
+  "multiple-choice": {
+    "version": "7.2.1",
+    "schemaHash": "abc123def456",
+    "syncedAt": "2025-12-24T10:00:00Z",
+    "sourcePath": "/path/to/pie-elements/packages/multiple-choice/docs/pie-schema.json"
+  }
+}
+```
+
+## Adding New Elements
+
+To add a new PIE element schema:
+
+1. Add the element name to `ELEMENTS_TO_SYNC` in `scripts/sync-schemas.ts`
+2. Add the element type to `AVAILABLE_SCHEMAS` in `src/index.ts`
+3. Run `bun --filter @pie-qti/element-schemas sync` to pull the schema
+4. Commit the new schema file and updated metadata
+
+## CI Integration
+
+Example GitHub Action to check for schema drift:
+
+```yaml
+name: Check PIE Schemas
+on: [push, pull_request]
+jobs:
+  check-schemas:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: oven-sh/setup-bun@v1
+      - run: bun install
+      - name: Clone pie-elements
+        run: git clone --depth 1 https://github.com/pie-framework/pie-elements.git ../pie-elements
+      - name: Check schema versions
+        run: bun --filter @pie-qti/element-schemas check-updates
+```

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @pie-qti/element-schemas
+ *
+ * PIE element JSON schemas for validation
+ */
+/**
+ * Available PIE element schemas
+ */
+export declare const AVAILABLE_SCHEMAS: readonly ["multiple-choice", "extended-text-entry", "placement-ordering", "match", "explicit-constructed-response", "select-text", "inline-dropdown", "drag-in-the-blank", "ebsr", "hotspot", "image-cloze-association", "match-list", "passage"];
+export type ElementType = typeof AVAILABLE_SCHEMAS[number];
+/**
+ * Load a PIE element schema
+ * @param elementType - Element type (e.g., 'multiple-choice')
+ * @returns JSON schema object
+ */
+export declare function loadSchema(elementType: ElementType): Promise<object>;
+/**
+ * Load all available schemas
+ * @returns Map of element type to schema
+ */
+export declare function loadAllSchemas(): Promise<Map<string, object>>;
+/**
+ * Get schema synchronously (must be loaded first)
+ * @param elementType - Element type
+ * @returns Cached schema or undefined
+ */
+export declare function getSchema(elementType: ElementType): object | undefined;
+/**
+ * Check if a schema is available
+ * @param elementType - Element type to check
+ */
+export declare function hasSchema(elementType: string): elementType is ElementType;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,eAAO,MAAM,iBAAiB,mPAcpB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAO3D;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1E;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASnE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,IAAI,WAAW,CAEzE"}

package/dist/index.js

@@ -0,0 +1,80 @@
+/**
+ * @pie-qti/element-schemas
+ *
+ * PIE element JSON schemas for validation
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Available PIE element schemas
+ */
+export const AVAILABLE_SCHEMAS = [
+    'multiple-choice',
+    'extended-text-entry',
+    'placement-ordering',
+    'match',
+    'explicit-constructed-response',
+    'select-text',
+    'inline-dropdown',
+    'drag-in-the-blank',
+    'ebsr',
+    'hotspot',
+    'image-cloze-association',
+    'match-list',
+    'passage',
+];
+/**
+ * Schema cache
+ */
+const schemaCache = new Map();
+/**
+ * Load a PIE element schema
+ * @param elementType - Element type (e.g., 'multiple-choice')
+ * @returns JSON schema object
+ */
+export async function loadSchema(elementType) {
+    // Check cache first
+    if (schemaCache.has(elementType)) {
+        return schemaCache.get(elementType);
+    }
+    const schemaPath = resolve(__dirname, `schemas/${elementType}.json`);
+    try {
+        const content = await readFile(schemaPath, 'utf-8');
+        const schema = JSON.parse(content);
+        schemaCache.set(elementType, schema);
+        return schema;
+    }
+    catch (error) {
+        throw new Error(`Failed to load schema for ${elementType}: ${error.message}`);
+    }
+}
+/**
+ * Load all available schemas
+ * @returns Map of element type to schema
+ */
+export async function loadAllSchemas() {
+    const schemas = new Map();
+    for (const elementType of AVAILABLE_SCHEMAS) {
+        const schema = await loadSchema(elementType);
+        schemas.set(`@pie-element/${elementType}`, schema);
+    }
+    return schemas;
+}
+/**
+ * Get schema synchronously (must be loaded first)
+ * @param elementType - Element type
+ * @returns Cached schema or undefined
+ */
+export function getSchema(elementType) {
+    return schemaCache.get(elementType);
+}
+/**
+ * Check if a schema is available
+ * @param elementType - Element type to check
+ */
+export function hasSchema(elementType) {
+    return AVAILABLE_SCHEMAS.includes(elementType);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB;IACjB,qBAAqB;IACrB,oBAAoB;IACpB,OAAO;IACP,+BAA+B;IAC/B,aAAa;IACb,iBAAiB;IACjB,mBAAmB;IACnB,MAAM;IACN,SAAS;IACT,yBAAyB;IACzB,YAAY;IACZ,SAAS;CACD,CAAC;AAIX;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAwB;IACvD,oBAAoB;IACpB,IAAI,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,WAAW,WAAW,OAAO,CAAC,CAAC;IAErE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,KAAM,KAAe,CAAC,OAAO,EAAE,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,MAAM,WAAW,IAAI,iBAAiB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,WAAwB;IAChD,OAAO,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,WAA0B,CAAC,CAAC;AAChE,CAAC"}