Add interlinearizer feature with XML parsing and web view integration

- Introduced `interlinearizer.web-view.tsx` and `interlinearizer.web-view.scss` for rendering interlinear data.
- Implemented `InterlinearXmlParser` for parsing interlinear XML data.
- Updated `package.json` and `package-lock.json` to include `fast-xml-parser` dependency.
- Added new types for interlinear data in `paranext-extension-template.d.ts`.
- Included sample interlinear XML data in `test-data/Interlinear_en_MAT.xml`.
- Enhanced `main.ts` to register the new web view provider for the interlinearizer.
- Updated `cspell.json` with new terms related to interlinearization.

Author: gnarlings

cspell.json

@@ -24,6 +24,8 @@
     "guids",
     "hopkinson",
     "iframes",
+    "interlinearization",
+    "interlinearizer",
     "localstorage",
     "maximizable",
     "networkable",

package-lock.json

@@ -35,6 +35,7 @@
   },
   "dependencies": {
     "@sillsdev/scripture": "^2.0.2",
+    "fast-xml-parser": "^5.3.3",
     "platform-bible-utils": "file:../paranext-core/lib/platform-bible-utils"
   },
   "devDependencies": {

package.json

@@ -0,0 +1 @@
+@use 'tailwind';

src/interlinearizer.web-view.scss

@@ -0,0 +1,56 @@
+import { useMemo } from 'react';
+import type { InterlinearData } from 'paranext-extension-template';
+import { InterlinearXmlParser } from './parsers/interlinearXmlParser';
+
+/** Test interlinear XML bundled at build time (from test-data/Interlinear_en_MAT.xml). */
+import testXml from '../test-data/Interlinear_en_MAT.xml?raw';
+
+const parser = new InterlinearXmlParser();
+
+/** Result of parsing the bundled test XML: either data or an error message. */
+type ParseResult = { data: InterlinearData; error: undefined } | { data: undefined; error: string };
+
+/**
+ * Main interlinearizer WebView. Parses the bundled test XML into the interlinear model and displays
+ * the result as raw JSON. No PAPI commands or file loading—everything is self-contained.
+ */
+globalThis.webViewComponent = function InterlinearizerWebView() {
+  const { data: parsed, error: parseError } = useMemo((): ParseResult => {
+    try {
+      const data = parser.parse(testXml);
+      return { data, error: undefined };
+    } catch (err) {
+      return {
+        data: undefined,
+        error: err instanceof Error ? err.message : String(err),
+      };
+    }
+  }, []);
+
+  return (
+    <div className="tw-flex tw-flex-col tw-gap-4 tw-p-6">
+      <h1 className="tw-text-2xl tw-font-semibold tw-tracking-tight">Interlinearizer</h1>
+      <p className="tw-text-sm tw-text-muted-foreground">
+        Raw JSON of the model parsed from <code>test-data/Interlinear_en_MAT.xml</code>.
+      </p>
+
+      {parseError && (
+        <div className="tw-flex tw-flex-col tw-gap-2">
+          <h2 className="tw-text-lg tw-font-medium tw-text-destructive">Parse error</h2>
+          <pre className="tw-overflow-auto tw-rounded-md tw-bg-muted tw-p-4 tw-text-sm tw-text-muted-foreground">
+            {parseError}
+          </pre>
+        </div>
+      )}
+
+      {parsed && !parseError && (
+        <>
+          <p className="tw-text-sm tw-text-muted-foreground">Parsed interlinear data (JSON):</p>
+          <pre className="tw-overflow-auto tw-rounded-md tw-border tw-border-border tw-bg-muted tw-p-4 tw-text-sm tw-font-mono tw-leading-relaxed">
+            {JSON.stringify(parsed, undefined, 2)}
+          </pre>
+        </>
+      )}
+    </div>
+  );
+};

src/interlinearizer.web-view.tsx

@@ -1,10 +1,48 @@
-import { logger } from '@papi/backend';
+import papi, { logger } from '@papi/backend';
+import type {
+  ExecutionActivationContext,
+  IWebViewProvider,
+  SavedWebViewDefinition,
+  WebViewDefinition,
+} from '@papi/core';
+import interlinearizerReact from './interlinearizer.web-view?inline';
+import interlinearizerStyles from './interlinearizer.web-view.scss?inline';
 
-export async function activate() {
-  logger.debug('Extension template is activating!');
+const mainWebViewType = 'paranextExtensionTemplate.interlinearizer';
+
+/** WebView provider that provides the interlinearizer React WebView when Platform.Bible requests it. */
+const mainWebViewProvider: IWebViewProvider = {
+  async getWebView(savedWebView: SavedWebViewDefinition): Promise<WebViewDefinition | undefined> {
+    if (savedWebView.webViewType !== mainWebViewType) {
+      throw new Error(
+        `${mainWebViewType} provider received request to provide a ${savedWebView.webViewType} WebView`,
+      );
+    }
+    return {
+      ...savedWebView,
+      title: 'Interlinearizer',
+      content: interlinearizerReact,
+      styles: interlinearizerStyles,
+    };
+  },
+};
+
+export async function activate(context: ExecutionActivationContext): Promise<void> {
+  logger.debug('Interlinearizer extension is activating!');
+
+  const mainWebViewProviderPromise = papi.webViewProviders.registerWebViewProvider(
+    mainWebViewType,
+    mainWebViewProvider,
+  );
+
+  papi.webViews.openWebView(mainWebViewType, undefined, { existingId: '?' });
+
+  context.registrations.add(await mainWebViewProviderPromise);
+
+  logger.debug('Interlinearizer extension finished activating!');
 }
 
-export async function deactivate() {
-  logger.debug('Extension template is deactivating!');
+export async function deactivate(): Promise<boolean> {
+  logger.debug('Interlinearizer extension is deactivating!');
   return true;
 }