@unisphere/nx 4.5.8 → 4.6.1

package/dist/generators/add-documentation/add-documentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-documentation.d.ts","sourceRoot":"","sources":["../../../src/generators/add-documentation/add-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAsB3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,qCAiJzC;AAED,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"add-documentation.d.ts","sourceRoot":"","sources":["../../../src/generators/add-documentation/add-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAsB3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,qCAgKzC;AAED,eAAe,yBAAyB,CAAC"}

package/dist/generators/add-documentation/add-documentation.js

@@ -72,6 +72,17 @@ async function addDocumentationGenerator(tree, options) {
         tmpl: '',
     };
     (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'templates'), projectRoot, templateVariables);
+    // Write .gitignore explicitly — npm strips .gitignore files from published packages
+    tree.write(`${projectRoot}/.gitignore`, `# Dependencies
+node_modules
+
+# Production
+build
+
+# Generated files
+.docusaurus
+.cache-loader
+`);
     // Update .unisphere configuration
     (0, utils_1.updateUnisphereConfig)(tree, 'documentation', fullDocumentationName, {
         sourceRoot: projectRoot,

package/dist/generators/add-documentation/templates/docs/changelog/overview.md

@@ -1,6 +1,7 @@
 ---
+id: overview
 sidebar_position: 1
-title: Overview
+sidebar_label: Overview
 ---
 
 # Changelog

package/dist/generators/add-documentation/templates/docs/documentations/overview.md

@@ -0,0 +1,9 @@
+---
+id: overview
+sidebar_position: 1
+sidebar_label: Overview
+---
+
+# Documentation
+
+Welcome to the documentation site. This portal covers everything you need to build, configure, and deploy your application.

package/dist/generators/add-documentation/templates/docs/{api → reference}/overview.md

@@ -1,6 +1,7 @@
 ---
+id: overview
 sidebar_position: 1
-title: Overview
+sidebar_label: Overview
 ---
 
 # API Reference

package/dist/generators/add-documentation/templates/docusaurus.config.ts.template

@@ -19,10 +19,9 @@ const config: Config = {
   baseUrl: '/<%= experienceName__lowerDashCase %>',
 <% } -%>
 
-  onBrokenLinks: 'throw',
+  onBrokenLinks: 'warn',
   onBrokenMarkdownLinks: 'warn',
 
-  // Prevent search engine crawling and indexing
   noIndex: true,
 
   i18n: {
@@ -34,21 +33,46 @@ const config: Config = {
     [
       'classic',
       {
-        docs: {
-          sidebarPath: './sidebars.ts',
-          exclude: [],
-        },
+        docs: false,
+        blog: false,
         theme: {
           customCss: './src/css/custom.css',
         },
-        // Disable sitemap generation
         sitemap: {
           ignorePatterns: ['**'],
         },
       } satisfies Preset.Options,
     ],
   ],
-  plugins: typedocPlugins,
+  plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        path: 'docs/documentations',
+        routeBasePath: 'documentations',
+        sidebarPath: './sidebars.ts',
+      },
+    ],
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'reference',
+        path: 'docs/reference',
+        routeBasePath: 'reference',
+        sidebarPath: './sidebars.ts',
+      },
+    ],
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'changelog',
+        path: 'docs/changelog',
+        routeBasePath: 'changelog',
+        sidebarPath: './sidebars.ts',
+      },
+    ],
+    ...typedocPlugins,
+  ],
   themes: [
     '@docusaurus/theme-mermaid',
     [
@@ -57,6 +81,7 @@ const config: Config = {
         hashed: true,
         indexBlog: false,
         forceIgnoreNoIndex: true,
+        docsRouteBasePath: ['documentations', 'reference', 'changelog'],
       },
     ],
   ],
