Skip to content

Commit 13d4db3

Browse files
KSemenenkoKSemenenko
committed
code and style
1 parent 93ad185 commit 13d4db3

44 files changed

Lines changed: 1085 additions & 218 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎AGENTS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ This file defines the global rules for AI agents working in this repository.
3030
- SDK projects with local `AGENTS.md` files:
3131
- `SDK/ts/`
3232
- `SDK/js/`
33-
- `SDK/dotnet/src/ManagedCode.Tps.Compiler/`
34-
- `SDK/dotnet/tests/ManagedCode.Tps.Compiler.Tests/`
33+
- `SDK/dotnet/src/ManagedCode.Tps/`
34+
- `SDK/dotnet/tests/ManagedCode.Tps.Tests/`
3535

3636
## Rule Precedence
3737

‎README.md‎

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,18 @@ TPS bridges this gap: it is human-readable markdown that any text editor can ope
2121
TPS now includes a `ManagedCode.Tps` SDK workspace for parsing, validation, compilation, and playback.
2222

2323
- **SDK catalog page:** [tps.managed-code.com/sdk](https://tps.managed-code.com/sdk/)
24-
- **TypeScript SDK:** [SDK/ts](https://github.com/managedcode/TPS/tree/main/SDK/ts)
25-
- **JavaScript SDK:** [SDK/js](https://github.com/managedcode/TPS/tree/main/SDK/js)
26-
- **.NET SDK:** [SDK/dotnet](https://github.com/managedcode/TPS/tree/main/SDK/dotnet)
24+
- **SDK glossary:** [docs/Glossary.md](https://github.com/managedcode/TPS/blob/main/docs/Glossary.md)
25+
26+
### Runtime Catalog
27+
28+
| Runtime | Status | Workspace | Notes |
29+
|---------|--------|-----------|-------|
30+
| **TypeScript** | Active | [SDK/ts](https://github.com/managedcode/TPS/tree/main/SDK/ts) | Canonical typed TPS implementation |
31+
| **JavaScript** | Active | [SDK/js](https://github.com/managedcode/TPS/tree/main/SDK/js) | Built consumer runtime generated from TypeScript |
32+
| **.NET / C#** | Active | [SDK/dotnet](https://github.com/managedcode/TPS/tree/main/SDK/dotnet) | `ManagedCode.Tps` runtime and xUnit suite |
33+
| **Flutter** | Planned | [SDK/flutter](https://github.com/managedcode/TPS/tree/main/SDK/flutter) | Reserved placeholder runtime |
34+
| **Swift** | Planned | [SDK/swift](https://github.com/managedcode/TPS/tree/main/SDK/swift) | Reserved placeholder runtime |
35+
| **Java** | Planned | [SDK/java](https://github.com/managedcode/TPS/tree/main/SDK/java) | Reserved placeholder runtime |
2736

2837
Each active SDK exposes the same core contract:
2938

@@ -39,6 +48,7 @@ Additional SDK documentation:
3948
- **TypeScript docs:** [SDK/ts/README.md](https://github.com/managedcode/TPS/blob/main/SDK/ts/README.md)
4049
- **JavaScript docs:** [SDK/js/README.md](https://github.com/managedcode/TPS/blob/main/SDK/js/README.md)
4150
- **.NET docs:** [SDK/dotnet/README.md](https://github.com/managedcode/TPS/blob/main/SDK/dotnet/README.md)
51+
- **Future runtime placeholders:** [SDK/flutter/README.md](https://github.com/managedcode/TPS/blob/main/SDK/flutter/README.md), [SDK/swift/README.md](https://github.com/managedcode/TPS/blob/main/SDK/swift/README.md), [SDK/java/README.md](https://github.com/managedcode/TPS/blob/main/SDK/java/README.md)
4252

4353
## Design Goals
4454

@@ -49,17 +59,25 @@ Additional SDK documentation:
4959

5060
## Glossary
5161

62+
Complete canonical glossary, including `#`, `##`, `###`, inline tags, diagnostics, compiler/runtime terms, and SDK terminology: [docs/Glossary.md](https://github.com/managedcode/TPS/blob/main/docs/Glossary.md)
63+
5264
| Term | Definition |
5365
|------|-----------|
5466
| **Script** | The entire TPS document, including front matter and all content. |
5567
| **Front Matter** | YAML metadata block delimited by `---` at the top of the file. |
68+
| **Title** | The optional `#` heading used as display metadata for the script. |
5669
| **Segment** | A major section (`##` header) — e.g., Intro, Problem, Solution. |
5770
| **Block** | A topic group (`###` header) within a segment. |
5871
| **Phrase** | A sentence or thought within a block, delimited by sentence-ending punctuation or pause markers. |
5972
| **Word** | An individual token with optional per-word properties (emphasis, volume, pause). |
6073
| **WPM** | Words Per Minute — the reading speed. |
6174
| **Edit Point** | A marker indicating a natural place to stop or start an editing session. |
6275
| **Emotion** | A predefined delivery style that controls tone, energy, and visual presentation. |
76+
| **Validator** | The TPS component that reports actionable authoring diagnostics. |
77+
| **Compiler** | The TPS component that turns parsed TPS into a JSON-friendly timed state machine. |
78+
| **Compiled Script** | The runtime-ready output containing metadata, segments, blocks, phrases, words, and timing. |
79+
| **Player** | The runtime component that resolves what should be shown at a specific elapsed time. |
80+
| **ManagedCode.Tps SDK** | The multi-runtime SDK workspace under `SDK/` for TypeScript, JavaScript, .NET, and future runtimes. |
6381

6482
## File Structure
6583

‎SDK/dotnet/AGENTS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ Parent: `../../AGENTS.md`
1212

1313
## Entry Points
1414

15-
- `src/ManagedCode.Tps.Compiler/`
16-
- `tests/ManagedCode.Tps.Compiler.Tests/`
15+
- `src/ManagedCode.Tps/`
16+
- `tests/ManagedCode.Tps.Tests/`
1717

1818
## Project Commands
1919

‎SDK/dotnet/ManagedCode.Tps.slnx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<Solution>
22
<Folder Name="/dotnet/">
3-
<Project Path="tests/ManagedCode.Tps.Compiler.Tests/ManagedCode.Tps.Compiler.Tests.csproj" />
4-
<Project Path="src/ManagedCode.Tps.Compiler/ManagedCode.Tps.Compiler.csproj" />
3+
<Project Path="tests/ManagedCode.Tps.Tests/ManagedCode.Tps.Tests.csproj" />
4+
<Project Path="src/ManagedCode.Tps/ManagedCode.Tps.csproj" />
55
</Folder>
66
</Solution>

‎SDK/dotnet/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ManagedCode.Tps .NET SDK
22

3-
This folder contains the .NET TPS runtime under the `ManagedCode.Tps.Compiler` namespace.
3+
This folder contains the .NET TPS runtime under the `ManagedCode.Tps` namespace.
44

55
## Public API
66

@@ -12,8 +12,8 @@ This folder contains the .NET TPS runtime under the `ManagedCode.Tps.Compiler` n
1212

1313
## Project Layout
1414

15-
- `src/ManagedCode.Tps.Compiler/`: runtime implementation
16-
- `tests/ManagedCode.Tps.Compiler.Tests/`: xUnit coverage and parity tests
15+
- `src/ManagedCode.Tps/`: runtime implementation
16+
- `tests/ManagedCode.Tps.Tests/`: xUnit coverage and parity tests
1717

1818
## Contract Notes
1919

‎SDK/dotnet/src/ManagedCode.Tps.Compiler/Properties/AssemblyInfo.cs‎

Lines changed: 0 additions & 3 deletions
This file was deleted.

‎SDK/dotnet/src/ManagedCode.Tps.Compiler/TpsPlayer.cs‎

Lines changed: 0 additions & 56 deletions
This file was deleted.

SDK/dotnet/src/ManagedCode.Tps.Compiler/AGENTS.md renamed to SDK/dotnet/src/ManagedCode.Tps/AGENTS.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# AGENTS.md
22

3-
Project: ManagedCode.Tps.Compiler
3+
Project: ManagedCode.Tps
44
Owned by: ManagedCode.Tps .NET core library maintainers
55

66
Parent: `../../../../AGENTS.md`
@@ -12,7 +12,7 @@ Parent: `../../../../AGENTS.md`
1212

1313
## Entry Points
1414

15-
- `ManagedCode.Tps.Compiler.csproj`
15+
- `ManagedCode.Tps.csproj`
1616
- `TpsSpec.cs`
1717
- `TpsRuntime.cs`
1818
- `TpsPlayer.cs`
@@ -21,7 +21,7 @@ Parent: `../../../../AGENTS.md`
2121

2222
- In scope:
2323
- .NET library code
24-
- public contracts and namespaces under `ManagedCode.Tps.Compiler`
24+
- public contracts and namespaces under `ManagedCode.Tps`
2525
- library-only build settings
2626
- Out of scope:
2727
- xUnit test code
@@ -33,10 +33,10 @@ Parent: `../../../../AGENTS.md`
3333

3434
## Project Commands
3535

36-
- `build`: `dotnet build ManagedCode.Tps.Compiler.csproj`
37-
- `test`: `dotnet test ../../tests/ManagedCode.Tps.Compiler.Tests/ManagedCode.Tps.Compiler.Tests.csproj`
36+
- `build`: `dotnet build ManagedCode.Tps.csproj`
37+
- `test`: `dotnet test ../../tests/ManagedCode.Tps.Tests/ManagedCode.Tps.Tests.csproj`
3838
- `format`: `dotnet format ../../ManagedCode.Tps.slnx --verify-no-changes`
39-
- `analyze`: `dotnet build ManagedCode.Tps.Compiler.csproj -warnaserror`
39+
- `analyze`: `dotnet build ManagedCode.Tps.csproj -warnaserror`
4040

4141
For this .NET project:
4242

@@ -63,6 +63,6 @@ For this .NET project:
6363

6464
## Local Rules
6565

66-
- Keep the `ManagedCode.Tps.Compiler` namespace prefix intact.
66+
- Keep the `ManagedCode.Tps` namespace prefix intact.
6767
- Do not place test helpers or test-only code in this project.
6868
- Prefer small, composable types over large utility buckets.

SDK/dotnet/src/ManagedCode.Tps.Compiler/Internal/TpsContentCompiler.cs renamed to SDK/dotnet/src/ManagedCode.Tps/Internal/TpsContentCompiler.cs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
using System.Text;
2-
using ManagedCode.Tps.Compiler.Models;
2+
using ManagedCode.Tps.Models;
33

4-
namespace ManagedCode.Tps.Compiler.Internal;
4+
namespace ManagedCode.Tps.Internal;
55

66
internal sealed class TpsContentCompiler
77
{

SDK/dotnet/src/ManagedCode.Tps.Compiler/Internal/TpsEscaping.cs renamed to SDK/dotnet/src/ManagedCode.Tps/Internal/TpsEscaping.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
namespace ManagedCode.Tps.Compiler.Internal;
1+
namespace ManagedCode.Tps.Internal;
22

33
internal static class TpsEscaping
44
{

0 commit comments

Comments
 (0)