----------------------------------------------------------------------
This is the API documentation for the gdtest_page_tags library.
----------------------------------------------------------------------


## Classes

Core classes


Widget(name: str, size: int = 100)

A configurable widget.

Parameters
----------
name
    Display name of the widget.
size
    Size in pixels (default 100).


## Exceptions

Exception classes


WidgetError

Raised when a widget operation fails.


## Functions

Public functions


create_widget(name: str, size: int = 100) -> gdtest_page_tags.Widget

Factory function for creating widgets.

Parameters
----------
name
    Display name of the widget.
size
    Size in pixels (default 100).

Returns
-------
Widget
    A new widget instance.


----------------------------------------------------------------------
This is the User Guide documentation for the package.
----------------------------------------------------------------------

### Introduction

Welcome to the Page Tags Demo user guide!

This guide covers the basics of widget creation.


### Configuration

Learn how to configure widgets for your project.

## Basic Setup

Create a widget with default settings:

```python
from gdtest_page_tags import create_widget

w = create_widget("my-widget")
```


### Advanced Usage

Advanced patterns for power users.

## Custom Rendering

Override the default render method for custom output.


### Error Handling

How to handle errors when working with widgets.

## WidgetError

The `WidgetError` exception is raised when an invalid operation
is attempted.


### Rendering Widgets

This page has a subtitle to test tag pill placement.

## The Render Pipeline

Widgets go through a multi-step rendering pipeline before
producing their final HTML output.


### Frequently Asked Questions

This page has no tags at all.

## Why use widgets?

Widgets provide a reusable, configurable abstraction for
building HTML components.


### Tips and Tricks

This page uses description (not subtitle) with tags.

## Keyboard Shortcuts

Use Ctrl+W to close the current widget.


### Best Practices

This page has both subtitle and description, plus tags.

## Naming Conventions

Use descriptive names for your widgets.