slicejs-web-framework 1.0.16 → 1.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slicejs-web-framework",
-  "version": "1.0.16",
+  "version": "1.0.19",
   "description": "",
   "engines": {
     "node": ">=20"

package/src/Components/AppComponents/DocumentationPage/DocumentationPage.js

@@ -15,7 +15,7 @@ export default class DocumentationPage extends HTMLElement {
             items: [
                {
                   title: 'What is Slice.js?',
-                  path: '/Documentation/What-is-Slice.js',
+                  path: '/Documentation/Slice',
                   component: 'WhatIsSlice'
                },
                {

package/src/Components/AppComponents/Installation/Installation.css

@@ -0,0 +1,185 @@
+slice-installation {
+  font-family: var(--font-family);
+  color: var(--font-primary-color);
+}
+
+slice-installation .installation-container {
+  width: 100%;
+  max-width: 800px;
+  margin: 0 auto;
+  padding: 20px;
+}
+
+slice-installation h1 {
+  color: var(--primary-color);
+  margin-bottom: 30px;
+}
+
+slice-installation h2 {
+  color: var(--primary-color);
+  margin: 30px 0 15px 0;
+  padding-bottom: 8px;
+  border-bottom: 1px solid var(--secondary-background-color);
+}
+
+slice-installation .installation-intro {
+  font-size: 1.1em;
+  line-height: 1.6;
+  margin-bottom: 30px;
+}
+
+slice-installation .installation-step {
+  margin-bottom: 40px;
+  padding: 20px;
+  background-color: var(--secondary-background-color);
+  border-radius: var(--border-radius-slice);
+  box-shadow: 0 3px 10px rgba(0, 0, 0, 0.1);
+}
+
+slice-installation .installation-step-code {
+  position: relative;
+  margin: 15px 0;
+  background-color: var(--primary-background-color);
+  border-radius: var(--border-radius-slice);
+  border: 1px solid var(--primary-color-shade);
+  overflow: hidden;
+}
+
+slice-installation pre {
+  margin: 0;
+  padding: 15px;
+  overflow-x: auto;
+}
+
+slice-installation code {
+  font-family: 'Courier New', monospace;
+  color: var(--font-primary-color);
+}
+
+slice-installation .copy-button {
+  position: absolute;
+  top: 5px;
+  right: 5px;
+  background-color: var(--primary-color);
+  color: var(--primary-color-contrast);
+  border: none;
+  border-radius: var(--border-radius-slice);
+  padding: 5px 10px;
+  cursor: pointer;
+  font-size: 0.8em;
+  transition: all 0.3s ease;
+}
+
+slice-installation .copy-button:hover {
+  background-color: var(--secondary-color);
+}
+
+slice-installation .terminal {
+  background-color: #1e1e1e;
+  border-radius: var(--border-radius-slice);
+  margin: 15px 0;
+  overflow: hidden;
+}
+
+slice-installation .terminal-header {
+  background-color: #323232;
+  padding: 8px 15px;
+  display: flex;
+  align-items: center;
+}
+
+slice-installation .terminal-dot {
+  height: 12px;
+  width: 12px;
+  border-radius: 50%;
+  margin-right: 6px;
+}
+
+slice-installation .red {
+  background-color: #ff5f56;
+}
+
+slice-installation .yellow {
+  background-color: #ffbd2e;
+}
+
+slice-installation .green {
+  background-color: #27c93f;
+}
+
+slice-installation .terminal-title {
+  color: #cccccc;
+  margin-left: 10px;
+  font-size: 0.9em;
+}
+
+slice-installation .terminal-content {
+  padding: 15px;
+  color: #f8f8f2;
+  font-family: 'Courier New', monospace;
+  font-size: 0.9em;
+  line-height: 1.5;
+  min-height: 60px;
+}
+
+slice-installation .terminal-output {
+  white-space: pre-wrap;
+}
+
+slice-installation .note {
+  font-size: 0.9em;
+  font-style: italic;
+  color: var(--font-secondary-color);
+  margin-top: 10px;
+}
+
+slice-installation .installation-next-steps {
+  margin-top: 40px;
+  padding: 20px;
+  background-color: var(--primary-background-color);
+  border: 1px solid var(--primary-color);
+  border-radius: var(--border-radius-slice);
+}
+
+slice-installation .installation-next-steps ul {
+  list-style-type: none;
+  padding-left: 0;
+}
+
+slice-installation .installation-next-steps li {
+  margin-bottom: 10px;
+  padding-left: 24px;
+  position: relative;
+}
+
+slice-installation .installation-next-steps li:before {
+  content: "→";
+  position: absolute;
+  left: 0;
+  color: var(--primary-color);
+}
+
+slice-installation .installation-next-steps code {
+  background-color: var(--secondary-background-color);
+  padding: 2px 6px;
+  border-radius: 3px;
+}
+
+@media only screen and (max-width: 770px) {
+  slice-installation .installation-container {
+    padding: 10px;
+  }
+  
+  slice-installation .installation-step {
+    padding: 15px;
+  }
+  
+  slice-installation pre {
+    padding: 10px;
+    font-size: 0.9em;
+  }
+  
+  slice-installation .terminal-content {
+    font-size: 0.8em;
+  }
+}

package/src/Components/AppComponents/Installation/Installation.html

@@ -0,0 +1,102 @@
+<div class="installation-container">
+  <h1 id="installation-title">Installation Guide</h1>
+  
+  <p class="installation-intro">
+    Getting started with Slice.js is easy! Follow these simple steps to create your first Slice.js project:
+  </p>
+  
+  <div class="installation-steps">
+    <div class="installation-step">
+      <h2 id="step1">Step 1: Initialize your project</h2>
+      <p>First, create a new directory for your project and initialize it with npm:</p>
+      <div class="installation-step-code">
+        <pre><code>npm init</code></pre>
+        <button class="copy-button">Copy</button>
+      </div>
+      <div class="terminal">
+        <div class="terminal-header">
+          <span class="terminal-dot red"></span>
+          <span class="terminal-dot yellow"></span>
+          <span class="terminal-dot green"></span>
+          <span class="terminal-title">Terminal</span>
+        </div>
+        <div class="terminal-content">
+          <div class="terminal-output">Follow the prompts to set up your package.json file. You can press Enter to accept the default values or customize as needed.</div>
+        </div>
+      </div>
+    </div>
+    
+    <div class="installation-step">
+      <h2 id="step2">Step 2: Install Slice.js CLI</h2>
+      <p>Next, install the Slice.js CLI tool which will help you create components and manage your project:</p>
+      <div class="installation-step-code">
+        <pre><code>npm i slicejs-cli</code></pre>
+        <button class="copy-button">Copy</button>
+      </div>
+      <div class="terminal">
+        <div class="terminal-header">
+          <span class="terminal-dot red"></span>
+          <span class="terminal-dot yellow"></span>
+          <span class="terminal-dot green"></span>
+          <span class="terminal-title">Terminal</span>
+        </div>
+        <div class="terminal-content">
+          <div class="terminal-output">added X packages, and audited Y packages in Zs</div>
+        </div>
+      </div>
+    </div>
+    
+    <div class="installation-step">
+      <h2 id="step3">Step 3: Initialize Slice.js</h2>
+      <p>Initialize the Slice.js folder structure in your project:</p>
+      <div class="installation-step-code">
+        <pre><code>npm run slice:init</code></pre>
+        <button class="copy-button">Copy</button>
+      </div>
+      <div class="terminal">
+        <div class="terminal-header">
+          <span class="terminal-dot red"></span>
+          <span class="terminal-dot yellow"></span>
+          <span class="terminal-dot green"></span>
+          <span class="terminal-title">Terminal</span>
+        </div>
+        <div class="terminal-content">
+          <div class="terminal-output">Creating folder structure...
+Slice framework initialized successfully!</div>
+        </div>
+      </div>
+      <p class="note">This command creates the necessary folder structure for your Slice.js project, including directories for components, styles, and themes.</p>
+    </div>
+    
+    <div class="installation-step">
+      <h2 id="step4">Step 4: Start the Server</h2>
+      <p>Finally, start the development server to see your Slice.js application in action:</p>
+      <div class="installation-step-code">
+        <pre><code>npm run slice:start</code></pre>
+        <button class="copy-button">Copy</button>
+      </div>
+      <div class="terminal">
+        <div class="terminal-header">
+          <span class="terminal-dot red"></span>
+          <span class="terminal-dot yellow"></span>
+          <span class="terminal-dot green"></span>
+          <span class="terminal-title">Terminal</span>
+        </div>
+        <div class="terminal-content">
+          <div class="terminal-output">Server is running on port 3001, http://localhost:3001</div>
+        </div>
+      </div>
+    </div>
+  </div>
+  
+  <div class="installation-next-steps">
+    <h2 id="next-steps">Next Steps</h2>
+    <p>Congratulations! You've successfully set up your Slice.js project. Here's what you can do next:</p>
+    <ul>
+      <li>Explore the documentation to learn about components</li>
+      <li>Create your first component with <code>npm run slice:create</code></li>
+      <li>Check out the built-in Visual components library</li>
+      <li>Build your application by adding routes and services</li>
+    </ul>
+  </div>
+</div>

package/src/Components/AppComponents/Installation/Installation.js

@@ -0,0 +1,61 @@
+export default class Installation extends HTMLElement {
+  constructor(props) {
+    super();
+    slice.attachTemplate(this);
+
+    slice.controller.setComponentProps(this, props);
+    this.debuggerProps = [];
+  }
+
+  async init() {
+    // Add code for installation steps visualization
+    
+    // Get all code blocks with copy buttons
+    const codeBlocks = this.querySelectorAll('.installation-step-code');
+    
+    // Add copy functionality to each code block
+    codeBlocks.forEach(block => {
+      const copyButton = block.querySelector('.copy-button');
+      const codeText = block.querySelector('code');
+      
+      copyButton.addEventListener('click', () => {
+        navigator.clipboard.writeText(codeText.textContent.trim());
+        copyButton.textContent = 'Copied!';
+        
+        setTimeout(() => {
+          copyButton.textContent = 'Copy';
+        }, 2000);
+      });
+    });
+
+    // Add animation for terminal output
+    const terminals = this.querySelectorAll('.terminal-output');
+    terminals.forEach(terminal => {
+      const text = terminal.textContent;
+      terminal.textContent = '';
+      let i = 0;
+      
+      const typeEffect = () => {
+        if (i < text.length) {
+          terminal.textContent += text.charAt(i);
+          i++;
+          setTimeout(typeEffect, 10);
+        }
+      };
+      
+      // Start the typing effect when element is in view
+      const observer = new IntersectionObserver(entries => {
+        entries.forEach(entry => {
+          if (entry.isIntersecting) {
+            typeEffect();
+            observer.unobserve(entry.target);
+          }
+        });
+      });
+      
+      observer.observe(terminal);
+    });
+  }
+}
+
+customElements.define('slice-installation', Installation);

package/src/Components/AppComponents/TheBuildMethod/TheBuildMethod.css

@@ -1,6 +1,7 @@
 slice-the-build-method {
   font-family: var(--font-family);
   color: var(--font-primary-color);
+  display: block;
 }
 
 slice-the-build-method .build-method-container {
@@ -9,107 +10,266 @@ slice-the-build-method .build-method-container {
   padding: 20px;
 }
 
+slice-the-build-method .build-method-header {
+  display: flex;
+  align-items: center;
+  margin-bottom: 1.5rem;
+}
+
 slice-the-build-method h1 {
   font-size: 2.2rem;
-  margin-bottom: 1.5rem;
   color: var(--primary-color);
   border-bottom: 2px solid var(--secondary-background-color);
   padding-bottom: 0.5rem;
+  margin-right: 1rem;
+  margin-bottom: 0;
+  flex-grow: 1;
+}
+
+slice-the-build-method .build-method-badge {
+  background-color: var(--primary-color);
+  color: var(--primary-color-contrast);
+  padding: 6px 12px;
+  border-radius: 20px;
+  font-size: 0.9rem;
+  font-weight: bold;
 }
 
 slice-the-build-method h2 {
   font-size: 1.8rem;
-  margin-top: 2rem;
-  margin-bottom: 1rem;
+  margin-top: 2.5rem;
+  margin-bottom: 1.2rem;
   color: var(--primary-color);
+  position: relative;
+  padding-left: 1rem;
+}
+
+slice-the-build-method h2:before {
+  content: "";
+  position: absolute;
+  left: 0;
+  height: 100%;
+  width: 4px;
+  background-color: var(--primary-color);
+  border-radius: 4px;
 }
 
 slice-the-build-method h3 {
   font-size: 1.5rem;
-  margin-top: 1.5rem;
-  margin-bottom: 0.75rem;
+  margin-top: 1.8rem;
+  margin-bottom: 1rem;
   color: var(--font-primary-color);
 }
 
 slice-the-build-method p {
-  margin-bottom: 1rem;
-  line-height: 1.6;
+  margin-bottom: 1.2rem;
+  line-height: 1.7;
   text-align: justify;
+  font-size: 1.05rem;
 }
 
 slice-the-build-method code {
   font-family: monospace;
   background-color: var(--secondary-background-color);
-  padding: 2px 5px;
+  padding: 3px 6px;
   border-radius: 4px;
-  font-size: 0.9em;
+  font-size: 0.95em;
+  color: var(--primary-color);
 }
 
 slice-the-build-method .syntax-box {
   background-color: var(--secondary-background-color);
-  padding: 15px;
+  padding: 20px;
   border-radius: var(--border-radius-slice);
   margin: 20px 0;
   overflow-x: auto;
+  border-left: 4px solid var(--primary-color);
+  box-shadow: 0 3px 6px rgba(0, 0, 0, 0.1);
+  transition: transform 0.2s ease;
+}
+
+slice-the-build-method .syntax-box:hover {
+  transform: translateY(-2px);
 }
 
 slice-the-build-method .syntax-box code {
-  font-size: 1.1em;
+  font-size: 1.2em;
   background: none;
 }
 
-slice-the-build-method .parameters-list,
-slice-the-build-method .best-practices-list,
-slice-the-build-method .lifecycle-steps {
-  margin-left: 20px;
-  margin-bottom: 1.5rem;
-  line-height: 1.6;
+slice-the-build-method .parameters-section,
+slice-the-build-method .return-section {
+  background-color: var(--primary-background-color);
+  padding: 15px 20px;
+  border-radius: var(--border-radius-slice);
+  margin: 15px 0;
+  border: 1px solid var(--secondary-background-color);
 }
 
-slice-the-build-method .parameters-list li,
-slice-the-build-method .best-practices-list li,
-slice-the-build-method .lifecycle-steps li {
-  margin-bottom: 0.75rem;
+slice-the-build-method .parameters-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
 }
 
+slice-the-build-method .parameters-list li {
+  display: grid;
+  grid-template-columns: 1fr 1fr 3fr;
+  gap: 15px;
+  margin-bottom: 12px;
+  padding-bottom: 12px;
+  border-bottom: 1px solid var(--secondary-background-color);
+}
 
-slice-the-build-method .lifecycle-steps li {
-  counter-increment: step-counter;
-  position: relative;
-  padding-left: 10px;
+slice-the-build-method .parameters-list li:last-child {
+  border-bottom: none;
+  margin-bottom: 0;
+  padding-bottom: 0;
 }
 
-slice-the-build-method .lifecycle-steps li::before {
+slice-the-build-method .param-name {
   font-weight: bold;
-  margin-right: 8px;
+  color: var(--primary-color);
+}
+
+slice-the-build-method .param-type {
+  font-style: italic;
+  color: var(--font-secondary-color);
+}
+
+slice-the-build-method .example-card {
+  background-color: var(--primary-background-color);
+  border-radius: var(--border-radius-slice);
+  padding: 20px;
+  margin-bottom: 30px;
+  border: 1px solid var(--secondary-background-color);
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.05);
+  transition: box-shadow 0.3s ease;
+}
+
+slice-the-build-method .example-card:hover {
+  box-shadow: 0 6px 12px rgba(0, 0, 0, 0.1);
+}
+
+slice-the-build-method .example-card h3 {
+  margin-top: 0;
   color: var(--primary-color);
 }
 
 slice-the-build-method .method-examples div[class$="-container"] {
-  margin-bottom: 2rem;
+  margin-top: 1rem;
   border-radius: var(--border-radius-slice);
   overflow: hidden;
 }
 
+slice-the-build-method .lifecycle-diagram {
+  background-color: var(--primary-background-color);
+  border-radius: var(--border-radius-slice);
+  padding: 20px;
+  border: 1px solid var(--secondary-background-color);
+}
+
+slice-the-build-method .lifecycle-steps {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+slice-the-build-method .lifecycle-steps li {
+  display: flex;
+  align-items: center;
+  margin-bottom: 15px;
+  padding-bottom: 15px;
+  border-bottom: 1px dashed var(--secondary-background-color);
+}
+
+slice-the-build-method .lifecycle-steps li:last-child {
+  margin-bottom: 0;
+  padding-bottom: 0;
+  border-bottom: none;
+}
+
+slice-the-build-method .step-number {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 30px;
+  height: 30px;
+  background-color: var(--primary-color);
+  color: var(--primary-color-contrast);
+  border-radius: 50%;
+  margin-right: 15px;
+  font-weight: bold;
+  flex-shrink: 0;
+}
+
+slice-the-build-method .step-content {
+  flex-grow: 1;
+  line-height: 1.5;
+}
+
+slice-the-build-method .best-practices-container {
+  background-color: var(--primary-background-color);
+  border-radius: var(--border-radius-slice);
+  padding: 20px;
+  border: 1px solid var(--secondary-background-color);
+}
+
+slice-the-build-method .best-practices-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+slice-the-build-method .best-practices-list li {
+  display: flex;
+  align-items: flex-start;
+  margin-bottom: 15px;
+  line-height: 1.6;
+}
+
+slice-the-build-method .best-practices-list li:last-child {
+  margin-bottom: 0;
+}
+
+slice-the-build-method .practice-icon {
+  display: inline-block;
+  margin-right: 10px;
+  color: var(--success-color);
+  font-weight: bold;
+  font-size: 1.2rem;
+}
+
+slice-the-build-method .method-introduction,
 slice-the-build-method .method-syntax,
 slice-the-build-method .method-examples,
 slice-the-build-method .method-lifecycle,
 slice-the-build-method .method-best-practices {
-  margin-bottom: 3rem;
+  margin-bottom: 3.5rem;
 }
 
 slice-the-build-method section {
-  padding-top: 10px;
+  padding-top: 15px;
 }
 
 @media only screen and (max-width: 770px) {
   slice-the-build-method .build-method-container {
     max-width: 100%;
-    padding: 10px;
+    padding: 15px;
+  }
+
+  slice-the-build-method .build-method-header {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  slice-the-build-method .build-method-badge {
+    margin-top: 10px;
   }
 
   slice-the-build-method h1 {
     font-size: 1.8rem;
+    margin-right: 0;
   }
 
   slice-the-build-method h2 {
@@ -119,4 +279,18 @@ slice-the-build-method section {
   slice-the-build-method h3 {
     font-size: 1.3rem;
   }
+
+  slice-the-build-method .parameters-list li {
+    grid-template-columns: 1fr;
+    gap: 5px;
+  }
+
+  slice-the-build-method .lifecycle-steps li {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  slice-the-build-method .step-number {
+    margin-bottom: 10px;
+  }
 }