RubyGems - presently - Versions diffs - 0.1.0 - Mend

presently 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (215) hide show

data/public/_components/@socketry/syntax/examples/readme.md ADDED Viewed

@@ -0,0 +1,79 @@
+# Examples
+This directory contains example pages demonstrating syntax highlighting for various languages.
+## Structure
+All example pages follow a consistent structure:
+### HTML Template
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>[Language] Examples - @socketry/syntax</title>
+	<link rel="stylesheet" href="examples.css">
+</head>
+<body>
+	<header>
+		<h1>[Language] Examples</h1>
+		<p class="subtitle">[Brief description]</p>
+	</header>
+	<nav>
+		<a href="index.html">Back to Examples</a>
+		<a href="[related].html">[Related Language]</a>
+	</nav>
+	<div class="example">
+		<h2>[Feature Name]</h2>
+		<p class="description">[Description of what this demonstrates]</p>
+		<syntax-code language="[language-id]">
+[code example]
+		</syntax-code>
+	</div>
+	<script type="module">
+		import Syntax from '../Syntax.js';
+		import register[Language] from '../Syntax/Language/[language].js';
+		register[Language](Syntax.default);
+		await Syntax.highlight({
+			autoUpgrade: true,
+			syntax: Syntax.default
+		});
+	</script>
+</body>
+</html>
+```
+## Shared Styles
+All examples use `examples.css` which provides:
+- Consistent header and navigation styling
+- Responsive layout
+- Dark mode support
+- Semantic HTML structure
+- Example containers with descriptions
+## Adding a New Example
+1. Copy `_template.html` to `[language].html`
+2. Replace placeholders with your language details
+3. Add code examples in `<div class="example">` blocks
+4. Update the navigation links to related languages
+5. Add a link to your example in `index.html`
+## Guidelines
+- **Header**: Use `<header>` with `<h1>` and subtitle
+- **Navigation**: Always include "Back to Examples" as first link
+- **Examples**: Wrap each example in `<div class="example">` with an `<h2>` heading and description
+- **Code**: Use `<syntax-code language="...">` elements
+- **Initialization**: Import and register the language, then call `Syntax.highlight()`

data/public/_components/@socketry/syntax/examples/ruby.html ADDED Viewed

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Ruby Examples - @socketry/syntax</title>
+	<link rel="stylesheet" href="examples.css">
+</head>
+<body>
+	<header>
+		<h1>Ruby Examples</h1>
+		<p class="subtitle">Ruby syntax with classes, symbols, and metaprogramming</p>
+	</header>
+	<nav>
+		<a href="index.html">Back to Examples</a>
+		<a href="python.html">Python</a>
+		<a href="bash.html">Bash</a>
+	</nav>
+	<div class="example">
+		<h2>Ruby Class Example</h2>
+		<p class="description">Object-oriented programming with Ruby:</p>
+		<syntax-code language="ruby">
+# Simple class
+class Greeter
+  def initialize(name)
+    @name = name
+  end
+  def greet
+    puts "Hello, #{@name}!"
+  end
+end
+# Usage
+user = Greeter.new('World')
+user.greet
+# Symbols and regex
+status = :ok
+pattern = /foo.+bar/i
+# Percent literals
+words = %w{alpha beta gamma}
+# Command
+output = `uname -a`
+		</syntax-code>
+	</div>
+	<script type="module">
+		import Syntax from '../Syntax.js';
+		await Syntax.highlight({ autoUpgrade: true });
+	</script>
+</body>
+</html>

data/public/_components/@socketry/syntax/examples/scala.html ADDED Viewed

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Scala Examples - @socketry/syntax</title>
+	<link rel="stylesheet" href="examples.css">
+</head>
+<body>
+	<header>
+		<h1>Scala Examples</h1>
+		<p class="subtitle">Scala syntax highlighting</p>
+	</header>
+	<nav>
+		<a href="index.html">Back to Examples</a>
+	</nav>
+<h1>Scala Example</h1>
+    <p>Minimal sample showing keywords, strings, functions, types, comments, and XML literals.</p>
+    <syntax-code language="scala">
+object App extends App {
+  // line comment
+  /* block comment */
+  def greet(name: String): String = {
+    val msg = "Hello, " + name
+    msg
+  }
+  val xml = &lt;note&gt;Hi {greet("World")}!&lt;/note&gt;
+  val multi = """This is a
+multi-line string"""
+  val value: MyType = MyType(42)
+}
+    </syntax-code>
+</body>
+</html>

data/public/_components/@socketry/syntax/examples/smalltalk.html ADDED Viewed

@@ -0,0 +1,436 @@
+<!DOCTYPE html>
+<html>
+	<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Smalltalk Examples - @socketry/syntax</title>
+	<link rel="stylesheet" href="examples.css">
+</head>
+	<body>
+	<header>
+		<h1>Smalltalk Examples</h1>
+		<p class="subtitle">Smalltalk syntax highlighting</p>
+	</header>
+	<nav>
+		<a href="index.html">Back to Examples</a>
+	</nav>
+<h1>Smalltalk Code Example</h1>
+		<div class="example">
+		<h2>Basic Syntax</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"This is a comment"
+"Assignment"
+x := 42.
+name := 'Alice'.
+"Pseudo-variables"
+self initialize.
+super doSomething.
+result := true.
+value := false.
+object := nil.
+</code></pre>
+		<div class="example">
+		<h2>Messages</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Unary messages (no arguments)"
+object initialize.
+collection size.
+number squared.
+"Binary messages (one argument, operator-like)"
+3 + 4.
+10 - 5.
+6 * 7.
+20 / 4.
+x < y.
+a = b.
+"Keyword messages (one or more arguments with colons)"
+array at: 1.
+dictionary at: key put: value.
+collection do: [:each | each printString].
+</code></pre>
+		<div class="example">
+		<h2>Blocks (Closures)</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Simple block"
+[3 + 4] value.
+"Block with arguments"
+[:x | x * 2] value: 5.
+"Block with multiple arguments"
+[:x :y | x + y] value: 3 value: 4.
+"Blocks as control structures"
+x > 0 ifTrue: [Transcript show: 'positive'].
+x > 0 ifFalse: [Transcript show: 'not positive'].
+x > 0
+	ifTrue: [Transcript show: 'positive']
+	ifFalse: [Transcript show: 'not positive'].
+</code></pre>
+		<div class="example">
+		<h2>Temporary Variables</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Single temporary variable"
+| temp |
+temp := 42.
+"Multiple temporary variables"
+| x y result |
+x := 10.
+y := 20.
+result := x + y.
+</code></pre>
+		<div class="example">
+		<h2>Method Definition</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Unary method"
+initialize
+	super initialize.
+	collection := OrderedCollection new.
+"Binary method"
++ aNumber
+	"Add two numbers"
+	^ value + aNumber value.
+"Keyword method (one argument)"
+at: index
+	"Return the element at the given index"
+	^ collection at: index.
+"Keyword method (multiple arguments)"
+at: index put: anObject
+	"Set the element at the given index"
+	collection at: index put: anObject.
+	^ anObject.
+"Method with temporary variables"
+factorial: n
+	| result |
+	result := 1.
+	2 to: n do: [:i | result := result * i].
+	^ result.
+</code></pre>
+		<div class="example">
+		<h2>Collections</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Array literals"
+#(1 2 3 4 5).
+#('one' 'two' 'three').
+"Creating arrays dynamically"
+Array new: 10.
+Array with: 1 with: 2 with: 3.
+"OrderedCollection"
+| collection |
+collection := OrderedCollection new.
+collection add: 'first'.
+collection add: 'second'.
+collection add: 'third'.
+"Dictionary"
+| dict |
+dict := Dictionary new.
+dict at: 'name' put: 'Alice'.
+dict at: 'age' put: 30.
+dict at: 'name'.
+"Set"
+| set |
+set := Set new.
+set add: 1.
+set add: 2.
+set add: 1.  "Duplicate ignored"
+</code></pre>
+		<div class="example">
+		<h2>Iteration</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"do: - iterate over elements"
+#(1 2 3 4 5) do: [:each | Transcript show: each printString; cr].
+"collect: - transform elements"
+#(1 2 3 4 5) collect: [:each | each * 2].
+"select: - filter elements"
+#(1 2 3 4 5 6) select: [:each | each even].
+"reject: - inverse filter"
+#(1 2 3 4 5 6) reject: [:each | each odd].
+"detect: - find first matching element"
+#(1 2 3 4 5) detect: [:each | each > 3].
+"inject:into: - reduce/fold"
+#(1 2 3 4 5) inject: 0 into: [:sum :each | sum + each].
+</code></pre>
+		<div class="example">
+		<h2>Control Structures</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Conditionals"
+x > 0 ifTrue: [Transcript show: 'positive'].
+x = 0 ifTrue: [Transcript show: 'zero'].
+x < 0 ifTrue: [Transcript show: 'negative'].
+x > 0
+	ifTrue: [Transcript show: 'positive']
+	ifFalse: [Transcript show: 'not positive'].
+"Loops - timesRepeat:"
+10 timesRepeat: [Transcript show: 'Hello'; cr].
+"Loops - to:do:"
+1 to: 10 do: [:i | Transcript show: i printString; cr].
+"Loops - to:by:do:"
+0 to: 100 by: 10 do: [:i | Transcript show: i printString; cr].
+"Loops - whileTrue:"
+| i |
+i := 1.
+[i <= 10] whileTrue: [
+	Transcript show: i printString; cr.
+	i := i + 1
+].
+"Loops - whileFalse:"
+[i > 0] whileFalse: [
+	Transcript show: i printString; cr.
+	i := i + 1
+].
+</code></pre>
+		<div class="example">
+		<h2>Class Definition</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Defining a new class"
+Object subclass: #Person
+	instanceVariableNames: 'name age'
+	classVariableNames: ''
+	package: 'MyApp-Model'.
+"Instance methods"
+Person>>name
+	^ name.
+Person>>name: aString
+	name := aString.
+Person>>age
+	^ age.
+Person>>age: aNumber
+	age := aNumber.
+Person>>initialize
+	super initialize.
+	name := ''.
+	age := 0.
+Person>>printOn: aStream
+	super printOn: aStream.
+	aStream
+		nextPutAll: ' (';
+		nextPutAll: name;
+		nextPutAll: ', age ';
+		print: age;
+		nextPut: $).
+"Class methods"
+Person class>>named: aString aged: aNumber
+	^ self new
+		name: aString;
+		age: aNumber;
+		yourself.
+</code></pre>
+		<div class="example">
+		<h2>Cascades</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Multiple messages to same receiver"
+Transcript
+	show: 'Hello';
+	space;
+	show: 'World';
+	cr.
+"Creating and initializing objects"
+person := Person new
+	name: 'Alice';
+	age: 30;
+	yourself.
+"Building complex structures"
+stream := WriteStream on: String new.
+stream
+	nextPutAll: 'Name: ';
+	nextPutAll: person name;
+	nextPutAll: ', Age: ';
+	print: person age.
+</code></pre>
+		<div class="example">
+		<h2>Exception Handling</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Basic exception handling"
+[
+	"Code that might fail"
+	collection at: index
+] on: Error do: [:ex |
+	Transcript show: 'Error: ', ex messageText; cr
+].
+"Ensure - always execute cleanup"
+[
+	file := FileStream fileNamed: 'data.txt'.
+	file contents
+] ensure: [
+	file ifNotNil: [file close]
+].
+"ifCurtailed - execute if block exits abnormally"
+[
+	"Some operation"
+] ifCurtailed: [
+	"Cleanup code"
+].
+</code></pre>
+		<div class="example">
+		<h2>Streams</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Reading from a stream"
+| stream |
+stream := ReadStream on: 'Hello World'.
+stream next.       "Returns $H"
+stream next: 5.    "Returns 'Hello'"
+stream upToEnd.    "Returns ' World'"
+"Writing to a stream"
+| stream |
+stream := WriteStream on: String new.
+stream nextPut: $H.
+stream nextPutAll: 'ello'.
+stream space.
+stream nextPutAll: 'World'.
+stream contents.   "Returns 'Hello World'"
+"Building strings"
+String streamContents: [:stream |
+	stream
+		nextPutAll: 'The answer is ';
+		print: 42
+].
+</code></pre>
+		<div class="example">
+		<h2>Metaprogramming</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Reflection - inspecting objects"
+object class.
+object class name.
+object class superclass.
+object class allInstVarNames.
+object class allSelectors.
+"Dynamic method invocation"
+object perform: #initialize.
+object perform: #at: with: 1.
+object perform: #at:put: with: 1 with: 'value'.
+"Testing capabilities"
+object respondsTo: #initialize.
+object class includesSelector: #initialize.
+"Creating classes dynamically"
+Object subclass: #DynamicClass
+	instanceVariableNames: 'slot1 slot2'
+	classVariableNames: ''
+	package: 'MyPackage'.
+"Compiling methods at runtime"
+DynamicClass compile: 'slot1 ^ slot1'.
+DynamicClass compile: 'slot1: anObject slot1 := anObject'.
+</code></pre>
+		<div class="example">
+		<h2>Advanced Examples</h2>
+		<p class="description">Example:</p>
+		<pre><code class="language-smalltalk">"Fibonacci sequence"
+fibonacci: n
+	n <= 1 ifTrue: [^ n].
+	^ (self fibonacci: n - 1) + (self fibonacci: n - 2).
+"Quicksort"
+quicksort: aCollection
+	| pivot less greater |
+	aCollection size <= 1 ifTrue: [^ aCollection].
+	pivot := aCollection first.
+	less := aCollection allButFirst select: [:each | each <= pivot].
+	greater := aCollection allButFirst select: [:each | each > pivot].
+	^ (self quicksort: less), (Array with: pivot), (self quicksort: greater).
+"Binary search"
+binarySearch: anArray for: aValue
+	| low high mid |
+	low := 1.
+	high := anArray size.
+	[low <= high] whileTrue: [
+		mid := (low + high) // 2.
+		(anArray at: mid) = aValue ifTrue: [^ mid].
+		(anArray at: mid) < aValue
+			ifTrue: [low := mid + 1]
+			ifFalse: [high := mid - 1]
+	].
+	^ nil.
+"Observer pattern"
+Object subclass: #Subject
+	instanceVariableNames: 'observers'
+	classVariableNames: ''
+	package: 'Patterns'.
+Subject>>initialize
+	super initialize.
+	observers := OrderedCollection new.
+Subject>>addObserver: anObserver
+	observers add: anObserver.
+Subject>>removeObserver: anObserver
+	observers remove: anObserver ifAbsent: [].
+Subject>>notifyObservers
+	observers do: [:each | each update: self].
+</code></pre>
+	</body>
+</html>