slicejs-web-framework 1.0.19 → 1.0.21

package/src/Components/AppComponents/SwitchDocumentation/SwitchDocumentation.js

@@ -1,103 +0,0 @@
-export default class SwitchDocumentation extends HTMLElement {
-   constructor(props) {
-      super();
-      slice.attachTemplate(this);
-
-      slice.controller.setComponentProps(this, props);
-      this.debuggerProps = [];
-   }
-
-   async init() {
-      await this.createSwitch(this.querySelector('.mySwitch'), {}, `{}`);
-      await this.createSwitch(
-         this.querySelector('.colorSwitch'),
-         { customColor: 'gold' },
-         `{ 
-        customColor: "gold" 
-      }`
-      );
-      await this.createSwitch(
-         this.querySelector('.label'),
-         {
-            label: 'Switch',
-         },
-         `{
-        label: "Switch",
-      }`
-      );
-      await this.createSwitch(
-         this.querySelector('.labelLeft'),
-         {
-            label: 'Left',
-            labelPlacement: 'left',
-         },
-         `{
-        label: "Left",
-        labelPlacement: "left",
-      }`
-      );
-      await this.createSwitch(
-         this.querySelector('.labelTop'),
-         {
-            label: 'Top',
-            labelPlacement: 'top',
-         },
-         `{
-        label: "Top",
-        labelPlacement: "top",
-      }`
-      );
-      await this.createSwitch(
-         this.querySelector('.labelRight'),
-         {
-            label: 'Right',
-            labelPlacement: 'right',
-         },
-         `{
-        label: "Right",
-        labelPlacement: "right",
-      }`
-      );
-      await this.createSwitch(
-         this.querySelector('.labelBottom'),
-         {
-            label: 'Bottom',
-            labelPlacement: 'bottom',
-         },
-         `{
-        label: "Bottom",
-        labelPlacement: "bottom",
-      }`
-      );
-   }
-
-   async createSwitch(appendTo, switchProps, codeProps) {
-      if (!codeProps) {
-         codeProps = '{}';
-      }
-      const mySwitch = await slice.build('Switch', switchProps);
-
-      const componentCode = await slice.build('CodeVisualizer', {
-         value: `const mySwitch = await slice.build("Switch", ${codeProps});
-
-`,
-         language: 'javascript',
-      });
-
-      const div = document.createElement('div');
-      const switchDiv = document.createElement('div');
-      switchDiv.classList.add('switchs');
-      switchDiv.appendChild(mySwitch);
-      div.classList.add('switchs_container');
-      div.appendChild(switchDiv);
-      div.appendChild(componentCode);
-
-      if (appendTo) {
-         appendTo.appendChild(div);
-      }
-
-      return div;
-   }
-}
-
-customElements.define('slice-switchdocumentation', SwitchDocumentation);

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

