Add TypeScript example for PSPDFKit integration

- Created a new TypeScript example project demonstrating the integration of PSPDFKit for Web.
- Added essential files including package.json, README.md, and TypeScript configuration (tsconfig.json).
- Implemented a basic HTML structure with a PDF viewer using PSPDFKit.
- Included scripts for verifying installation and copying necessary PSPDFKit files.
- Configured Webpack for development and production builds, including handling TypeScript files.
- Added a sample PDF for demonstration purposes and styled the application with CSS.
- Updated biome.json to include new ignore patterns for build artifacts.

Author: ritz078

biome.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
   "files": {
-    "ignore": ["examples/angular/.angular/cache/*"],
+    "ignore": ["examples/angular/.angular/cache/*", "./examples/*/public/*"],
     "ignoreUnknown": true
   },
   "formatter": {

examples/typescript/.gitignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+src/index.js
+src/index.js.map

examples/typescript/LICENSE

@@ -0,0 +1,42 @@
+The PSPDFKit Sample applications are licensed with a modified BSD
+license. In plain language: you're allowed to do whatever you wish
+with the code, modify, redistribute, embed in your products (free or
+commercial), but you must include copyright, terms of usage and
+disclaimer as stated in the license.
+
+You will require a commercial PSPDFKit License to run these examples
+in non-demo mode. Please refer to [email protected] for details.
+
+Copyright © 2017-present PSPDFKit GmbH.
+All rights reserved.
+
+Redistribution and use in source or binary forms,
+with or without modification, are permitted provided
+that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the
+  distribution.
+
+- Redistributions of PSPDFKit Samples must include attribution to
+  PSPDFKit, either in documentation or other appropriate media.
+
+- Neither the name of the PSPDFKit, PSPDFKit GmbH, nor its developers
+  may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

examples/typescript/README.md

@@ -0,0 +1,48 @@
+# Nutrient Web SDK Example – Typescript
+
+This example shows how to integrate [Nutrient Web SDK](https://www.nutrient.io/web/) into a [Typescript](https://www.typescriptlang.org) app.
+
+## Prerequisites
+
+- [Node.js](http://nodejs.org/)
+
+## Getting Started
+
+Clone the repo:
+
+```bash
+git clone https://github.com/PSPDFKit/pspdfkit-web-example-typescript.git
+cd pspdfkit-web-example-typescript
+```
+
+Install the project dependencies with `npm`:
+
+```bash
+npm install
+```
+
+## Running the Example
+
+We are ready to launch the app! 🎉
+
+```bash
+npm start
+```
+
+You can now open http://localhost:3000 in your browser and enjoy!
+
+## Support, Issues and License Questions
+
+PSPDFKit offers support for customers with an active SDK license via https://www.nutrient.io/support/request/
+
+Are you [evaluating our SDK](https://www.nutrient.io/try/)? That's great, we're happy to help out! To make sure this is fast, please use a work email and have someone from your company fill out our sales form: https://www.nutrient.io/sales/
+
+## License
+
+This software is licensed under a [modified BSD license](LICENSE).
+
+## Contributing
+
+Please ensure
+[you have signed our CLA](https://www.nutrient.io/guides/web/current/miscellaneous/contributing/) so that we can
+accept your contributions.

examples/typescript/assets/example.pdf

@@ -0,0 +1,15 @@
+try {
+  require("pspdfkit");
+} catch (error) {
+  if (!/cannot find module/i.test(error.message)) {
+    process.exit(0);
+  }
+
+  console.log(
+    `This application requires you to install Nutrient Web SDK manually using your unique customer or trial url.
+For further instructions please refer to our online guide available at:
+
+https://www.nutrient.io/guides/web/current/standalone/adding-to-your-project#toc_install-with-npm`,
+  );
+  process.exit(1);
+}

examples/typescript/bin/verify-install.js

@@ -0,0 +1,95 @@
+/**
+ * webpack configuration file used to build both a development and production
+ * version of the app.
+ *
+ * The production version is built in the `./dist` folder. When building the
+ * development mode it also starts a web server at http://localhost:8080
+ *
+ * This configuration file creates two main bundles:
+ *
+ * - vendor.js - contains external libraries (including pspdfkit.js).
+ * - app.js - contains the application code.
+ *
+ * It also copies the WASM/ASM and CSS files from the npm package folder, since
+ * `PSPDFKit.load` loads them relative to the application execution path.
+ */
+
+const path = require("node:path");
+const HtmlWebpackPlugin = require("html-webpack-plugin");
+const CopyWebpackPlugin = require("copy-webpack-plugin");
+
+const filesToCopy = [
+  // PSPDFKit files.
+  {
+    from: "./node_modules/pspdfkit/dist/pspdfkit-lib",
+    to: "./pspdfkit-lib",
+  },
+  // Application CSS.
+  {
+    from: "./src/index.css",
+    to: "./index.css",
+  },
+  // Example PDF.
+  {
+    from: "./assets/example.pdf",
+    to: "./example.pdf",
+  },
+];
+
+/**
+ * webpack main configuration object.
+ */
+const config = {
+  entry: path.resolve(__dirname, "../src/index.ts"),
+  mode: "development",
+  devtool: "inline-source-map",
+  output: {
+    path: path.resolve(__dirname, "../dist"),
+    filename: "[name].js",
+  },
+  resolve: {
+    extensions: [".ts", ".tsx", ".js"],
+  },
+  module: {
+    rules: [
+      // all files with a `.ts` or `.tsx` extension will be handled by `ts-loader`
+      {
+        test: /\.tsx?$/,
+        use: { loader: "ts-loader" },
+        exclude: /node_modules/,
+      },
+    ],
+  },
+  plugins: [
+    // Automatically insert <script src="[name].js"><script> to the page.
+    new HtmlWebpackPlugin({
+      template: "./src/index.html",
+    }),
+
+    // Copy the WASM/ASM and CSS files to the `output.path`.
+    new CopyWebpackPlugin({
+      patterns: filesToCopy,
+    }),
+  ],
+
+  optimization: {
+    splitChunks: {
+      cacheGroups: {
+        // Creates a `vendor.js` bundle which contains external libraries (including pspdfkit.js).
+        vendor: {
+          test: /node_modules/,
+          chunks: "initial",
+          name: "vendor",
+          priority: 10,
+          enforce: true,
+        },
+      },
+    },
+  },
+
+  devServer: {
+    port: 3000,
+  },
+};
+
+module.exports = config;

examples/typescript/config/webpack.js

@@ -0,0 +1,9 @@
+// @ts-check
+
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  tseslint.configs.recommended,
+);