semmet-angular 0.9.0 → 0.11.0

package/README.md

@@ -79,7 +79,7 @@ The same pattern applies to `tabs`, `carousel`, and `disclosure`:
 
 By default, projected panel/slide content is preserved after its first render. Set `[preserveContent]="false"` on the generated container to destroy inactive content when it closes or becomes inactive.
 
-## Schematics (32)
+## Schematics (33)
 
 **Overlays & disclosure**
 
@@ -131,6 +131,7 @@ By default, projected panel/slide content is preserved after its first render. S
 |---|---|---|
 | `ng generate semmet-angular:alert <name>` | [Alert](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) | Dismissible assertive live region |
 | `ng generate semmet-angular:toast <name>` | Toast / Notification | Auto-dismisses after 5s (cleaned up via `DestroyRef`); dismissible early |
+| `ng generate semmet-angular:skeleton <name>` | Skeleton Loading | Composable loading placeholder for text, media, circles, cards, and custom blocks |
 | `ng generate semmet-angular:carousel <name>` | [Carousel](https://www.w3.org/WAI/ARIA/apg/patterns/carousel/) | Previous/Next controls; `aria-live="polite"` slide region |
 
 ## What every generated component looks like

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semmet-angular",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Angular schematics that generate real, ARIA-conformant standalone components (Accordion, Tabs, Dialog, Disclosure, Tooltip...) with signals-based state and keyboard interaction built in.",
   "publisher": "danilodevsilva",
   "license": "MIT",

package/src/collection.json

@@ -146,6 +146,11 @@
       "factory": "./progress-bar/index#progressBar",
       "schema": "./progress-bar/schema.json"
     },