@@ -72,9 +97,9 @@ const config: Config = {
     image: 'img/social-card.png',
     navbar: {
 <% if (hasSubName) { -%>
-      title: '<%= experienceName__humanReadable %> | <%= subNameKebab %> Documentation',
+      title: '<%= experienceName__humanReadable %> | <%= subNameKebab %>',
 <% } else { -%>
-      title: '<%= experienceName__humanReadable %> Documentation',
+      title: '<%= experienceName__humanReadable %>',
 <% } -%>
       logo: {
         alt: 'Logo',
@@ -83,30 +108,22 @@ const config: Config = {
       },
       items: [
         {
-          type: 'docSidebar',
-          sidebarId: 'gettingStarted',
+          to: 'documentations/overview',
+          label: 'Documentations',
           position: 'left',
-          label: 'Getting Started',
         },
         {
-          type: 'docSidebar',
-          sidebarId: 'api',
+          to: 'reference/overview',
+          label: 'Reference',
           position: 'left',
-          label: 'API',
         },
         {
-          type: 'docSidebar',
-          sidebarId: 'changelog',
-          position: 'left',
+          to: 'changelog/overview',
           label: 'Changelog',
+          position: 'left',
         },
       ],
     },
-    footer: {
-      style: 'dark',
-      links: [],
-      copyright: `Copyright © ${new Date().getFullYear()} Kaltura. Built with Docusaurus.`,
-    },
     prism: {
       theme: prismThemes.github,
       darkTheme: prismThemes.dracula,

package/dist/generators/add-documentation/templates/sidebars.ts

@@ -1,9 +1,9 @@
 import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
 
 const sidebars: SidebarsConfig = {
-  gettingStarted: [{ type: 'autogenerated', dirName: 'getting-started' }],
-  api: [{ type: 'autogenerated', dirName: 'api' }],
-  changelog: [{ type: 'autogenerated', dirName: 'changelog' }],
+  documentations: [{ type: 'autogenerated', dirName: '.' }],
+  reference: [{ type: 'autogenerated', dirName: '.' }],
+  changelog: [{ type: 'autogenerated', dirName: '.' }],
 };
 
 export default sidebars;

package/dist/generators/add-documentation/templates/src/components/homepage-features/index.tsx

@@ -1,176 +1,116 @@
-import clsx from 'clsx';
 import Heading from '@theme/Heading';
-import styles from './styles.module.css';
 
 type FeatureItem = {
   title: string;
-  target: string;
   description: JSX.Element;
-  Svg: React.ComponentType<React.ComponentProps<'svg'>>;
+  icon: JSX.Element;
 };
 
 const FeatureList: FeatureItem[] = [
   {
-    title: 'Robust Documentation',
-    target: 'Everyone',
-    Svg: require('@site/static/homepage/icons/Infra.svg').default,
-    description: (
-      <>
-        Access detailed guides, tutorials, and examples to get started quickly,
-        whether you're new to web development or an experienced developer.
-      </>
+    title: 'Quick Start Guides',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 10V3L4 14h7v7l9-11h-7z" />
+      </svg>
     ),
-  },
-  {
-    title: 'Compliance and Standards',
-    target: 'Product managers',
-    Svg: require('@site/static/homepage/icons/Standards.svg').default,
     description: (
       <>
-        Ensure all modules adhere to essential standards and regulations,
-        including accessibility, terms of conditions, theming, language support,
-        and recovery handling, providing a robust and compliant platform
-        experience.
+        Get up and running quickly with step-by-step guides, tutorials, and
+        practical examples for common use cases.
       </>
     ),
   },
   {
-    title: 'Reusable Experiences',
-    target: 'Product managers & developers',
-    Svg: require('@site/static/homepage/icons/Infra.svg').default,
-    description: (
-      <>
-        Benefit from highly reusable components and modules designed to ensure
-        consistency and reduce development time.
-      </>
+    title: 'API Reference',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4" />
+      </svg>
     ),
-  },
-  {
-    title: 'Kaltura Player Integration',
-    target: 'Product managers',
-    Svg: require('@site/static/homepage/icons/Architecture.svg').default,
     description: (
       <>
-        Leverage deep integration with the Kaltura player, allowing seamless
-        synchronization between the player’s current time and Unisphere modules.
-        This enables displaying visual elements on the player area, player seek
-        bar, and content modules based on the current playback time.
+        Complete TypeScript API documentation with detailed type definitions,
+        parameters, and return values for every public interface.
       </>
     ),
   },
   {
-    title: 'Dynamic Workspaces',
-    target: 'Product managers & professional services',
-    Svg: require('@site/static/homepage/icons/Redundancies.svg').default,
-    description: (
-      <>
-        Effortlessly create and configure an Unisphere workspace at runtime in
-        the application, allowing you to adapt to changes and updates without
-        significant code modifications.
-      </>
+    title: 'Code Examples',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2" />
+      </svg>
     ),
-  },
-  {
-    title: 'Enhanced Developer Experience',
-    target: 'Developers',
-    Svg: require('@site/static/homepage/icons/Unified.svg').default,
     description: (
       <>
-        Take advantage of a robust suite of tools tailored to streamline your
-        development workflow. This includes generators, boilerplates, CLI,
-        playground applications, Storybook integration, and runtime features
-        like theming and translation infrastructure.
+        Real-world usage patterns and copy-paste-ready code snippets to
+        accelerate your development workflow.
       </>
     ),
   },
   {
-    title: 'Advanced Customization',
-    target: 'Developers',
-    Svg: require('@site/static/homepage/icons/Architecture.svg').default,
-    description: (
-      <>
-        For more advanced needs, directly consume components and modules from
-        NPM or Yarn. Customize these elements to perfectly suit your specific
-        requirements.
-      </>
+    title: 'Architecture & Patterns',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
+      </svg>
     ),
-  },
-  {
-    title: 'Version Control',
-    target: 'Developers',
-    Svg: require('@site/static/homepage/icons/Architecture.svg').default,
     description: (
       <>
-        Grow confidently with versioned components and modules that effectively
-        manage dependencies and ensure backward compatibility.
+        Understand the design decisions, module structure, and best practices
+        for building scalable applications.
       </>
     ),
   },
   {
-    title: 'Dynamic Workspaces',
-    target: 'Professional services',
-    Svg: require('@site/static/homepage/icons/Infra.svg').default,
-    description: (
-      <>
-        Effortlessly create and configure an Unisphere workspace at runtime in
-        the application, allowing you to adapt to changes and updates without
-        significant code modifications.
-      </>
+    title: 'Changelog & Releases',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
+      </svg>
     ),
-  },
-  {
-    title: 'Streamlined Delivery',
-    target: 'Professional services',
-    Svg: require('@site/static/homepage/icons/Speed.svg').default,
     description: (
       <>
-        Leverage our platform to accelerate project delivery, minimize risks,
-        and ensure successful implementations.
+        Stay up to date with the latest releases, breaking changes, migration
+        guides, and new features.
       </>
     ),
   },
   {
-    title: 'Enhanced Client Value',
-    target: 'Professional services',
-    Svg: require('@site/static/homepage/icons/Cost.svg').default,
+    title: 'Developer Tools',
+    icon: (
+      <svg className="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.066 2.573c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.573 1.066c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.066-2.573c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+      </svg>
+    ),
     description: (
       <>
-        Deliver exceptional value to your clients by creating tailored,
-        innovative solutions that exceed their expectations.
+        Leverage CLI tools, code generators, and development utilities designed
+        to streamline your workflow.
       </>
     ),
   },
 ];
 
-function Feature({ title, target, Svg, description }: FeatureItem) {
+function Feature({ title, icon, description }: FeatureItem) {
   return (
     <div className="group relative bg-white dark:bg-gray-800 rounded-2xl p-8 shadow-sm hover:shadow-xl border border-gray-100 dark:border-gray-700 transition-all duration-300 hover:-translate-y-1">
-      {/* Gradient background on hover */}
       <div className="absolute inset-0 bg-gradient-to-br from-blue-50/50 to-purple-100/50 dark:from-blue-900/20 dark:to-purple-800/20 rounded-2xl opacity-0 group-hover:opacity-100 transition-opacity duration-300"></div>
 
       <div className="relative z-10">
-        {/* Icon with modern styling */}
-        <div className="w-16 h-16 mb-6 bg-gradient-to-br from-blue-500 to-purple-400 rounded-xl flex items-center justify-center shadow-lg group-hover:shadow-xl transition-shadow duration-300">
-          <Svg className="w-8 h-8 text-white" role="img" />
+        <div className="w-14 h-14 mb-6 bg-gradient-to-br from-blue-500 to-purple-400 rounded-xl flex items-center justify-center shadow-lg group-hover:shadow-xl transition-shadow duration-300">
+          {icon}
         </div>
 
-        {/* Content */}
-        <div className="space-y-4">
-          <div>
-            <Heading as="h3" className="text-xl font-bold text-gray-900 dark:text-white mb-2 group-hover:text-blue-600 dark:group-hover:text-blue-400 transition-colors duration-200">
-              {title}
-            </Heading>
-            <div className="inline-flex items-center px-3 py-1 bg-blue-50 dark:bg-blue-900/30 text-blue-700 dark:text-blue-300 text-sm font-medium rounded-full">
-              <svg className="w-4 h-4 mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z" />
-              </svg>
-              {target} love this
-            </div>
-          </div>
-
-          <div className="text-gray-600 dark:text-gray-300 leading-relaxed">
+        <div className="space-y-3">
+          <Heading as="h3" className="text-xl font-bold text-gray-900 dark:text-white mb-0 group-hover:text-blue-600 dark:group-hover:text-blue-400 transition-colors duration-200">
+            {title}
+          </Heading>
+          <p className="text-gray-600 dark:text-gray-300 leading-relaxed mb-0">
             {description}
-          </div>
+          </p>
         </div>
       </div>
     </div>
@@ -180,60 +120,22 @@ function Feature({ title, target, Svg, description }: FeatureItem) {
 export default function HomepageFeatures(): JSX.Element {
   return (
     <section className="py-20 px-4 max-w-7xl mx-auto">
-      {/* Modern section header */}
       <div className="text-center mb-16">
         <Heading as="h2" className="text-4xl md:text-5xl font-bold text-gray-900 dark:text-white mb-4">
           <span className="text-transparent bg-clip-text bg-gradient-to-r from-blue-600 to-purple-400 dark:from-blue-400 dark:to-purple-300">
-            The Unisphere
-          </span>
-          {' '}
-          <span className="text-transparent bg-clip-text bg-gradient-to-r from-purple-400 to-pink-400 dark:from-purple-300 dark:to-pink-300">
-            Advantage
+            Everything You Need
           </span>
         </Heading>
         <p className="text-xl text-gray-600 dark:text-gray-300 max-w-3xl mx-auto leading-relaxed">
-          Discover the powerful features that make Unisphere the perfect choice for modern development teams
+          Comprehensive documentation to help you integrate, build, and ship with confidence
         </p>
       </div>
 
-      {/* Features grid with modern responsive design */}
       <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
         {FeatureList.map((props, idx) => (
           <Feature key={idx} {...props} />
         ))}
       </div>
-
-      {/* Call-to-action section */}
-      <div className="mt-16 text-center">
-        <div className="bg-gradient-to-r from-blue-50 to-purple-100 dark:from-gray-800 dark:to-gray-700 rounded-2xl p-8">
-          <h3 className="text-2xl font-bold text-gray-900 dark:text-white mb-4">
-            Ready to get started?
-          </h3>
-          <p className="text-gray-600 dark:text-gray-300 mb-6 max-w-2xl mx-auto">
-            Join thousands of developers who are already building amazing applications with Unisphere
-          </p>
-          <div className="flex flex-col sm:flex-row gap-4 justify-center">
-            <a
-              href="/docs/documentation/overview"
-              className="inline-flex items-center px-6 py-3 bg-gradient-to-r from-blue-600 to-blue-700 hover:from-blue-700 hover:to-blue-800 text-white font-semibold rounded-lg shadow-md hover:shadow-lg transition-all duration-200 transform hover:-translate-y-0.5"
-            >
-              <svg className="w-5 h-5 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 10V3L4 14h7v7l9-11h-7z" />
-              </svg>
-              Get Started
-            </a>
-            <a
-              href="/docs/documentation/overview"
-              className="inline-flex items-center px-6 py-3 bg-white dark:bg-gray-600 text-gray-700 dark:text-gray-200 font-semibold rounded-lg border border-gray-200 dark:border-gray-500 hover:border-gray-300 dark:hover:border-gray-400 shadow-md hover:shadow-lg transition-all duration-200 transform hover:-translate-y-0.5"
-            >
-              <svg className="w-5 h-5 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
-              </svg>
-              Learn About Unisphere
-            </a>
-          </div>
-        </div>
-      </div>
     </section>
   );
 }

package/dist/generators/add-documentation/templates/src/components/homepage-start-now/index.tsx

@@ -8,7 +8,7 @@ export default function HomepageStartNow(): JSX.Element {
   return (
     <section className={styles.startNow}>
       <Heading as="h2" className={clsx('text--center', styles.heading)}>
-        Ready to integrate Unisphere into your application
+        Ready to get started?
       </Heading>
       <a
         className={clsx('uc-button', styles.startNowBtn)}