@@ -1,296 +0,0 @@
-slice-the-build-method {
-  font-family: var(--font-family);
-  color: var(--font-primary-color);
-  display: block;
-}
-
-slice-the-build-method .build-method-container {
-  max-width: 90%;
-  margin: 0 auto;
-  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;
-  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: 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.8rem;
-  margin-bottom: 1rem;
-  color: var(--font-primary-color);
-}
-
-slice-the-build-method p {
-  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: 3px 6px;
-  border-radius: 4px;
-  font-size: 0.95em;
-  color: var(--primary-color);
-}
-
-slice-the-build-method .syntax-box {
-  background-color: var(--secondary-background-color);
-  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.2em;
-  background: none;
-}
-
-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 {
-  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 .parameters-list li:last-child {
-  border-bottom: none;
-  margin-bottom: 0;
-  padding-bottom: 0;
-}
-
-slice-the-build-method .param-name {
-  font-weight: bold;
-  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-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: 3.5rem;
-}
-
-slice-the-build-method section {
-  padding-top: 15px;
-}
-
-@media only screen and (max-width: 770px) {
-  slice-the-build-method .build-method-container {
-    max-width: 100%;
-    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 {
-    font-size: 1.5rem;
-  }
-
-  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;
-  }
-}

package/src/Components/AppComponents/TheBuildMethod/TheBuildMethod.html

@@ -1,89 +0,0 @@
-<div class="build-method-container">
-   <div class="build-method-header">
-      <h1 id="build-method">The Build Method</h1>
-      <div class="build-method-badge">Core API</div>
-   </div>
-   
-   <section class="method-introduction">
-      <p>
-         The <code>build</code> method is the cornerstone of Slice.js component creation. It's an asynchronous method that instantiates and configures components, handling all of the necessary resource loading, template attachment, and initialization.
-      </p>
-   </section>
-
-   <section class="method-syntax">
-      <h2 id="syntax">Syntax</h2>
-      <div class="syntax-box">
-         <code>await slice.build(componentName, props);</code>
-      </div>
-      <div class="parameters-section">
-         <h3>Parameters</h3>
-         <ul class="parameters-list">
-            <li><div class="param-name">componentName</div><div class="param-type">string</div><div class="param-description">The name of the component to build as registered in components.js</div></li>
-            <li><div class="param-name">props</div><div class="param-type">object</div><div class="param-description">(Optional) An object containing properties to set on the component</div></li>
-         </ul>
-      </div>
-      <div class="return-section">
-         <h3>Return Value</h3>
-         <p>A Promise that resolves to the constructed component instance, or null if construction fails.</p>
-      </div>
-   </section>
-
-   <section class="method-examples">
-      <h2 id="examples">Examples</h2>
-      
-      <div class="example-card">
-         <h3 id="basic-usage">Basic Usage</h3>
-         <p>Creating a simple button component and adding it to the DOM:</p>
-         <div class="basic-example-container"></div>
-      </div>
-      
-      <div class="example-card">
-         <h3 id="advanced-props">Advanced Properties</h3>
-         <p>Building a component with more complex properties:</p>
-         <div class="advanced-example-container"></div>
-      </div>
-      
-      <div class="example-card">
-         <h3 id="nested-components">Building Nested Components</h3>
-         <p>Creating a structure of components that contain other components:</p>
-         <div class="nested-components-container"></div>
-      </div>
-      
-      <div class="example-card">
-         <h3 id="error-handling">Error Handling</h3>
-         <p>Proper error handling when building components:</p>
-         <div class="error-handling-container"></div>
-      </div>
-   </section>
-
-   <section class="method-lifecycle">
-      <h2 id="build-lifecycle">Build Lifecycle</h2>
-      <p>When <code>slice.build()</code> is called, the following steps occur:</p>
-      <div class="lifecycle-diagram">
-         <ol class="lifecycle-steps">
-            <li><div class="step-number">1</div><div class="step-content">Verify that the component exists in the component registry</div></li>
-            <li><div class="step-number">2</div><div class="step-content">Load the component's template (HTML) if not already cached</div></li>
-            <li><div class="step-number">3</div><div class="step-content">Load the component's class (JS) if not already cached</div></li>
-            <li><div class="step-number">4</div><div class="step-content">Load the component's styles (CSS) if not already cached</div></li>
-            <li><div class="step-number">5</div><div class="step-content">Create an instance of the component with the provided properties</div></li>
-            <li><div class="step-number">6</div><div class="step-content">Call the component's <code>init()</code> method if it exists</div></li>
-            <li><div class="step-number">7</div><div class="step-content">Attach debug mode if enabled in configuration</div></li>
-            <li><div class="step-number">8</div><div class="step-content">Register the component in the controller's active components registry</div></li>
-            <li><div class="step-number">9</div><div class="step-content">Return the fully initialized component instance</div></li>
-         </ol>
-      </div>
-   </section>
-
-   <section class="method-best-practices">
-      <h2 id="best-practices">Best Practices</h2>
-      <div class="best-practices-container">
-         <ul class="best-practices-list">
-            <li><span class="practice-icon">✓</span> Always use <code>await</code> with <code>slice.build()</code> since it returns a Promise</li>
-            <li><span class="practice-icon">✓</span> Provide a unique <code>sliceId</code> for components that need to be referenced later</li>
-            <li><span class="practice-icon">✓</span> Implement proper error handling around component building</li>
-            <li><span class="practice-icon">✓</span> Use the component's <code>init()</code> method for additional setup rather than the constructor</li>
-            <li><span class="practice-icon">✓</span> Remember that component properties are set after construction but before initialization</li>
-         </ul>
-      </div>
-   </section>
-</div>

package/src/Components/AppComponents/TheBuildMethod/TheBuildMethod.js

@@ -1,86 +0,0 @@
-export default class TheBuildMethod extends HTMLElement {
-   constructor(props) {
-      super();
-      slice.attachTemplate(this);
-
-      slice.controller.setComponentProps(this, props);
-      this.debuggerProps = [];
-   }
-
-   async init() {
-      // Crear ejemplos de código para la documentación
-      const basicBuildExample = await slice.build('CodeVisualizer', {
-         value: `// Construir un componente básico
-const myButton = await slice.build("Button", {
-   value: "Click me!"
-});
-
-// Añadir el componente al DOM
-document.querySelector("#container").appendChild(myButton);`,
-         language: 'javascript'
-      });
-
-      const advancedBuildExample = await slice.build('CodeVisualizer', {
-         value: `// Componente con propiedades más avanzadas
-const customCard = await slice.build("Card", {
-   title: "Custom Card",
-   text: "This is a custom card with specific styling",
-   icon: {
-      name: "github",
-      iconStyle: "filled"
-   },
-   customColor: {
-      card: "#3a0ca3",
-      icon: "#f72585"
-   },
-   sliceId: "my-custom-card" // ID personalizado para referencia futura
-});`,
-         language: 'javascript'
-      });
-
-      const nestedComponentsExample = await slice.build('CodeVisualizer', {
-         value: `// Construcción de componentes anidados
-const grid = await slice.build("Grid", { 
-   columns: 2, 
-   rows: 1 
-});
-
-// Construir componentes hijos
-const card1 = await slice.build("Card", { 
-   title: "First Card" 
-});
-const card2 = await slice.build("Card", { 
-   title: "Second Card" 
-});
-
-// Añadir componentes hijos al grid
-await grid.setItem(card1);
-await grid.setItem(card2);
-
-// Añadir el grid al DOM
-document.body.appendChild(grid);`,
-         language: 'javascript'
-      });
-
-      const errorHandlingExample = await slice.build('CodeVisualizer', {
-         value: `// Manejo de errores al construir componentes
-try {
-   const component = await slice.build("NonExistentComponent", {});
-   if (!component) {
-      console.error("Component could not be built");
-   }
-} catch (error) {
-   console.error("Error building component:", error);
-}`,
-         language: 'javascript'
-      });
-
-      // Añadir los ejemplos al DOM
-      this.querySelector('.basic-example-container').appendChild(basicBuildExample);
-      this.querySelector('.advanced-example-container').appendChild(advancedBuildExample);
-      this.querySelector('.nested-components-container').appendChild(nestedComponentsExample);
-      this.querySelector('.error-handling-container').appendChild(errorHandlingExample);
-   }
-}
-
-customElements.define('slice-the-build-method', TheBuildMethod);