+    "skeleton": {
+      "description": "Generates a standalone Angular Skeleton loading placeholder component for composable loading states.",
+      "factory": "./skeleton/index#skeleton",
+      "schema": "./skeleton/schema.json"
+    },
     "alert": {
       "description": "Generates a standalone Angular Alert component following the W3C ARIA Authoring Practices Guide.",
       "factory": "./alert/index#alert",

package/src/skeleton/files/__name@dasherize__/__name@dasherize__.css.template

@@ -0,0 +1,91 @@
+:host {
+  --semmet-color-surface: #ffffff;
+  --semmet-color-outline: #d4d4d8;
+  --semmet-color-skeleton: #e4e4e7;
+  --semmet-color-skeleton-highlight: #f4f4f5;
+  --semmet-radius-sm: 8px;
+  --semmet-radius-md: 12px;
+
+  display: block;
+  width: 100%;
+}
+
+.semmet-skeleton,
+.semmet-skeleton__line {
+  position: relative;
+  display: block;
+  overflow: hidden;
+  box-sizing: border-box;
+  background: var(--semmet-color-skeleton);
+  border-radius: var(--semmet-radius-sm);
+}
+
+.semmet-skeleton {
+  width: 100%;
+  height: 1rem;
+}
+
+.semmet-skeleton--circle {
+  width: 2.75rem;
+  height: 2.75rem;
+  border-radius: 999px;
+}
+
+.semmet-skeleton--card {
+  min-height: 16rem;
+  border: 1px solid var(--semmet-color-outline);
+  border-radius: var(--semmet-radius-md);
+}
+
+.semmet-skeleton--media {
+  height: 12.5rem;
+  border-radius: var(--semmet-radius-md);
+}
+
+.semmet-skeleton-text {
+  display: grid;
+  width: 100%;
+  gap: 0.65rem;
+}
+
+.semmet-skeleton__line {
+  width: 100%;
+  height: 1rem;
+}
+
+.semmet-skeleton--animated::after,
+.semmet-skeleton-text--animated .semmet-skeleton__line::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  transform: translateX(-100%);
+  background: linear-gradient(
+    90deg,
+    transparent,
+    var(--semmet-color-skeleton-highlight),
+    transparent
+  );
+  animation: semmet-skeleton-shimmer 1.35s ease-in-out infinite;
+}
+
+@keyframes semmet-skeleton-shimmer {
+  100% {
+    transform: translateX(100%);
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  :host {
+    --semmet-color-surface: #18181b;
+    --semmet-color-outline: #3f3f46;
+    --semmet-color-skeleton: #27272a;
+    --semmet-color-skeleton-highlight: #3f3f46;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .semmet-skeleton--animated::after,
+  .semmet-skeleton-text--animated .semmet-skeleton__line::after {
+    animation: none;
+  }
+}

package/src/skeleton/files/__name@dasherize__/__name@dasherize__.html.template

@@ -0,0 +1,32 @@
+<!-- Semmet Angular: Skeleton Loading - decorative placeholder for pending content. -->
+@if (variant() === 'text') {
+  <span
+    [id]="instanceId"
+    [class]="textClasses()"
+    [attr.aria-hidden]="ariaHidden()"
+    [attr.aria-label]="ariaLabel()"
+    [attr.aria-live]="ariaLive()"
+    [attr.role]="role()"
+  >
+    @for (line of lineItems(); track line) {
+      <span
+        class="semmet-skeleton__line"
+        [style.width]="lineWidth(line)"
+        [style.height]="heightStyle()"
+        [style.border-radius]="radiusStyle()"
+      ></span>
+    }
+  </span>
+} @else {
+  <span
+    [id]="instanceId"
+    [class]="skeletonClasses()"
+    [style.width]="widthStyle()"
+    [style.height]="heightStyle()"
+    [style.border-radius]="radiusStyle()"
+    [attr.aria-hidden]="ariaHidden()"
+    [attr.aria-label]="ariaLabel()"
+    [attr.aria-live]="ariaLive()"
+    [attr.role]="role()"
+  ></span>
+}

package/src/skeleton/files/__name@dasherize__/__name@dasherize__.ts.template

@@ -0,0 +1,69 @@
+import { Component, booleanAttribute, computed, input, numberAttribute } from '@angular/core';
+
+type <%= classify(name) %>Variant = 'rect' | 'text' | 'circle' | 'card' | 'media';
+
+let nextId = 0;
+
+@Component({
+  selector: '<%= selector %>',
+  imports: [],
+  templateUrl: './<%= dasherize(name) %>.html',
+  styleUrl: './<%= dasherize(name) %>.css',
+})
+export class <%= classify(name) %> {
+  protected readonly instanceId = `<%= dasherize(name) %>-${nextId++}`;
+
+  readonly variant = input<<%= classify(name) %>Variant>('rect');
+  readonly width = input<string | null>(null);
+  readonly height = input<string | null>(null);
+  readonly size = input<string | null>(null);
+  readonly radius = input<string | null>(null);
+  readonly lines = input(1, { transform: numberAttribute });
+  readonly animated = input(true, { transform: booleanAttribute });
+  readonly decorative = input(true, { transform: booleanAttribute });
+  readonly label = input('Loading content');
+
+  protected readonly normalizedLines = computed(() => Math.max(1, Math.floor(this.lines() || 1)));
+  protected readonly lineItems = computed(() =>
+    Array.from({ length: this.normalizedLines() }, (_item, index) => index),
+  );
+
+  protected readonly skeletonClasses = computed(() =>
+    [
+      'semmet-skeleton',
+      `semmet-skeleton--${this.variant()}`,
+      this.animated() ? 'semmet-skeleton--animated' : '',
+    ]
+      .filter(Boolean)
+      .join(' '),
+  );
+
+  protected readonly textClasses = computed(() =>
+    [
+      'semmet-skeleton-text',
+      this.animated() ? 'semmet-skeleton-text--animated' : '',
+    ]
+      .filter(Boolean)
+      .join(' '),
+  );
+
+  protected readonly widthStyle = computed(() => this.size() ?? this.width());
+  protected readonly heightStyle = computed(() => this.size() ?? this.height());
+  protected readonly radiusStyle = computed(() => this.radius());
+  protected readonly ariaHidden = computed(() => (this.decorative() ? 'true' : null));
+  protected readonly role = computed(() => (this.decorative() ? null : 'status'));
+  protected readonly ariaLive = computed(() => (this.decorative() ? null : 'polite'));
+  protected readonly ariaLabel = computed(() => (this.decorative() ? null : this.label()));
+
+  protected lineWidth(index: number): string | null {
+    if (this.width()) {
+      return this.width();
+    }
+
+    if (this.normalizedLines() > 1 && index === this.normalizedLines() - 1) {
+      return '68%';
+    }
+
+    return null;
+  }
+}

package/src/skeleton/index.d.ts

@@ -0,0 +1 @@
+export declare const skeleton: (options: import("./schema").Schema) => import("@angular-devkit/schematics").Rule;

package/src/skeleton/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skeleton = void 0;
+const generate_component_1 = require("../utils/generate-component");
+exports.skeleton = (0, generate_component_1.createAriaComponentSchematic)();
+//# sourceMappingURL=index.js.map

package/src/skeleton/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA,oEAA2E;AAE9D,QAAA,QAAQ,GAAG,IAAA,iDAA4B,GAAE,CAAC"}

package/src/skeleton/index.ts

@@ -0,0 +1,3 @@
+import { createAriaComponentSchematic } from '../utils/generate-component';
+
+export const skeleton = createAriaComponentSchematic();

package/src/skeleton/schema.d.ts

@@ -0,0 +1 @@
+export { ComponentSchematicOptions as Schema } from '../utils/schema-types';

package/src/skeleton/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/src/skeleton/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":""}

package/src/skeleton/schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SemmetAngularSkeleton",
+  "title": "Semmet Angular Skeleton Options Schema",
+  "type": "object",
+  "description": "Generates a standalone Angular Skeleton loading placeholder component for composable loading states.",
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name for the new component. Used to derive the class name, selector, and file names.",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like to use for the skeleton component?"
+    },
+    "path": {
+      "type": "string",
+      "format": "path",
+      "$default": { "$source": "workingDirectory" },
+      "description": "The path where the component files should be created, relative to the workspace root. Defaults to the project's source root.",
+      "visible": false
+    },
+    "project": {
+      "type": "string",
+      "description": "The name of the project to add the component to.",
+      "$default": { "$source": "projectName" }
+    }
+  },
+  "required": ["name", "project"]
+}

package/src/skeleton/schema.ts

@@ -0,0 +1 @@
+export { ComponentSchematicOptions as Schema } from '../utils/schema-types';